| decisions_registry |
BDR |
| id |
date |
title |
decision |
why |
alternatives |
status |
supersedes |
| BDR-XXX |
YYYY-MM-DD |
string (<= 80 chars) |
string (what was chosen) |
string (motivation, context) |
list of strings (what was rejected + why) |
| proposed | accepted | deprecated | superseded |
|
BDR-XXX (optional) |
|
| Append-only. Never rewrite past entries - add a new one with status superseded if needed. |
| One entry per non-trivial choice. Trivial = reversible in under 10 min with no cross-file impact. |
| Capture why more carefully than what - the what rots, the why lasts. |
| Entries in English, caveman format (BDR-009) |
| drop articles + filler, fragments OK, technical terms exact. |
|
|
