doc-brd-autopilot

doc-brd-autopilot

目的

自動化された BRD 生成パイプラインです。参照ドキュメント （docs/00_REF/）、ユーザープロンプト、または実装計画（IPLAN-*）から、 ソースを分析して BRD の種類を判定し、完全な BRD を生成し、準備状況を検証して、 BRD-00_index.md を維持し、監査↔修正サイクルを合格スコアに達するまで進めます。 対象は単一の BRD またはバッチです。

レイヤー：1。上流：任意の REF／プロンプト／IPLAN 入力。下流： 検証済み BRD とインデックスエントリ。

スキルの依存関係

スキル	役割
../doc-brd/SKILL.md	BRD の構造と作成ルール（生成）
../doc-brd-audit/SKILL.md	品質ゲート（採点＋指摘事項）
../doc-brd-fixer/SKILL.md	監査レポートに基づいて修正を適用
../doc-naming/SKILL.md	要素 ID の標準
../review-team/SKILL.md	チームモードのディスパッチャー（ペルソナ別サブエージェントへの並列ファンアウト）
../charts-flow/SKILL.md	図の契約タグ（C4-L1、DFD-L1）

生成する BRD の作成スタイルは ${CLAUDE_PLUGIN_ROOT}/framework/governance/AUTHORING_STYLE.md（ doc-brd と doc-brd-audit 経由で継承）によって規定されます。

入力コントラクト

対象の BRD ID／パス、REF ディレクトリまたはファイル、自由形式のプロンプト、 あるいは IPLAN パスを受け付けます。スコアのしきい値（デフォルト 90）、修正の 最大反復回数（デフォルト 3）、バッチリストは任意です。明示的な入力がない場合は、 リクエストをプロンプトとして扱います。

ドキュメントのスマート検出

各対象について、BRD がすでに存在するか（ネストされたフォルダー docs/01_BRD/BRD-NN_{slug}/）を確認します。

• 存在しない → 生成モード。
• 存在する → レビュー＆修正モード（監査し、しきい値を下回る場合は修正）。

ソースコンテンツから deliverable_type（code／document／ux／risk／process） と BRD の種類（Platform または Feature）を判定します。

モデルの事前チェック

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

1. .claude/aidoc-flow.config.yaml が存在しないか、model.* キーがない場合は、 このセクション全体をスキップします（出力なし）。
2. 推奨モデルを解決します。model.per_layer.BRD が設定されていればそれを使い、 そうでなければ model.default を使います。
3. model.precheck（warn | silent | block）に従って動作します。
   • warn（デフォルト）— 1 行表示してからドライバーに進みます。 ℹ BRD 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. を表示し、続行前に ユーザーの確認を待ちます。

ワークフロー

必須のオーケストレーション手順（上記のモデル事前チェックの後）。 review_mode: team（フレームワークのデフォルト）の場合、最初の オーケストレーションアクションとして、Bash ツール経由で saga ドライバーを呼び出します。サブエージェントを Task で直接ディスパッチしては なりません。また、SlashCommand などを使って doc-brd／doc-brd-audit／ doc-brd-fixer を直接呼び出してはなりません。セッション内で BRD を生成しても なりません。ドライバーだけが作成・レビュー・改訂ループをオーケストレーション します。これを迂回すると saga.json ジャーナルのない BRD が生成されます。 この方法は 2026-06-05 の BRD 検証で実際に失敗しており、この SKILL のスリム化が 修正するまさにそのバグです。

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

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

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

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

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

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

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

team モードのワークフローは以上です。ここでそれ以外のこと（文章のドラフト作成、Task サブエージェントのディスパッチ、その他のスラッシュコマンドの呼び出しなど）を行っていることに気づいたら、STOP し、ドライバーを迂回していることを認識したうえで、上記の Bash コマンドを実行してください。

線形パイプライン（review_mode: single_pass）

従来の動作を維持します。プロファイルで指定されている場合、Task サブエージェントのディスパッチが利用できない場合、または書き込み時（on_author）にコストを最優先する場合に使用します。

3. 生成 — ../doc-brd/SKILL.md に従って BRD を作成します。最初に Document Control（セクション 1）を記述し、必須セクション §3–§15 を含めます（section_toggles に従って §2 Executive Summary を切り替えます）。図の一覧、付録、7 カテゴリにわたる §8、要素 ID BRD.NN.SS.xxxx、および ../charts-flow/SKILL.md による図のタグを含めます。
4. 検証 — ../doc-brd-audit/SKILL.md を最初から実行し、single_pass モードで監査します。
5. 監査 ↔ 修正サイクル — スコアがしきい値未満で、反復回数が上限未満の間、../doc-brd-fixer/SKILL.md を single_pass モードで実行してから、再監査します。合格したら docs/01_BRD/BRD-00_index.md を更新します。反復回数が上限に達した場合は、手動レビュー対象としてフラグを付けます。

実行モード

• 単体 — 1 件の BRD（生成、またはレビューと修正）。
• バッチ — 複数の BRD を、コンテキスト量を抑えるため 3 件ずつ処理します。依存先となる Feature BRD より先に Platform BRD を生成します。
• ドライラン — ファイルを書き込まず、予定されているアクション（種類、セクション、ID）を報告します。

品質ゲート

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

エラー処理

状況	アクション
参照先の Platform BRD が存在しない（Feature BRD）	停止し、不足している依存関係を報告します
スコアがしきい値未満のまま反復回数の上限に到達	レポートを書き込み、手動レビューのフラグを付けて、バッチを続行します
ソース入力が曖昧	プロンプトモードに切り替え、前提条件を BRD に記録します
書き込み／権限エラー	ログに記録し、その項目をスキップして、バッチを続行します

適用

デフォルトを適用する前に、プロジェクト適用プロファイル（.aidoc/profile.yaml）を読み取り、生成フェーズと内部監査／修正フェーズの両方に適用します。section_toggles、active_layers、audit_threshold（引き上げのみ。より厳格にする場合のみ変更可能）、および glossary に従ってください。未知のキー、または適用範囲外のキーは無視してください。プロファイルがない場合は、フレームワークのデフォルトを使用します。 準拠先：${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md。

Related Resources

• Create: ../doc-brd/SKILL.md · Audit: ../doc-brd-audit/SKILL.md · Fix: ../doc-brd-fixer/SKILL.md
• Authority: ${CLAUDE_PLUGIN_ROOT}/framework/layers/01_BRD/BRD-TEMPLATE.yaml, ${CLAUDE_PLUGIN_ROOT}/framework/layers/01_BRD/README.md, ${CLAUDE_PLUGIN_ROOT}/framework/layers/01_BRD/BRD-00_index.TEMPLATE.md