name: reclaude
description: Refactor CLAUDE.md files to follow progressive disclosure principles. Use when CLAUDE.md is too long or disorganized.

reclaude

Refactor CLAUDE.md files to follow progressive disclosure principles.

Prompt

I want you to refactor my CLAUDE.md file to follow progressive disclosure principles.

Follow these steps:

1. Find contradictions: Identify any instructions that conflict with each other. For each contradiction, ask me which version I want to keep.

2. Identify the essentials: Extract only what belongs in the root CLAUDE.md:

3. One-sentence project description
4. Package manager (if not npm)
5. Non-standard build/typecheck commands

6. Anything truly relevant to every single task

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

8. Create the file structure: Output:

9. A minimal root CLAUDE.md with markdown links to the separate files
10. Each separate file with its relevant instructions

11. A suggested docs/ folder structure

12. Flag for deletion: Identify any instructions that are:

13. Redundant (the agent already knows this)
14. Too vague to be actionable
15. Overly obvious (like "write clean code")