Claude Code Compound Engineering

Compound Engineeringプラグインは、特化型エージェント、スラッシュコマンド、スキル、そしてPlan → Work → Review → Compoundサイクルの構造化されたワークフローでClaude Codeを拡張します。

インストール

ステップ	Command
Claude Codeをインストール	claude.ai/code のセットアップに従う
プラグインをクローン	git clone https://github.com/anthropics/claude-code-plugins
Claude Codeに追加	Claude Codeの設定でプラグインパスを追加
確認	Claude Codeで/helpを実行して利用可能なコマンドを確認

コアワークフローサイクル

フェーズ	Slash Command	説明
Plan	/plan	機能の説明を構造化された実装計画に変換
Work	/lfg	完全自律型エンジニアリング — マルチエージェント連携で計画を実行
Review	/review-pr	特化型並列エージェントによる包括的なPRレビュー
Compound	/compound	解決済みの問題を文書化して組織的知識を構築

スラッシュコマンド

計画とアーキテクチャ

Command	説明
/plan	ファイルレベルの詳細を含む構造化された実装計画を作成
/brainstorm	計画前に要件とアプローチを探索
/deepen-plan	並列リサーチエージェントで計画の深さとベストプラクティスを強化
/plan_review	複数の特化型エージェントが並列で計画をレビュー

開発と実行

Command	説明
/lfg	完全自律型エンジニアリングワークフロー — 計画、実装、テスト、レビュー
/resolve_parallel	並列処理で全TODOコメントを解決
/resolve_pr_parallel	並列処理で全PRコメントを解決
/resolve_todo_parallel	並列処理で全CLI待機タスクを解決

レビューと品質

Command	説明
/review-pr	特化型エージェント（コード、セキュリティ、パフォーマンス）による包括的PRレビュー
/code-review	計画と標準に対する特定のコード変更をレビュー
/test-browser	現在のPRまたはブランチの影響を受けるページでブラウザテストを実行
/reproduce-bug	ログ、コンソール、スクリーンショットを使用してバグを再現・調査

ドキュメントと知識

Command	説明
/compound	組織的知識として解決済みの問題を文書化
/changelog	mainへの最近のマージに対する魅力的な変更ログを作成
/deploy-docs	GitHub Pagesへのドキュメントを検証・準備
/release-docs	現在のコンポーネントでドキュメントサイトをビルド・更新

ユーティリティ

Command	説明
/generate_command	新しいカスタムスラッシュコマンドを作成
/triage	CLI todoシステムの検出結果をトリアージ・分類
/feature-video	機能のウォークスルー動画を録画してPRの説明に追加
/agent-native-audit	包括的なエージェントネイティブアーキテクチャレビューを実行

特化型エージェント

コードレビューエージェント

Agent	用途
code-reviewer	バグ、ロジックエラー、セキュリティ、コード品質のレビュー
code-simplifier	機能を維持しながらコードを簡素化して明確化
silent-failure-hunter	サイレント障害と不適切なエラー処理を特定
comment-analyzer	コメントの正確性と保守性を分析
pr-test-analyzer	テストカバレッジの品質と完全性をレビュー
type-design-analyzer	型設計と不変条件の専門分析
code-simplicity-reviewer	YAGNI準拠と最小複雑性の最終チェック

アーキテクチャとセキュリティエージェント

Agent	用途
architecture-strategist	システム設計の決定とコンポーネント境界を評価
security-sentinel	セキュリティ監査、脆弱性評価、OWASPコンプライアンス
performance-oracle	パフォーマンス、アルゴリズム、ボトルネック、スケーラビリティを分析
agent-native-reviewer	機能が人間だけでなくエージェントにもアクセス可能であることを保証
pattern-recognition-specialist	デザインパターン、アンチパターン、コード重複を検出

言語別レビュアー

Agent	用途
kieran-rails-reviewer	厳格なRails規約と品質レビュー
kieran-python-reviewer	厳格なPython規約と品質レビュー
kieran-typescript-reviewer	厳格なTypeScript規約と品質レビュー
dhh-rails-reviewer	DHHの視点からのRailsレビュー — アンチパターン検出
julik-frontend-races-reviewer	JS/Stimulusのフロントエンド競合状態検出

データとデプロイメントエージェント

Agent	用途
data-integrity-guardian	データベースマイグレーション、データ制約、参照整合性
data-migration-expert	IDマッピング、ロールバック安全性、データ変換を検証
deployment-verification-agent	デプロイ前後のチェックリスト、SQL検証、ロールバック計画

リサーチエージェント

Agent	用途
framework-docs-researcher	包括的なフレームワークドキュメントとベストプラクティスを取得
learnings-researcher	docs/solutions/の組織的学習を検索
best-practices-researcher	ドキュメントとOSSからの外部ベストプラクティスを収集
git-history-analyzer	gitの履歴とコードの進化の考古学的分析
repo-research-analyst	包括的なリポジトリ構造とパターン分析

デザインエージェント

Agent	用途
figma-design-sync	実装とFigmaデザインの同期
design-implementation-reviewer	UIがFigma仕様に一致していることを検証
design-iterator	N回のスクリーンショット分析修正サイクルによる反復的デザイン改善

スキル

開発スキル

