decision-record.txt
I've decided to <the decision> for <the project>.

Write it up as a short record:
- The decision, in one sentence.
- The context: what forced a choice here.
- The alternatives I considered and why each was rejected.
- What this makes easy, and what it makes hard.
- What would make me revisit this.

Keep it under 300 words. It goes in the repo, and the audience is me
in six months having forgotten all of this.

Ask me anything you need before writing it — particularly about the
alternatives, since I probably haven't stated them.

The "what would make me revisit this" line is the one with real value. It turns a decision into something with an expiry condition rather than an assumption you never re-examine.