Interactive overview
The SDD Mode Big Picture
The whole operating mode on a single diagram: the seven-step cycle, the Tier 1 governance band above it, the artifacts that feed it, the responsibilities that carry it and the metrics that measure it. Click any element to open the corresponding article.
Tier 1 governance (veto) Cycle steps Gates & Human Authorship Artifacts & Drift Lock Responsibilities Rituals & metrics
The cycle in text
Full alternative to the diagram above:
- Intent Statement (
/sdd intent) — an identifiable human captures the WHY in five fields. Without a human author the session is invalidated (Human Authorship). The value unfolds as an authority continuum: each step up — clarification, SPEC validation, write authorisation, deployment authorisation — is a distinct human act, and answering the agent is not consenting. - Research Phase (
/sdd research) — mandatory code-grounded discovery, graduated verdict GO / CONDITIONAL GO / DEFER / NO-GO decided by the human. - SPEC (
/sdd spec,/sdd split) — the living specification: scope, interface, behaviour, edge cases, tests, drift criterion. Prose or EARS format. - Execution Gate (
/sdd gate) — the SQS scores 5 criteria plus the Stranger Test. Below 4/5, the gate closes and the SPEC goes back to revision. As soon as an agent action is irreversible or an agent holds credentials, the Gate also checks the autonomy ceiling, prior human authorisation, the execution perimeter and the stop threshold (see Agent autonomy). - Agent Execution (
/sdd exec,/sdd resume) — optimised context within the Context Engineering Budget, implementation plan required before code. The agent stops on its own at the stop points set by the SPEC. - Validation (
/sdd validate) — four axes: technical, functional, business, governance. The 4 Tier 1 agents hold a fail-closed veto. Verification is designed, not bought: what is checked, when and by whom matters first. - Drift Lock (
/sdd drift-check,/sdd trace) — code and SPEC synchronised in the same PR, verified by the traceability matrix. It is the last link of the chain of evidence. - Deployment — staging then production, monitoring, rollback if needed (Integrate loop). Automated deployment is admissible only when the chain of evidence is complete: Intent Statement, SPEC validated at the Gate, traced verifications, Drift Lock.
- Consolidation (
/aiad retro,/aiad intention,/aiad status) — Lessons Learned, Human Learnings, metrics. Then a new iteration from step 1 (rituals).
In permanent support: the artifacts (PRD, ARCHITECTURE, AGENT-GUIDE, Intents, SPECs), the five responsibilities, the JNSP uncertainty policy, agent autonomy (authority continuum, stop points, execution perimeter, stop threshold) and the SQS, DORA and Flow metrics.