Skill	トリガー
frontend-design	高品質なデザインのWebコンポーネントを構築
agent-native-architecture	エージェントがファーストクラスの市民であるアプリを設計
dspy-ruby	型安全でコンポーザブルなLLMアプリのためのRubyフレームワーク
andrew-kane-gem-writer	Andrew Kaneパターンに従ったRuby gemを作成
dhh-rails-style	DHHの37signalsスタイルでRuby/Railsコードを作成

ワークフロースキル

Skill	トリガー
brainstorming	実装前に意図とアプローチを探索
git-worktree	分離された並列開発のためのGit Worktreeを管理
file-todos	ファイルベースのTodo追跡システムを管理
every-style-editor	Everyのスタイルガイドに沿ったテキストのレビューと編集
compound-docs	解決済みの問題をカテゴリ化されたドキュメントとしてキャプチャ

ツール連携スキル

Skill	トリガー
agent-browser	Vercelのagent-browser CLIを使用したブラウザ自動化
rclone	クラウドストレージプロバイダー間のファイルアップロードと同期
gemini-imagegen	Gemini APIを使用した画像の生成と編集
xcode-test	シミュレータでのiOSアプリのビルドとテスト
skill-creator	効果的な新しいスキルを作成するためのガイド

フック

Hook	イベント	用途
SessionStart	セッション初期化	コンテキストのセットアップ、メモリの読み込み
PreToolUse	ツール実行前	検証、危険なコマンドのブロック
PostToolUse	ツール実行後	結果の処理、フォローアップのトリガー
Stop	エージェント完了	最終チェック、クリーンアップ
UserPromptSubmit	ユーザーがメッセージ送信	ユーザー入力の前処理

マルチエージェントレビューワークフロー

/review-prコマンドは、複数の特化型エージェントを並列で起動します：

┌─────────────────────────────────────────────────┐
│                  /review-pr                      │
├─────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │ Code     │  │ Security │  │ Perf     │      │
│  │ Reviewer │  │ Sentinel │  │ Oracle   │      │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘      │
│       │              │              │            │
│  ┌────┴─────┐  ┌────┴─────┐  ┌────┴─────┐      │
│  │ Silent   │  │ Type     │  │ Pattern  │      │
│  │ Failure  │  │ Design   │  │ Recog.   │      │
│  └────┬─────┘  └────┬─────┘  └────┴─────┘      │
│       └──────────┬───┘──────────────┘            │
│            Consolidated Report                   │
└─────────────────────────────────────────────────┘

よくあるユースケース

機能開発

# 1. Brainstorm the approach
/brainstorm

# 2. Create a structured plan
/plan

# 3. Deepen with research agents
/deepen-plan

# 4. Execute autonomously
/lfg

# 5. Review the PR
/review-pr

# 6. Document what you learned
/compound

PRコメントの解決

# Resolve all PR comments in parallel
/resolve_pr_parallel

# Or resolve TODOs across the codebase
/resolve_parallel

カスタムコマンドの作成

# Generate a new slash command
/generate_command

# Create a new skill
Use the skill-creator skill for guidance

設定

プラグイン構造

compound-engineering/
├── plugin.json          # Plugin manifest
├── commands/            # Slash command definitions
│   ├── lfg.md
│   ├── plan.md
│   ├── review-pr.md
│   └── ...
├── agents/              # Agent definitions
│   ├── code-reviewer.md
│   ├── security-sentinel.md
│   └── ...
├── skills/              # Skill definitions
│   ├── frontend-design/
│   ├── agent-native-architecture/
│   └── ...
└── hooks/               # Event hooks
    ├── session-start.md
    └── ...

エージェント設定

エージェントはYAMLフロントマター付きのMarkdownファイルで定義されます：

---
name: "code-reviewer"
description: "Reviews code for bugs, logic errors, and quality"
tools:
  - Glob
  - Grep
  - Read
  - Task
model: sonnet  # or opus, haiku
---

ベストプラクティス

• 実装に着手する前に/brainstormから始める — エッジケースを早期に発見できる
• 些細でないものには/planを使用 — 「シンプルな」機能でも構造化された思考の恩恵を受ける
• マージ前に/review-prを実行 — マルチエージェントレビューは単一パスレビューが見逃す問題を発見する
• /compoundで文書化 — 組織的知識が同じミスの繰り返しを防ぐ
• 複雑な機能には/deepen-planを使用 — リサーチエージェントがドキュメントとベストプラクティスからの深みを追加する
• 並列解決を活用 — /resolve_parallelはTODOを逐次修正より高速に処理する
• 繰り返しパターンにはカスタムスキルを作成 — 再利用のためにドメイン知識をカプセル化する
• 簡単なエージェントにはhaikuモデルを使用 — 簡単なタスクのコストとレイテンシを最小化する

トラブルシューティング

問題	解決策
エージェントが見つからない	Claude Codeの設定でプラグインパスを確認して再起動
コマンドが認識されない	/helpを実行して利用可能なコマンドを一覧表示、plugin.jsonを確認
エージェントが空を返す	モデルの利用可能性を確認、opus/sonnetにはAPIキーが必要な場合あり
マルチエージェントレビューが遅い	簡単なエージェントにはhaikuモデル、重要なものにはsonnetを使用
スキルがトリガーされない	スキルの説明がプロンプトの表現と一致しているか確認
フックが発火しない	フックイベントタイプの一致を確認（PreToolUse vs PostToolUse）
計画が曖昧すぎる	リサーチエージェント付きの/deepen-planを使用してさらに詳細化
レビューがコンテキストを見逃す	/review-prにPR URLまたはブランチ名を明示的に提供