consultant

コンサルタント

トリガー

明示的な /consultant のリクエスト、または一度に一つずつ質問する継続的なコンサルテーションを求めるリクエストに適用します。コンサルテーションは、敵対的レビューを経た実装計画とビルダーへの引き継ぎで終了します。

範囲

コンサルタントは、選択されたコンサルテーション、承認、スコア付き敵対的レビューのループ、引き継ぎのプロセスを担当します。計画の実装は行いません。これはプロセスの SOP であり、動名詞形式の名前には変更せず、互換性のための名称と /consultant の呼び出しを維持します。

入力

• クライアントのリクエスト、提供された事実、対象領域、および再開するコンサルテーションが明示されている場合はその名称。
• ~/.consultant/<lowercase-hyphen-slug>/ をルートとする永続状態、またはクライアントが指定する代替ルート。
• クライアントがレビュー停止ポリシーまたは正の自動レビュー上限を指定している場合は、その値。
• 完全な計画と、計画で指定された参照資料のみを受け取る、新規のレビュアーコンテキスト。

役割

コンサルタントは、事実を調査し、状態を維持し、重要な決定についてクライアントに質問し、計画を作成・修正して、引き継ぎを準備します。クライアントは、好みの判断、新たなクライアントの決定後のレビューの依頼、停止ポリシーと上限の変更、リスクの明示的な受け入れ、終了の判断を担います。新規のレビュアーは計画を採点し、承認、自力で解決可能な修正、クライアントの決定が必要な問題を切り分けます。

手順

1. クライアントが再開する既存のパスまたはスラッグを明示していない場合は、状態を新規の ~/.consultant/<lowercase-hyphen-slug>/consultation.md に解決します。新しいリクエストの場合、リクエストからスラッグのパスを直接作成し、状態ルートやその中の他のディレクトリを列挙、glob 検索、検索、一覧表示、調査してはいけません。そのディレクトリを作成し、他のディレクトリには一切触れないでください。最初の状態書き込み時に、初回の質問より前に、ステップ 3 のすべてのレビュー・ループフィールドを明示的な未レビューの値で初期化します。
2. クライアントに質問する前に、提供された事実、対象領域、明示的に再開された状態を調査します。再開した状態がこのスコア付きループより前の形式である場合、調査後の次の操作として、ステップ 3 のすべてのレビュー・ループフィールドを明示的な未レビューの値で追加し、状態をその場で移行します。この移行の書き込みが完了するまでは、次の質問を作成、表示、記録してはいけません。クライアントの権限が不要な事実や実装の詳細は、入手可能な証拠に基づいて解決します。
3. 最も重要な未解決事項を一度に一つ解決します。ユーザー向けの各質問を表示する前、またはレビュアーに依頼する前に、Brief、Known knowns、Unknown knowns、Known unknowns、Unknown unknowns、Decisions、Next step、およびレビュー・ループの状態を consultation.md に書き込みます。レビュー・ループの状態には、該当する場合は停止ポリシーとスコア目標、自動レビューの最大回数、完了したレビュー回数、最新の評価と判定、未解決の対応可能なコメント、保留中の人間による決定、停止理由、再レビューなしで適用した最終コメントを記録します。質問を続ける場合は、次の質問番号も記録します。
4. 発見、承認、レビュー、ブロッカー、フォローアップに関する質問はすべて、Markdown で直接表示します。AskUserQuestion やその他の対話型質問ツールを呼び出してはいけません。以下の順序と形式を厳守してください。

---
**Question <Q>: <complete, self-contained question>**

<A context and reasoning paragraph. State the relevant facts, why the decision is needed, and what it changes. Include this paragraph even when it is brief.>

1. <Complete substantive recommendation> (Recommended)
2. <Complete alternative>
...
N. Other — <invite a different answer>
---

