_inputs/_outputs Sibling Discipline¶
Every plan suite has three sibling directories adjacent to the MASTER-PLAN.md: _inputs/, _outputs/, and _spec/. This page documents their roles and invariants.
_spec/¶
Contains the authoritative spec document. All phases must trace decisions back to _spec/spec.md. The spec is the source of truth for the suite.
_inputs/¶
Read-only input surface. Contains: - External state snapshots captured at Phase 01 (git mirrors, API responses) - The handoff manifest from predecessor suites - Forge artifacts and extract lineage records
No phase may write to _inputs/ after the snapshot phase.
_outputs/¶
Operator-facing emission surface. Contains:
- Per-phase REPORT.md mirrors (byte-identical to phases/
Optional siblings¶
Three optional siblings may be materialized per operator decision:
| Directory | Role | Ratified |
|---|---|---|
| _decisions/ | Operator-ratified decisions and deferral rationale | Per OQ-P04-1 |
| _evidence/ | Artifacts and data that substantiate spec claims | Per OQ-P04-1 |
| _handoffs/ | Inter-agent and inter-phase transfer packets | Per OQ-P04-1 |