AI駆動開発の実運用ノート

AI駆動開発の実運用ノート　›　本編の目次　›　第2部

第2部・全32回要件定義と設計

AI は文書を読んで実装する——文書の質が実装の質の上限になる

第2部を最初から読む

はじめに

  1. No.30AIに何を作らせるかを、どう文書で伝えるか
  2. No.31第2部から読み手は判定する側に回る

エンジニアの立ち上げ

  1. No.32AIに任せる前に知っておくべき相手のクセ
  2. No.33実際に起きたAIの悪癖4つと、その対策の置き場所
  3. No.34Claude Code を統治の4階層で捉える
  4. No.35題材システム Keihi を起動して一巡する

ドキュメント駆動開発

  1. No.36AIは何を読んで実装するのか
  2. No.37AIにとって文書は読み物ではなく実行環境
  3. No.382.4ヶ月コミットが止まり、9分間で要件57本が入った
  4. No.39要件と画面を突き合わせるギャップ分析
  5. No.40文書は98本から274本へ、事業の写像として育つ
  6. No.41文書に残った古い250円をAIが信じて誤説明した
  7. No.42文書は4ヶ月で3種類の劣化を起こした
  8. No.43コード変更と文書更新を同じコミットに縛る

イシュー駆動とタスク分割

  1. No.44すべての作業をイシューから始めると何が変わるか
  2. No.45イシュー管理ツールはAIの外部記憶である
  3. No.46「レビュー中」に独自の意味を与えて品質ゲートにする
  4. No.471PR = 1レイヤーで分ける理由

大規模な要件追加・仕様変更の作法

  1. No.48大きな仕様変更のとき、AIに何と言うか
  2. No.49大規模変更5件の実例で何が起きたか
  3. No.508回却下した設計案をAIがまた提案してくる
  4. No.51「お金の支払いが発生する業務は急がない」
  5. No.52人間が出すのは答えではなく原則と反例
  6. No.53コードより先に「設計メモ」を書く
  7. No.54「小さな変更」が実測で12ファイル40箇所になった
  8. No.55大規模変更を安全に進める4つの段階
  9. No.56別のセッションのAIが8時間で11PRを完走した計画書

再現と演習

  1. No.57要件と画面を突き合わせて、実装前に漏れを見つける
  2. No.58要件文書を1PR=1レイヤーのイシューに割る
  3. No.59ギャップ分析で要件と画面の食い違いを洗い出す
  4. No.60AIが書いた設計メモの穴を3つの観点で探す
  5. No.61第2部のまとめと、第3部への問い