はじめに
複雑な機能実装を体系的に進めたい...レガシーコードを理解・文書化したい...そんな課題はありませんか？
今回紹介するclaude-code-workflowsは、21エージェント + 15コマンド + 11スキルという大規模なオーケストレーション型ワークフローです。/implement、/diagnose、/reviewなどのコマンドでタスクを実行します。
特にスケール別分岐（Large/Medium/Small）と3エージェント診断パイプラインが特徴的です。
評価スコア: 46/50 (Rank S)
基本情報
| 項目 | 内容 |
|---|---|
| リポジトリ | https://github.com/shinpr/claude-code-workflows |
| 作者 | Shinsuke Kagawa (shinpr) |
| Star数 | 107 |
| 構成 | 21エージェント + 15コマンド + 11スキル |
| 形式 | オーケストレーション型 |
主要コマンド
| コマンド | 機能 | エージェント数 |
|---|---|---|
| /implement | 機能実装（スケール自動判定） | 5-7 |
| /diagnose | 問題診断（ACH + Devil's Advocate） | 3 |
| /reverse-engineer | レガシーコード文書化 | 3 |
| /review | コードレビュー | 2 |
| /refactor | リファクタリング | 3 |
主要機能
1. スケール別分岐
タスクの規模を自動判定し、ワークフローの深度を調整します。
Large (大規模)
→ 要件分析
→ 詳細設計
→ 実装
→ テスト
→ レビュー
→ ドキュメント
Medium (中規模)
→ 設計
→ 実装
→ テスト
Small (小規模)
→ 直接実装
判定基準：
- Large: 複数ファイル変更、新規アーキテクチャ、外部API連携
- Medium: 単一機能、既存パターンの拡張
- Small: バグ修正、軽微な変更
2. /diagnose - 3エージェント診断パイプライン
ACH（Analysis of Competing Hypotheses）+ Devil's Advocate手法を採用。
[Agent 1: Hypothesis Generator]
問題から複数の仮説を生成
↓
[Agent 2: Devil's Advocate]
各仮説に対して反論・検証
↓
[Agent 3: Integrator]
証拠を統合し、最も妥当な仮説を選定
この手法により、単一視点では見落としがちな問題の根本原因を特定できます。
3. /reverse-engineer - レガシーコード文書化
[Agent 1: Code Analyzer]
コード構造・依存関係を分析
↓
[Agent 2: Business Logic Extractor]
ビジネスロジックを抽出・整理
↓
[Agent 3: Documentation Writer]
技術文書を生成
出力物：
- アーキテクチャ図（Mermaid）
- API仕様書
- データフロー図
- 依存関係マップ
4. metronomeプラグイン
AIの「効率化」ショートカット行動を多言語で検出・防止します。
検出パターン例：
- "Let me simplify this..."
- "For brevity, I'll skip..."
- "This should be straightforward..."
- 「簡略化のため...」
- 「省略しますが...」
これらのフレーズが検出されると、「本当に省略してよいか？」と再確認を促します。
5. 3段階設計逸脱チェック
実装が設計から逸脱していないかを3段階でチェック。
Level 1: 軽微な逸脱
→ 警告のみ、続行可能
Level 2: 中程度の逸脱
→ 理由の説明を要求
→ 承認後に続行
Level 3: 重大な逸脱
→ 実装停止
→ 設計の再検討を強制
グレーゾーンの鉄則: 判断に迷う場合は必ずエスカレーション。
ワークフロー例：/implement
1. タスク受付
↓
2. スケール判定（Large/Medium/Small）
↓
3. [Large/Mediumの場合] 設計フェーズ
- 要件分析エージェント
- 設計エージェント
↓
4. 実装フェーズ
- コード生成エージェント
- 設計逸脱チェック
↓
5. テストフェーズ
- テスト生成エージェント
- テスト実行・検証
↓
6. [Largeの場合] レビューフェーズ
- コードレビューエージェント
- ドキュメント生成
注意点
- 学習コスト: 21エージェント + 15コマンドの理解が必要
- 処理時間: 大規模タスクは複数エージェントを経由するため時間がかかる
- コスト: 多くのAPIコールが発生
評価詳細
| 評価項目 | 点数 | コメント |
|---|---|---|
| 明確な目的定義 | 4/5 | オーケストレーション型として明確 |
| ファイル構成の論理性 | 5/5 | agents/commands/skills分離 |
| ワークフロー設計 | 5/5 | スケール別分岐が秀逸 |
| 参照ファイルの有用性 | 4/5 | 各エージェント定義が詳細 |
| 記法・フォーマットの一貫性 | 5/5 | 統一されたエージェント定義 |
| 再利用性 | 4/5 | プロジェクト横断で使える |
| エラーハンドリング | 5/5 | 設計逸脱チェック・エスカレーション |
| ドキュメント品質 | 4/5 | README詳細 |
| 拡張性 | 5/5 | エージェント追加容易 |
| 実用性 | 5/5 | コマンド一発で開始可能 |
合計: 46/50 (Rank S)
まとめ
claude-code-workflowsは「複雑な開発タスクを体系化する」ための強力なフレームワークです。
- 21エージェントによる役割分担
- スケール別分岐でワークフロー深度を自動調整
- ACH + Devil's Advocateによる多角的診断
- metronomeでAIのショートカット行動を防止
- 設計逸脱チェックで品質を担保
大規模な機能実装やレガシーコードの理解が必要な場面で威力を発揮します。