Learning path
Work through these in order if you are learning.
Learning path
Work through these in order if you are learning.
If you are adopting today: follow FIRST_WEEK.md (copy scaffold + minimum files), keep appendix/phase-folder-map.md as the path SSoT, then read primer chapters as you fill each phase.
Core (required)
Read these before anything else.
Lifecycle chapters
One chapter per phase, in order. Read alongside the phase you are filling.
- Phase 0 — Charter
- Phase 1 — Requirements
- Phase 2 — Architecture
- Phase 3 — Detailed design
- Phase 4 — Implementation docs
- Phase 5 — Testing
- Phase 6 — Operations
- Phase 7 — User docs
- Phase 8 — Maintenance
- Phase 9 — Retirement
Practice layers
Cross-cutting topics that apply across phases. Read in any order after Core.
Then use the kit
FIRST_WEEK.md— minimum fill setscaffold/README.DOCS.md— copy instructions (kit repo)scaffold/docs/GOVERNANCE.md— stub policy (copied)scaffold/docs/KIT.md— upstream path index (copied; post-copy safe)appendix/phase-folder-map.md— canonical paths (kit repo)templates/·examples/acme-export-platform/·recipes/
Suggested timeboxes
| Goal | Effort |
|---|---|
| Understand the model | 40–60 minutes (core + phases overview) |
| First week pack on a greenfield repo | ~1 week calendar / few focused hours |
| Copy scaffold only | ≤ 30 minutes |
| Fill Phase 0–2 for a real project | 1–3 days (team dependent) |
| Enable optional Spectral + one publishing recipe | half a day |