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 stream: one document stating the scope, the test plan (each guarded behaviour with the test that proves it, written red first) and what done means — see orders.
  2. You gate the plan. The first gate (stop1) is a human act: the gate verb has no default decision, and nothing records one on a timeout — see human gates.
  3. Each run is dispatched to an actor you name — a frontier model, a second vendor, a local model, or a deterministic tool — with a quote the dispatch will not compose without. A preflight checks the target machine before the run (it can be skipped, and a machine it did not check is never reported as proven); "same quality" is checked by the same suites and gates regardless of who did the work, which is what makes the choice of a cheaper actor enforceable rather than aspirational.
  4. Execution is isolated: its own git worktree, its own seat, and operating-system confinement that limits writes to the working directory — locally and, for SSH-dispatched runs, applied by the runner's own kernel — with a named deny list (signing keys, seat tokens, other runs' captures) hidden from reads. An unprobed remote machine is refused rather than run unconfined. ⚠ Not every backend is confined by the engine on every platform; where it is not, the run record says so — see the sandbox matrix.
  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.