Forge

Claude Codeを構造化されたデリバリーループに変えましょう：作業の計画、モジュールの並列実行、詳細な検証、インテリジェントな再試行、そして成功した成果の引き継ぎを行います。

インストール

コピー＆ペースト：

claude plugin marketplace add TT-Wang/forge
claude plugin install forge@tt-wang-plugins

ForgeはMCPサーバーの依存関係を自動的にブートストラップするため、初回起動には数秒かかる場合があります。

インストール後：

1. Claude Codeが既に開いている場合は再起動します

2. 作業したいリポジトリを開きます

3. /forge <objective> を実行します

例：

/forge add audit logging for admin actions

Related MCP server: KIA - Kaizen Intelligent Agent

特徴

Forgeは、単純なプロンプトだけでは不十分な場面で役立ちます。

タスクが複数のファイルにまたがる場合、モジュール間の調整が必要な場合、あるいは実際に動作することの証明が必要な場合、Forgeは単なるプロンプトではなく、Claude Codeにワークフローを提供します：

• 作業をモジュールに分割する

• 並列実行可能なものを実行する

• 各モジュールを厳密に検証する

• デバッガーのコンテキストを使用して失敗を再試行する

• 次のタスクのために成功した内容を記憶する

引き続きClaude Codeを使用しますが、Forgeは困難な部分に対して構造を追加します。

得られるもの

• 構造化された計画: 機能の依存関係と検証コマンドを含むモジュールに分割します

• 並列実行: 独立したモジュールを分離されたワークツリーで同時に実行します

• 詳細な検証: ファイル、コマンド、構文、およびモジュール間のAPIコントラクトをチェックします

• インテリジェントな再試行: 試行を追跡し、停滞を検出し、デバッガーエージェントにエスカレーションします

• セッションの再開可能性: 最初からやり直すのではなく、未完了の作業を再開します

• セッション間メモリ: 慣習、失敗パターン、テストコマンドを記憶します

• ステータスの可視化: Claudeの出力とターミナルのステータス行で進捗を表示します

なぜClaude Codeを直接使わないのか？

多くのタスクでは、直接使うべきです。

Forgeは通常の利用を置き換えるものではありません。オーケストレーションが重要なタスクのためのものです。

クイックスタート

60秒セットアップ

1. 上記の2つのコマンドでForgeをインストール

2. Claude Codeを再起動

3. プロジェクトを開く

4. 目的を1つ貼り付ける：

/forge add JWT auth with refresh tokens

5. 生成された計画を承認する

実行

/forge build an audit log for admin actions

進捗確認

/forge-status

モジュールの再チェック

/forge-validate m2

一般的なセッション

/forge add JWT auth with refresh tokens

[forge] Phase 1: Planning...
[forge] Proposed Plan: 4 modules, 2 parallel groups
[forge] Proceed with this plan? (yes / modify / abort)

[forge] Phase 2: Executing m1...
[forge] Phase 2: Executing m2, m3 in parallel...
[forge] ✓ m2: DONE — validated, score 1.0
[forge] ✗ m3: FAILED — retrying with debugger
[forge] ✓ m3: DONE — validated after retry

[forge] ## Forge Complete
[forge] 4/4 modules completed

これがForgeが目指す体験です：手動での操作を減らし、進捗を可視化し、サイレントな失敗を減らします。

初回実行時の注意点

• Forgeはプロジェクト内にローカルの .forge/ ディレクトリを作成します

• MCPサーバーがNodeの依存関係をインストールするために数秒かかる場合があります

• 最初の実際の対話は計画のレビューステップです

• 計画を明示的に承認するまで何も実行されません

現在のプロジェクト構造

forge/
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .claude/
│   ├── settings.json
│   └── settings.local.json
├── agents/
│   ├── planner.md
│   ├── worker.md
│   ├── reviewer.md
│   └── debugger.md
├── skills/
│   ├── forge/
│   │   └── SKILL.md
│   ├── forge-status/
│   │   └── SKILL.md
│   └── forge-validate/
│       └── SKILL.md
├── forge-mcp-server/
│   ├── index.mjs
│   ├── start.sh
│   ├── package.json
│   └── tests/
├── statusline/
│   └── forge-status.sh
├── docs/
│   ├── architecture.md
│   ├── mcp-tools.md
│   └── launch/
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
├── CLAUDE.md
└── README.md

実行時、Forgeは作業中のプロジェクト内にローカルの .forge/ ディレクトリを作成し、計画、ログ、メモリ、再試行履歴、再開可能な状態を保存します。

主な構成要素

エージェント

Forgeには4つの専門エージェントが付属しています：

• planner: コードベースを探索し、モジュール計画を提案します

• worker: 分離されたワークツリーで1つのモジュールを実装します

• reviewer: 正確性、セキュリティ、コントラクトの不一致をチェックします

• debugger: 失敗したモジュールを調査し、再試行を推進します

スキル

ユーザー向けのコマンドは以下の通りです：

• /forge: 完全なオーケストレーターワークフロー

• /forge-status: 現在の計画、モジュールの進捗、学習したパターン

• /forge-validate: 1つのモジュールの検証を再実行

MCPサーバー

バンドルされているMCPサーバーは、Forgeが必要とする共有ランタイム機能を提供します：

• validate

• validate_plan

• memory_recall

• memory_save

• iteration_state

• forge_logs

• session_state

これらのツールにより、複数のエージェントが曖昧な会話メモリに頼ることなく調整できます。

ステータス行

Forgeはターミナルでライブ進捗を表示できます：

[forge] ████░░░░░░ 2/5 | VALIDATE | refresh endpoint | 3m19s | ~2m30s left

使用方法：

claude statusline set "bash /path/to/forge/statusline/forge-status.sh"

プロジェクト内に保存されるもの

Forgeはランタイム状態を作業中のプロジェクト内のローカル .forge/ ディレクトリに保持します。これには以下が含まれます：

• 実行計画

• 再試行履歴

• 学習したパターン

• 構造化ログ

• 再開可能なセッション状態

これにより、不透明なエージェント状態の背後にすべてを隠すのではなく、ワークフローを検証可能に保ちます。

ドキュメント

• アーキテクチャ — オーケストレーター、エージェント、MCPサーバー、状態フロー

• MCPツールリファレンス — 7つの全ツールの入出力スキーマと例

• 変更履歴 — リリースノート

• 貢献 — 開発セットアップ、テスト、リンティング、PRプロセス

• セキュリティ — 脆弱性報告とセキュリティ範囲

手動インストール

Claude Codeマーケットプレイスからインストールしたくない場合は、手動でForgeを接続できます：

git clone https://github.com/TT-Wang/forge.git /tmp/forge
mkdir -p .claude/agents .claude/skills
cp /tmp/forge/agents/*.md .claude/agents/
cp -r /tmp/forge/skills/* .claude/skills/
cp -r /tmp/forge/forge-mcp-server ./forge-mcp-server/
cd forge-mcp-server && npm install && cd ..

その後、.claude/settings.json の参照設定を使用してMCPサーバーを接続します。

開発

git clone https://github.com/TT-Wang/forge.git
cd forge/forge-mcp-server
npm install
npm test

併用におすすめ

• memem — Claude Code用の永続的なセッション間メモリ。Forgeは計画と実行を処理し、mememは実行間で有用なパターンを引き継ぐのに役立ちます。

• Vibereader — Claudeが作業している間に厳選された技術ニュースを提供

ライセンス

MIT — LICENSE を参照