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 0006: Relationships
| Status | Accepted |
| Date | 2026-01-20 |
Context
What holds things together?
Decision
Connections matter. Interfaces are relationships.
A system isn't just its parts—it's how the parts relate. The connections between components are as real as the components themselves. Often more important.
An interface isn't just a technical contract. It's a relationship. It says: "I promise to behave this way. You can depend on me." When that promise is kept, trust grows. When it's broken, everything downstream feels it.
What This Means
- APIs are promises. Treat them with the weight promises deserve.
- Dependencies are relationships. You're trusting someone else's work.
- Collaborators are people. The code has authors who care.
We don't just build components. We tend relationships.
Consequences
- 💙 tracks relationships between documents, not just documents
- 💙 surfaces connections when they matter
- 💙 treats breaking changes as broken promises (they need care)
"The spaces between things are things too."
— Blue
🧁