Council — 多視点分析 は何をしますか?
コードベース、プロジェクト、ドキュメントを客観的かつ公平に評価する多視点分析フレームワークです。複数の視点とデバイアス技法を用いて、既存コードに固執する傾向を克服します。
解決する問題
AIツール(そして人間も)は既存コードに固執しがちです。現状を見て、「あるべき姿」を想像するのに苦労します。検証ではなく探索を怠ります。Councilは以下を使用します:
- デバイアス技法 — 新鮮な思考を強制する方法
- 複数の視点 — 異なるメンタルモデルが異なる問題を捉える
- 構造化された統合 — 意見の相違を追跡しながら洞察を統合
使用すべきタイミング
- 現在のアプローチが最適か評価する場合
- 既存実装の代替案を探る場合
- プロジェクトの隠れた前提を特定する場合
- 重要な決断の前に客観的なフィードバックを得る場合
- 局所最適で行き詰まった場合
- 「もっと良い方法があるはずだが、見えない」と感じる場合
- AIツールが既存のパターンを繰り返し返す場合
入力
ユーザーが提供するもの:
- ターゲット:リポジトリパス、ドキュメント、または具体的な問題の説明
- 目標(オプション):成功の定義(例:「収益性を最大化する」)
- 制約(オプション):維持すべきもの(例:「既存のデータモデルを使用する必要がある」)
実行フロー
フェーズ1:スカウト
ターゲットを徹底的に読み理解する。以下の項目を記録:
- プロジェクトの目的
- 現在の構造
- 存在する制約
- 明示された目標
まだ意見を形成しないこと。 事実だけを収集する。
フェーズ2:視点の生成
ターゲットに基づいて3~5の関連する視点を選択:
| 視点 | 焦点 | 最適な用途 |
|---|---|---|
| アーキテクト | 構造、パターン、結合度、凝集度 | システム設計、リファクタリング |
| チャレンジャー | 前提、リスク、代替案 | 意思決定の検証、リスク軽減 |
| オポチュニスト | 新技術、近道、簡略化 | 最適化、負債削減 |
| セキュリティ | 信頼境界、障害モード | 安全性、信頼性 |
| エコノミスト | コスト、複雑さ、ROI | リソース配分、優先順位付け |
| ユーザー | ユーザビリティ、価値、摩擦 | UX、製品決定 |
| アーキオロジスト | レガシー、負債、履歴 | 理解、移行 |
| フューチャリスト | トレンド、スケーリング、進化 | 長期計画 |
複雑なターゲットの場合:spawn_agentsを使用して視点を並行実行 — 各エージェントはグループシンクを避けるために独立して作業し、フェーズ3で結果を統合。
単純なターゲットの場合:単一のエージェントで視点を逐次実行。
各視点は以下のデバイアス技法を適用:
- 新鮮な目モード:既存の実装を意図的に無視する。「目標だけを知っていて、ゼロから作るとしたら何を構築するか?」と問う。
- 挑戦モード:すべての前提に疑問を投げかける。なぜこのコンポーネントは存在するのか?削除したらどうなるか?逆のことが真ならどうか?
- 再構築モード:「今日の知識でゼロから解決しなければならないとしたら、何を変えるか?」
詳細なデバイアス技法とプロンプトについては references/debiasing.md を参照。
フェーズ3:統合
視点を構造化された出力に統合:
- 合意:複数の視点が一致する点(信頼度が高い)
- 不一致:視点が衝突する点(トレードオフを明らかにするため深掘り)
- 新たな洞察:1つの視点だけが捉えた点
- 優先度順の推奨事項:影響と信頼度でランク付け
サブエージェントを使用する場合の詳細な統合手順については agents/synthesizer.md を参照。
フェーズ4:検証
- 推奨事項が互いに矛盾しないか確認
- 検証されていない前提にフラグを立てる
- 結論を変える可能性のある情報を特定
出力形式
# Councilレポート:[ターゲット]
## エグゼクティブサマリー
[2~3文の客観的評価 — 何を行ったかの要約ではなく、結論]
## 重要発見
### [発見名]
- **内容**:[発見の明確な説明]
- **同意する視点**:[リスト]
- **異議を唱える視点**:[リスト + 簡潔な理由]
- **信頼度**:[高/中/低]
- **証拠**:[具体的なファイル:行、指標、または観察結果]
## 推奨事項
### [高影響] [推奨タイトル]
- **解決する問題**:[この推奨事項が修正する発見]
- **解決策**:[具体的なアクション]
- **期待される影響**:[何がどの程度改善されるか]
- **労力**:[低/中/高]
- **リスク**:[低/中/高]
- **支持する視点**:[リスト]
### [中影響] ...
### [低影響] ...
## 検討された代替アプローチ
| アプローチ | 長所 | 短所 | 判定 |
|----------|------|------|---------|
| ... | ... | ... | 維持/置換/さらに調査 |
## この評価を変えるもの
- [X]が真の場合、[推奨Y]が変わる
- [影響を与える未検証の前提]
バンドルリソース
references/debiasing.md— 視点タイプごとの詳細なデバイアス技法とプロンプトagents/perspective.md— 個々の視点分析を実行するサブエージェント向けの手順agents/synthesizer.md— 複数の視点出力を統合する統合サブエージェント向けの手順