fable-council

Fable Council

アーキテクチャ計画を確定する前に、AI コーディングエージェントの評議会を招集します。提案 → インストール済みの各エージェント CLI から独立した評価を受ける → 修正する、というプロセスを、上限を定めた複数の審議ラウンドにわたって繰り返します。

目的

複雑な計画について、複数エージェントによる審議とモデル間の合意形成を確実にします。補完し合うモデル（Claude、Codex、Cursor、Gemini、Grok、OpenCode）を活用し、見落としを検出し、誤った前提に異議を唱え、堅牢なエンジニアリング計画へと収束させます。

使用する場合

• 重大な影響を及ぼすアーキテクチャ変更、大規模なリファクタリング、または移行を計画するとき。
• ユーザーが評議会の招集やセカンドオピニオンの取得を求めたとき（「評議会に尋ねる」「ほかのエージェントに相談する」など）。
• 複数の実装戦略を比較検討するとき。

使用しない場合

• 単一ファイル内に収まる小規模なバグ修正や定型的な実装タスクの場合（fable-execute または fable-tdd を使用してください）。
• ローカルシステムにほかのエージェント CLI がインストールされていない場合（代わりに単独で fable-plan を使用してください）。
• 実装後の差分検証やコードレビューの場合（fable-review または fable-judge を使用してください）。

入力

• draft_plan：リードエージェントによる初期のアーキテクチャ提案。
• member_clis：ホストマシン上で検出された、またはユーザーが指定したエージェント CLI バイナリのリスト。
• rounds_count：要求された審議ラウンド数（デフォルト：1）。

期待される出力

• counciled_plan：複数エージェントからの批評を通じて改善された、最終的な統合計画。
• deliberation_transcript：メンバーからの批評、採用した変更、却下した論拠を記録した構造化された会話記録。

手順

1. リクエストを解析する：中心となるタスク、要求された審議ラウンド数（X）、ホスト側のリードランタイム（SELF）を特定します。
2. メンバーを検出する：PATH 上で利用可能な CLI（claude、codex、cursor-agent、gemini、grok、opencode）を調査し、SELF は除外します。
3. セッションを初期化する：~/.council/<timestamp>-<slug> を作成し、タスクの原文を task.md に、初期計画を plan-v1.md に保存します。
4. 審議ループ（1..X）：
   • 厳格な読み取り専用実行フラグを指定して、メンバーごとのプロンプトを生成します。
   • タイムアウトを約300秒に設定し、すべてのメンバーをバックグラウンドプロセスで並行して起動します。
   • メンバーの応答を収集して解析します。
   • 計画を修正します。有効な批評を採用し、問題のある提案は明確な技術的根拠を示して却下します。
   • plan-v(R+1).md と changes-v(R+1).md を作成します。
5. 最終回答を整える：審議の会話を提示し、その後に確定した合意計画を示します。

判断ルール

• 評議会の実行中、リードエージェントは変更を実装しません。計画と審議のみを行います。
• 評議会のメンバーは読み取り専用モード（--mode plan、-s read-only、--skip-trust）で起動します。
• すべてのメンバーの提案は、モデルの権威ではなく技術的な妥当性に基づいて評価します。
• 具体的な技術的根拠がある場合は、当初の立場を維持してもかまいません。

ツールのポリシー

• 非対話型フラグを使用して、メンバーの CLI バイナリを並行して実行します。
• 厳格なタイムアウトを設定します（たとえば、macOS では Perl のアラームやプロセスマネージャーを使用します）。
• Grok などのヘッドレスモデルには、許可されていないツール使用による停滞を防ぐため、システムプロンプトの上書きを渡します。

エビデンス要件

• 審議セッションの成果物を ~/.council/ 以下に保存します。
• 採用した提案と却下した提案について、逐語的な引用と根拠を記録します。

障害への対応

• メンバーの CLI がタイムアウトしたりエラーになったりした場合は、その内容を記録し、ラウンドを妨げることなく続行します。
• マシン上にほかのエージェント CLI が存在しない場合は、評議会を経ていない単独の計画であることを明示します。

完了条件

• デッドロックすることなく、X 回の審議ラウンドをすべて完了していること。
• 審議記録と最終的な統合計画を明確に提示していること。
• 実行を開始する前に、人間の承認を得られる状態で成果物が整っていること。