self-improving-agent

自己改善エージェント

自動メモリーが記録し、このプラグインが整理します。

Claude Code の自動メモリー（v2.1.32+）は、プロジェクトのパターン、デバッグの知見、ユーザーの設定を自動的に MEMORY.md に記録します。このプラグインはインテリジェンスレイヤーを追加し、Claude が学んだ内容を分析して、実証済みのパターンをプロジェクトルールに昇格させ、繰り返し使われる解決策を再利用可能なスキルとして抽出します。

クイックリファレンス

コマンド	説明
/si:memory-review	MEMORY.md を分析し、昇格候補、古くなった項目、統合の機会を見つけます
/si:promote	MEMORY.md のパターンを CLAUDE.md または .claude/rules/ に昇格させます
/si:extract	実証済みのパターンを独立したスキルに変換します
/si:memory-status	メモリーの健全性ダッシュボードを表示します。行数、トピックファイル、推奨事項を確認できます
/si:remember	重要な知識を明示的に自動メモリーに保存します

仕組み

┌─────────────────────────────────────────────────────────┐
│                  Claude Code Memory Stack                │
├─────────────┬──────────────────┬────────────────────────┤
│  CLAUDE.md  │   Auto Memory    │   Session Memory       │
│  (you write)│   (Claude writes)│   (Claude writes)      │
│  Rules &    │   MEMORY.md      │   Conversation logs    │
│  standards  │   + topic files  │   + continuity         │
│  Full load  │   First 200 lines│   Contextual load      │
├─────────────┴──────────────────┴────────────────────────┤
│              ↑ /si:promote        ↑ /si:memory-review   │
│         Self-Improving Agent (this plugin)               │
│              ↓ /si:extract    ↓ /si:remember            │
├─────────────────────────────────────────────────────────┤
│  .claude/rules/    │    New Skills    │   Error Logs     │
│  (scoped rules)    │    (extracted)   │   (auto-captured)│
└─────────────────────────────────────────────────────────┘

インストール

Claude Code（プラグイン）

/plugin marketplace add alirezarezvani/claude-skills
/plugin install self-improving-agent@claude-code-skills

OpenClaw

clawhub install self-improving-agent

Codex CLI

./scripts/codex-install.sh --skill self-improving-agent

メモリーアーキテクチャ

ファイルの保存場所

ファイル	書き込むユーザー	スコープ	読み込み方法
./CLAUDE.md	あなた（＋/si:promote）	プロジェクトルール	毎セッション、ファイル全体
~/.claude/CLAUDE.md	あなた	グローバル設定	毎セッション、ファイル全体
~/.claude/projects/<path>/memory/MEMORY.md	Claude（自動）	プロジェクトの学習内容	最初の 200 行
~/.claude/projects/<path>/memory/*.md	Claude（あふれた内容）	トピック別のメモ	必要に応じて
.claude/rules/*.md	あなた（＋/si:promote）	スコープ付きルール	該当ファイルを開いたとき

昇格のライフサイクル

1. Claude discovers pattern → auto-memory (MEMORY.md)
2. Pattern recurs 2-3x → /si:memory-review flags it as promotion candidate
3. You approve → /si:promote graduates it to CLAUDE.md or rules/
4. Pattern becomes an enforced rule, not just a note
5. MEMORY.md entry removed → frees space for new learnings

主な概念

自動メモリーは記録するものであり、整理するものではありません

自動メモリーは、Claude が学んだ内容を記録するのに優れています。しかし、次のような判断は行いません。

• どの学習内容が一時的で、どれが恒久的か
• どのパターンを強制適用されるルールにすべきか
• 古くなった項目で 200 行の上限を無駄にしているのはいつか
• どの解決策を再利用可能なスキルにするのに十分な品質とするか

その役割を担うのが、このプラグインです。

昇格＝正式採用

学習内容を昇格させると、Claude のスクラッチパッド（MEMORY.md）からプロジェクトのルールシステム（CLAUDE.md または .claude/rules/）に移動します。この違いは重要です。

• MEMORY.md：「このプロジェクトでは pnpm を使っているようです」（背景情報）
• CLAUDE.md：「npm ではなく pnpm を使ってください」（強制適用される指示）

昇格したルールは優先度が高く、200 行で切り詰められることなく全体が読み込まれます。

スコープ付きの知識にはルールディレクトリを使用

すべての内容を CLAUDE.md に入れる必要はありません。特定のファイル形式にのみ適用されるパターンには .claude/rules/ を使用します。

# .claude/rules/api-testing.md
---
paths:
  - "src/api/**/*.test.ts"
  - "tests/api/**/*"
---
- Use supertest for API endpoint testing
- Mock external services with msw
- Always test error responses, not just happy paths

これにより、Claude が API テストファイルを扱うときだけ読み込まれるため、それ以外の場合は負荷がかかりません。

エージェント

memory-analyst

MEMORY.md とトピックファイルを分析し、次の項目を特定します。

• 複数のセッションで繰り返し現れる項目（昇格候補）
• 削除済みファイルや古いパターンに言及している古い項目
• 統合すべき関連項目
• MEMORY.md が把握している内容と CLAUDE.md が適用している内容の差

skill-extractor

実証済みのパターンを受け取り、完全なスキルを生成します。

• 適切なフロントマターを含む SKILL.md
• リファレンスドキュメント
• 例とエッジケース
• /plugin install または clawhub publish ですぐに利用可能

フック

error-capture（PostToolUse → Bash）

コマンドの出力を監視し、エラーを検出すると、次の情報を含む構造化された項目を自動メモリーに追加します。

• 失敗したコマンド
• エラー出力（長さを制限）
• タイムスタンプとコンテキスト
• 推奨カテゴリ

トークンのオーバーヘッド： 成功時はゼロです。エラー検出時のみ約 30 トークンです。

プラットフォーム対応状況

プラットフォーム	メモリーシステム	プラグインの動作
Claude Code	自動メモリー（MEMORY.md）	✅ 完全対応
OpenClaw	workspace/MEMORY.md	✅ 対応済み（workspace のメモリーを読み込み）
Codex CLI	AGENTS.md	✅ 対応済み（AGENTS.md のパターンを読み込み）
GitHub Copilot	.github/copilot-instructions.md	⚠️ 手動での昇格のみ

関連情報

• Claude Code Memory Docs
• pskoett/self-improving-agent — インスピレーション
• playwright-pro — このリポジトリ内の関連プラグイン