reclaude
Refactor CLAUDE.md files to follow progressive disclosure principles. Use when CLAUDE.md is too long or disorganized.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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:
-
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")
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-02-03
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!