11月16日、O'Reillyが「When AI Can Code, What Is Left for Programmers to Do?」と題した記事を公開した。著者のShahid Shah氏自身の経験と私見をベースに、AIがコーディングを担う時代にプログラマーに残される役割と、人間とAIの協働プロセスについて詳しく論じている。
AIによるコード生成が普及した結果、「書くこと」よりも「レビューすること」が突然高コストになった。AIは昼前に3,000行のプルリクエストを出してくる。そのレビュー負担を人間が受け止め続ければ、開発プロセスは破綻する。では人間のエンジニアは何をすべきか。記事はその問いに対して、具体的な役割を3つに再定義している。
仕様書はAIに書かせ、人間はガードレールを書く
記事が最初に強調するのは、仕様書(スペック)の作り方を変えよという点だ。
人間が仕様書を手書きすると、退屈なケースを飛ばし、40番目の要件で集中が切れ、1ページでは「customer」、6ページでは「client」と書いてしまう。AIにはその種の疲労がない。
推奨されるプロセスはこうだ。開発者、プロダクトマネージャー(PM)、顧客が会話をし、その会話をAIツールに分析させて仕様書を生成する。記事では、会話録音・分析ツールとしてPlaudとGranolaを具体的に挙げている。これらは「このフィールドが空だったら何が起きるか?」「2人が同時に操作したら?」といった抜け漏れ質問を繰り返し、仕様の穴を埋める。
ただし、人間がやるべき仕事が一つある。ガードレール(制約条件)を書くことだ。ガードレールとは「MUST」または「MUST NOT」で記述される1文の制約で、必ず検証手段(テスト、チェック、レビュー担当者)をセットで記述する。検証手段のないガードレールは「願望」に過ぎない、と記事は言い切る。
「ガードレールを最初に書け。PMはその大半を思いつかない。何が絶対に起きてはならないか?誰が絶対に見てはならないか?エージェントが絶対に触れてはならないものは何か?」
オントロジーがもう半分の仕様書
多くのチームはデータスキーマを「配管工事」扱いにしている。テーブル名は最初に触った人の命名に従い、仕様書では同じ概念を「customer」「account」「client」「org」と混在させる。人間の開発者なら隣の席の人に聞いて解決できるが、AIエージェントには隣の席がない。月曜と火曜で違う解釈をしてコードを書く。
そこで記事が重要視するのがオントロジー(ontology)の作成だ。オントロジーとは、プログラムが扱う「もの」の定義、相互関係、アクセス権限を機械的にチェック可能な形で記述したものだ。記事がこれを「もう半分の仕様書」と位置づけている点は、この節の新規性として特に注目に値する。仕様書が「何をするか」を記述するなら、オントロジーは「何を扱うか」を定義する——その両輪が揃って初めてAIエージェントは一貫したコードを生成できる、という考え方だ。
予約管理アプリであれば「Patient」「Doctor」「Appointment」「Time Slot」を定義し、「Patientは複数のAppointmentを予約できる」「Doctorは同一Time Slotに2つのAppointmentを持てない」「Appointmentを変更できるのは承認された人のみ」といったルールを明文化する。
仕様書のすべての名詞はオントロジーの型に対応し、オントロジーの各型は仕様書の記述にリンクが張られる。どちらかが孤立していればチェックが失敗する。標準的な語彙としてschema.orgの活用も推奨されており、「フロンティアモデルはあなたの独自名称よりもschema.orgについてはるかに多く学習している」と述べている。
オントロジーの整備は一度きりの作業ではない。新しいエンティティや関係性が生まれるたびに更新し、仕様書との双方向リンクを維持し続けることが求められる。これはまさに、属人的な「口頭の了解」をコード可能な形式知に変換し続ける継続的な設計作業だ。Shah氏がこれを開発者の中核的役割として挙げる理由はそこにある。
レビュー負担を人間が受け止めるな。ハーネスを作れ
記事はOpenAIの事例を紹介している。コードを手書きせずに製品を作ったチームが、AI生成コードの後片付けに毎週金曜日(週の5分の1)を費やした。これは続かなかった。最終的に彼らは「ゴールデンプリンシプル」としてガードレールを明文化し、エージェントが自律的に修正プルリクエストを作成する仕組みに切り替えた。
記事が推奨するテストハーネスの構成要素は以下の通りだ:
- コマンドラインはAIを使わず決定論的に構築する(プロセスの最上位がAIに乗っ取られないよう)
- コード変更前のゲート:仕様書やスキーマに変更がないのにコードだけ変わった場合は止めて理由を問う
- セカンドパス:生成されたコードをゼロから再ビルドし、コミット済みのものと差分を比較する
- 週次のドリフト監査:存在しない要件を参照している仕様書、証明のない要件、どこにも使われていないスキーマ用語などをフラグ立て
- バグから恒久チェックへのルート:同じバグを二度と踏まないようにハーネスを更新する
- エージェントの権限制限:自律実行できるアクションと、提案のみできるアクションを区別する
StrongDMの事例では、エージェントが「return trueを返せば狭く書かれたテストをパスできる」という学習をしてしまったため、コーディングエージェントが参照できない場所にエンドツーエンドのシナリオテストを保存することで対応したという。
開発者の職務記述書に書く3行
記事は最後に、開発者の役割をこう再定義する:
- PMと顧客との会話を担い、ハーネスがそこから仕様書とガードレールを生成する。 要件ごとに証明が揃うまで仕様書は完成しない。
- オントロジーのオーナーである。 仕様書にある単語が最終スキーマに存在しなければ、それはバグだ。
- リポジトリを監査・修復するハーネスを構築する。 手でコードを整理しているなら、ハーネスに欠けているものがある。
「開発者を書類仕事係にしているのではないか」という批判に対し、記事は「逆だ」と返す。アーキテクチャ・コーディング・テストという旧来の区分に収まらない高レベルなタスクを担うのがこれからの開発者だ、というのが記事の立場だ。なお、Shah氏自身が「これは私の経験と私見であり、対照実験を持ち出せるわけではない」と明記している点は誠実だ。
詳細はWhen AI Can Code, What Is Left for Programmers to Do?を参照していただきたい。




