/ ディレクトリ / プレイグラウンド / claude-reflect
● コミュニティ BayramAnnakov ⚡ 即起動

claude-reflect

作者 BayramAnnakov · BayramAnnakov/claude-reflect

修正・称賛・好みの再表明から静かに学ぶ Claude Code。学んだことを CLAUDE.md / AGENTS.md に書き込む。

claude-reflect は Claude Code セッションのバックグラウンドで動作し、あなたが修正・称賛・好みを再表明する瞬間を観察する。それらを永続ルールとして蒸留し、CLAUDE.md と AGENTS.md を更新して、将来のセッションがそれを継承する。手動で指示ファイルを管理する必要のない、軽量な代替手段。

なぜ使うのか

主な機能

ライブデモ

実際の動作

準備完了

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-reflect-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-reflect-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/BayramAnnakov/claude-reflect",
          "~/.claude/skills/claude-reflect"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add claude-reflect-skill -- git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: claude-reflect

手動のキュレーションなしに CLAUDE.md を進化させる

👤 ドキュメントファイルの管理が苦手なソロ開発者 ⏱ ~5 min beginner

使うタイミング: CLAUDE.md を自分の好みに合わせ続けたいが、それを書く手間をかけたくないとき。

前提条件
  • スキルのインストール — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
  • リフレクションの有効化 — プロジェクトの CLAUDE.md の前文に use claude-reflect を追加する
フロー
  1. 普通にコーディングする
    Just code with Claude as usual. Correct it when wrong, praise it when right.✓ コピーしました
    → スキルがサイレントにキャプチャしている。気づかない
  2. 1 日の終わりにレビューする
    Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ コピーしました
    → プロンプトの出所付きで 5〜10 件の候補ルールが表示される
  3. 差分をコミットする
    Apply approved rules and commit CLAUDE.md.✓ コピーしました
    → きれいな git 差分。ルールが有効になる

結果: 手動メンテナンスのコストなしに、自分と共に成長する CLAUDE.md が完成する。

注意点
  • スキルが一度限りのコンテキストを永続ルールとしてキャプチャしてしまう — 毎日の候補を必ずレビューする。状況固有のものは全て却下する
組み合わせ: filesystem

集合的な修正からチーム全体の AI 規約を構築する

👤 AI ワークフローを標準化するテックリード ⏱ ~60 min intermediate

使うタイミング: 複数の開発者が似たようなことで Claude を修正している。共有のルールセットが欲しいとき。

フロー
  1. 開発者ごとの下書きを収集する
    Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ コピーしました
    → N 件の候補が保留中のブランチが作成される
  2. セッションをマージする
    Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ コピーしました
    → 共通基盤のルールセットが作成される
  3. ロールアウトする
    Merge to main. New AGENTS.md applies to everyone.✓ コピーしました
    → チームが同じベースラインを使う。個人のローカルルールはそのまま

結果: プロセス委員会なしのボトムアップな標準化が実現する。

注意点
  • 声の大きい開発者が主導し、控えめな人のパターンが見落とされる — 全員がスキルを実行することを確認する。ファイル編集数ではなくリフレクションイベント数で重み付けする
組み合わせ: github

CLAUDE.md の古いルールを監査して削除する

👤 長期間 CLAUDE.md を使っているユーザー ⏱ ~25 min intermediate

使うタイミング: CLAUDE.md が 600 行になり、Claude のコンテキストが肥大化しているとき。

フロー
  1. 関連度をスコアリングする
    Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ コピーしました
    → ルールごとのスコアが表示される
  2. 削除を提案する
    Suggest 30 rules to remove (stale or obsolete).✓ コピーしました
    → 根拠付きの削除リストが表示される
  3. 差分を作成してコミットする
    Apply approved removals; commit with message 'reflect: prune stale rules'.✓ コピーしました
    → スリムになった CLAUDE.md が完成する

結果: 流し読みではなく、実際に読まれる CLAUDE.md になる。

注意点
  • 適用されなかったのは Claude がルールを尊重していたからかもしれない — 迷ったら残す。ただし「最後に確認済み」とマークして翌四半期に再確認する

組み合わせ

他のMCPと組み合わせて10倍の力を

claude-reflect-skill + pro-workflow-skill

pro-workflow で明示的なキャプチャ、claude-reflect でパッシブなキャプチャ。2 チャンネルの学習

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ コピーしました
claude-reflect-skill + github

PR 経由でルール変更をレビュー可能にする

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
watch_session 常時起動のバックグラウンドプロセス 0
review_candidates since? 日次・週次の承認ループ 0
consolidate scope? 定期的な重複排除・矛盾解消 0
score_rules 削除前の監査 0
apply_to_files approved_ids[], files[] 承認済み候補を CLAUDE.md / AGENTS.md に反映する 0

コストと制限

運用コスト

APIクォータ
なし — ローカル
呼び出しあたりのトークン
バックグラウンドキャプチャは無料。レビュー・統合はローカル LLM を設定した場合に発生
金額
無料
ヒント
候補を保守的に承認する。量より質

セキュリティ

権限、シークレット、影響範囲

最小スコープ: filesystem-write
認証情報の保管: スキルの状態は .claude/reflect/ に保存。共有したい場合はリポジトリにコミットする
データ送信先: デフォルトはなし

トラブルシューティング

よくあるエラーと対処法

候補がキャプチャされない

スキルが CLAUDE.md の前文で呼び出されているか確認する。.claude/reflect/log にエントリがあるか確認する

候補がノイズだらけ

トリガーの感度を上げる。明示的な修正のみからキャプチャし、一般的なチャットには反応しないようにする

AGENTS.md が CLAUDE.md から乖離する

定期的に consolidate を実行する。ツールは同期を保つ設計だが手動編集で乖離が生じる

承認プロンプトが多すぎて対応できない

--limit 5 で毎日レビューを実行する。50 件をまとめてではなく習慣として積み重ねる

代替案

claude-reflect 他との比較

代替案代わりに使う場面トレードオフ
pro-workflow-skill明示的なキャプチャと作業ツリーオーケストレーションを好む場合より手動。並列作業には強力
Manual CLAUDE.md curation自分でルールを書く規律がある場合しばしば放置される。意志の力に依存する

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る