docs(agents): point agents to CLAUDE.md for Claude review context

Adds a cross-reference so any agent (not just Claude) knows to look at CLAUDE.md when it exists for review or deep-dive background. Signed-off-by: Aaron D. Lee <himself@adlee.work>
docs(adr): ratify ADR-0009 amendment — shared spend accounting
2026-07-05 00:48:28 -04:00 · 2026-07-05 00:39:08 -04:00
2 changed files with 12 additions and 1 deletions
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -10,6 +10,17 @@ This file orients any agent (human, AI, hybrid) working in the repo.

 ---

+## Context files for agents
+
+- **`AGENTS.md`** (this file) — shared orientation: project structure, build/test commands,
+  code style, git workflow, and multi-agent coordination rules.
+- **`CLAUDE.md`** — optional companion used when Claude is brought in for review or
+  deep-dive context. All agents, including future Claude sessions, should check
+  `CLAUDE.md` when available for extra background before resuming a task or acting
+  on review feedback.
+
+---
+
 ## Project structure (current + planned)

 ```
--- a/docs/adr/0009-spend-gate-honest-rescope.md
+++ b/docs/adr/0009-spend-gate-honest-rescope.md
@@ -84,7 +84,7 @@ security-constitutive), but its guarantees are restated precisely:

 ## Amendment 2026-07-04 — enforcement locality ≠ accounting locality

- **Status:** Proposed (pending maintainer ratification)
+- **Status:** Accepted (maintainer-ratified 2026-07-05)
 - **Origin:** [2026-07-04 scalability & infra-fit review](../reviews/2026-07-04-scalability-infra-review.md),
  finding M5.
Author	SHA1	Message	Date
Aaron D. Lee	465aeda789	docs(agents): point agents to CLAUDE.md for Claude review context All checks were successful CI / fmt (pull_request) Successful in 1m0s Details CI / clippy (pull_request) Successful in 1m33s Details CI / test (1.85) (pull_request) Successful in 4m10s Details CI / test (stable) (pull_request) Successful in 4m25s Details CI / deny (pull_request) Successful in 1m13s Details Adds a cross-reference so any agent (not just Claude) knows to look at CLAUDE.md when it exists for review or deep-dive background. Signed-off-by: Aaron D. Lee <himself@adlee.work>	2026-07-05 00:48:28 -04:00
Aaron D. Lee	cf49618abe	docs(adr): ratify ADR-0009 amendment — shared spend accounting All checks were successful CI / fmt (pull_request) Successful in 1m11s Details CI / clippy (pull_request) Successful in 1m21s Details CI / test (1.85) (pull_request) Successful in 3m41s Details CI / test (stable) (pull_request) Successful in 4m27s Details CI / deny (pull_request) Successful in 1m10s Details Maintainer accepted 2026-07-05. Step 6 builds the gate against a check-and-reserve ledger trait: in-memory at N=1, Valkey at N>1. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012QndwfhjyTiZcUYp87dwW8 Signed-off-by: Aaron D. Lee <himself@adlee.work>	2026-07-05 00:39:08 -04:00