Project Narrative

A narrative records the history of a project: why it exists, what happened, what changed, what failed and what comes next. Keep it separate from the README, changelog and ADRs, and link to them.

One document serves two readers. People read from the top for orientation. Agents go to the status, invariants and evidence links.

Outcomes

• A newcomer can explain the project after five minutes.
• An agent can answer "why is this like this?" without reading the whole repository.
• Decisions, failures and reversals remain available after the people who made them leave.
• Every claim is traceable to evidence.
• The narrative reads as a series of short blog posts.

Procedure