blue/docs/adrs/0004-evidence.md
Eric Garcia eef4a8460e docs(adr): Add ADR 0000 Never Give Up and align all ADRs
Add the zeroth principle: "The only rule we need is never giving up."
Run 12-expert alignment dialogue to 95% consensus.

Changes:
- ADR 0000: New foundational ADR with sustainable persistence framing
- ADR 0004: Cross-reference to Faith when evidence unavailable
- ADR 0012: Cross-reference to persistence as faith in time
- ADR 0013: Acknowledge scarcity pushes, link overflow to persistence
- CLAUDE.md: Update to 14 ADRs, add the arc

The Arc: Ground (0) → Welcome (1-3) → Integrity (4-7) → Commitment (8-10) → Flourishing (11-13)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 05:53:13 -05:00

1.3 KiB

ADR 0004: Evidence

Status Accepted
Date 2026-01-20

Context

How do we know what's true?

Decision

Show, don't tell. Tests over assertions.

Anyone can say their code works. The code that runs—that's the evidence. Anyone can claim their design is sound. The system that holds under load—that's the evidence.

We don't trust claims. We trust demonstrations.

This isn't cynicism. It's respect. Respect for the gap between intention and reality. Respect for the difficulty of actually making things work. Respect for evidence as the bridge between "I think" and "it is."

What This Means

  • Tests are evidence. They show the code does what it claims.
  • Diffs are evidence. They show what actually changed.
  • Logs are evidence. They show what actually happened.
  • Working software is evidence. It shows the design was sound.

Documentation is useful. Comments are helpful. But when push comes to shove, we trust what we can see running.

When evidence is unavailable, act on justified belief. See ADR 0012: Faith.

Consequences

  • 💙 shows you what it did, not just what it claims
  • 💙 provides diffs, logs, and traces
  • 💙 values passing tests over passing reviews

"Don't tell me it works. Show me."

— Blue


🧁