0fea499957
Every document filename now mirrors its lifecycle state with a status suffix (e.g., .draft.md, .wip.md, .accepted.md). No more bare .md for tracked document types. Also renamed all from_str methods to parse to avoid FromStr trait confusion, introduced StagingDeploymentParams struct, and fixed all 19 clippy warnings across the codebase. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1.1 KiB
1.1 KiB
ADR 0005: Single Source
| Status | Accepted |
| Date | 2026-01-20 |
Context
Where does truth live?
Decision
One truth, one location. No shadow copies.
When the same fact exists in two places, they will eventually disagree. It's not a matter of if—it's when. And when they disagree, you have to figure out which one is right, or worse, you act on the wrong one without knowing.
This is structural damage. It's a crack in integrity that spreads.
So: one truth, one place. Everything else is a reference, a pointer, a link. Not a copy.
What This Means
- Documents live in one place. Other places link to them.
- Configuration has one source. Everything else reads from it.
- State has one owner. Others observe, they don't duplicate.
The cost of looking something up is lower than the cost of disagreement. Always.
Consequences
- 💙 stores documents in one canonical location
- 💙 uses symlinks and references, not copies
- 💙 syncs from source, never to source
"If it exists in two places, it'll lie to you eventually."
— Blue
🧁