Repository navigation
docs: compress CLAUDE.md into a tight project brain - #78
developerz-ai[bot] merged 1 commit into
Conversation
Lead with the non-negotiables, tables over prose: move NEVER up top, merge Coding Rules into Conventions, bulletize the execution model, drop the Where-to-look section (the module map already navigates), and add the missing bin/setup + bin/stop command rows plus the .githooks pre-commit note. Module-map rows keep their exact format (tests/module_map.rs parses them); no new infrastructure strings (tests/public_tree.rs scans every tracked file). Dz-Task-Id: tsk_21c970624abb1609b9d9e7b22d54976c
✅ Reviewed — nothing blocking0 actionable comment(s) · grounded on your code 🤖 developerz.ai — automated review, running on your model and your box. |
There was a problem hiding this comment.
Review summary — 1 file(s), 0 finding(s).
Rewrites CLAUDE.md shorter: NEVER moves to the top, Coding Rules merge into Conventions, the execution model becomes bullets, Where-to-look is dropped, and bin/setup, bin/stop and pre-commit hook notes are added. Low risk: the module map, NEVER rules, tool contract and kill semantics all survive.
- test files were not shown to the reviewer — this diff touched no path recognised as a test, so no assertion was available to read the change against
🤖 developerz.ai review — automated, running on your model and your box. What is this?
What
Lead with the non-negotiables, tables over prose: move NEVER up top,
merge Coding Rules into Conventions, bulletize the execution model,
drop the Where-to-look section (the module map already navigates), and
add the missing bin/setup + bin/stop command rows plus the .githooks
pre-commit note. Module-map rows keep their exact format
(tests/module_map.rs parses them); no new infrastructure strings
(tests/public_tree.rs scans every tracked file).
Acceptance
## Module mapheading intact, all 54 first-cell src rows kept, every backticked src/ path in the section exists on disk## Where to looksection deleted (duplicated by the module map), Coding Rules merged into Conventions, execution-model prose bulletized; file shorter than the current 236 linesChanges
CLAUDE.md(edit) — Compress CLAUDE.md (236 lines) into a tight project brain: lead with the non-negotiables (NEVER list + core rules), tables over prose. Merge 'Coding Rules' into 'Conventions'; convert 'Execution model' prose to bullets; DELETE the '## Where to look' section (lines 190-210, duplicates the module map); add bin/setup + bin/stop rows to Commands and one line for the .githooks/pre-commit hook. Keep the '## Module map' heading and all 54 row first-cells byte-identical; only tighten 'Owns' cell prose. All four areas must stay covered: stack, commands, structure, conventions.Verification
./bin/checkpassed (exit 0) in 2m 19s.What the editors ran to see the change working, and what they saw:
~/.rustup/toolchains/1.100.0-x86_64-unknown-linux-gnu/bin via env PATH=… cargo test --test module_map --test public_tree(docs): module_map: 4 passed (every_path_in_the_module_map_exists, every_source_file_has_a_module_map_row, no_source_file_exceeds_the_loc_limit, non_test_loc helper); public_tree: 2 passed (no_tracked_file_carries_an_infrastructure_fact, case-insensitivity) — 6/6 okwc -l CLAUDE.md && grep -c '^| 'src/' CLAUDE.md(docs): 190 lines (was 236), 54 module-map rowsrustup run 1.100.0 cargo test --locked --test module_map --test public_tree(docs): EXIT=0; module_map: "test result: ok. 4 passed; 0 failed"; public_tree: "test result: ok. 2 passed; 0 failed" — module-map heading intact, all 54 src rows valid, no forbidden infra stringcargo test --locked --test module_map --test public_tree (plain cargo)(docs): EXIT=101: "error: rustc 1.99.1 is not supported by the following packages: mcp-ssh@2.2.0 requires rustc 1.100" — mise's cargo shim resolves to 1.99.1; the repo's pinned 1.100.0 is installed under rustup and the check passes under it. The harness's serialized gate must select the pinned toolchain on this boxPart 2/5 of a goal
🤖 Opened by developerz.ai, an automated agent, not a human, on developerz-ai/mcp-ssh.
Raised automatically by a developerz.ai maintainer lane.