- Status: Proposed
- Date: YYYY-MM-DD
The forces at play: the problem, the constraints, and what makes the choice non-obvious. State the facts a reader needs, including any evidence (numbers, parity checks, links). Set the decision up; do not argue for it yet.
The choice, stated plainly in the active voice ("We will ..."). Name the main alternatives considered and why they lost, so the reasoning stays recoverable.
What becomes true after this decision: the benefits, the costs, the new constraints, and any follow-up work or open risks. Capture the bad with the good.