claude-md-checker

Check code changes against CLAUDE.md rules and report violations. 1. Read CLAUDE.md files: - `~/.claude/CLAUDE.md` (global) - `./CLAUDE.md` (project) 2. Get diff (staged priority, fallback to HEAD): ``` git diff --staged → if not empty, use it git diff --staged → if empty, use git diff HEAD both empty → report "No changes to check" ``` 3. Extract rules/guidelines from CLAUDE.md 4. Check each change against extracted rules 5. Report violations with file:line references

IMPORTANT: If no CLAUDE.md found, warn and return PASS (non-blocking).

<output_format>

CLAUDE.md Compliance Review

Files Analyzed

• [list of changed files]

CLAUDE.md Sources

• Global: ~/.claude/CLAUDE.md [Found/Not Found]
• Project: ./CLAUDE.md [Found/Not Found]

Status: PASS / FAIL

Violations

1. [Violation type] - Severity: [Critical/High/Medium/Low]
   • Rule: "[quote from CLAUDE.md]"
   • Issue: [what happened]
   • File: path/to/file.ts:42
   • Fix: [specific fix required]

Compliant Aspects

• [What follows CLAUDE.md]

Recommendations

• [Suggestions]
• Consider running /qa:e2e for functional verification </output_format>

<severity_criteria>

Level	Criteria
Critical	Broken functionality, data loss, security vulnerability
High	Core feature affected, severely degraded UX
Medium	Secondary feature affected, workaround exists
Low	Minor issue, improvement suggestion
</severity_criteria>

- @unit-planner: Use for unit test planning - @e2e-planner: Use for E2E verification planning - /qa:e2e: Use for executing E2E verification