Files
claude/templates/memory/decisions.md
T

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"`.
-->