Example: Acme Export Platform

Fictional product used to show the kit filled in — not a real system.

Example: Acme Export Platform

Fictional product used to show the kit filled in — not a real system.

Product one-liner: Self-service data export so enterprise customers can download account data without filing engineering tickets.

What’s included

Path	Phase	Shows
internal/charter/vision.md	0	Vision + KPIs
internal/requirements/user-stories/export-csv.md	1	Testable user story
internal/requirements/non-functional.md	1	Numeric NFRs + bad→good
internal/requirements/personas/persona-enterprise-admin.md	1	Persona
internal/architecture/context-diagram.md	2	C4-style context (Mermaid)
internal/decisions/adr-001-queue-for-exports.md	2	ADR with alternatives
internal/system-design/services/export-service.md	3	Module spec
internal/system-design/api-specs/export-api.yaml	3	Canonical OpenAPI sample
internal/operations/runbooks/export-queue-backlog.md	6	Symptom-oriented runbook
user/getting-started/quickstart.md	7	User getting started
user/api-reference/overview.md	7	Curated API intro (derived from OpenAPI)
user/changelog/2024-03-15-export-improvements.md	8	User-facing release changelog
internal/changelog-2026-q1.md	8	Internal quarterly changelog
internal/retrospectives/2026-02-11-worker-oom-crash-loop.md	8	Incident retrospective
internal/charter/retirement-v1-export-legacy.md	9	Retirement plan + knowledge transfer
shared/glossary.md	Shared	Shared terms

How to read this

Note what is internal (honest, operational) vs user (goal-oriented, safe).
Compare structure to scaffold/docs/.
Use with FIRST_WEEK.md — copy patterns, not the fictional product details.

This example covers Phases 0–9. It prioritises phases teams get stuck on (1, 3) plus the two-audience and ops patterns, then models Phase 8 (maintenance) and Phase 9 (retirement) with realistic entries.