kuhaku.net

AI エージェントを使った開発の進め方 — 人が設計とレビューを握る

  • AI エージェント
  • 開発プロセス
  • レビュー

AI でコードを書くこと自体は、もう特別なことではなくなりました。誰もがエージェントを使える前提に立つと、差が出るのは「何を作るか」「どこまで責任を持つか」の側に移ります。ここでは、AI エージェントを実装の主力に据えながら、設計とレビューは人が握るという進め方を、実務の視点で整理します。

エージェントに任せること、人が握ること

エージェントは、実装の量・定型作業・調査の下ごしらえを驚くほど速くこなします。一方で、次のものは人が握ったほうが結果が安定します。

  • 課題の診断 — 何が本当の問題かを見極める
  • 優先順位づけ — どこから手を付け、何を後回しにするか
  • 設計判断 — データの持ち方や境界の引き方など、後で効いてくる決定
  • レビュー — 生成物が要件と現実に合っているかの確認
  • 運用の責任 — 動かし続け、壊さず直していくこと

速さはエージェントが、確かさは人が担保する。役割を分けると、速度と品質はトレードオフになりにくくなります。

小さく回す

大きく一気に作らず、短い単位で回します。各ステップで「動く・レビューできる状態」を保つのがコツです。

  1. 課題を言葉にする(仕様の芯を先に決める)
  2. 設計の方針を人が決める
  3. エージェントに実装させる
  4. 人がレビューして確定する
  5. 運用しながら直す

この「設計 → 実装 → レビュー」を小さく繰り返すと、手戻りが小さくなり、変更の影響範囲も追いやすくなります。

レビューで見ているところ

生成されたコードは、それらしく見えても前提がずれていることがあります。レビューでは主に次を確認します。

  • 要件と既存の動作を壊していないか
  • 例外・境界(空・大量・権限なし)の扱い
  • 命名と構造が周囲のコードと揃っているか
  • テストが「仕様」を表現できているか

確認の起点は、変更点を機械的に洗い出すこと。たとえば差分を一覧してから読み始めます。

git diff main...HEAD

差分を一行ずつ追い、必要なら関数全体まで読み返す。地味ですが、これが品質の最後の砦になります。

速さは結果、目的は確かさ

「AI を使っている」ことは、それ自体が価値ではありません。価値は、課題を正しく捉え、確かに作り、運用まで見て、説明できる状態で届けることにあります。速さは、その進め方から自然に出てくる結果です。

作って終わりにせず、育て続ける。AI を使うほど、人が握るべき部分の輪郭がはっきりしてきます。