0150a5d1ed
Per RFC 0003, Blue-tracked documents live in per-repo .blue/ directories. ADRs needed for semantic adherence checking. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
44 lines
1.1 KiB
Markdown
44 lines
1.1 KiB
Markdown
# 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
|
|
|
|
---
|
|
|
|
🧁
|