Tab · Knowledge
Decisions
The receipts behind the code. An ADR log. Every architectural call with the reasoning, the alternatives considered, and what we'll see if it turns out to be wrong. Reverse-chronological. Updated in the same PR that locks in the decision.
See it in motion
Where to find it
- Localhost:
/decisions.html?repo=<id> - Source:
.claude/brain/decisions.md - Backlinks: Open Brain links to see who references a decision.
What it does for you
You'll know why every architectural call was made.Each entry has the decision (one sentence), context, what won, what lost, and a falsifier ("what we'll see if this is wrong"). Six months later, the call still makes sense.
No more rebuilding the same logic differently.When an agent walks in cold, decisions.md tells it which paths are already settled. Less prompt amnesia, more compounding.
The audit trail for AI-assisted choices.Every entry has a human author. Even if the AI drafted it, the decision is owned.
Configure
Nothing — decisions are a flat .md file. New entries land via PR.
Use it well
Add a decision the moment you commit to a path. Skip the comparison shopping (decisions.md isn't a meeting minutes log) — write the decision, the alternatives that lost, and the falsifier. Done in 5 minutes.