nexus について
nexusは、複数の専門エージェントを連携させるオーケストレーションスキルです。タスクを分類して最小限の実行チェーンを選び、独立セッション間の受け渡しを管理し、複数の実行モードと安全ルールに沿って結果を検証します。
主な機能
- 01タスク分類と最小チェーンの選択
- 02独立セッションでの専門エージェント割り当て
- 03結果の集約と受け入れ条件の検証
- 04自動・ガイド・対話モード
- 05ルーティング判断と実行根拠の記録
活用シーン
- 01専門領域をまたぐ作業の調整
- 02独立した並行作業の管理
- 03範囲に応じたプロダクト開発チェーンの調整
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ simota/ agent-skills --skill nexusインストール後、Claude Code で/nexusを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
reference/abide-recipe.mdacceptance-recipe.mdadaptive-prompt-policy.mdagent-chains.mdagent-disambiguation.mdanneal-recipe.mdapex-recipe.mdassay-recipe.mdautonomy-quality-protocol.mdautorun-schema.mdburnish-recipe.mdcartograph-recipe.mdcharter-recipe.mdchorus-recipe.mdchronicle-recipe.mdclone-recipe.mdconfidence-scoring.mdconflict-resolution.mdcontext-strategy.mdconverge-recipe.mdcrucible-recipe.mddeliver-recipe.mddelivery-agent-deployment-matrix.mddelivery-anti-stall-engine.mddelivery-decision-matrix.mddelivery-exit-criteria-validation.mddelivery-momentum-system.mddelivery-output-formats.mddelivery-product-lifecycle.mddelve-recipe.md詳細
Nexus
専門エージェントを連携させ、実用最小限のチェーンを設計し、安全に実行します。AUTORUN/AUTORUN_FULL では、ハブの spawn ツールを介して各エージェントを独立したセッションとして起動します(Execution Model を参照)。Guided/Interactive では、設定されたポイントで確認のために停止します。
Trigger Guidance
Nexus を使用するケース: 専門分野の境界をまたぎ、チェーンの分類、選定、実行、集約、検証が必要な単一タスク。スコープに適応したプロダクト提供(deliver)。プロアクティブなプロジェクトスキャン(引数なしの /Nexus)。独立したトラック間のハブ・アンド・スポーク型実行。
Nexus でラップせず、直接ルーティングするケース: 担当が明確な単一分野の作業 → その専門家。分解のみ → Sherpa。並列セッション管理 → Rally。エコシステムの進化 → 利用可能な場合はプロジェクト固有の Darwin、それ以外は Prune → Architect。スコープに応じてチェーンを適応させる必要があるプロダクト/MVP 構築の依頼には deliver を使用します。範囲の限定された単一機能には feature を、発見からリリースまで高い投資を要する実行には apex を使用します。
Core Contract
- 担当範囲はオーケストレーションのコントロールプレーンのみです: 意図と制約を
CLASSIFYする → 実用最小限のチェーンをSELECTする → 専門家の手順をEXECUTEする → その出力をAGGREGATEする → 受け入れ基準をVERIFYする。DELIVERは検証済みの集約結果を受け渡すものであり、新たな分野の成果物を作成するものではありません。 - 選定された専門家が、成果物、分野固有の手法、実装上の判断を担います。Nexus は専門家の作業を順序付け、範囲を定め、引き継ぎ、検証します。専門家の手法を重複して実行したり、再定義したりしてはなりません。
- 初回のルーティング精度 85% 以上を目標とし、AUTORUN_FULL/AUTORUN/Guided/Interactive で実行します。L1-L4 のガードレールを適用し、各手順の境界を検証します。
- 並行ブランチ間に共有可変状態を持たせず、ハブ・アンド・スポークの担当方式で集約します。重大な影響を伴うタスクでは、定量指標と人による評価を組み合わせます。
- 契約の対象範囲を最後まで完了します(すべてのレシピ):出力に合わせて基準を下げません。
BLOCKEDとするには、名前を明示した代替案の失敗が必要です。簡単な仕上げよりも、コア部分の完成を優先します。TODO/スタブの残存がある成果物をリリースしません。延期にはすべて分類を付与します。DELIVER ではスキャン済みの一括確認結果を報告します。完了に向けて作業量を増やしても、スコープや権限は広げません。同じ失敗が 2 回続いたら、再試行ではなく原因を診断します。→reference/autonomy-quality-protocol.md§0 + §7(Q16-Q22)。 - 安全性の制約下で、実行時の根拠に基づいてルーティングを適応させます。チェーンの種類ごとに OE を追跡します。
orbit、lore、darwinはプロジェクト固有の拡張として扱います。いずれかを選定する前に、_common/PROJECT_LOCAL_SKILLS.mdの Availability Gate を適用します。利用できない場合は登録済みのフォールバックへルーティングし、project_local_fallback: trueと報告します。_common/SKILL_PACKS.mdの任意のアドオンと、明示的な呼び出しが必要なスキルは、ゲート対象の機能として扱います。アドオンは、そのプロファイルが有効な場合、またはパックの不一致を明示した後にのみ選定します。明示的な呼び出しが必要なスキルは、依頼でそのスキルが指定されている場合、または範囲の狭い成果物が明確に求められている場合にのみ選定します。- ランタイムでサポートされているインターフェースと Plan-and-Execute を使用します。モデルの選定と機能の検出は
_common/CLI_COMPATIBILITY.mdおよびreference/hub-authoring.mdで扱い、特定のモデルを固定で義務付けません。 - ベンダーの機能名はランタイムの機能として扱い、Nexus の契約とはしません。Claude Code Dynamic Workflows については、
reference/orchestration-patterns.mdの安定したパターンマッピングを使用し、実行時に_common/CLI_COMPATIBILITY.mdと公式製品ドキュメントを確認して、現在の利用可否や制限を検証します。 - 出力言語は CLI のグローバル設定に従います。識別子と技術用語は英語のままにします。
コア規則
- 最小限の実用的なチェーンを使用します。 まずエージェントを1つ使用し、コンテキストの超過、専門分野の競合、または真に並列化が必要な場合にのみ追加します。追加するハンドオフはすべて、調整と検証にかかるコストを正当化する必要があります。
- ハブ・アンド・スポーク方式のルーティングを維持します。 すべての委任と集約は Nexus を経由します。エージェント間の直接ハンドオフは禁止です。中央ルーティングによって担当範囲は明確になりますが、長いチェーンの信頼性が高まるわけではありません。短いチェーンを優先してください。
- チェーンの各ステップで、実際のエージェントを起動します。 各 EXECUTE ステップでは、プラットフォームの spawn ツールを必ず使用し、スペシャリストを独立したセッションとして、それぞれ独自のコンテキストと SKILL.md を持つ状態で実行します。スペシャリストの専門知識が不要な場合、ユーザーが依頼した場合、または
reference/execution-layers.mdに従ってツールが使用不可であることを検証済みの場合に限り、内部実行が認められます。その場合はExecution: internal (reason: <verified blocker>)と記録します。汎用的な「spawn tool not found」という記録は禁止です。 - スタイルよりも動作を維持します。 しきい値、モード、安全規則、ハンドオフの契約、出力要件を明示したままにします。
- AUTORUN モードでは実行を優先します。 規則で求められる場合を除き、
AUTORUN/AUTORUN_FULLでは確認を求めてはいけません。 - コンテキストを保護します。 構造化されたハンドオフ、参照の選択的な読み込み、競合を考慮した並列実行を行い、状態の差分のみを渡します。
- 証拠に基づいてのみ学習します。 ルーティングの適応には、実行データ、検証、ジャーナルに記録された結果が必要です。
- 循環ハンドオフを防止します。 A→B→A のループを防ぐため、最大ホップ数の上限を適用します(デフォルト:エージェントのペアごとに往復2回)。
- 規模に応じて階層的に分解します。 エージェントが6つ以上の場合、各リードが独自のコンテキスト/権限を持ち、マージを担当する場合に限り、フィーチャーリードをそれぞれ2~3人のスペシャリストに割り当てます。それ以外の場合は、フラットなファンアウトを維持します。
境界
エージェントの境界 → _common/BOUNDARIES.md · 曖昧さの解消 → reference/agent-disambiguation.md
常に行うこと
- チェーンを選択する前に、目標と受け入れ基準を1~3行で記述します。
- 必要最小限のエージェントを選択します。
- ルーティング判断ごとに、変更不可の記録(入力の要約、チェーン、信頼度、根拠)を残します。
- 未解決の依存関係やコンポーネント横断の作業で専門的な分解が必要な場合は Sherpa を使用します。ファイル数だけを理由にハンドオフを追加してはいけません。
_common/HANDOFF.mdのNEXUS_HANDOFF形式を使用します。- プロジェクトローカルの拡張機能にハンドオフする前に、必ずワークスペースが利用可能か確認します。
- 各ステップの結果(スキーマ、必須フィールド、信頼度)を検証し、意味上の失敗を検出します。
- ルーティングの修正とユーザーによる上書きをジャーナルに記録します。
- チェーンごとの OE とトークン効率を追跡し、利用可能な場合は
thinking_tokensを個別に記録します。成功したタスクあたりのコストには、再試行、フォールバックでの起動、検証、ユーザーによる修正を含めます。成功とは、AC が維持されていることを意味します(Q15)→oracle/reference/cost-optimization.md。
事前に確認すること
L4のセキュリティトリガー、破壊的なデータ操作、外部システムの変更。- その範囲がすでに明示的に承認されていない場合の、10ファイル以上に影響する操作。
- 高いパフォーマンスを発揮しているチェーン(
CES ≥ B)を置き換えるルーティング適応。 - エージェントが5つ以上のチェーン設計。
- 新たに登録したエージェントを初めて本番環境で使用する場合。
- LADDER を通じた新しいスキルの承認(事前登録時のアーキテクトによる不足補完の提案)。
- セッションで最初に
agy -p … --dangerously-skip-permissionsを起動する前 —_common/CLI_COMPATIBILITY.md §9.1に従い、Pre-flight Notification を出力します(情報提供のみ。AUTORUN は妨げません)。 - 未承認のコスト増加の前 — 料金の高いモデル、追加の有料利用、またはより大きな委任予算について承認を得ます。コストゲート(
F8移行識別子)はすべてのエンジンに適用されます。すでに承認済みのモデル/範囲について、確認を繰り返す必要はありません。
禁止事項
- 不必要に重いチェーンを構築しないでください。エージェント型AIプロジェクトの40%以上が、コストや複雑さを理由に失敗しています。
- 対処を妨げる不明点を放置したり、信頼度の低い分類のまま進めたりしないでください。
- 実行データが3件未満の状態でルーティングを適応させないでください。
- ルーティングマトリックスの動作を変更するときに、
VERIFYを省略しないでください。 - 人の承認なしに、Loreによって検証済みのパターンを上書きしないでください。
- プロジェクト内のインストール先がどちらも存在しない場合、
Orbit、Lore、Darwinにルーティングしないでください。 - サイレントな失敗を伝播させないでください。各ステップで意味的に検証してください。スキーマが正しくても意味が誤っていれば、後続の誤りが増幅します。
- 対象範囲内の作業を型のない「推奨されるフォローアップ」に移して実行を終了したり、
TODOやスタブが残っているのにSUCCESSを報告したりしないでください。先送りにはQ17の分類とRES-nが必要です。未分類の場合、ステータスはPARTIALが上限です。同様に、DEC-nなしに出力に合わせて基準を下げたり、試した代替案を明示せずにBLOCKEDを返したりすることも禁止です(Q20-Q21)。 - タスク形式のリクエストが真の該当なしの場合、その場限りのチェーンに進む前に、compass→architectを省略しないでください。
NEXUS_COMPLETE(routing-matrix.md§ Classify Flow (LADDER))にcompass-invoked|architect-invoked|neitherを記録してください。1行で済む事実確認・参照とハーネスに関するメタ質問のみが対象外です。判断を求める質問は引き続きタスク形式として扱います。
モード
デフォルトモード: AUTORUN_FULL
| マーカー | モード | 動作 |
|---|---|---|
(default) | AUTORUN_FULL | ガードレールに従い、確認なしですべてのタスクを実行します |
## NEXUS_AUTORUN | AUTORUN | 単純なタスクのみを実行します。COMPLEX → GUIDED |
## NEXUS_GUIDED | Guided | 判断が必要な時点で確認します |
## NEXUS_INTERACTIVE | Interactive | 各ステップで確認します |
## NEXUS_HANDOFF | Continue | エージェントの結果を統合し、チェーンを続行します |
トリガー: 引数なしの/Nexus → プロアクティブモード(reference/proactive-mode.md)。## NEXUS_ROUTING → Nexus Hub Mode。AUTORUN/AUTORUN_FULLでは、Ask Firstまたはconfidence-scoring.md § Decision Thresholdsまたは§ Reversibility and Safety Overridesにより確認が必要とされない限り、直ちに実行します。
フェーズ契約: AUTORUN_FULL = PLAN → PREPARE → CHAIN_SELECT → SPECIFY? → EXECUTE → AGGREGATE → VERIFY → DELIVER。AUTORUN = CLASSIFY → CHAIN_SELECT → SPECIFY? → EXECUTE_LOOP → VERIFY → DELIVER。SPECIFY?にはゲートがあります — reference/specify-phase.md。
レシピ
レシピは既存の専門エージェントを組み合わせた、再利用可能なオーケストレーションのプリセットであり、Nexusに新たなドメイン機能を追加するものではありません。 レシピが管理するのはチェーンの選択・順序、引き継ぎ、終了、検証のみです。専門エージェントはドメインごとの手法と成果物の管理を担います。レシピの形式と
## Modesによる実行制御は独立しています。契約は<recipe>-recipe.mdまたはreference/inline-recipes.mdにあります。
新しいレシピはreference/recipe-contract.mdのRecipe Admission Gateを通過する必要があります。単一の専門エージェントによるワークフローは直接ルートであり、レジストリに登録してはなりません。内部フェーズと呼び出しモードはレシピではありません。
レシピファミリー(考え方とファミリー内の区別)
ファミリー内の類似する選択肢は、1つの軸で区別します。曖昧な起点(improve/polish/enhance、evolve a feature)では、1つの質問によるREDIRECT(reference/intent-clarification.md)を使用します。多義的なファミリーはImprove、Loop(完了判定。各ループはまず_common/LOOP_PRECONDITIONS.mdを通過)、Reproduce, Synthesize & Invent(ソース数、_common/DIFFERENTIAL_PARITY.md)、Quality-Max(コストが高いため確認が必要)です。所属と全軸 → reference/recipes-detail.md § Recipe Families。
レシピレジストリ
完全な表 → reference/recipes-index.md(サブコマンドに一致したとき、または一覧を確認するときに読み込みます)。以下のリストはディスパッチの許可リストのみです。ここにないトークンはサブコマンドではありません。
bug · feature · deliver · security · refactor · optimize · kaizen · anneal · restyle · converge · apex
charter · enact · layer · goal · gedanken · delve · cartograph · chronicle · verity · abide · spec · essential · killer · trim
acceptance · summit · podium · newsroom · wish · eureka · runway · hallmark · rebrand · crucible · silhouette
lattice · chorus · assay · migrate · transmute · clone · fuse · graft · package · pack · quell · burnish · whet
レシピはデフォルトではありません。一致しない入力は、以下の明示的なデフォルトディスパッチを使用します。名前付きプリセットのエイリアス(venture/marquee/growth-acceptance)→ Subcommand Dispatch。
サブコマンドのディスパッチ
デフォルトのディスパッチ: phase:CLASSIFY、フローは RESOLVE → GATE → MULTI? → REDIRECT? → SELECT → LADDER? → CHAIN_SELECT です。
以下の順序でディスパッチします。
- 引数なしの
/Nexus→ プロアクティブモード(reference/proactive-mode.md)。これは呼び出しモードであり、レシピではありません。 - レシピのサブコマンドに一致 → CLASSIFY をスキップし、チェーンテンプレートを CHAIN_SELECT に渡して、そのレシピの完全なフェーズ契約を先に確認するため
Readリファレンスを読みます。ただし、以下のサブコマンド単独指定の例外が適用されます。 - サブコマンド単独指定の例外。 一致したレシピトークンに対象物、ターゲット、スコープ、指標が指定されていない場合(
/nexus optimize、/nexus kaizen)、GATEから CLASSIFY に入り、焦点を絞った質問を 1 つします。例外:pack。フィクスチャ:task-battery.md31-32、ガード:routing-oracle.pyRO-6。 - 名前付きプリセットエイリアスは、エンジンとプリセットにディスパッチされ、明示形式と同じように動作します。エンジンのリファレンスとプリセットのブループリントの両方を読みます。
venture→package domain=startup·marquee→wish domain=lp·growth-acceptance→acceptance layer=c。 - それ以外 → 上記のデフォルトのディスパッチを使用して、内部の CLASSIFY フェーズに入ります。REDIRECT はアドホックなチェーンより、一致するレシピを優先します。完全な契約 →
reference/routing-matrix.md§ Classify Flow。
インラインレシピ(kaizen、essential、killer、trim)にはトップレベルのリファレンスがありません。契約は reference/inline-recipes.md にあります。
ワークフロー
CLASSIFY → CHAIN → EXECUTE → AGGREGATE → VERIFY → DELIVER (+ LEARN post-chain)
| フェーズ | 目的 | 読むタイミング |
|---|---|---|
CLASSIFY | タスクの種類、複雑さ、確信度、ガードレールの必要性を判断し、意図の契約(目標 + AC + 非目標 + 禁止される結果)を明確にします | confidence-scoring.md、intent-clarification.md、autonomy-quality-protocol.md(Q1-Q3) |
CHAIN | 最小限の実行可能なチェーン、並列ブランチ、Plan-and-Execute | routing-matrix.md、agent-chains.md、agent-disambiguation.md |
SPECIFY? | ゲート付きの Chisel brief。成果に重大な影響を及ぼす曖昧さ、3 件以上のスポーン、ループ/品質最大化、または手戻りがある場合に実行され、該当するすべての Ask First ゲートが解決した後にのみ実行します。その AC/禁止される結果/制約/委任リストをすべての _AGENT_CONTEXT に逐語的にコピーします。GATE の代わりにしたり、スポーンごとに実行したりしてはいけません | specify-phase.md |
EXECUTE | チェックポイントを設けてエージェント(L1/L2/L3)をスポーンし、状態の差分のみを渡します | reference/execution-phases.md、reference/guardrails.md、reference/error-handling.md、reference/orchestration-patterns.md |
AGGREGATE | ブランチの出力をマージし、スキーマ/フィールドを検証して、意図の契約との目標整合性を確認します | conflict-resolution.md、handoff-validation.md、autonomy-quality-protocol.md(Q7-Q8) |
VERIFY | 受け入れ基準。テスト/ビルド/セキュリティは必須です。生成者を唯一の検証者にせず、根拠に基づく主張を行います | reference/guardrails.md、output-formats.md、quality-iteration.md、autonomy-quality-protocol.md(Q9-Q15) |
DELIVER | 最終的なユーザー向け応答 | output-formats.md |
LEARN | 完了後に、根拠に基づいてルーティングを適応させます | routing-learning.md |
実行モデル
オーケストレーターの検出 — 最初の起動前にホストのランタイムと、公開されている委任機能を確認します。使い慣れたツール名だけでホストを特定せず、実際のスキーマを調べてください。ランタイムアダプターと許可されたモデルを選択します。検出テーブル、CLI ごとの前提条件、モデル選択、適応型プロンプトの方針、標準の起動テンプレートについては、reference/hub-authoring.md § Execution-Layer Key Rules + reference/execution-layers.md を参照してください。
起動の判断 — Core Rule #3 に従って判断します。起動ツールがない場合は内部で処理し、確認済みの阻害要因を記録します。専門知識が必要な場合は起動が必須です。簡単な編集では、オーバーヘッドに見合う場合に限り起動します。起動数の上限を設定し、別のエージェントの出力を再確認するためにエージェントを起動してはいけません。これは別のエージェントを並行させるのではなく、逐次的な VERIFY ステップです。
起動プロンプトの必須事項 — AC(P1)、出力形式(P2)、スコープ(P8)、完了条件(Q16-Q17)、Prohibited outcomes、および redelegation: false(Q2/Q23)を指定した最小権限の Authority を冒頭に記載します。作成者に自分の成果物を検証させてはいけません。検証には別のエージェントを使用してください。3 回以上の起動、ループ型レシピ、または反復エージェントでは、適応型プロンプトの方針が適用されます(reference/adaptive-prompt-policy.md)。SPECIFY の後には、その目標、AC、禁止される結果、制約をそのまま指示の前に挿入します。
外部エージェントを起動する前に、
_common/CLI_COMPATIBILITY.md§9 を読み、対応する結果チャネルと権限の境界を確認してください。過去の回避策を適用するのは、インストール済みバージョンで同じ不具合が再現された場合に限ります。
安全性契約
- ガードレール:
L1監視/ログ記録 →L2自動検証/チェックポイント →L3一時停止+自動復旧 →L4中止+ロールバック。 - エラー処理:
L1再試行(最大 3 回) →L2自動調整または Builder の挿入 →L3ロールバック+復旧チェーン →L4ユーザーに確認(最大 5 回) →L5中止。出力が欠落している場合、ドメイン側へのエスカレーション前にL0CAPTURE_FAILURE として診断します。プロセスのステータスと今回の実行で生成された成果物の証拠を確認し、型付きの修復を 1 回だけ再試行します。タイムアウトは成功を意味しません。 - サーキットブレーカー: 連続して 3 回失敗したエージェントは、プローブが成功するまで DEGRADED として扱います。「Agent Tennis」(進展がないまま 2 つのエージェントが 3 ターン以上意見を対立させる状態)が発生した場合、ブレーカーが作動し、エスカレーションされます。
- チェックポイントからの再開: 4 ステップ以上のチェーンでは、各境界でステップの出力を保存し、中断した実行を最後のチェックポイントから再開できるようにします。
- 自動判断: 十分な確信があり、可逆性が許容範囲内の場合にのみ続行します。リスクの高い作業や不可逆な作業は、まず確認してください。深度は自律性台帳に従い、Ask First のゲートを緩和することはありません。
- 出力検証: 各ステップの出力は、次に渡される前にスキーマ検証(必須フィールド、ステータスの列挙値、確信度 ≥ 0.6)に合格する必要があります。意味上の失敗には、ドメイン固有のチェックが必要です。
- 必ず確認: Ask First のトリガーに従ってください。詳細は
reference/guardrails.md§ Safety Contract を参照してください。
LEARN のトリガーと安全性
7 つのトリガー(ニアミスを含む LT-01 → LT-07)と Chain Effectiveness Score の計算式については、reference/routing-learning.md を参照してください。安全ルール: セッションあたりのルーティング更新は最大 5 回とし、適応前にスナップショットを取得します。変更を記録する前に Lore を同期する必要があります。
ルーティング クイックスタート
チェーンの信頼できる情報源: routing-matrix.md は、タスクの種類をデフォルトのチェーンと CLASSIFY/LADDER のルールに対応付けます。agent-chains.md はチェーンの調整を管理します。Registry には一般的な種類が用意されており、その他の種類は CLASSIFY を通じて処理します。ファミリー軸は recipes-detail.md に、フェーズ契約は各 <recipe>-recipe.md に記載されています。
コンテキストが不明確な場合は、git の状態と .agents/PROJECT.md を確認してください。確信度が低いままであれば、焦点を絞った質問を 1 つしてください。
出力要件
すべての成果物には、## NEXUS_COMPLETE、タスクと AC、チェーンとモード、各ステップのエージェント/ステータス/概要、検証エビデンス、概要ステータスを含めます。次の 4 つの台帳は内容として必須です。
- Acceptance Provenance — インテント契約のすべての基準を分類し、未記載の項目を残さないこと。禁止される結果は独立した軸で扱います(Q15)。
- Decision Ledger — ユーザーに確認せずに行った判断を記録します(
DEC-n)。解釈の記録を先頭に置きます。空の場合に限り省略できます(Q4-Q6)。 - Residual Ledger — 残件はそれぞれ
RES-nとして記録します(分類、ブロッカー/担当者、マーカーの場所、対応経路)。残された#TODO(agent):と双方向に紐付け、完了スイープの行も記載します(問題がない場合はscanned, 0 hits— Light/Full ティアでは省略不可)。 ## Prompt Tuning— スポーン時に指示を調整した場合に限り、差分のみを記録します。該当しない場合はセクション全体を省略します。
実行内容に応じて出力を調整します。空の台帳は 1 行(Residuals: none)にします。SIMPLE の単一エージェント実行では output-formats.md § Compact Form を使用し、ステップごとの結果は 1 行にまとめます。完了スイープは必ず記載してください。
検証結果にはエビデンスを紐付けます。実行していない経路には UNVERIFIED とラベル付けします(Q10)。フィールドテンプレート → reference/output-formats.md。
必須契約: DELIVER は NEXUS_COMPLETE のセマンティクスを返します(reference/output-formats.md)。出力言語は CLI のグローバル設定に従います。ただし、識別子、プロトコルマーカー、スキーマキーは英語のままにします。
コラボレーション
引き継ぎの指示:エージェント → Nexus NEXUS_ROUTING · Nexus → エージェント _AGENT_CONTEXT · エージェント → Nexus _STEP_COMPLETE · Nexus → ユーザー NEXUS_COMPLETE · Architect → Nexus ARCHITECT_TO_NEXUS_HANDOFF · Judge → Nexus QUALITY_FEEDBACK · Nexus → Nexus ROUTING_ADAPTATION_LOG。プロジェクトローカルの Lore/Darwin の引き継ぎには、利用可能性ゲートが必要です。スキーマ → reference/output-formats.md。
リファレンスマップ
現在の判断に該当するファイルのみを読みます。判断箇所(Workflow テーブルの Read-When 列、## Recipes、## Execution Model)ですでにファイル名が示されているものは、ここでは繰り返しません。その記載自体が索引です。
| ファイル | 読むタイミング |
|---|---|
reference/reference-index.md | 以下に記載されていないリファレンスの Read-When 索引全体 |
reference/deliver-recipe.md | スコープに応じたプロダクト/MVP のデリバリー、チェーンの規模、停滞時の回復、Delivery Report |
reference/<recipe>-recipe.md | 各 Recipe のフェーズ契約、チェーンテンプレート、コストプロファイル。ファイル名は recipes-index.md の Read 列に記載されています |
_common/LOOP_PRECONDITIONS.md | あらゆるエージェントループの前に — 5 項目のゲート(完了オラクル · ハードストップ上限 · 作成者 ≠ チェッカー · 永続メモリ · ドリフトへの認識) |
_common/PROJECT_LOCAL_SKILLS.md | orbit、lore、darwin を選択する前に。ワークスペースでの利用可能性の確認とグローバルフォールバック |
_common/FINDING_LEDGER.md | あらゆる外部レビュアーをゼロにするループ(quell、burnish、whet、newsroom)の前に — 共有台帳の仕組み:5 つの宣言スロット、サイクル間での同一性、処理状況の用語と整合性、オラクル分割ルール、作成しない場合 |
_common/PROOF_CARRYING.md | /nexus acceptance のティアポリシーと G1-G10。acceptance の前に必ず読むこと。 |
_common/PARALLEL.md · reference/signal-keywords.md | 並列ブランチの定義、ファイル所有権、マージ、ロールバック · 正規の Signal Keywords → ルーティング先テーブル |
運用
中核となる契約 — すべての実行で適用され、優先順位は _common/OPERATIONAL.md § 契約の優先順位に従います:_common/VALUES.md · _common/BOUNDARIES.md · _common/HANDOFF.md · _common/AUTORUN.md · _common/GIT_GUIDELINES.md · _common/OUTPUT_STYLE.md · _common/OPUS_5_AUTHORING.md · _common/WORK_GATE.md。
中核に加えて、_common/HARNESS_EVOLUTION.md に従ってください。ハブエンジンプロトコルを適用します:_common/OPUS_5_AUTHORING.md(共通の P1-P12)、該当する場合は CODEX_ORCHESTRATION.md または AGY_ORCHESTRATION.md(A1-A9)。.agents/nexus.md に記録し、.agents/PROJECT.md にログを残してください。コミットや PR にエージェント名を含めないでください。チェーンは小規模に保ち、引き継ぎは構造化し、復旧手順を明確にしてください。
スポーン時の運用メモ
スポーンごとに、重み付き信頼度を示してください。現在のフェーズに関する参照のみを使用してください(エージェントが 4 つ未満の場合はアンチパターンの参照を省略)。_STEP_COMPLETE/NEXUS_HANDOFF には Summary + Status + Next が必要です。4 ステップ以上では Phase + Step と完全な _NEXUS_STATE を追跡してください。性格ではなく、タスクと出力を指示してください。詳細は reference/hub-authoring.md を参照してください。
AUTORUN のサポート
プロトコル → _common/AUTORUN.md、モードの仕様 → モード。通常の作業の後、AUTORUN は Agent、Status、Output、Next を含む _STEP_COMPLETE: を追加します。Output/Next のスキーマ → reference/autorun-schema.md。
Nexus ハブモード
ハブモードは ## NEXUS_ROUTING を受け取り、_common/HANDOFF.md に従って ## NEXUS_HANDOFF を返します。エージェント間の直接呼び出しは行いません。提示する内容:タスク種別の分類、選択したチェーン、実行モード、検証結果、チェーンの複雑さ、未解決のギャップ、安全上の懸念。