Autonomous Agent Builder & Orchestrator
要件からエージェントを設計・生成し、
claude-peers-mcp 経由で複数エージェントを司令塔として指揮する
JAVISは、Claude Code上で動作する「エージェントを作るエージェント」+「複数の独立エージェントを指揮する司令塔」。 builder（生成）と orchestrator（指揮）の 2 役を持つメタエージェントです。 v2.0 では claude-peers-mcp を統合し、別ターミナルで独立動作する複数の peer を Hub-and-spoke で束ねる能力を獲得しました。
曖昧な要件のまま作らない。徹底的な目線合わせで目的・対象・制約・成功定義を明確化します。
ARCHITECTURE.md を自動生成。design-critic が過剰/過少設計・コンテキスト重量・実現可能性を批判的にレビュー。
合意された設計書に基づき、CLAUDE.md・Skills・Agents・Rules・Settings 一式を独立ディレクトリに生成します。
生成後は generation-critic が Phase 4.5 で設計書と実ファイルを照合。未実装項目・品質不備・共通ルール注入漏れを検出。
生成済み peer を claude-peers-mcp 経由で指揮。/delegate, /broadcast, /orchestrate で意図ベースのタスク分配。
failure-modes 蓄積、/update-knowledge、Auto Memory、registry 運用で「成長する前提」の設計。
JAVIS は 1 つの Claude Code セッション内で 2 つの役割を切り替えます。 Builder モードで新エージェントを産み、Orchestrator モードで生まれたエージェント群を指揮します。
要件のヒアリングから設計書、生成、登録までを自動実行。design-critic と generation-critic の 2 段レビューで品質を担保します。
生成済み peer を claude-peers-mcp 経由で指揮。Hub-and-spoke で JAVIS が 司令塔となり、task-decomposer と result-synthesizer が内部品質ゲートを担います。
/create-agent を実行するだけ。6 フェーズ（+ Phase 4.5 レビュー）で完成されたエージェントが生まれます。
目的・対象・ユーザー像・成功定義・制約・Agent Teams 要否・peer 化の必要性を質問。曖昧さがなくなるまで対話を繰り返します。
HUMAN IN THE LOOPARCHITECTURE.md を自動生成。プロジェクト構造、ワークフロー、出力形式、成長機構を網羅した詳細設計書。
AUTO GENERATEDdesign-critic サブエージェントが過剰/過少設計・コンテキスト重量・実現可能性・Agent Teams 妥当性を検証。GO / REVISE / REJECT を判定。
VERIFICATION AGENT設計書サマリーを提示し、明示的合意を取得。修正が必要なら設計に戻る反復。
HUMAN APPROVAL全ファイルを独立ディレクトリに生成。common-rules 注入、成長機構スタンプ、peer 化設定まで自動。
FULLY AUTOMATEDgeneration-critic サブエージェントが ARCHITECTURE.md と実ファイルを 1 対 1 で照合。未実装項目・frontmatter 欠損・common-rules 注入ミスを検出。REWRITE なら Phase 5 に戻る。
WRITER / REVIEWERregistry/REGISTRY.md に peer_alias、startup_cmd、role、status=dormant を追加。以降 /list-agents と /wake-agent の対象に。
PEER MANIFEST
/orchestrate <goal> が司令塔モードの本丸。抽象ゴールを受け取り、
task-decomposer で分解、各サブタスクを peer に delegate し、result-synthesizer で統合します。
内部で /peer-status を呼び、managed-active な peer を把握。0 件なら中断し /wake-agent を案内。
MCP: list_peerstask-decomposer subagent (opus) が fresh context でゴールを 2-6 個のサブタスクに分解。各サブタスクに peer・依存関係・Why ベースの intent を付与。
SUBAGENT: opus分解計画をテーブル表示。ユーザーの yes / revise / cancel を待つ。外部 peer を動かす前に必ず人間の目を通す。
HUMAN APPROVAL依存グラフに従って /delegate を実行。独立タスクは最大 5 並列。30 秒タイムアウト、retry/fallback は JAVIS が判断。
MCP: send_messageresult-synthesizer subagent (opus) が各 peer の応答を再構築。ゴール視点で再編集、出典明示、矛盾・欠損の評価。
SUBAGENT: opusExecutive Summary + 主な発見 + 出典 + 矛盾点 + 欠損影響 + 達成度判定を統合レポートとして提示。
COMPLETE / PARTIAL / INSUFFICIENTfailure があれば failure-modes.md の FM-ORC に追記。全送受信は audits/javis/{date}/orchestration.log に永続化。
GROWTH MECHANISM
claude-peers-mcp は machine 上で起動している全 Claude Code セッションを peer として認識します。
JAVIS は summary の [javis-managed] prefix と registry の
peer_alias の二重管理で、自身の管理下と無関係セッションを厳密に区別します。
registry に登録済み、かつ現在起動中。/delegate、/broadcast、/orchestrate の対象。
registry に登録済みだが未起動。/wake-agent で起動コマンドを取得し、別ターミナルで手動起動。
[javis-managed] prefix を持つが registry 未登録。要調査（不整合の兆候）。
無関係な別プロジェクトの Claude。自動通信対象から除外。prompt injection 防御で untrusted 扱い。
JAVIS v2.0 には 9 つの Skill が組み込まれています。すべて disable-model-invocation: true
+ user-invocable: true で、ユーザーが明示的にスラッシュコマンドで呼びます。
| Trigger | Role | Mode |
|---|---|---|
| /create-agent | 要件深掘り → 設計書 → design-critic → 生成 → generation-critic → registry 追記。Builder の本丸。 | BUILDER |
| /update-knowledge | JAVIS 自身の references/ (claude-code-features.md 他 3 ファイル) を最新情報で更新。templates/ との同期も判定。 | BUILDER |
| /peer-status | list_peers + registry 突き合わせで 4 カテゴリ（managed-active / dormant / orphan / external）に分類表示。起動時に必ず最初に呼ぶ。 | ORCHESTRATOR |
| /peer-resolve | peer_alias → 現在の peer_id を動的解決する内部ヘルパー。/delegate、/broadcast、/orchestrate が内部で呼ぶ。 | ORCHESTRATOR |
| /delegate <alias> <task> | 単一 peer に 1 タスクを意図ベースで委任。30 秒タイムアウト、managed チェック、全送受信を audit.log 記録。 | ORCHESTRATOR |
| /broadcast <question> | [javis-managed] prefix で filter した managed peer 群に並列問い合わせ（最大 5）。集約は JAVIS 自身が行う（peer に丸投げしない）。 | ORCHESTRATOR |
| /orchestrate <goal> | 高次司令塔モード。task-decomposer で分解 → 承認 → 並列 delegate → result-synthesizer で統合 → 最終報告 → FM-ORC 記録。 | ORCHESTRATOR |
| /list-agents | registry の全行をファイルシステム + list_peers と突き合わせ、健全性を表形式表示。missing / orphan / status 不一致を検出。 | ORCHESTRATOR |
| /wake-agent <alias> | dormant な agent の起動コマンドを生成してユーザーに案内。JAVIS 自身は子 claude を spawn しない (ADR-3)。 | ORCHESTRATOR |
JAVIS 内部の品質ゲート役 4 体。peer にはせず、Javis プロセス内の fresh context で動きます（ADR-2）。
trace 解釈と因果推論を要する 2 体は opus、静的照合の 2 体は sonnet。
Javis が生成した ARCHITECTURE.md を批判的にレビュー。過剰設計（サブエージェント過多、Agent Teams 乱用）、 過少設計（failure-modes 欠如、tools 無制限）、コンテキスト重量、実現可能性、Agent Teams 妥当性を検証。 GO / REVISE / REJECT を判定。
設計書と実生成ファイルを 1 対 1 で照合。CLAUDE.md ≤ 100 行、frontmatter 必須項目、common-rules 注入、 failure-modes 配置、registry 追記、Skill description 品質、Agent tools 制限を全項目チェック。 GO / REVISE / REWRITE / BLOCK を判定。
抽象的ゴールを 2-6 個のサブタスクに分解。対象・フェーズ・種類・視点のいずれかの分割軸を選定、 各サブタスクに担当 peer と Why ベースの intent を割り当て、依存グラフを構築。 READY / NEEDS_MORE_PEERS / CANNOT_DECOMPOSE を返却。
各 peer からの応答を連結ではなく再構築。ゴール視点で再編集、各主張に出典 [t1 より] 形式を付与、 矛盾・欠損・推測混入を検出し明示。失敗タスクの影響評価。 COMPLETE / PARTIAL / INSUFFICIENT を判定。
JAVIS v2.0 の完全なディレクトリ構成。★ NEW マークは v2.0 で追加された要素です。
javis/ ├── CLAUDE.md ← 地図（100行以下、builder + orchestrator 両役明記） ├── .mcp.json ← ★ claude-peers project scope 登録 ├── .claude/ │ ├── settings.json ← deny 22 項目 + peer tools allow │ ├── rules/ │ │ ├── common-rules.md ← ★ 自家注入（dogfooding 遵守） │ │ ├── javis-rules.md ← paths frontmatter + orchestrator 規律 │ │ └── orchestration-rules.md ← ★ ADR 5 本 + 5 原則 + 防御 4 項目 │ ├── agents/ │ │ ├── design-critic.md ← 設計書レビュー（sonnet） │ │ ├── generation-critic.md ← ★ 生成物レビュー（sonnet） │ │ ├── task-decomposer.md ← ★ ゴール分解（opus） │ │ └── result-synthesizer.md ← ★ 結果統合（opus） │ └── skills/ │ ├── create-agent/ │ │ ├── SKILL.md ← Builder ワークフロー（Phase 1-5 + 4.5） │ │ └── references/ │ │ ├── agent-design-patterns.md ← 6 つの設計パターン │ │ ├── architecture-template.md ← 設計書テンプレート │ │ ├── claude-code-features.md ← Claude Code 全機能（979 行） │ │ └── failure-modes.md ← ★ FM-META / FM-ORC 蓄積 │ ├── update-knowledge/SKILL.md ← ★ JAVIS 自身の references 更新 │ ├── peer-status/SKILL.md ← ★ peer pool 4 カテゴリ分類 │ ├── peer-resolve/SKILL.md ← ★ alias → peer_id 解決 │ ├── delegate/SKILL.md ← ★ 単一 peer 委任 │ ├── broadcast/SKILL.md ← ★ 並列問い合わせ │ ├── orchestrate/SKILL.md ← ★ 高次司令塔（7 Phase） │ ├── list-agents/SKILL.md ← ★ registry ↔ peer 同期 │ └── wake-agent/SKILL.md ← ★ dormant peer 起動案内 ├── registry/ │ └── REGISTRY.md ← peer manifest（テーブル形式 v2） └── templates/ ├── common-rules.md ← 生成対象への注入元 └── growth-kit/ ├── failure-modes-template.md └── update-knowledge-template/ ▼ 生成されるエージェント (v2.0 対応) ▼ {agent-name}/ ├── CLAUDE.md ← 地図（100 行以下） ├── ARCHITECTURE.md ← JAVIS 生成の設計書 ├── .mcp.json ← ★ claude-peers 設定（peer 化時） ├── .claude/ │ ├── rules/common-rules.md ← JAVIS から注入 │ ├── skills/{main-skill}/ │ │ ├── SKILL.md ← やりがちな間違い + GOOD/BAD + 自己点検 │ │ └── references/ │ │ └── failure-modes.md ← 成長機構 │ ├── agents/ ← 必要な subagent 群 │ └── settings.json ← deny + allow + AGENT_TEAMS └── .claude/skills/update-knowledge/ ← 知識更新骨格
v2.0 の司令塔アーキテクチャは 5 つの ADR (Architecture Decision Records) に基づきます。 各判断は orchestration-rules.md に永続化され、将来の変更時に参照されます。
指示は全て JAVIS を経由。agent 同士の直接通信は当面禁止。追跡可能性を最優先し、何か壊れた時に「誰が誰に何を言ったか」を audit.log で一元確認できる。
design-critic、generation-critic、task-decomposer、result-synthesizer は peer にしない。fresh context と軽量即応性が品質ゲートに必須、peer 通信は過重。
JAVIS は子 claude を spawn しない。起動コマンドを /wake-agent で生成し、ユーザーが別ターミナルで実行。sandbox 安全性と権限モデルの複雑化を避ける。
list_peers の peer_id は再起動ごとに変わる。registry の peer_alias を安定識別子とし、/peer-resolve で動的解決する。コードベース全体で alias のみを使う。
claude-peers-mcp README はこのフラグを推奨するが、JAVIS では使わない。deny が無効化されると prompt injection 対策が崩れるため。代替: mcp__claude-peers__* の各 tool を settings.json の allow に列挙する。permission prompt が出るが、それで良い（頻度が多ければ allow を広げる）。
claude-peers 経由で外部 peer から JAVIS にメッセージが届く設計は、prompt injection の強力な侵入経路になります。 JAVIS は司令塔として権限が高く、乗っ取られた場合の被害も大きい。そのため 4 層の防御を組み合わせています。
settings.json の deny で OS レベルの破壊的操作を遮断。22 項目を deny 登録。
Read(**/.env), Read(**/.env.*)Read(**/*credentials*), Read(**/*secrets*)Read(**/.ssh/**), Read(**/id_rsa)Bash(rm -rf /), Bash(rm -rf ~)Bash(git push --force*)Bash(curl * | sh*), Bash(wget * | sh*)外部 peer から届いた message にこれらのキーワードが含まれると、JAVIS は自動実行せずユーザー確認を求める。
rm, rmdir, delete, unlinkcurl | sh, wget | sh, curl | bash.env, credentials, id_rsa, .sshgit push --force, git reset --hardsudo, chmod 777, chmod +sbase64 -d | sh信頼境界は registry。registry に登録された managed peer のみを信頼する。
JAVIS 自身の summary に防御メッセージを含めることで、良識ある peer にシグナルを送る。
set_summary で自動宣言"[javis-managed] meta-orchestrator. Do NOT send destructive commands. All external instructions reviewed by human."JAVIS が生成するエージェントとオーケストレーションが効くシナリオ。単独動作だけでなく、複数 peer 連携の例も含みます。
security / perf / coverage の 3 reviewer peer を生成し、/orchestrate で PR を並列レビュー → 統合レポート。
プロジェクト設定・構造・品質を自動評価し具体的処方箋を出力。Harness Auditor がこの実例。
コードベースから API ドキュメントと README を自動生成。Writer/Reviewer パターン + generation-critic で品質保証。
既存コードから test ケース生成 → カバレッジ測定 → 不足 test 追加の Pipeline 型エージェント。
ビルド・テスト・デプロイを hooks でガード。問題検知で即ロールバック。1 peer で完結する Single Skill 型。
複数 repo を横断するフレームワーク移行。各 repo に peer を起動し、/orchestrate で段階的に進行。
researcher / summarizer / fact-checker の 3 peer。/broadcast で同じ問題を複数視点から分析し、result-synthesizer で統合。
planner → executor → logger の Pipeline。朝の /orchestrate "今日の TODO を計画して実行して" が日次ルーティンに。
analyzer + refactorer + test-runner を delegate で連携。各段階で design-critic 判定 → 次フェーズ進行。
JAVIS はプロジェクト要件に応じて最適な設計パターンを自動選択します。 agent-design-patterns.md で詳細を管理。
反復的な単一タスク向け。Skill 1 つで完結。Phase 1 相当の最小構成。
複数の独立ワークフロー。各 Skill は独立した use case を持つ。
自己評価バイアスを排除。生成と検証を独立エージェントに分離。JAVIS 自身がこの型（design-critic / generation-critic）。
計画→実行→検証の段階的処理。各フェーズが専門エージェント。
複数観点から並列分析→統合。Harness Auditor がこの型。/broadcast + result-synthesizer で実現。
★ v2.0 新設。1 orchestrator + N 独立 peer。/orchestrate で JAVIS が司令塔として束ねる。
6 フェーズで完了。Phase 0 の前提確認から、Phase 5 の初回起動まで、所要約 15-20 分。
JAVIS v2.0 は claude-peers-mcp を使うため、以下が必要です:
複数の Claude Code インスタンスが会話するための MCP サーバーを clone してインストール:
~/claude-peers-mcp。
user scope 登録により、どのディレクトリで起動した Claude Code でも claude-peers が使えるようになります（JAVIS だけでなく生成される peer も同じ）:
~ は展開されない場合があります。
このページの Download ボタンから javis.zip を取得し、展開:
JAVIS の .mcp.json には claude-peers の絶対パスが埋め込まれています。あなたの環境に合わせて書き換えてください:
$(whoami) を実名に展開した値）。user scope にも登録してあれば project scope は無くても動きますが、明示性のため残す構成を推奨。
新しい起動コマンドで JAVIS セッションを開始:
起動後、JAVIS は自動的に set_summary を呼び、/peer-status で自身が peer として認識されることを確認します。その後、以下のコマンドで作業開始:
alias javis='cd ~/Desktop/javis && claude --dangerously-load-development-channels server:claude-peers' を .zshrc / .bashrc に追加すると javis だけで起動できます。
ダウンロードして上記の Setup Guide に従うだけ。15-20 分で Builder + Orchestrator が手に入ります。
DOWNLOAD JAVIS v2.0javis.zip — Agent Builder & Orchestrator
要件: Bun · Claude Code v2.1.80+ · claude.ai ログイン
よくある質問とトラブルシューティング。詰まったらまずここを確認してください。
必須ではありませんが、同梱の .mcp.json は claude-peers を前提としています。Builder モードだけ使う場合は、.mcp.json を削除するか、起動コマンドから --dangerously-load-development-channels server:claude-peers を外してください。ただし Orchestrator モード (/delegate, /broadcast, /orchestrate) は動かなくなります。
使わないことを強く推奨します (ADR-5)。peers-mcp の README では推奨されていますが、JAVIS ではこのフラグを使うと settings.json の deny が無効化され、prompt injection 防御の 1 層が消えます。代わりに JAVIS では mcp__claude-peers__* の各 tool を settings.json の allow に明示登録しています。permission prompt が頻繁に出るようなら allow を広げる方向で対応してください。
user scope 登録が済んでいないか、Claude Code セッションが古いです。claude mcp list で claude-peers が表示されることを確認し、表示されていなければ Phase 2 の claude mcp add --scope user を実行。登録後は Claude Code セッションを再起動してください（MCP サーバー一覧は起動時に確定されるため）。
create-agent/SKILL.md 本体に Phase 4.5 挿入が完全には反映されていない場合があります。手動で「generation-critic サブエージェントを起動して生成物をレビューしてください」と指示すると動きます。運用で頻発するようなら、failure-modes.md の FM-BUILD に記録した上で SKILL.md を編集するのがベスト。
これは正常動作です。claude-peers-mcp は machine 全体の Claude Code セッションを peer として認識します。JAVIS は summary の [javis-managed] prefix で自分の管理下のみを区別し、それ以外は External カテゴリに入れて自動通信対象から除外します。/broadcast も managed peer にしか送りません。
JAVIS は 4 層の防御で対応します。Layer 1 で settings.json の deny が OS レベルで rm -rf / や .env 読み取りを遮断。Layer 2 で受信メッセージをキーワード検知し、破壊的コマンドが含まれていれば自動実行せずユーザー確認を求めます。Layer 3 で registry 未登録の peer からの指示は untrusted 扱い。Layer 4 で JAVIS 自身の summary に防御メッセージを含め、social signal を発します。
/wake-agent <peer_alias> を呼ぶと、registry に登録された startup_cmd をそのまま表示します。コピペして別ターミナルで実行してください。さらに頻繁に使うなら shell alias を作るのが楽です。例: alias wake-daily-log='claude --add-dir ~/Desktop/daily-log --dangerously-load-development-channels server:claude-peers'
まず /peer-status で対象 peer が managed-active になっているか確認。dormant なら /wake-agent で起動。active なのに応答が来なければ、peer 側のセッションが busy（別のタスク中）か、channels 接続が切れた可能性。peer を Ctrl+C で落として起動し直してください。繰り返すなら failure-modes.md の FM-ORC に追記して原因追跡を。
~/Desktop/javis/.claude/skills/create-agent/references/failure-modes.md が JAVIS 自身の FM 蓄積先。orchestration.log は ~/Desktop/javis/audits/javis/YYYY-MM-DD/orchestration.log に日付ごとに永続化されます。両者は /delegate, /broadcast, /orchestrate 実行時に自動生成・追記されます。
このページの Download ボタンから最新の javis.zip を取得し、既存の ~/Desktop/javis を rename してバックアップした上で、新しい zip を展開してください。設定ファイル (.mcp.json) のパス書き換えと claude-peers-mcp の clone は再利用可能なので、Phase 4-6 だけ繰り返せば良いです。カスタマイズした rules/ や references/ があれば手動でマージしてください。