claude-md-cleanup

name	claude-md-cleanup
description	Clean up project CLAUDE.md — remove duplicates with global config

Analyze the project CLAUDE.md and remove everything already covered by the global config or installed modules. Keep only what's specific to this project.

Process

1. Read the project's CLAUDE.md

2. Read ~/.claude/CLAUDE.md and identify installed modules by scanning for markers:

   • <!-- critical-thinking:start --> — mindset, anti-complaisance, debugging approach covered
   • <!-- backlog:start --> — ticketing system covered
   • Also check for: handoff system, supervisor rules, general rules (no AI mention, documentation, etc.)

3. Classify each section of the project CLAUDE.md:

   • SUPPRIMER — duplicate of global (same concept, even if different wording). Examples:
     • Ticketing/backlog rules → covered by backlog-kit
     • Handoff/context saving → covered by handoff-kit
     • "No band-aid fixes" / "understand before coding" → covered by critical-thinking
     • "Never mention Claude/AI" → covered by global general rules
     • Generic dev advice ("write tests", "be clean") → useless, remove
   • GARDER — specific to this project (stack conventions, build commands, architecture, project-specific rules)
   • REFORMULER — mix of generic + specific → keep only the specific part

4. Present the plan to the user:

   SECTIONS A SUPPRIMER (doublons avec global) :
   - "[section name]" — reason (covered by [module/section])
   
   SECTIONS A GARDER :
   - "[section name]" — reason
   
   SECTIONS A REFORMULER :
   - "[section name]" — keep [specific part], remove [generic part]
   

5. Wait for explicit validation before writing.

6. Write the cleaned CLAUDE.md. Preserve the structure and intent of kept sections.

Key rule

Detect by MEANING, not string matching. "Pas de fix en pansement" and "No band-aid fixes" are the same concept — both must be flagged as duplicates.