← Files i-have-headacheARCHIVED FILE
.ai/rules/no-second-source-of-truth.md
772 Bytes · Oct 5, 2026 · 18:34 UTC
# Rule — no second source of truth `AGENTS.md` is canonical. Every other agent config file (`CLAUDE.md`, `CODEX.md`, `KIMI.md`, `GEMINI.md`, `QWEN.md`, `GROK.md`, `LLM.md`, `.clinerules`, `.windsurfrules`, `.rules`, `.cursor/rules/agents.mdc`, `.github/copilot-instructions.md`) is a pointer. Each pointer restates exactly three rules: be concise, one command only, and the command text lives in one file. When instructions change, edit `AGENTS.md`. Touch a pointer only if one of those three has changed — then update all of them together, or `router-sync` in the coverage check will fail. Never let a pointer grow tool-specific content. If a tool genuinely needs something the others do not, that reopens [ADR-0001](../decisions/ADR-0001-agents-md-canonical.md).
SHA-256: 022f0b509f77b9e614c2d65e19743a562686ba4f8c5ba2ea35a46b28cccea406