d23f65ac
docs: CLAUDE.md figures re-measured 2026-09-02
a73x 2026-09-02 09:17
Commit message
CLAUDE.md
| Old | New | ||
|---|---|---|---|
| @@ -21,23 +21,23 @@ First build after a clean checkout fetches ~30MB of QUIC deps (minutes, once). | |||
| 21 | 21 | ||
| 22 | ## Reading this repo without burning context | 22 | ## Reading this repo without burning context |
| 23 | 23 | ||
| 24 | Files are large and comment-dense (~44% of Zig bytes are `//`). Reading the repo | 24 | Files are large and comment-dense (~36% of Zig bytes are whole `//` lines). Reading the repo |
| 25 | costs ~800k tokens; every token stays in context and is re-billed each turn. | 25 | costs ~800k tokens; every token stays in context and is re-billed each turn. |
| 26 | 26 | ||
| 27 | - **Never `cat` these:** `src/server/server.zig` (3.2k lines, ~31k tok; its tests are | 27 | - **Never `cat` these:** `src/server/server.zig` (3.2k lines, ~31k tok; its tests are |
| 28 | siblings in `src/server/`, none over 1.6k; the agent relay and the | 28 | siblings in `src/server/`, none over 1.7k; the agent relay and the |
| 29 | session table are `src/server/server_agent.zig` and `src/server/server_sessions.zig`), | 29 | session table are `src/server/server_agent.zig` and `src/server/server_sessions.zig`), |
| 30 | `src/tui/interact.zig` (4.5k), | 30 | `src/tui/interact.zig` (4.5k), |
| 31 | `docs/decisions.md` (7.8k). `test/e2e.sh` is a 182-line runner now; the | 31 | `docs/decisions.md` (7.8k). `test/e2e.sh` is a 182-line runner now; the |
| 32 | bodies are `test/e2e_NN_*.sh` (`E2E_ONLY=<group>` runs one). | 32 | bodies are `test/e2e_NN_*.sh` (`E2E_ONLY=<group>` runs one). |
| 33 | Use `grep -n` for the symbol, then `sed -n 'A,Bp'` for a window. | 33 | Use `grep -n` for the symbol, then `sed -n 'A,Bp'` for a window. |
| 34 | `src/client/client.zig` is 3.0k now — cheap enough to read, and so is | 34 | `src/client/client.zig` is 3.1k now — cheap enough to read, and so is |
| 35 | every piece of the wall: `wallview.zig` is 2.3k (tiles, focus, births, | 35 | every piece of the wall: `wallview.zig` is 2.4k (tiles, focus, births, |
| 36 | endings, the keyboard loop) with `wall_pump.zig` (0.9k, one tile's | 36 | endings, the keyboard loop) with `wall_pump.zig` (0.9k, one tile's |
| 37 | thread), `wall_host.zig` (0.5k), `wall_picker.zig` (0.6k), | 37 | thread), `wall_host.zig` (0.5k), `wall_picker.zig` (0.6k), |
| 38 | `wall_layout.zig` (0.4k) and its tests in `src/tui/wall_test_*.zig` | 38 | `wall_layout.zig` (0.4k) and its tests in `src/tui/wall_test_*.zig` |
| 39 | (none over 1.3k). | 39 | (none over 1.4k). |
| 40 | Every figure here is `wc -l` on 2026-09-01; re-measure before trusting one. | 40 | Every figure here is `wc -l` on 2026-09-02; re-measure before trusting one. |
| 41 | - Every module has a `//!` header stating its contract. `head -12` on it | 41 | - Every module has a `//!` header stating its contract. `head -12` on it |
| 42 | answers most "what is this" questions for ~200 tokens. | 42 | answers most "what is this" questions for ~200 tokens. |
| 43 | - Pipe Bash output: `| tail -30`, `2>/dev/null`, `grep -c`. `make test` full | 43 | - Pipe Bash output: `| tail -30`, `2>/dev/null`, `grep -c`. `make test` full |