Refactor CLAUDE.md
Refactor the project's CLAUDE.md (or AGENTS.md) file to follow progressive disclosure principles.
Instructions
Follow these steps:
- •
Find contradictions: Identify any instructions that conflict with each other. For each contradiction, ask me which version I want to keep.
- •
Identify the essentials: Extract only what belongs in the root CLAUDE.md:
- •One-sentence project description
- •Package manager (if not npm)
- •Non-standard build/typecheck commands
- •Anything truly relevant to every single task
- •
Group the rest: Organize remaining instructions into logical categories (e.g., TypeScript conventions, testing patterns, API design, Git workflow). For each group, create a separate markdown file.
- •
Create the file structure: Output:
- •A minimal root CLAUDE.md with markdown links to the separate files
- •Each separate file with its relevant instructions
- •A suggested docs/ folder structure
- •
Flag for deletion: Identify any instructions that are:
- •Redundant (the agent already knows this)
- •Too vague to be actionable
- •Overly obvious (like "write clean code")