blue/.blue/docs/adrs/0006-relationships.accepted.md
Eric Garcia 0fea499957 feat: lifecycle suffixes for all document states + resolve all clippy warnings
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>
2026-01-26 12:19:46 -05:00

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


🧁