はじめに
claude-forge とは？
claude-forge は、隔離されたサブエージェントを使用してマルチフェーズの開発パイプラインをオーケストレーションする Claude Code プラグインです。分析、設計、実装、レビュー間のハンドオフチェーンを自動化し、手動オーケストレーションを構造化されたシステムに置き換えます。
解決する課題
AI開発のランドスケープは3つのフェーズを経て進化してきました：
- バイブコーディング — 「Xをする関数を書いて」。小さなタスクには有効。複雑さが増すと破綻する。
- 仕様駆動開発（SDD） — まず仕様を書き、AIに渡す。改善されるが、すべてのハンドオフを管理するオーケストレーターは依然として人間。
- パイプライン自動化 — タスクを一度記述すれば、システムがワークフロー全体を実行し、制約を強制し、問題箇所を自己報告する。
claude-forge はフェーズ3のために構築されています。Anthropicの研究が特定した「デプロイメントオーバーハング」に対処します — モデルは人間が実際に与えるよりもはるかに多くの自律性を処理できます。
主な差別化要素
SDD は手動 — claude-forge は自動
SDD は各フェーズで何をすべきかを教えてくれますが、フェーズを実行しません。claude-forge はハンドオフチェーン全体を自動化します。各フェーズがMarkdownアーティファクトを書き、次のフェーズがそれを読みます。コンテキスト共有なし — エージェント間のAPIとして構造化されたファイルのみ。
自動改善ループ
毎回の実行後、claude-forge は改善レポートを出力します：
- エージェントの速度を低下させたドキュメントギャップ
- 明確化ループを引き起こした規約の不足
- コンテキスト構造の問題によるトークン集中フェーズ
工数に応じたフロー選択
すべてのタスクに全フェーズは不要です。claude-forge は工数レベル（S / M / L）に基づいてパイプラインテンプレートを選択します — 軽量なライトパイプラインから10以上のエージェントと必須チェックポイントを持つフル実行まで。
決定論的ガードレール
重要な制約はClaude Codeフックを介してシェルレベルで強制されます — プロンプト指示だけではありません：
- 読み取り専用ガード — 分析フェーズ中のソースファイル編集をブロック
- コミットガード — 並列タスク実行中のgitコミットを防止
- チェックポイントゲート — アーティファクトの存在と人間の承認が記録されるまで進行をブロック
機能一覧
- 10の専門エージェントによるマルチフェーズパイプライン
- 工数に応じたスケーリング（S/M/L → light/standard/full フローテンプレート）
- 決定論的フックガードレール（PreToolUse/PostToolUse/Stop）
- AIレビューループ（APPROVE/REVISEサイクル）
- mkdir ベースのアトミックロッキングによる並列実装
- オプションの自動承認付きヒューマンチェックポイント
- ディスクベースの状態マシン（47 MCPツール）
- 再開(resume)と放棄(abandon)のサポート
- 入力バリデーション（決定論的 + セマンティック）
- フェーズごとのトークン/時間メトリクス
- GitHub Issue と Jira Issue の統合
- 自動PR作成
- 過去の実装パターン注入（BM25スコアリング）
- 包括的テストスイート（58以上のフックテスト + Go MCPサーバーテスト）
- デバッグレポートモード