plan-artifactslisted

# Plan Artifacts — Structured Knowledge Trail Plans, brainstorms, and solutions live as dated artifacts under `docs/`. New plans default to **directory format** (v1) with machine-checkable ground truth in `features.json`. Older single-file plans (v0) remain readable. ## Directory layout ``` docs/ ├── plans/ # Implementation plans (executable contracts) │ ├── <YYYY-MM-DD-NNN-type-name>/ # v1 directory format (preferred) │ │ ├── plan.md # frontmatter validated by plan.schema.json │ │ ├── features.json # validated by features.schema.json │ │ ├── decisions.jsonl # append-only decision log │ │ ├── audit/*.json # per-agent audit reports │ │ └── evidence/ # small artifacts; large → cloud storage │ └── <YYYY-MM-DD-NNN-type-name>-plan.md # v0 single-file (legacy, still readable) │ ├── brainstorms/ # Design explorations and requirements (from brainstorm-gate) └── solutions/ # Learnings post-implementation (root-cause + fix) ``` If `docs/` doesn't exist at the repo root, create it. ## When to use which format | Plan tier | Format | Why | |---|---|---| | `trivial` | v0 single-file OK | Low ceremony; just a checklist | | `local` | v0 OR v1 | Operator preference | | `cross-cutting` and above | v1 directory **required** | Multi-agent panel + signoff need machine-checkable contract | | Any plan that will be audited by another agent | v1 required | Auditors