分析 Playbook の追加

Institution Mode、Roundtable テンプレート、Deep Research を焦点の定まった分析枠組みで拡張する

Minara は 2026 年 5 月に独立した Scenario Registry を廃止しました。SCENARIO_* 定義ファイル、シナリオカタログ、SCENARIO_LEARNING フラグを追加しないでください。ユーザー意図のルーティングはスキルが担当し、残った分析 Playbook は Institution Mode と Deep Research が直接利用します。

適切な拡張面を選ぶ

目的	拡張ポイント
一群のユーザー要求を既存ツールへ振り分ける	組み込みスキル
Institution の役割へ再利用可能な分析枠組みを与える	`apps/agent/src/tools/institution/playbooks/index.ts`
組み込み Agent、フェーズ、Roundtable テンプレートを加える	`apps/agent/src/tools/institution/builder-templates.ts`
Deep Research の収集と統合の指針を加える	`apps/agent/src/skills/builtin/deep-research/references/scenarios.md`
一人の利用者が独自のマルチ Agent 流れを組む	Roundtable Builder を使い、ソースは変更しない

Institution Playbook を追加する

Institution Playbook は一つ以上の役割に分析内容を与えます。institution.playbook.stock_quality のような安定した名前空間付き ID を使い、INSTITUTION_PLAYBOOKS に追加します。

"institution.playbook.stock_quality": {
  id: "institution.playbook.stock_quality",
  description: "Evaluate earnings quality, reinvestment, and balance-sheet resilience.",
  body: `1. Verify the latest filing period and data freshness.
2. Compare cash conversion, margins, and invested-capital returns.
3. Identify the strongest disconfirming evidence.
4. State the conditions that would invalidate the conclusion.`,
},

本文だけで意味が通るように書いてください。必要な証拠、反対証拠が結論をどう変えるか、ライブデータがない場合の動作を明示します。システムプロンプトにある共通の安全、引用、言語規則は重複させません。

組み込み役割が既定で使う場合だけ、apps/agent/src/tools/institution/roles.ts で ID を割り当てます。資産クラス固有の対応は playbookIdsForRole() に置きます。テストは参照されたすべての ID が解決できることを確認します。

調整可能な値には、安全な既定値を持つメソドロジーのプレースホルダーを使います。

Treat beta above `{{methodology:stock_beta_high_corr_threshold|default:0.8}}`
as market-sensitive.

再利用する投資ルールを長い Playbook に埋め込まないでください。メソドロジーシステムへ移し、プレースホルダーまたは methodology_lookup から参照します。

組み込み Roundtable テンプレートを追加する

Roundtable Builder は context、parallel、debate、synthesis、final の五種類のフェーズを扱います。組み込み Agent、フェーズ、Roundtable 全体のテンプレートは builder-templates.ts にあり、共有型は @minara/types から取得します。

バリデータは次を保証します。

パイプライン全体でフェーズ ID と Agent ID が重複しない。
debate フェーズには二つ以上の Agent がいる。
synthesis と final には管理者が一人だけいる。
final フェーズは一つだけで、最後に置かれる。
反復、ツール呼び出し、タイムアウト、出力 Token が宣言範囲内に収まる。

テンプレート変更では Agent テストと Web UI Builder テストを更新します。利用者が作るテンプレートは Builder Store に保存されるため、ソース管理へ追加しません。

Deep Research を拡張する

Deep Research の外側の六段階契約は deep-research/SKILL.md にあります。トピック固有の収集と分析の指針は references/scenarios.md へ追加します。情報源の選択、証拠の質、比較方法、最終統合の形に集中してください。

新しい能力が必要なら、先にツールを追加してテストし、スキルの tool_names へ公開してから参照文書を更新します。情報源や認証情報が使えない場合、Playbook はその制限を明示して縮退しなければなりません。

貢献を検証する

pnpm --filter @minara/agent exec vitest run tests/unit/tools/institution.test.ts
pnpm --filter @minara/agent exec vitest run tests/unit/tools/institution-builder.test.ts
pnpm --filter @minara/agent typecheck

Deep Research を変更した場合は、対応するスキルとレポートフローのテストも実行します。公開動作が変わる場合は、Institution Mode または Deep Research の文書を四言語で更新してください。