Skip to content

docs: compress CLAUDE.md into a tight project brain - #78

Merged
developerz-ai[bot] merged 1 commit into
mainfrom
dz/refine-claude-md-into-a-tight-project-brain--21c97062
Nov 14, 2026
Merged

developerz-ai[bot] merged 1 commit into
mainfrom
dz/refine-claude-md-into-a-tight-project-brain--21c97062

Conversation

@developerz-ai

@developerz-ai developerz-ai Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

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

  • CLAUDE.md still documents stack, commands (all 6 bin/ scripts), structure (module map, one row per non-test src file) and conventions + NEVER
  • tests/module_map.rs passes: ## Module map heading intact, all 54 first-cell src rows kept, every backticked src/ path in the section exists on disk
  • tests/public_tree.rs passes: no forbidden infrastructure string (ubicloud) anywhere in CLAUDE.md
  • Net compression: ## Where to look section deleted (duplicated by the module map), Coding Rules merged into Conventions, execution-model prose bulletized; file shorter than the current 236 lines
  • No file besides CLAUDE.md changed in the diff

Changes

  • 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/check passed (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 ok
  • wc -l CLAUDE.md && grep -c '^| 'src/' CLAUDE.md (docs): 190 lines (was 236), 54 module-map rows
  • rustup 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 string
  • cargo 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 box

Part 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.

🤖 developerz.ai, an automated agent, not a human — this PR is one slice of a stacked plan.
Dispatched automatically by a developerz.ai maintainer lane
Raised automatically by the developerz.ai setup maintainer lane, from manual.
Plan: https://app.developerz.ai/fleet/plans/run_d02686b693c14f48a68ed0e932a99159
Part 2/5
BYOK spend: $0.00 (flat-rate subscription: no per-token charge).

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
@developerz-ai developerz-ai Bot added the dz/fleet-pr Opened by developerz.ai, an automated agent, from a fleet run. label Nov 14, 2026
@developerz-ai

developerz-ai Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor Author

✅ Reviewed — nothing blocking

0 actionable comment(s) · grounded on your code

⚠️ 1 config note(s): 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 — automated review, running on your model and your box.

@developerz-ai developerz-ai Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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?

@developerz-ai
developerz-ai Bot merged commit 6de4d93 into main Nov 14, 2026
13 checks passed
@developerz-ai
developerz-ai Bot deleted the dz/refine-claude-md-into-a-tight-project-brain--21c97062 branch November 14, 2026 14:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dz/fleet-pr Opened by developerz.ai, an automated agent, from a fleet run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants