doc-adr-autopilot

doc-adr-autopilot

目的

自動化されたADR生成パイプラインです。上流の成果物（BRD §8／PRD §14／EARS／BDD）、ユーザープロンプト、または実装計画（IPLAN-*）を基に、ソースを分析し、決定の範囲を定め、Context-Decision-Consequences形式の完全な記録を生成して、準備状況を検証し、ADR-00_index.mdを維持し、監査↔修正のサイクルを合格スコアに達するまで進めます。単一のADRにも一括処理にも対応します。

レイヤー：5。上流：BRD → PRD → EARS → BDD（またはプロンプト／IPLAN）。 下流：検証済みADRとインデックスエントリ。

スキルの依存関係

スキル	役割
../doc-adr/SKILL.md	ADRの構成と作成ルール（生成）
../doc-adr-audit/SKILL.md	品質ゲート（スコアリングと指摘事項）
../doc-adr-fixer/SKILL.md	監査レポートに基づく修正の適用
../doc-naming/SKILL.md	要素IDの標準
../adr-roadmap/SKILL.md	プロジェクトに必要なADR一式の計画

入力の仕様

次の入力を受け付けます：対象のADR ID／パス、上流のID（BRD-NN／PRD-NN／EARS-NN／BDD-NN）またはトピック要素ID、自由形式のテキストプロンプト、あるいはIPLANのパス。スコアのしきい値（デフォルト：90）、修正の最大反復回数（デフォルト：3）、一括処理リストは任意です。明示的な入力がない場合、リクエストをプロンプトとして扱います。

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

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

• 存在しない → 生成モード（上流から決定を統合します）。
• 存在する → レビューと修正モード（監査し、しきい値を下回る場合は修正します）。

ソースの内容から、deliverable_type（code／document／ux／risk／process。上流から継承）と、起点となるトピック（PRD §14。BRD §8までさかのぼって追跡）を特定します。1つのADRには1つの決定を記録します。

モデルの事前確認

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

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

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

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

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

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

ステップ 2 — ドライバーの終了後に報告します。 次を読み込みます。 .aidoc/review/05_ADR/${ARTIFACT_ID}/saga.json。最終ステータスは、CLOSED（PASS）、ESCALATED（終端 FAIL）、または PARTIAL_TIMEOUT（ソフト期限切れ。再開可能）のいずれかでなければなりません。ステータス、verdict.json にある場合は最終スコア、および 1 行の要約を出力してください。

ステップ 3 — インデックスを更新します（CLOSED の場合のみ）。 新しい ADR を参照する行を docs/05_ADR/ADR-00_index.md に追加し、上流アーティファクトの下流エントリーを更新してください。

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

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

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

1. 入力分析 — 入力（上流 ID／プロンプト／IPLAN）を分類し、元のトピックを特定し（PRD §14 → BRD §8）、生成するか、レビューして修正するかを判断します。
2. 決定範囲 — 決定がちょうど 1 つであることを確認し、次の ADR-NN を確保し、参照する上流アーティファクトが存在することを検証します。
3. 生成 — ../doc-adr/SKILL.md に従って ADR を作成します。最初に Document Control（ステータスは Proposed／Accepted）、§2～§10 + 用語集 + 付録を記載し、選択した案のほかに 2～3 個の代替案を示します。各代替案には不採用理由を記載します（コストと適合性は任意）。内部要素 ID は ADR.NN.SS.xxxx、累積タグは @brd @prd @ears @bdd、自己タグは @adr: ADR-NN とし、../charts-flow/SKILL.md に従ってアーキテクチャフロー図を作成します。
4. 検証 — ../doc-adr-audit/SKILL.md を最初から実行します。
5. 監査と修正のサイクル — スコアがしきい値未満で、反復回数が上限未満の間は、../doc-adr-fixer/SKILL.md を実行してから再監査します。合格したら docs/05_ADR/ADR-00_index.md を更新します。反復回数が上限に達したら、手動レビュー対象としてフラグを立てます。

実行モード

• 単一 — ADR を 1 件処理します（生成、またはレビューと修正）。
• バッチ — 複数の ADR を処理します。コンテキストを適切な範囲に保つため、3 件ずつ処理します。他の ADR が依存する ADR（@depends: ADR-NN）を先に生成します。
• ドライラン — ファイルを書き込まずに、予定するアクション（決定範囲、セクション、ID）を報告します。

品質ゲート

• 監査に合格（SPEC-Ready がしきい値以上、Tier-1 エラーが 0 件）するか、反復上限に達する（この場合は手動レビューのフラグを立てる）まで、生成は完了しません。
• ADR インデックスを更新するのは、ADR の合格後のみです。
• 毎サイクル、新たに監査を実行します。スコアをキャッシュして再利用しないでください。

エラー処理

状況	対応
引用された上流成果物（BRD/PRD/EARS/BDD）が見つからない	停止し、不足している依存関係を報告します
ソースに複数の決定が記述されている	それぞれ1つの決定を扱う個別のADRに分割します
最大反復回数に達しても閾値未満である	レポートを作成し、手動レビューが必要であることを明記して、バッチを続行します
ソース入力が曖昧である	プロンプトモードに切り替え、前提をADRに記録します
書き込み／権限エラー	ログに記録し、該当項目をスキップして、バッチを続行します

適用

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

関連リソース

• 作成：../doc-adr/SKILL.md · 監査：../doc-adr-audit/SKILL.md · 修正： ../doc-adr-fixer/SKILL.md
• 意思決定の計画：../adr-roadmap/SKILL.md
• 権威ある参照先：${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/ADR-TEMPLATE.yaml、 ${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/README.md、 ${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/ADR-00_index.TEMPLATE.md