proposal-review

提案レビュー

内容をチャンクに分割し、フィードバックを予測して、提案者が実行に移せる形で提示することで、提案を体系的にレビューします。

ワークフロー

┌─────────────────────────────────────────────────────────────┐
│  1. INTAKE: Read entire proposal, identify source format    │
├─────────────────────────────────────────────────────────────┤
│  2. CHUNK: Split into reviewable sections (smart hybrid)    │
├─────────────────────────────────────────────────────────────┤
│  3. REVIEW LOOP: For each chunk:                            │
│     • Present chunk content                                 │
│     • Predict 3-4 likely reactions                          │
│     • Use AskUserQuestion for feedback                      │
│     • Record response                                       │
├─────────────────────────────────────────────────────────────┤
│  4. SYNTHESIZE: Compile feedback, infer overall sentiment   │
├─────────────────────────────────────────────────────────────┤
│  5. OUTPUT: Generate feedback document matching source      │
└─────────────────────────────────────────────────────────────┘

フェーズ 1：受け付け

提案全体を読みます。以下を特定します。

• ソース形式：ローカルファイル、GitHub PR／issue／gist、Google ドキュメントのエクスポートなど
• 構成：見出し、セクション、番号付きリスト、または散文
• 長さ：チャンク数の見積もり（一般的な提案では 3～8 チャンクを目安とします）

要約したり、最初の印象を共有したりしないでください。チャンク分割に直接進みます。

フェーズ 2：チャンク分割の方針

スマートなハイブリッド方式でチャンクに分割します。

提案の構成	チャンク分割の方法
明確な見出し／セクションがある	主要なセクションごとに 1 チャンク
大きなセクション（500 語超）	自然な段落の区切りで分割
隣接する小さなセクション（各 100 語未満）	1 つのチャンクにまとめる
項目の番号付きリスト	関連する項目を 3～5 個ずつまとめる
構成のない散文	トピックの変わり目で分割（約 300～400 語）

チャンクの順序：明確な依存関係（例：代替案が解決策のレビューに関わる場合は、「提案された解決策」より先に「代替案」を提示する）がない限り、文書の順序どおりに提示します。

フェーズ 3：レビューループ

各チャンクについて、以下を行います。

3.1 チャンクを提示する

チャンクの内容を引用または要約します。長いチャンクの場合は、重要な文を引用し、残りを要約します。次のような明確な見出しを使用します。

### Chunk 2 of 5: Technical Architecture

3.2 反応を予測する

以下のカテゴリにわたる反応を 3～4 個予測します。

カテゴリ	予測の例
確認	「ここは不明瞭です。X とは何ですか？」「これは Y とどのように連携しますか？」
懸念	「このスコープは大きすぎるようです」「Z のリスクを検討しましたか？」
賛同	「この方針は妥当です」「トレードオフの分析がよくできています」
提案	「代替案 A を検討してください」「B について、さらに詳しい説明が必要です」

このチャンクに特に関係する予測を選びます。すべてのチャンクにすべてのカテゴリを含める必要はありません。

3.3 フィードバックを収集する

AskUserQuestion を使用し、次のようにします。

• 予測した反応を選択肢として提示する（可能性の高いものを 2～4 個）
• ユーザーは選択肢を 1 つ選ぶか、「Other」から独自のフィードバックを入力できる
• 選択肢のラベルは簡潔にし（10 語未満）、詳細は説明に記載する

例：

question: "What's your reaction to this technical architecture section?"
header: "Architecture"
options:
  - label: "Looks good"
    description: "The proposed architecture is sound and well-reasoned"
  - label: "Scope concern"
    description: "This feels too ambitious for the timeline"
  - label: "Need clarification"
    description: "Some technical details are unclear or missing"
  - label: "Consider alternative"
    description: "There may be a simpler or better approach"

3.4 回答を記録する

各回答について、以下を記録します。

• チャンク識別子（番号＋タイトル）
• 選択した項目または自由記述
• フィードバックで参照されている引用箇所

フェーズ 4：統合

すべてのチャンクのレビュー後、以下を行います。

1. フィードバックをテーマ別にまとめる：複数のチャンクにまたがる類似の懸念を統合します
2. 全体的な評価を推定する：フィードバックの分布に基づきます。
   • 賛同が中心 → 軽微な提案を含む前向きな評価
   • さまざまな意見が混在 → 条件付きの支持。修正が必要
   • 懸念が中心 → 対処すべき重大な問題あり
3. 傾向を特定する：同じ懸念が複数回現れていないか確認します

次に、以下を尋ねます。

question: "Would you like me to include suggested next steps for the proposer?"
header: "Next Steps"
options:
  - label: "Yes, include action items"
    description: "Generate concrete next steps based on feedback"
  - label: "No, just the feedback"
    description: "Keep output to observations and reactions only"

フェーズ 5：出力の生成

ソースに合わせて出力形式を調整します。

ソース	出力形式
GitHub PR	引用行とスレッド形式のフィードバックを含む PR レビューコメント
GitHub Issue	issue の構成に合ったセクションを含むコメント
Markdown ファイル	インライン参照付きの補足ファイル *-feedback.md
Google ドキュメント	セクション参照付きの構造化されたコメントリスト
汎用／不明	明確なセクションを含む構造化 Markdown

出力の構成

## Feedback Summary

**Overall**: [Inferred sentiment - 1 sentence]

## Section-by-Section Feedback

### [Section Name]
[Feedback with quotes where relevant]

### [Section Name]
...

## Key Themes
- [Theme 1]: [Consolidated feedback]
- [Theme 2]: ...

## Next Steps (if requested)
- [ ] [Action item 1]
- [ ] [Action item 2]

トーンのガイドライン

• 率直でありながら建設的にします
• 批評する際は具体的な箇所を引用します
• 可能な限り懸念を質問の形で表現します（「これはうまくいきません」ではなく、「……を検討しましたか？」）
• うまくいっている点にも触れ、問題点だけを指摘しないようにします

例外的なケース

非常に短い提案（300 語未満）：チャンク分割を省略し、1 つの単位としてレビューし、反応を 4～5 個予測します。

非常に長い提案（3000 語超）：チャンク数を 8～10 個に制限します。積極的にまとめるか、特定のセクションに絞ってレビューすることを提案します。

構成が不明瞭：チャンク分割の前に、どのセクションを重視するかユーザーに尋ねます。

複数の提案：一度に 1 つずつレビューします。順序が明らかでない場合は、ユーザーに希望の順序を尋ねます。