docs(governance): split CLAUDE.md into common + agent-scoped rules#30
Conversation
Refactored CLAUDE.md to contain only universal rules (project overview, architecture, security, rule integrity, authority, team structure, workflow). Agent-specific content (Rust coding standards, testing anti-weakening, VCS rules, Git commit gates, preferred crates) moved into each owning agent file. Caveman compression applied to all 14 files to reduce token load while preserving every MUST/NEVER rule — audited twice by @it-consultant with zero rule loss. Closes #27
|
Important Review skippedReview was skipped due to path filters ⛔ Files ignored due to path filters (14)
CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: ASSERTIVE Plan: Pro Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
1 participant
Description
Refactor CLAUDE.md so it only holds rules that apply to every team member
(CTO + all agents) equally. Move agent-specific rules into each owning agent's
definition file under
.claude/agents/. Apply caveman compression to all 14files to reduce token load while preserving every MUST/NEVER rule.
Type of change
Changes
CLAUDE.md(now common-only)Retained sections: Project Overview, Architecture, Configuration Files,
Security, Rule Integrity (Anti-Bypass), Authority and Rule Immutability,
Team Structure (roster + scope matrix + delegation rules + rules for all
agents), Commands, Development Workflow, Before Committing checklist.
Removed (moved into agent files): Core Principles, Preferred Tools, Code
Style, Documentation, Type System, Error Handling, Function Design,
Struct/Enum Design, Testing, Imports/Dependencies, Rust Best Practices,
Memory/Performance, Concurrency, Version Control, Tools, Test Integrity
(Anti-Weakening), Coupling Rule, Git Commit Gates.
Agent files (canonical owners of moved content)
rust-developer.md: Core Principle (fully optimized), Type System,Function Design, Struct/Enum Design, Rust Best Practices, Memory/Performance,
Concurrency, Imports, Preferred Crates, Tools, Code Style
qa.md: Test Integrity (Anti-Weakening) canonical owner,#[test]/mock MUSTs, Code Style for test codesysadmin.md: Version Control rules canonical owner, Git Commit Gates 1-4lead-dev.md: Coupling Rule (Cargo vs CI)devops.md: Coupling Rule (CI side, symmetric)reviewer.md: Prime Directive routes findings to agent-file sources;example findings updated to cite agent files instead of removed CLAUDE.md
sections
Caveman compression
Applied to all 14 governance files. Technical substance preserved: code
blocks, URLs, file paths, MUST/NEVER rules intact. Two @it-consultant audit
passes confirmed zero rule loss.
Testing
Breaking changes
None for the codebase. Agents referencing removed CLAUDE.md sections have
been updated in the same commit.
Related
Closes #27