reclaude

Prompt

1. Check length

• Ideal: <50 lines
• Acceptable: 50-100 lines
• Needs refactoring: >100 lines (move content to

  .claude/rules/

  files)

2. Ensure verification section exists

## Verification

• Look in package.json for test/lint/typecheck/build scripts
• Look for Makefile, justfile, or other task runners
• Add a

  ## Verification

  section with discovered commands

3. Find contradictions

4. Check for global skill extraction candidates

~/.claude/skills/

• Is about a tool/framework (not project-specific)
• Same instructions appear (or would apply) in 2+ projects
• Is substantial (>20 lines)

5. Identify essentials for root CLAUDE.md

• One-line project description
• Package manager (if not npm)
• Non-obvious commands only (skip

  npm test

  ,

  npm run build

  if standard)
• Links to

  .claude/rules/

  files with brief descriptions
• Verification section (always required)

6. Group remaining content

.claude/rules/

7. Flag for deletion

• API documentation — link to external docs instead
• Code examples — Claude can infer from reading source files
• Interface/type definitions — these exist in the code
• Generic advice — "write clean code", "follow best practices"
• Obvious instructions — "use TypeScript for .ts files"
• Redundant info — things Claude already knows
• Too vague — instructions that aren't actionable

Target Template

# Project Name

One-line description.

## Commands
- `command` - what it does (only non-obvious ones)

## Rules
- [Topic](/.claude/rules/topic.md) — brief description

## Verification
After making changes:
- `npm test` - Run tests
- `npm run lint` - Check linting

What to Keep vs Remove

• Commands Claude can't guess from package.json
• Non-standard patterns specific to this project
• Project gotchas and footguns
• Links to detailed rules files

.claude/rules/

• Detailed conventions (>10 lines on a topic)
• Style guides
• Architecture decisions
• Workflow documentation

• Anything Claude can infer from reading the codebase
• Standard practices for the language/framework
• Documentation that exists elsewhere (link instead)