はじめに
KAWAI(@kawai_design)氏は 2026 年 3 月 18 日、X で記事「【AI時代ほど1枚が重くなる】要件定義書こそ全てです」を公開しました。仕様駆動開発(Spec-driven Development、SDD)をめぐる議論に、要件定義書という別の切り口を持ち込んだ記事です。
背景には、2026 年 3 月に X で起きた「仕様駆動開発は要るのか、要らないのか」という議論があります。発端は 3 月 11 日の「仕様駆動開発はやめた方がええ」という投稿でした。KAWAI 氏は、この議論は 争点が少しズレている と見ています。減らすべきなのは詳細仕様書で、要件定義書はむしろ重くなる、というのが KAWAI 氏の主張です。
本記事では、この主張を次の 3 点に整理し、実務でどう使うかを考えます。
- なぜ仕様駆動開発の議論はかみ合わないのか
- AI が実装を安くしても、要件定義書が安くならないのはなぜか
- 人間はどの成果物を持ち、どこから AI に任せるのか
用語
| 用語 | 意味 |
|---|---|
| 要件定義書 | 誰のどんな課題を解くのか、何をもって成功とするのか、守るべき制約は何かを決める上流の文書 |
| 詳細仕様書 | 画面・API・データ構造など、どう作るかを細かく決める設計レベルの文書 |
| 受入基準 | 完成したものを受け入れてよいかを判定する条件。テストに落とせる形で書く |
| 仕様駆動開発(SDD) | 仕様書を先に書いてレビューし、それを入力として AI に実装させる進め方 |
仕様駆動開発の議論がかみ合わない理由
「仕様書は要らない、コードこそが真実だ」という意見があります。KAWAI 氏は、これは 詳細設計のレベルではかなり正しい と認めています。AI が実装を速くした今、画面の項目一覧や関数ごとの説明を人が書き写す価値は落ちた、という理由です。
一方で、同じ理屈で要件定義書まで軽く扱うと、別の問題が起きます。誰の課題を解くのか、何をもって成功とするのか、どこまでが制約なのか。これらがあいまいなまま進むと、AI とチームがそれぞれ別の正解を作り始めてしまいます。
「詳細設計なら正しい」と認めること自体がズレている
ここからは筆者の見方です。筆者は、KAWAI 氏のこの譲歩にこそ、議論のズレが残っていると考えます。
コードが正確に示せるのは「システムが今なにをしているか」であって、「なにをすべきか」ではありません。そしてコードの中身は、詳細設計のレベルであっても、AI へのプロンプトや実装者の判断など、誰かの指示で決まります。画面にどの項目を出すか、どの順で処理するか、エラーのときにどうするか。こうした判断が利用者の要求に基づいていなければ、コードは誤った判断を正確に記録しているだけです。
つまり、コードが真実かどうかは、文書のレベル(詳細設計か上流か)では決まりません。そのコードを生んだ指示が、利用者の要求にさかのぼれるか で決まります。「詳細設計のレベルなら正しい」と線を引くと、詳細設計の判断は誰の要求に基づいているのか、という問いが抜け落ちてしまいます。
筆者なりにまとめると、「仕様書は要る / 要らない」の対立は、どのレベルの文書を残すかを言い合っているように見えます。しかし本当の争点は、コードの正しさを何で判定するか です。詳細仕様書を薄くしてよいのは、詳細設計の判断が要らないからではありません。要件定義書 → 受入基準 → テストの鎖があれば、詳細設計の判断も利用者の要求に照らして確かめられるからです(後述)。
AI 時代ほど、要件定義書の 1 行が重くなる
AI エージェントは実装のコストを大きく下げました。しかし KAWAI 氏が指摘するように、要件の読み違いのコストは下がっていません。
要件があいまいなまま AI に実装させると、それらしく動くが現場では使えないものが、最速で量産されます。一見すると動くので、問題が表に出るのは実際に業務で使い始めてからです。実装が速くなった分、「間違ったものを作る速度」も上がったと言えます。
KAWAI 氏は、要件定義書ではっきりさせておくべきこととして、次の 5 つを挙げています(左の列。原文の「受け入れ条件」は、本記事では「受入基準」と書きます)。右の列は筆者による補足です。
| 決めること | あいまいなままだと起きること(筆者補足) |
|---|---|
| 誰の課題か | 使う人のいない機能が増える |
| 何を改善するのか | 改善したかどうかを判断できない |
| どんなときには使わないのか | 想定外の場面にまで適用され、事故が起きる |
| 絶対に破ってはいけない制約は何か | AI が「動く」ことを優先して制約を破る |
| 受入基準 | 完成の判定ができず、手戻りが続く |
どれも、AI に「よしなに」作らせたときに起きやすい失敗です。とくに「使わない場面」と「破れない制約」は、利用者に聞かないと出てこない情報で、AI がコードから推測することはできません。
人間が持つのは「上流の地図」
KAWAI 氏は仕様書を全否定しているわけではありません。要件定義書を、発注側・事業側・開発側・デザイナー・QA、そして AI エージェントが同じ方向を向くための 「上流の地図」 と位置づけています。どこへ向かうのかを、立場の違う全員が同じ 1 枚で確かめられる、ということです。
そして、人間が持つべき成果物の順番として、要件定義書 → 受入基準 → テスト → コード という鎖を示しています。この鎖がつながっていれば、詳細仕様書は薄くてよい、という考え方です。
ここで「コードを人間が持つ」とは、人間が手で書くという意味ではありません。書くのは AI に任せても、どの受入基準を満たすためのコードなのかを人間が把握し、責任を持つという意味です。
逆に、要件定義の裏付けがないままコードだけが増えていく状態 を、KAWAI 氏は最も危険だとしています。コードは動いていても、それが何のために存在するのかを説明できる文書がどこにもない状態です。
鎖をつなぐための実務のポイント
この鎖を実際のプロジェクトでつなぐには、次の点を意識するとよいでしょう。
- 受入基準は、テストに落とせる形で書く。 「使いやすいこと」ではなく、「〇〇の場合は△△を表示する」のように、条件と結果の組で書きます。要求の書き方をそろえるには EARS 記法 が使えます
- 要件定義書に「使わない場面」と「破れない制約」の欄を必ず設ける。 ここは AI が推測で埋めてはいけない部分です。空欄なら、実装に入る前に利用者に確認します
- テストから要件定義書へさかのぼれるようにする。 テスト名やコメントに受入基準の番号を書いておくと、コードを AI が書き直しても、どの要件を守っているのかを追えます
- 詳細仕様書は使い捨てでもよい。 AI に計画を立てさせ、人間が承認して実装する(いわゆる Planモード)だけで足りる場面も多くあります。この点は「SDD は Planモードと何が違うのか」でも整理しました
問うべきは「誰がどの文書を持つか」
KAWAI 氏の結論は、「仕様駆動開発は要るのか」という問いは粒度が粗すぎる、というものです。本当に問うべきなのは、人間がどの文書を持ち、どこから AI に任せるのか です。
詳細仕様書は薄くし、実装は AI に任せてよい。しかし、要件定義書にはこれまで以上の重みを置く。KAWAI 氏の記事タイトルにある「要件定義書こそ全て」は、この線引きを一言で表したものです。
バイブコーディングの本当の問題は、誰も決めていない仕様が実装されること でも書いたように、AI は決められていないことを黙って決めてしまいます。要件定義書は、その「黙って決める」余地を上流で塞ぐための文書だと言えます。
まとめ
- 仕様駆動開発の議論は、どのレベルの文書を残すかを言い合っているように見えるが、本当の争点はコードの正しさを何で判定するか
- 「コードこそが真実だ」は、詳細設計のレベルでも無条件には成り立たない。コードが示すのは「なにをしているか」であり、それを生んだ指示が利用者の要求にさかのぼれるときにだけ正しいと言える
- AI は実装を安くしたが、要件の読み違いは安くならない。あいまいな要件からは、それらしく動くが現場で使えないものが速く出来上がる
- 要件定義書では、誰の課題か・何を改善するか・使わない場面・破れない制約・受入基準をはっきりさせる
- 人間が持つのは 要件定義書 → 受入基準 → テスト → コード の鎖。これがつながっていれば、詳細仕様書は薄くして AI に任せてよい
- 最も危険なのは、要件定義の裏付けがないままコードだけが増えていく状態
