doc-prd-autopilot

doc-prd-autopilot

目的

自動化されたPRD生成パイプラインです。上流のBRD、ユーザープロンプト、または実装計画（IPLAN-*）を基に、ソースを分析してプロダクトのスコープを導き出し、完全なPRDを生成し、EARS対応状況を検証し、PRD-00_index.mdを維持し、監査↔修正サイクルを合格スコアに達するまで進めます。単一のPRDにも、バッチにも対応します。

レイヤー：2。上流：BRD（またはプロンプト／IPLAN入力）。下流：検証済みのPRDとインデックスエントリー。

スキルの依存関係

スキル	役割
../doc-prd/SKILL.md	PRDの構成と作成ルール（生成）
../doc-brd-audit/SKILL.md	上流BRDの品質ゲート（PRD対応状況）
../doc-prd-audit/SKILL.md	品質ゲート（スコアリング＋指摘事項）
../doc-prd-fixer/SKILL.md	監査レポートに基づいて修正を適用
../doc-naming/SKILL.md	要素IDの標準

入力契約

対象となるPRDのID／パス、ソースBRDのID／パス、自由形式のテキストプロンプト、またはIPLANのパスを受け付けます。任意の設定：スコアのしきい値（デフォルト90）、修正の最大反復回数（デフォルト3）、バッチリスト。明示的な入力がない場合は、リクエストをプロンプトとして扱います。複数の入力がある場合の優先順位は、IPLAN > BRD／REF > プロンプトです。目的／スコープに矛盾がある場合は処理を中断し、ユーザーへの確認が必要です。

ドキュメントの自動判定

対象ごとに、PRDがすでに存在するか（ネストされたフォルダー docs/02_PRD/PRD-NN_{slug}/）を確認します。

• 存在しない → 生成モード（ソースBRD／プロンプト／IPLANから生成）。
• 存在する → レビューと修正モード（監査し、しきい値未満の場合は修正）。

BRD-NN入力は対応するPRDにマッピングされます。存在しない場合は生成し、すでに存在する場合はレビューします。ソースBRDから継承したdeliverable_type（code／document／ux／risk／process）を判定します。

モデルの事前チェック

参考情報として、ベストエフォートで実行します。このレイヤーに推奨されるモデルを提示しますが、セッションのモデルを切り替えることはできません。ドライバーを呼び出す前に、次の手順を実行します。

1. .claude/aidoc-flow.config.yamlが存在しない場合、またはmodel.*キーがない場合は、このセクション全体をスキップします（出力なし）。
2. 推奨モデルを解決します。model.per_layer.PRDが設定されていればそれを使用し、そうでなければmodel.defaultを使用します。
3. model.precheck（warn | silent | block）に従って処理します。
   • warn（デフォルト）— 1行を表示してから、ドライバーに進みます。 ℹ PRD recommends model '<rec>'. If you're not on it, run /model <rec> (or set model.precheck: silent to hide this).
   • silent — 何も表示せずに続行します。
   • block — 上記の行に加えて、precheck=block: confirm you want to draft on the current model, or run /model <rec> first.を表示し、続行する前にユーザーの確認を待ちます。

ワークフロー

Saga 駆動の生成ループ（review_mode: team）

ステップ 1 — ドライバーを呼び出します。以上です。 ハーネスは、この SKILL を呼び出す前に PREV_OUTPUT、 ARTIFACT_ID、ARTIFACT_PATH の環境変数を設定します。 最初のオーケストレーションアクションでは、必ず Bash ツールを使い（上記の Model の事前チェックが先に実行されます）、次のコマンドをそのまま実行してください。

python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py" \
  --layer 02_PRD \
  --allow-skip-permissions

--allow-skip-permissions を指定すると、ドライバーがディスパッチする各フェーズで、権限確認を求めずにファイルを書き込めます。無人の自動実行には、このオプションが必要です。 このオプションを外すと、Claude Code の通常の確認プロンプトを使って同じループを実行できます。

十分に長いタイムアウト（≥1800s）を設定してください。入力を事前に分析しないでください。BRD を読まないでください。タイプやスコープを分類しないでください。ドライバーと、ドライバーがディスパッチするサブプロセス（ドラフト用の /aidoc-flow:doc-prd、レビュー用の /aidoc-flow:doc-prd-audit、修正用の /aidoc-flow:doc-prd-fixer）が、そのすべてを処理します。ドライバーは ${CLAUDE_PLUGIN_ROOT}/framework/governance/REVIEW_SAGA.md に従って状態マシンを先回りして適用します。この SKILL の役割は、ドライバーを呼び出して結果を報告することです。

