34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
---
|
|
format: 2
|
|
type: decisions_registry
|
|
entry_prefix: BDR
|
|
schema:
|
|
id: BDR-XXX
|
|
date: YYYY-MM-DD
|
|
title: string (<= 80 chars)
|
|
decision: string (what was chosen)
|
|
why: string (motivation, context)
|
|
alternatives: list of strings (what was rejected + why)
|
|
status: [proposed | accepted | deprecated | superseded]
|
|
supersedes: BDR-XXX (optional)
|
|
rules:
|
|
- 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.
|
|
---
|
|
|
|
# Decisions registry (BDR)
|
|
|
|
<!-- Written only by `bash ~/.claude/lib/memory.sh add decision --title "<title>"
|
|
--body-file <file> [--status accepted]` (it allocates the ID). Entry shape:
|
|
|
|
## BDR-NNN — <title> [accepted] (YYYY-MM-DD)
|
|
- **Decision**: <what was chosen>
|
|
- **Why**: <motivation>
|
|
- **Rejected alternatives**: <each option, why rejected>
|
|
- **Reference**: <commit / PR / file>
|
|
|
|
Later status: `bash ~/.claude/lib/memory.sh status BDR-NNN "superseded by BDR-NNN"`.
|
|
-->
|