付録C：成果物テンプレート集（ADR/PR/Runbook/ポストモーテム）
AIエージェントの出力を実務で活用する際は、「会話ログ」だけで終わらせず、成果物（意思決定・変更管理・運用手順・障害記録）に落とし込むことが重要です。本付録では、そのためのテンプレートをまとめます。
注意: AI の提案は誤り得ます。成果物には必ず「検証結果」「根拠」「責任者（レビュー担当）」を残してください。
ADR テンプレート（Architecture Decision Record）
# ADR: <意思決定タイトル>
## ステータス
- Draft / Accepted / Superseded / Deprecated
## 日付
- YYYY-MM-DD
## 決定者（責任者）
- <氏名/役割>
## 背景（Context）
- 何が課題か（現状/問題/制約）
- 何を最適化するのか（品質特性: 例 可用性/保守性/コスト/セキュリティ）
- 前提（確定事項）と未確定事項（要確認）
## 要求（Requirements）
- 機能要件:
- 非機能要件:
- 制約:
## 選択肢（Alternatives）
### Option A: <案1>
- 概要:
- メリット:
- デメリット:
- リスク:
### Option B: <案2>
（同上）
### Option C: <案3>
（同上）
## 決定（Decision）
- 採用案:
- 採用理由（トレードオフ含む）:
## 影響（Consequences）
- 期待する効果:
- 影響範囲（変更が及ぶ範囲）:
- 運用への影響:
## リスクと対策
- リスク:
- 対策:
- ロールバック/撤回方針:
## 検証（Verification）
- 何を確認すれば「正しい判断だった」と言えるか（検証観点）
- 検証手順（テスト/計測/レビュー）
- 期限:
## 参照（References）
- 参照ドキュメント/ログ/チケット:
## AI利用の記録（任意）
- 利用範囲: Level 0/1/2/3（自律度）
- 入力に含めた情報: <概要（機密は書かない）>
- 出力の採用範囲: <どこを採用/どこを捨てたか>
- 人間の検証: <誰が/何を/どう確認したか>
PR テンプレート（Pull Request）
# 変更概要（Summary）
- 何を変えたか（1〜3行）
## 背景 / 目的（Motivation）
- なぜ必要か（課題、チケット、ユーザー影響）
## 変更内容（Changes）
- 変更点1:
- 変更点2:
- 変更点3:
## 影響範囲（Scope）
- 影響を受ける機能/ファイル/環境:
- 互換性（破壊的変更の有無）:
## テスト / 検証（Testing）
- 実施したテスト:
- 再現手順:
- 期待結果:
## リスクと対策（Risks）
- リスク:
- 対策:
## ロールバック（Rollback）
- 戻し方（手順/条件）:
## レビュー観点（Review Focus）
- 重点的に見てほしいポイント:
## AI利用の記録（推奨）
- 利用範囲: Level 0/1/2/3（自律度）
- AIが生成したもの: 草案/差分案/レビュー観点/手順 など
- 人間の確認: 影響範囲/テスト/一次情報の裏取り
- 未確認点（要確認）:
Runbook テンプレート（運用手順書）
# Runbook: <手順書タイトル>
## 目的
- 何を達成する手順か
## 適用範囲
- 対象環境（検証/本番）:
- 対象システム/コンポーネント:
## 前提
- 必要な権限:
- 必要なツール:
- 事前確認:
## 禁止事項 / 注意事項
- （例: 破壊的操作は二重承認、機密情報の取り扱い、実行時間帯）
## 承認ゲート（Go/No-Go）
- 実行前に確認する項目:
- 承認者:
## 手順（Procedure）
1. 手順
2. 手順
3. 手順
## 検証（Verification）
- 成功条件:
- 確認コマンド/ログ:
## 失敗時の対応（Failure Handling）
- 典型的な失敗パターン:
- 切り分け手順:
## ロールバック（Rollback）
- 戻す手順:
- 影響/注意点:
## 監査ログ（Audit）
- どのログ/チケット/変更履歴を残すか
## AI利用の記録（任意）
- AIに依頼した範囲:
- 人間が確認した範囲:
ポストモーテム テンプレート（障害報告・再発防止）
# Postmortem: <インシデントタイトル>
## 概要（Summary）
- 発生日:
- 影響:
- 重要度:
## タイムライン（Timeline）
- YYYY-MM-DD hh:mm 事象
- YYYY-MM-DD hh:mm 対応
## 影響範囲（Impact）
- 影響を受けたユーザー/機能:
- 期間:
- 金銭/信用への影響（あれば）:
## 検知（Detection）
- 何で検知したか（監視/通報/ログ）:
- 検知が遅れた要因（あれば）:
## 対応（Response）
- 何をしたか（暫定対応）:
- 何が効いたか / 効かなかったか:
## 原因（Root Cause）
- 直接原因:
- 背景要因（プロセス/設計/運用）:
## 再発防止（Action Items）
- 短期（今週/今月）:
- 中期（四半期）:
- 長期（半年〜）:
- 担当者/期限:
## 学び（Lessons Learned）
- 技術面:
- プロセス面:
- コミュニケーション面:
## 参照（References）
- チケット/PR/ログ/監視グラフ:
## AI利用の記録（任意）
- AIが出した仮説/手順の採否:
- 人間が裏取りした一次情報:
- 誤り/改善点（次回の運用に反映すること）: