Skip to content

Explanation ​

Why peregrin is designed the way it is — the concepts behind the contracts in Reference.

Orientation ​

  • Architecture — nodes, hub, the sepia boundary, planes, where peregrin sits in the org.
  • Concepts — the domain vocabulary, defined once.
  • Boundaries — owns / doesn't-own, neighbors named.
  • Decisions — ADR-lite: decision → alternative → consequence.

The model ​

The seams ​

The bounds ​

  • Resilience — retry, DLQ, circuit breaker.
  • Loop protection — the mechanisms that bound a run.
  • Safety — how the engine keeps AI-governed workflows safe.
  • Threat model — who trusts whom, and what happens when trust is wrong.

The whole ​