[Document Title]
[One sentence: what this document decides or records, for whom, and its boundary.]
[The single most important takeaway or recommendation. A reader who stops here should still leave with the right conclusion.]
TL;DR
[A meaningful summary a reader can act on: the problem, the decision or finding, and what happens next. Not a table of contents in prose.]
Why
[Why this document exists: the trigger, the pain, the opportunity.]
Problem
Current failure
[What goes wrong today.]
Who feels it
[The user or system carrying the cost.]
Cost of doing nothing
[What continues or worsens.]
Goals
- [Outcome this document commits to.]
- [Outcome this document commits to.]
What
[The substance: requirements, findings, decisions — whatever this document type carries.]
[Main Content Section]
| ID | Item | Acceptance / Evidence |
|---|---|---|
| [X1] | [Statement a reviewer can verify.] | [What proves it.] |
How
[How it works or how it will be done.]
Approach
[Replace with the mechanism, plan, or method. Split into more sections as needed — copy a .section block and add it to the index.]
Why Not
[Rejected alternatives, non-goals, and what remains unresolved.]
Alternatives Rejected
| Alternative | Why Not | When To Reconsider |
|---|---|---|
| [Alternative] | [Concrete downside, not preference.] | [Future trigger.] |
Open Questions
| Question | Owner | Decision Needed By |
|---|---|---|
| [Question] | [Owner] | [Date or phase] |