I gave it one requirements file and it generated the full spec tree in a single pass. The read_order is the part that stuck with me. Every new session opens SPEC.md first and already knows the constraints, so I stopped re-explaining the project every morning.
The Diagnosis
by default. Every new AI chat starts cold — no memory of your architecture decisions, no memory of your constraints, no memory of what was already built last time.
Stack, structure, conventions, boundaries. You explain the same project in every new session. The model listens, nods, then guesses anyway.
without a spec. The AI fills every gap it finds — not with nothing, but with something plausible that quietly contradicts what you decided two sessions ago.
The Syntax
Every block is a contract. Nothing is implied.
Deterministic read order
AI always loads context in the same sequence. No inference, no drift.
Explicit memory tiers
Hot / warm / cold. Nothing is loaded that isn't needed for this session.
Declared dependencies
Each task block knows exactly what context it requires before execution.




