Saphan StudioDocs
Getting started

Notes from a fleet that builds itself

What dogfooding looks like in the record, with no number invented.

Saphan Studio is developed by a Saphan fleet — the engine you would run is the engine that runs its own development, orders, gates, ledger and all. Dogfooding is cheap to claim, so here is what it looks like in the record, with no mechanism revealed and no number invented:

A five-phase engine arc, priced and delivered by the fleet. The metering daemon was built as five gated phases — shared spawn door, daemon skeleton, master metering, monitoring triggers, mailbox — planned at $22–30 of agent work and landed at ~$34, with every dollar of the overrun attributed to a named cause (one provider outage, one cap-hit, one run whose terminal died mid-flight). The interesting part is not the number; it is that the number exists, per phase, with reasons.

Each phase proved its own necessity by a failure during its own construction. The phase that built the single spawn door was motivated when work about the daemon itself entered sideways, off the record. The phase that hardened the parser was motivated when the parser silently swallowed a malformed registration. The monitoring phase was motivated when a ratification sat waiting on an executor that was already dead. You do not get to invent better justifications than the ones your own record hands you.

A dead terminal could not kill the bookkeeping. A run's terminal died mid-flight — laptop-lid-class accident, the kind that normally leaves a zombie "in progress" forever. The stream still closed correctly, because closing is gated on durable records on disk, not on a live chat session. The accident cost a few dollars of unrecorded work and produced a tightened rule; the record of the stream is complete.

A mistyped dispatch cost zero. An accidental paste landed in a dispatch channel less than a minute before a run would have started. The dispatch surface's format invariants refused it — the run never spawned, the refusal was ledgered, and the price of the mistake was $0 instead of a full executor run. Refusal-first surfaces are cheaper than apologies.

An expensive lesson became a standing checklist, once. One stream quoted at $11 cost ~$36 across seven follow-up rounds — five of them caused by gaps in the original order that were all knowable in advance. The response was structural: a standard Definition-of-Done block that now rides in every order, with the rule "a failure class, once measured, enters the standard and never has to be rediscovered." The fleet's method improves by ratchet, not by memory.

Fresh eyes are an asset the process exploits. When a coordinating agent rotates out at the peak of its form (rotations are planned, with a written handoff from the record), the successor's first day routinely finds defects the veteran had stopped seeing — in one recorded case, two of them, fixed and promoted into standing rules within the same day. The knowledge lives in the record, not in any one agent's head — which is precisely what makes rotation cheap.

The judge is a test suite, not an opinion. Claims like "same quality from a cheaper actor" are settled by the conformance suite — end-to-end scenarios driving the real binary, from gate discipline through dispatch locking to authorization on the management surface — and by the ledger, to the cent. When the same order can be given to two different executors and the same suite judges both returns, "which actor should do this class of work" stops being a matter of taste.