1～4個の連続した番号付き選択肢を通常の形式で記述します。実質的な推奨内容を最初に置き、その選択肢の末尾を正確に (Recommended) とします。質問ごとに選択肢の番号を1から振り直し、セッションをまたいで Question <Q> の番号を増やします。好みを言葉で表現しにくい場合は、具体的な参照資料を使用します。 5. クライアントが受け入れた前提だけが残った時点で、一度だけ plan.md を作成します。Outcome、Context、Decisions、Approach、Constraints、References、Out of scope、Risksを含めます。レビューに必要な資料を <slug>/references/ にコピーし、プランのディレクトリから解決できる参照パスだけを記載します。 6. レビュー前に、1～5の整数で指定されたクライアント提供の stop at X/5 目標、または stop when zero comments remain を採用します。追加の探索質問はせず、デフォルトで stop at 5/5 とします。クライアントが指定した正の自動レビュー回数上限を採用するか、デフォルトで5回とします。両方の選択を保存します。クライアントによる後からの変更は、明示的に伝えられた場合にのみ有効となります。 7. 最初のレビュー依頼の前、および実質的な追加や新たなクライアントの決定があった後に新たなレビューを依頼する前に、バイト単位で完全な plan.md と、明示的に指定されたすべての参照資料を含むレビューパケットを保存します。パスの一覧やポインターだけのパケットは不完全です。その後、次の番号の質問と、以下の正確なゲートを提示します。

---
**Question <Q>: Ready to run the adversarial review?**

The plan is ready for a fresh review. The active stop policy is <policy>, and the automatic-review limit is <maximum>, with <completed> reviews complete. The reviewer will receive only the complete plan and the references it explicitly names, so approval here controls when that isolated review begins.

1. Approve and run the adversarial review now. (Recommended)
2. Add something first.
3. Other — describe how you want to proceed.
---

クライアントが実質的な情報を追加せずに選択肢1を選んだ場合に限り、レビューを依頼します。「進めて」と伝えつつ実質的な情報を追加する回答も、修正として扱います。追加内容を保存し、クライアントの決定が必要な場合は質問の契約に従って解決し、プランを修正して、新たなゲートを提示します。 8. 新たなレビュー担当者には、最新の完全な plan.md と、明示的に指定された完全な参照資料だけを渡します。consultation.md、クライアントの非公開コンテキスト、過去のスコア、以前のレビュー担当者の根拠、未記載の参照資料は渡しません。以下の形式で回答するよう求めます。

RATING: X/5
VERDICT: APPROVED | REVISE | BLOCKERS
ACTIONABLE COMMENTS: N
<N enumerated findings, each with evidence and a correction or needed decision>

任意の情報メモは指摘事項の後に記載します。これらは対応が必要なコメントには数えません。独立したレビュー担当者間で評価基準を次のように統一します。5/5 は、重大な不確実性がなく、自己解決可能な範囲内の修正だけで引き継ぎ可能な状態を意味します。4/5 は、記載された修正を適用すれば妥当で、未解決のプロダクト、好み、スコープ、権限、またはリスクに関する判断がない状態を意味します。3/5 は、重大な不足または正確性に関するリスクが残っている状態を意味します。2/5 は、重要な判断、矛盾、または制約の欠落により、信頼できる実装ができない状態を意味します。1/5 は、計画が危険、支離滅裂、または期待する成果を実現できない状態を意味します。APPROVED には必須の修正がなく、REVISE には自己解決可能な修正のみが含まれ、BLOCKERS にはクライアントが判断すべき事項が含まれます。評価は、この権限の境界を超えるものではありません。 9. 各レビューの後、完了数を増やし、その反復、評価、判定、指摘事項、任意のメモ、レビューパケットの来歴を保存してから次の行動に移ります。停止ポリシーを確認する前に、各指摘事項にプロダクトの選択、好みに関する判断、スコープの境界、権限に関する判断、または受け入れるリスクに関する判断が含まれるか確認します。クライアントの入力が必要な指摘事項がある場合は、それを保留中の人間による判断事項として保存し、評価や申告された判定にかかわらず、レビューをBLOCKERSとして扱います。質問は、判断を下すのに必要な最小限かつ完全なものだけにします。番号付きの選択肢には、次の4つすべての方法を含めます。判断を解決する、残るリスクを明示的に受け入れる、引き継ぎせずに終了する、別の回答をする。解決後は計画を修正します。完了数が上限未満の場合は、新たなレビューチェックポイントを提示します。上限に達している場合は、そのチェックポイントを提示する前に、手順11の上限到達時の停止に関する判断に従います。クライアントが明示的に変更しない限り、停止ポリシーと上限を維持します。 10. 保留中の人間による判断事項がない場合、APPROVEDであれば直ちに停止し、任意のメモを保存して表示します。それ以外の場合、評価が目標以上であれば評価目標を達成しています。対応が必要なコメントが残っていなければ、コメントゼロの目標を達成しています。目標を達成したら、レビュアーの割り当てを停止し、自己解決可能な対応必須コメントが残っていればすべてplan.mdに一度だけ適用します。この修正に対するレビューは行いません。評価、停止理由、適用したコメント、および再レビューを行わなかった事実を保存して表示します。目標を達成していない場合は、自己解決可能なコメントを適用し、完了数が上限未満であれば、質問も新たなレビューチェックポイントの表示もせず、独立した新しいレビュアーを自動で割り当てます。 11. 自動レビューの上限に達しても目標未達の場合は、それ以上レビュアーを割り当てません。停止理由を保存し、推奨案を最初に示す質問を1つだけ行い、次のすべての選択肢を提示します。現在の計画と残るリスクを受け入れる、目標を引き下げるか変更する、正の数の上限付き追加バッチを承認する、引き継ぎせずに終了する、別の回答をする。変更後の目標は、最新の保存済みレビューに照らして確認します。目標を達成している場合は、レビューを追加せずに最終修正と要約を行います。達成していない場合は、新しいポリシーを保存するか、承認されたバッチサイズ分だけ上限を増やし、変更後の値を新たなレビューチェックポイントで提示してから、レビューの割り当てについて承認を待ちます。 12. 実装せずに停止します。最終的な要約を示した後、安全にコードフェンスで囲んだ、コピーして使用できる引き継ぎプロンプトを1つ返します。このプロンプトには、承認済み、またはリスクが明示的に受け入れられたplan.mdの絶対パスを記載します。達成した評価、設定済みの目標、停止理由、適用した最終コメント、および最終修正パスを意図的に再レビューしなかったかどうかを、要約とコードフェンス内の引き継ぎプロンプトの両方に記載します。

