本文へスキップ
hdknr blog
戻る

AI 時代こそ要件定義書が重くなる — 仕様駆動開発(SDD)の議論がかみ合わない理由

はじめに

KAWAI(@kawai_design)氏は 2026 年 3 月 18 日、X で記事「【AI時代ほど1枚が重くなる】要件定義書こそ全てです」を公開しました。仕様駆動開発(Spec-driven Development、SDD)をめぐる議論に、要件定義書という別の切り口を持ち込んだ記事です。

背景には、2026 年 3 月に X で起きた「仕様駆動開発は要るのか、要らないのか」という議論があります。発端は 3 月 11 日の「仕様駆動開発はやめた方がええ」という投稿でした。KAWAI 氏は、この議論は 争点が少しズレている と見ています。減らすべきなのは詳細仕様書で、要件定義書はむしろ重くなる、というのが KAWAI 氏の主張です。

本記事では、この主張を次の 3 点に整理し、実務でどう使うかを考えます。

用語

用語意味
要件定義書誰のどんな課題を解くのか、何をもって成功とするのか、守るべき制約は何かを決める上流の文書
詳細仕様書画面・API・データ構造など、どう作るかを細かく決める設計レベルの文書
受入基準完成したものを受け入れてよいかを判定する条件。テストに落とせる形で書く
仕様駆動開発(SDD)仕様書を先に書いてレビューし、それを入力として AI に実装させる進め方

仕様駆動開発の議論がかみ合わない理由

「仕様書は要らない、コードこそが真実だ」という意見があります。KAWAI 氏は、これは 詳細設計のレベルではかなり正しい と認めています。AI が実装を速くした今、画面の項目一覧や関数ごとの説明を人が書き写す価値は落ちた、という理由です。

一方で、同じ理屈で要件定義書まで軽く扱うと、別の問題が起きます。誰の課題を解くのか、何をもって成功とするのか、どこまでが制約なのか。これらがあいまいなまま進むと、AI とチームがそれぞれ別の正解を作り始めてしまいます。

「詳細設計なら正しい」と認めること自体がズレている

ここからは筆者の見方です。筆者は、KAWAI 氏のこの譲歩にこそ、議論のズレが残っていると考えます。

コードが正確に示せるのは「システムが今なにをしているか」であって、「なにをすべきか」ではありません。そしてコードの中身は、詳細設計のレベルであっても、AI へのプロンプトや実装者の判断など、誰かの指示で決まります。画面にどの項目を出すか、どの順で処理するか、エラーのときにどうするか。こうした判断が利用者の要求に基づいていなければ、コードは誤った判断を正確に記録しているだけです。

つまり、コードが真実かどうかは、文書のレベル(詳細設計か上流か)では決まりません。そのコードを生んだ指示が、利用者の要求にさかのぼれるか で決まります。「詳細設計のレベルなら正しい」と線を引くと、詳細設計の判断は誰の要求に基づいているのか、という問いが抜け落ちてしまいます。

筆者なりにまとめると、「仕様書は要る / 要らない」の対立は、どのレベルの文書を残すかを言い合っているように見えます。しかし本当の争点は、コードの正しさを何で判定するか です。詳細仕様書を薄くしてよいのは、詳細設計の判断が要らないからではありません。要件定義書 → 受入基準 → テストの鎖があれば、詳細設計の判断も利用者の要求に照らして確かめられるからです(後述)。

AI 時代ほど、要件定義書の 1 行が重くなる

AI エージェントは実装のコストを大きく下げました。しかし KAWAI 氏が指摘するように、要件の読み違いのコストは下がっていません。

要件があいまいなまま AI に実装させると、それらしく動くが現場では使えないものが、最速で量産されます。一見すると動くので、問題が表に出るのは実際に業務で使い始めてからです。実装が速くなった分、「間違ったものを作る速度」も上がったと言えます。

KAWAI 氏は、要件定義書ではっきりさせておくべきこととして、次の 5 つを挙げています(左の列。原文の「受け入れ条件」は、本記事では「受入基準」と書きます)。右の列は筆者による補足です。

決めることあいまいなままだと起きること(筆者補足)
誰の課題か使う人のいない機能が増える
何を改善するのか改善したかどうかを判断できない
どんなときには使わないのか想定外の場面にまで適用され、事故が起きる
絶対に破ってはいけない制約は何かAI が「動く」ことを優先して制約を破る
受入基準完成の判定ができず、手戻りが続く

どれも、AI に「よしなに」作らせたときに起きやすい失敗です。とくに「使わない場面」と「破れない制約」は、利用者に聞かないと出てこない情報で、AI がコードから推測することはできません。

人間が持つのは「上流の地図」

KAWAI 氏は仕様書を全否定しているわけではありません。要件定義書を、発注側・事業側・開発側・デザイナー・QA、そして AI エージェントが同じ方向を向くための 「上流の地図」 と位置づけています。どこへ向かうのかを、立場の違う全員が同じ 1 枚で確かめられる、ということです。

そして、人間が持つべき成果物の順番として、要件定義書 → 受入基準 → テスト → コード という鎖を示しています。この鎖がつながっていれば、詳細仕様書は薄くてよい、という考え方です。

要件定義書、受入基準、テスト、コードの順に矢印でつながる鎖の図。上流ほど人間が重く持ち、詳細仕様書と実装作業は薄くして AI エージェントに任せてよいことを示している

ここで「コードを人間が持つ」とは、人間が手で書くという意味ではありません。書くのは AI に任せても、どの受入基準を満たすためのコードなのかを人間が把握し、責任を持つという意味です。

逆に、要件定義の裏付けがないままコードだけが増えていく状態 を、KAWAI 氏は最も危険だとしています。コードは動いていても、それが何のために存在するのかを説明できる文書がどこにもない状態です。

鎖をつなぐための実務のポイント

この鎖を実際のプロジェクトでつなぐには、次の点を意識するとよいでしょう。

問うべきは「誰がどの文書を持つか」

KAWAI 氏の結論は、「仕様駆動開発は要るのか」という問いは粒度が粗すぎる、というものです。本当に問うべきなのは、人間がどの文書を持ち、どこから AI に任せるのか です。

詳細仕様書は薄くし、実装は AI に任せてよい。しかし、要件定義書にはこれまで以上の重みを置く。KAWAI 氏の記事タイトルにある「要件定義書こそ全て」は、この線引きを一言で表したものです。

バイブコーディングの本当の問題は、誰も決めていない仕様が実装されること でも書いたように、AI は決められていないことを黙って決めてしまいます。要件定義書は、その「黙って決める」余地を上流で塞ぐための文書だと言えます。

まとめ

参考



前の記事
仕様駆動開発(SDD)の実践事例 — PRD から PR まで AI に渡す設計書と 2 つの課題
次の記事
『図と事例でやさしく学べる 要件定義 基本からAI対応まで』を目次から読む — 5 領域モデルと生成 AI の使いどころ