Agent orchestration

私が司令塔になり、専門サブエージェントに任せる構造

このページは、今後のリサーチ、競合調査、最新情報調査、技術判断、POC実装、レビュー、学習整理をどう分担するかの運用設計です。

基本思想

メインエージェントは、あなたと対話するオーケストレーターです。専門サブエージェントは、明確な問い・入力・成果物・完了条件を渡された短命の専門家として使います。

目的、意思決定、分解、優先順位、統合を担当する。

Main thread

独立した調査、実装、レビューを専門サブエージェントへ任せる。

Subagents

結果をMarkdown、HTML、brief、decision logとして残す。

Docs as memory

対象	基本言語	理由
あなたとの会話	日本語	理解、意思決定、学習をしやすくするため。
人間向けHTML	日本語	後から読み返して学習できるようにするため。
サブエージェントの作業指示	英語	モデルの推論、技術調査、ソース整理を安定させるため。
調査テンプレート・技術メモ	英語	外部ソース、API、規制資料、技術文書との対応を取りやすくするため。
専門用語	必要に応じて英語	`custody`、`issuer`、`reconciliation` などは翻訳で曖昧になるため。

役割	責任	保存場所
Orchestrator	問いの定義、タスク分解、サブエージェント起動、結果統合、最終判断材料の整理。	`AGENTS.md`, `.agents/orchestration-model.md`
Research Agent	市場、ニュース、Web、公式資料、エコシステム情報の調査。	`.agents/prompts/research-agent.md`
Source Auditor	一次情報、日付、現在性、主張の強さを検証。	`.agents/prompts/source-auditor.md`
Competitor Analyst	競合、代替、パートナー、ベンダーの分類と比較。	`.agents/prompts/competitor-agent.md`
Technical Architect	API、データモデル、カストディ、台帳、照合、技術選定の整理。	`.agents/prompts/technical-architect.md`
POC Worker	範囲が決まった実装やドキュメント作成。	`.agents/prompts/poc-worker.md`
Reviewer	仕様準拠、セキュリティ、品質、抜け漏れを確認。	`.agents/prompts/spec-reviewer.md`, `security-reviewer.md`

テンプレートは docs/research/task-intake-template.md にあります。

ファイル	役割
`.codex/config.toml`	薄い機械的デフォルト。重要パス、言語、オーケストレーション方針、チェックスクリプト。
`AGENTS.md`	全AIが守るプロジェクト方針。
`.agents/orchestration-model.md`	親エージェントとサブエージェントの責任分界。
`.agents/prompts/`	サブエージェントへ渡す標準プロンプト。
`.agents/workflows/`	リサーチ、検証、競合調査、POC、ドキュメント更新の手順。
`.codex/skills/`	再利用可能な作業スキル。

設定、エージェント構造、プロンプト、ワークフローを変えたら、同じ作業内で人間向けHTMLとLLM向けMarkdownを更新します。基本チェックは node scripts/check-docs-updated.mjs で実行できます。

Git repoとして使う場合は git config core.hooksPath .githooks でpre-commitチェックを有効化できます。

次に読む AI Research OSでプロジェクト設定全体を見る