ステップ 2 — ドライバーの実行後に報告します。 .aidoc/review/02_PRD/${ARTIFACT_ID}/saga.json を読み取ります。最終ステータスは、CLOSED（PASS）、ESCALATED（終端 FAIL）、または PARTIAL_TIMEOUT（ソフトデッドライン到達。再開可能）のいずれかでなければなりません。ステータス、verdict.json が存在する場合は最終スコア、そして 1 行の概要を出力してください。

ステップ 3 — インデックスの更新（CLOSED の場合のみ）。 新しい PRD を参照する行を docs/02_PRD/PRD-00_index.md に追加し、親 BRD の後続項目を更新します。

これが team モードのワークフローのすべてです。ここで別の作業（文章のドラフト作成、Task サブエージェントのディスパッチ、ほかのスラッシュコマンドの呼び出しなど）をしていることに気付いた場合は、そこで停止してください。ドライバーを迂回していることを認識し、上記の Bash コマンドを実行してください。

リニアパイプライン（review_mode: single_pass）

従来の動作から変更はありません。プロファイルで指定されている場合、Task サブエージェントをディスパッチできない場合、または書き込み時（on_author）にコストを最優先する場合に使用します。以下の 5 ステップのセッション内パターンでは saga.json を生成しません。そのため、ハーネスの saga-journal チェックでこのレイヤーは失敗します。このモードは手動のドライランにのみ適しています。

1. 入力分析 — 入力（BRD／プロンプト／IPLAN）を分類し、ソース資料を特定して、新規生成するかレビューして修正するかを判断します。
2. BRD の準備状況 — BRD から生成する場合は、../doc-brd-audit/SKILL.md に合格していること（PRD-Ready がしきい値以上）を確認します。BRD の全セクションファイルを 1 つの文書として読み、次の PRD-NN を確保します。
3. 生成 — ../doc-prd/SKILL.md に従って PRD を作成します。最初に Document Control（@brd: 参照と EARS-Ready スコアを含む）を記載し、全 15 セクションを含めます。§10 は 3 つ以上のカテゴリで記述し、§14 では ADR のトピックを詳しく説明します（ADR 番号は付けません）。要素 ID は PRD.NN.SS.xxxx とし、@brd: タグは累積して付与します。図のタグには ../charts-flow/SKILL.md を使い（c4-l2／dfd-l2／sequence-sync、および alt/else）、図を作成します。
4. 検証 — ../doc-prd-audit/SKILL.md を最初から実行します。
5. 監査と修正のサイクル — スコアがしきい値未満で、反復回数が上限未満である間、../doc-prd-fixer/SKILL.md を実行してから、再監査します。合格した場合は docs/02_PRD/PRD-00_index.md と親 BRD の後続項目を更新します。反復回数が上限に達した場合は、手動レビューが必要であることを示します。

実行モード

• 単一 — 1 件の PRD（生成、またはレビューと修正）。
• バッチ — 複数の PRD を、コンテキストを抑えるために3 件ずつ処理します。各 PRD は、ソース BRD の準備ができてから生成します。
• ドライラン — ファイルを書き込まず、予定している操作（ソース、セクション、ID）を報告します。

品質ゲート

• 監査に合格する（EARS-Ready がしきい値以上で、Tier-1 エラーが 0 件）か、反復回数の上限に達する（その場合は手動レビュー対象としてフラグを付ける）まで、生成は完了しません。
• PRD が合格した後にのみ、PRD インデックスと親 BRD の後続項目を更新します。
• サイクルごとに新たに監査します。キャッシュ済みのスコアは使用しません。

エラー処理

状況	対応
ソース BRD が存在しない、または PRD-Ready の基準を満たしていない	停止し、満たされていない依存関係を報告します
最大反復回数に達しても基準を下回っている	レポートを作成し、手動レビューが必要であることを示して、バッチを続行します
ソース入力が曖昧である	プロンプトモードに切り替え、前提条件を PRD に記録します
書き込み／権限エラー	ログに記録し、該当項目をスキップして、バッチを続行します

適用

デフォルトを適用する前に、プロジェクトの適用プロファイル （.aidoc/profile.yaml）を読み込み、生成フェーズと内部 監査／修正フェーズの両方に適用します。section_toggles、active_layers、audit_threshold （引き上げのみ — より厳格な設定のみ）、およびglossaryを尊重します。不明なキー、 または適用範囲外のキーは無視します。プロファイルがない場合は、フレームワークのデフォルトを使用します。 権限：${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md。

関連リソース

• 作成：../doc-prd/SKILL.md · 監査：../doc-prd-audit/SKILL.md · 修正： ../doc-prd-fixer/SKILL.md
• 権限：${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/PRD-TEMPLATE.yaml、 ${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/README.md、 ${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/PRD-00_index.TEMPLATE.md