Saphan StudioDocs
Concepts

How you work with it

The working method end to end, from order to observed merge.

The working method, end to end — this is the part that makes the rest matter:

  1. Work enters as an order on a named track. A planning run returns a plan contract: implementation plan and test plan as separate artifacts, produced so that the test author never sees the implementation plan — symmetry by construction, not by discipline.
  2. You gate the plan. STOP-1 is a human act with no default value and no timeout-as-consent. The engine refuses to spawn onto a stream that owes you an unsettled decision.
  3. The engine dispatches to the cheapest capable actor — frontier model, second vendor, local model, or a deterministic tool. "Capable" is probe-confirmed, never assumed; "same quality" is checked by the same suites and gates regardless of who did the work, which is what makes the principle enforceable rather than aspirational.
  4. Execution is isolated: its own git worktree, its own seat, OS-level confinement with deny-by-default writes — locally and, for SSH-dispatched runs, enforced by the runner's own kernel — and kernel-level read-deny on lane credentials. A missing sandbox refuses the run rather than degrading quietly.
  5. Merges are earned. Green suite as a merge condition; independent review scaled to the class of the work; then your gate — and the merge commit carries trailers binding it to the gate that authorized it. Afterwards the engine observes the git fact; merged is never declared, only observed.
  6. The fleet tells you what it owes you. The engine composes your pending acts — gates to decide, commands ready to paste, and an explicit "nothing on your hand" — instead of burying them in chat prose. Silence and health are distinguishable states.

What this buys the person running it: your attention goes where humans are irreplaceable — deciding what is worth doing, gating what is irreversible, ratifying what the fleet learned — and the paste-ready discipline means you execute decisions rather than reverse-engineer them. The fleet works around the clock; your judgment is applied in minutes a day, at the gates, with the evidence in front of you.