0f1426ad
docs: CLAUDE.md's line counts are re-measured and dated so they can rot loudly
a73x 2026-08-28 19:53
Commit message
CLAUDE.md
| Old | New | ||
|---|---|---|---|
| @@ -23,14 +23,15 @@ First build after a clean checkout fetches ~30MB of QUIC deps (minutes, once). | |||
| 23 | Files are large and comment-dense (~44% of Zig bytes are `//`). Reading the repo | 23 | Files are large and comment-dense (~44% of Zig bytes are `//`). Reading the repo |
| 24 | costs ~800k tokens; every token stays in context and is re-billed each turn. | 24 | costs ~800k tokens; every token stays in context and is re-billed each turn. |
| 25 | 25 | ||
| 26 | - **Never `cat` these:** `src/server.zig` (3.5k lines, ~35k tok; its tests are | 26 | - **Never `cat` these:** `src/server.zig` (3.6k lines, ~35k tok; its tests are |
| 27 | siblings, `src/server_test_*.zig`, none over 1.6k; the agent relay and the | 27 | siblings, `src/server_test_*.zig`, none over 1.9k; the agent relay and the |
| 28 | session table are `src/server_agent.zig` and `src/server_sessions.zig`), | 28 | session table are `src/server_agent.zig` and `src/server_sessions.zig`), |
| 29 | `src/wallview.zig` (6.6k), `src/interact.zig` (4.5k), | 29 | `src/wallview.zig` (8.6k), `src/interact.zig` (4.8k), |
| 30 | `docs/decisions.md` (7.3k). `test/e2e.sh` is a 189-line runner now; the | 30 | `docs/decisions.md` (7.4k). `test/e2e.sh` is a 189-line runner now; the |
| 31 | bodies are `test/e2e_NN_*.sh` (`E2E_ONLY=<group>` runs one). | 31 | bodies are `test/e2e_NN_*.sh` (`E2E_ONLY=<group>` runs one). |
| 32 | Use `grep -n` for the symbol, then `sed -n 'A,Bp'` for a window. | 32 | Use `grep -n` for the symbol, then `sed -n 'A,Bp'` for a window. |
| 33 | `src/client.zig` is 1.9k now — cheap enough to read. | 33 | `src/client.zig` is 2.4k now — cheap enough to read. |
| 34 | Every figure here is `wc -l` on 2026-08-28; re-measure before trusting one. | ||
| 34 | - Every module has a `//!` header stating its contract. `head -12 src/X.zig` | 35 | - Every module has a `//!` header stating its contract. `head -12 src/X.zig` |
| 35 | answers most "what is this" questions for ~200 tokens. | 36 | answers most "what is this" questions for ~200 tokens. |
| 36 | - Pipe Bash output: `| tail -30`, `2>/dev/null`, `grep -c`. `make test` full | 37 | - Pipe Bash output: `| tail -30`, `2>/dev/null`, `grep -c`. `make test` full |
| @@ -223,7 +224,7 @@ real pty), `wsclient` (browser stand-in), `rawmode`, `delaypipe`, `render`. | |||
| 223 | ## Where the answers live | 224 | ## Where the answers live |
| 224 | 225 | ||
| 225 | `docs/roadmap.md` (~650 ln) the ranked queue, but stale past 2026-08-16 — | 226 | `docs/roadmap.md` (~650 ln) the ranked queue, but stale past 2026-08-16 — |
| 226 | `git-collab issue list` is the live order · `docs/decisions.md` (7.3k ln, grep | 227 | `git-collab issue list` is the live order · `docs/decisions.md` (7.4k ln, grep |
| 227 | only) every decision + measurement · `docs/handoff.md` (~200 ln) the original | 228 | only) every decision + measurement · `docs/handoff.md` (~200 ln) the original |
| 228 | design, historical · `README.md` user-facing usage. | 229 | design, historical · `README.md` user-facing usage. |
| 229 | 230 | ||