12 lines
518 B
Markdown
12 lines
518 B
Markdown
|
# Decision-memo format
|
||
|
|
|
||
|
|
When surfacing a decision, tradeoff, or interpretation call, never bury it in
|
||
|
|
a status paragraph. Use this four-part memo:
|
||
|
|
|
||
|
|
1. **Headline** — one line naming the decision.
|
||
|
|
2. **Options as concrete A/B examples** — actual code/command snippets
|
||
|
|
side by side when the difference is code; never prose descriptions of the
|
||
|
|
difference.
|
||
|
|
3. **Recommendation** — with confidence % and the single deciding reason.
|
||
|
|
4. **Explicit ask + default** — state what happens if the user says nothing.
|