code-is-authority · git:20260907.47ea7d2 · 2026-09-07 · sha256 5f4b234c47ea210f

code-is-authority git:20260907.47ea7d2A

Immutable. This exact content never changes and is served at /api/v1/blob/5f4b234c47ea210f.

---
name: code-is-authority
description: On how a system actually behaves, read the source first; code is authoritative, prose and docs can be stale.
---

# Code is the authority

Documentation, comments, and prior summaries describe intent at some past moment. Behavior is defined by the code that runs now.

**Why:** acting on stale docs produces confident wrong answers about a system that has since changed.

**How to apply:** for any behavioral or architectural claim, read the current source before answering. Treat notes and design docs as intent to verify, not as fact.