「課題 → 構成 → 結果 → 学び」の型で読める導入事例集。自チームに近いものを1つ選び、同じ構成から始めるのが最短。各事例は一般化した再現可能な型として記述している。
| 課題 | 10年もののモノリス。仕様書なし・テストカバレッジ 10% 未満で、改修のたびにデグレ |
| 構成 | Claude Code のサブエージェントでモジュール単位の挙動を調査→仕様メモを docs/ に生成→そのメモを根拠に特性テスト（characterization test)を追加 |
| 結果 | 3週間で主要モジュールのカバレッジ 60%。以後の改修は AI 任せでもテストが網になる |
| 学び | 「コードを直す」前に「コードを説明させる」が先。生成した仕様メモは人間が必ず1周レビューする |
| 課題 | シニア2名にレビューが集中し、PR の滞留が平均2日 |
| 構成 | CI で claude -p（または Codex のコードレビュー連携）を実行し、規約違反・明らかなバグ・テスト漏れを先に指摘。人間は設計判断に集中 |
| 結果 | 人間レビューの指摘の約半分が前段で消化され、滞留が半日〜1日に短縮 |
| 学び | レビュー観点を Rules / Skills に明文化したことが効いた。AI 指摘への返信を必須にすると形骸化しない |
| 課題 | 「型エラー解消」「非推奨 API 置換」など、簡単だが面倒なタスクがバックログに 50 件滞留 |
| 構成 | 1タスク=1目的に分割して Codex クラウドへ一括投入。翌朝、生成された PR をまとめてレビュー |
| 結果 | 2週間でバックログをほぼ消化。成功率はタスクの独立性に強く依存（独立タスクで体感 7〜8割） |
| 学び | 失敗した PR は深追いせず閉じて手元でやり直す方が速い。環境構築スクリプトの整備で成功率が上がる |
| 課題 | 会議は録画されるが文字起こしは放置され、決定事項が人の記憶頼み |
| 構成 | 文字起こし→共有テンプレ（決定事項・宿題・期限の3点抽出）で要約→ナレッジベースの当該プロジェクト配下に保存、の3段ワークフロー |
| 結果 | 会議後 10 分で全員に決定事項が共有される。過去の決定の検索が可能に |
| 学び | テンプレの「3点だけ抽出」が肝。全文要約にすると誰も読まない。組み込み型の2→3への移行例 |
| 課題 | CS の返信作成に1件 15 分。新人は過去事例を探すだけで時間切れ |
| 構成 | FAQ・過去対応をナレッジ化（RAG）→受信内容から回答下書きと根拠リンクを生成→送信は必ず人間が確認・修正 |
| 結果 | 1件あたり 15 分→5分。新人の立ち上がりが早くなる副次効果が大きい |
| 学び | 「自動送信しない」と最初に決めたことで現場の抵抗がなかった。下書き品質の苦情はナレッジ側の不備のシグナルとして扱う |
| 課題 | 規程・手続きの問い合わせが管理部門に集中（月 200 件超） |
| 構成 | 規程文書を正本に統一→ハイブリッド検索の RAG→チャットツールの社内ボットとして提供。回答には必ず規程の該当箇所リンクを付ける |
| 結果 | 問い合わせの約6割がボットで自己解決。「文書がない質問」のログが規程整備の優先順位になった |
| 学び | 導入の8割は文書整備だった（RAG の手順1）。「分からない時は分からないと答える」指示が信頼を作る |
| 課題 | 取引先ごとに形式が違う発注書（PDF・メール本文）の手入力に毎日2時間 |
| 構成 | 構造化出力（JSON スキーマ）で品目・数量・期日を抽出→既存バリデーションを通過したものだけ基幹に登録→不合格は人間の確認キューへ |
| 結果 | 自動登録率 85%。残り 15% は従来どおり人間が処理（完全自動化を狙わない設計） |
| 学び | 「合格基準を機械的に判定できる形にして、不合格は人間へ」の振り分け設計がすべて。小型モデルで十分でコストはごく小さい |
| 課題 | 障害アラートのたびに当番がログ・メトリクス・直近デプロイを手作業で突き合わせ |
| 構成 | 監視ツール・ログ基盤・GitHub を MCP サーバ経由で読み取り専用接続したエージェントが、アラート発生時に一次調査レポート（仮説3つ＋根拠）を自動生成 |
| 結果 | 当番の初動 30 分が5分に。誤った仮説もあるが「どこを見るべきか」が揃う価値が大きい |
| 学び | 読み取り専用に限定したので導入の合意が早かった。対応操作（再起動等）の自動化は次段階として分離（権限は最小から） |
- 上の事例から「課題」が一番近いものを選ぶ
- その事例の「構成」を最小規模で再現する（対象を1業務・1リポジトリに絞る）
- 「学び」欄の落とし穴を先回りで対策に入れる
- 2週間運用して実測値を取り、効果測定の型で報告する