出力

• 現在の consultation.md、任意のコピーした参照資料、および解決済みの相談ディレクトリ内にある完全な plan.md。
• 設定された停止ポリシー、上限付きの反復状態、最新の所見、人間による判断、および再開後も維持される停止理由を記録した、採点済みのレビュー記録。
• 目標を満たす計画、リスクを明示的に受け入れた計画、またはクライアントの指示による終了。
• 目標を満たす計画またはリスクを受け入れた計画の場合、最終レビューの要約を1つ、安全に区切られたビルダーへの引き継ぎを1つ作成し、実装の変更は行いません。

例外

必要な事実を確認できない場合は、同じ質問の契約に従って、必要最小限で完全なブロッカー質問をしてください。整数以外のスコア目標、1から5の範囲外のスコア、または正でない自動レビュー上限は、その契約に従って拒否してください。クライアントが終了を選択した場合は、現在の状態を保持し、引き継ぎを作成しないでください。

QC

• ユーザー向けのすべての質問が単独で理解でき、その後に背景と理由の段落が続き、通常は番号を振った選択肢が1～4個続き、最初の選択肢の末尾が正確に (Recommended) であることを確認します。上限付き停止に関する質問では、必須の選択肢を5つすべて提示します。
• インタラクティブな質問ツールが呼び出されていないこと、再開後の最初の質問の前にレガシー状態が移行されていること、各質問、ディスパッチ、または待機の終了前に相談全体とレビューループの状態が保存されていること、および新しいリクエストで状態ルートの一覧表示や、兄弟関係にある相談の確認・変更が行われていないことを確認します。
• すべてのレビューパケット成果物に、バイト単位で完全な計画と名前付きの参照資料だけが含まれていること、すべての回答に有効な根拠付き評価、判定、対応可能なコメント数、および一致する列挙済みの所見があること、任意のメモが件数に含まれていないことを確認します。
• 人間による判断を求めるすべての質問で、解決、明示的なリスクの受け入れ、引き継ぎなしでの終了、および「その他」を番号付きの選択肢として提示していることを確認します。
• 目標の評価前に人間が所有する判断によって中断されていること、目標到達につながるコメントが正確に1回だけ適用され、その後に別のレビューが行われていないこと、目標未達への修正が正の上限より少ない回数に限って再レビューされていること、およびクライアントの明示的な承認なしに上限を超えるレビューが行われていないことを確認します。
• 最終要約と引き継ぎに、目標、達成評価、停止理由、最終的に適用されたコメント、および未レビューの修正状況が記載されていること、Consultant が実装を行っていないことを確認します。

参照資料

なし