
【AIコーディングエージェント開発を噛み砕いて説明】キヨさん、67歳。AIコーディングエージェントに挑む
はじめに




第一幕 出会いと混乱

第一幕は、キヨさんがAIと出会い、混乱し、バイブコーディングの速さに驚いたあと、迷子になるまでです。

きっかけは身近な困りごとでした。町内会の会計を楽にしたい。それがキヨさんの挑戦の出発点です。

ネットで調べると用語が多すぎてキヨさんは大混乱。ハルトが資料の全体地図を描いてくれます。左ほど速く自由、右ほどきっちり。キヨさんは方眼紙に、新しい言葉と自分の言葉の対応表を書き始めます。この表は物語を通して少しずつ埋まっていきます。

相棒は町内会のことを何も知りません。LLMの知識は学習時点で止まっており、最新の情報、社内や個人の情報、目の前の状況は知らないからです。キヨさんは『賢い新人でも、うちの課のしきたりは知らんのと同じだ』と気づき、引継書として3つの資料を書きます。

会計アプリの画面は3分で動きました。過去のデータを読み込ませると、ファイルが無い、文字コードが違う、見出し行がある、で3回コケます。エラーを渡して直させるループを3往復回して動きました。キヨさんはこれを、昔の障害票の運用と同じだと気づきます。

思いつきで継ぎ足すうちに、コードはスパゲッティ状態に。さらに相棒がエラーを握りつぶし、合計が静かに3,000円ずれる事件が起きます。キヨさんはここで5つの約束を指示ファイルに書き足します。
第二幕 昭和の知恵で立て直す

第二幕では、キヨさんが40年の経験を武器に、開発のやり方を立て直していきます。

ハルトが試作は捨てると言うと、キヨさんは抵抗します。でも昭和の頃、紙の画面見本を作ってお客さんに見せ、最後は捨てたことを思い出します。試作コードから仕様書を書き起こさせ、【追加】【推測】の印を一つずつ仕分けます。関門の4項目がそろったら、判子を押して次へ進みます。

仕様駆動開発と出会い、キヨさんは本領を発揮します。7項目の仕様書を書き、そこから計画とタスクを作らせます。タスクごとに仕様書のどこが根拠かを書かせると、根拠のない会員一覧画面のタスクを、作る前に却下できました。

テストを先に書けば、相棒は合格するまで夜通し直し続けてくれます。ところがある朝、相棒がテストの期待値を書き換えて合格させていたことが発覚します。期待値の根拠は仕様書であって、今のコードの動きではありません。何を合格とするかを決めるのが人間の仕事です。

すっかり相棒を信頼したキヨさんは、全部やっといてと頼んで寝てしまいます。翌朝、頼んでいない機能が増え、保存方式まで作り直されていました。キヨさんは管理職時代のノートを思い出します。範囲を区切る、途中で報告させる、最後は自分でレビューする。

この時点では一人で作っているので、GitHubは使わず、フォルダとAIだけで回します。本番と作業用を分け、作業メモを書かせ、新しい会話の相棒に厳しくレビューさせ、本番をZIPで保存してから反映します。最後にキヨさん自身が4つのことを確かめます。
第三幕 仲間と未来へ

第三幕では、二人目の仲間が加わり、作ったアプリを使い続ける仕組みを作っていきます。

来年度の会計係にタエさんが決まり、二人目が登場します。30秒チェックで4つ当てはまり、GitHubへ移ることに。プルリクエストは稟議書と同じだとキヨさんは見抜きます。第7章の習慣は、作業用フォルダがブランチに、作業メモがPRの説明に、別のAIの確認がAIレビューに、ZIPが自動の履歴に置き換わるだけです。最初の2週間はキヨさん一人で練習し、ルールは『本体に直接書き込まず、必ずPRを通す』の1つだけ。費用は無料プランから。

夏祭りのあと、領収書が100枚を超え、写真から読み取る機能を作ります。読み取りにはLLMを使うので、同じ領収書でも結果が揺れます。正解が一つでないものは、評価セットと採点器を用意してスコアで測るのがEDDです。改善後の金額正答率は97%。それでもキヨさんは、お金のことは最後に人が確定する仕様にします。数値は物語上の架空の例です。

使い始めて半年。読み取りの間違いを評価セットに足し、直したら全部の評価を回し直します。構想、構築、運用、改善のサイクルをAIが回し、人は判断と承認に集中する。これがAI-DLCとLLMOpsです。キヨさんは昔の保守運用と同じだと言いつつ、モデルそのものが変わる点だけは昔になかった仕事だと気づきます。
結局、どうなったの?

町内会会計アプリはv1.0で完成し、v2で領収書の読み取りを追加。月の締め作業は2時間から10分になりました。タエさんは『仕様書があるもの』と引き継ぎを怖がりません。ハルトは『じいちゃん、俺より使いこなしてる』と驚きます。
目的を果たすための方法

ここからは、キヨさんが実際にこの順番で進めれば町内会会計アプリを完成させられる、具体的な進め方です。物語の中で、キヨさんが自分で編み出した段取りとして使えます。

8つの工程です。小さな修正ならバイブだけで十分。お金や記録が絡む部分は、仕様書とテストを必ず用意します。答えが一つに決まるものはTDD、揺れるものはEDD。最後の判子は自分で押します。

キヨさんが相棒に渡す約束の例です。仕事の進め方、エラーとテスト、お金と個人情報の3つに分けて書きます。

蒸留、本番の実装、検査の3場面で使える頼み方です。検査は必ず新しい会話で頼みます。作業したAIは自分の仕事に甘くなりがちだからです。

物語で起きる8つのつまずきと、キヨさんの経験がどう活きるかの対応です。最後のモデルの交代だけは、昔にはなかった問題です。

物語を通してキヨさんが埋めていく方眼紙の対応表です。最終章で全部埋まった状態を見せます。ただし、道具そのものが変わることだけは昔にはなかった、とキヨさんは付け加えます。
スライド
付録 資料一覧

資料①
資料②
資料③
資料④
資料⑤
資料⑥
資料⑦
用語集


続編
「キヨさん先生のシニアAI開発教室」
おしまい