b29460a3
docs: re-measure the sizes CLAUDE.md quotes
a73x 2026-09-01 17:29
Commit message
CLAUDE.md
| Old | New | ||
|---|---|---|---|
| @@ -23,20 +23,20 @@ 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/server.zig` (3.6k lines, ~35k tok; its tests are | 26 | - **Never `cat` these:** `src/server/server.zig` (3.2k lines, ~31k tok; its tests are |
| 27 | siblings in `src/server/`, none over 1.9k; the agent relay and the | 27 | siblings in `src/server/`, none over 1.6k; the agent relay and the |
| 28 | session table are `src/server/server_agent.zig` and `src/server/server_sessions.zig`), | 28 | session table are `src/server/server_agent.zig` and `src/server/server_sessions.zig`), |
| 29 | `src/tui/interact.zig` (4.8k), | 29 | `src/tui/interact.zig` (4.5k), |
| 30 | `docs/decisions.md` (7.4k). `test/e2e.sh` is a 189-line runner now; the | 30 | `docs/decisions.md` (7.8k). `test/e2e.sh` is a 182-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/client.zig` is 2.7k now — cheap enough to read, and so is | 33 | `src/client/client.zig` is 3.0k now — cheap enough to read, and so is |
| 34 | every piece of the wall: `wallview.zig` is 2.2k (tiles, focus, births, | 34 | every piece of the wall: `wallview.zig` is 2.3k (tiles, focus, births, |
| 35 | endings, the keyboard loop) with `wall_pump.zig` (1.1k, one tile's | 35 | endings, the keyboard loop) with `wall_pump.zig` (0.9k, one tile's |
| 36 | thread), `wall_host.zig` (0.6k), `wall_picker.zig` (0.5k), | 36 | thread), `wall_host.zig` (0.5k), `wall_picker.zig` (0.6k), |
| 37 | `wall_layout.zig` (0.4k) and its tests in `src/tui/wall_test_*.zig` | 37 | `wall_layout.zig` (0.4k) and its tests in `src/tui/wall_test_*.zig` |
| 38 | (none over 1.2k). | 38 | (none over 1.3k). |
| 39 | Every figure here is `wc -l` on 2026-08-29; re-measure before trusting one. | 39 | Every figure here is `wc -l` on 2026-09-01; re-measure before trusting one. |
| 40 | - Every module has a `//!` header stating its contract. `head -12` on it | 40 | - Every module has a `//!` header stating its contract. `head -12` on it |
| 41 | answers most "what is this" questions for ~200 tokens. | 41 | answers most "what is this" questions for ~200 tokens. |
| 42 | - Pipe Bash output: `| tail -30`, `2>/dev/null`, `grep -c`. `make test` full | 42 | - Pipe Bash output: `| tail -30`, `2>/dev/null`, `grep -c`. `make test` full |
| @@ -358,8 +358,8 @@ own. Test fixtures in `test/`: | |||
| 358 | 358 | ||
| 359 | ## Where the answers live | 359 | ## Where the answers live |
| 360 | 360 | ||
| 361 | `docs/roadmap.md` (~650 ln) the ranked queue, but stale past 2026-08-16 — | 361 | `docs/roadmap.md` (~660 ln) the ranked queue, but stale past 2026-08-16 — |
| 362 | `git-collab issue list` is the live order · `docs/decisions.md` (7.4k ln, grep | 362 | `git-collab issue list` is the live order · `docs/decisions.md` (7.8k ln, grep |
| 363 | only) every decision + measurement · `README.md` user-facing usage. Design | 363 | only) every decision + measurement · `README.md` user-facing usage. Design |
| 364 | history (specs, plans, the original handoff) lives in git: `git log -- docs/superpowers`. | 364 | history (specs, plans, the original handoff) lives in git: `git log -- docs/superpowers`. |
| 365 | 365 | ||