brianlovin/agent-config

reclaude

Refactor CLAUDE.md files to follow progressive disclosure principles.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/brianlovin/agent-config --skill reclaude

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

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

Report the current line count. Flag issues:

  • Ideal: <50 lines
  • Acceptable: 50-100 lines
  • Needs refactoring: >100 lines (move content to .claude/rules/ files)

2. Integrate workflow orchestration

Read the workflow skill at ~/.claude/skills/workflow/SKILL.md and incorporate its principles into the CLAUDE.md or a .claude/rules/workflow.md file. Adapt the content to fit the project — don't copy verbatim, but ensure the key behaviors are represented:

  • Plan mode for non-trivial tasks
  • Subagent strategy
  • Self-improvement loop with tasks/lessons.md
  • Verification before marking tasks done
  • Elegance checks for non-trivial changes
  • Autonomous bug fixing

For short CLAUDE.md files, add a concise workflow section. For longer ones, create .claude/rules/workflow.md and link to it.

3. Ensure verification section exists

Check for a ## Verification section with commands Claude can run after making changes. If missing:

  • 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

This is critical—Claude performs dramatically better when it can verify its work.

4. Find contradictions

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

5. Check for global skill extraction candidates

Look for content that could become a reusable global skill in ~/.claude/skills/:

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

If found, suggest creating a global skill with name and description.

6. Identify essentials for root CLAUDE.md

Extract only what belongs in the 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)

7. Group remaining content

Organize remaining instructions into .claude/rules/ files by category (e.g., TypeScript conventions, testing patterns, API design, Git workflow).

8. Flag for deletion

Identify content that should be removed entirely:

  • 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

markdown
# 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

Keep in CLAUDE.md:

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

Move to `.claude/rules/`:

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

Remove entirely:

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

タスクに関連する項目

同じリポジトリから

関連する Skills

すべての Skills