仕様駆動開発とは：AIに実装を任せる前に書くべきこと

仕様駆動開発とは、コードを書き始める前に「何を作るか」「どう動けば正しいか」を文章として先に定義し、それをもとに実装を進める考え方です。AIコーディングエージェントは指示された内容をそのまま形にしようとするため、指示があいまいなままだと、AIは間違っていなくても「あなたが本当に欲しかったもの」とは違う結果を出してしまいます。

仕様を先に書くことは、AIのための説明書であると同時に、自分自身の頭の中を整理する作業でもあります。「なんとなく作りたいもの」を「具体的に確認できるもの」に変換する——それが仕様駆動開発の中心的な役割です。この考え方は個人開発に限らず、AIコーディングエージェント向けの標準的な進め方としても広がっており、GitHub公式ブログ「Spec-driven development with AI」でも、仕様を「意図の源泉」として扱う進め方が紹介されています。

3つの言葉は似ていますが、役割が異なります。

• 要件定義書：「誰のために、何のために作るのか」を言葉にしたもの。想定ユーザー・解決したい課題・実現したいことの全体像を書きます。書き方は要件定義書の書き方で詳しく解説しています。
• 仕様書：要件定義書をもとに、「具体的にどんな機能を、どう動かすか」を詳細化したもの。画面の項目、入力と出力、扱うデータの形などを書きます。
• 受け入れ基準：「何をもって完成とみなすか」の判定リスト。「ログインできる」だけでなく「メール形式が誤っている場合はエラーを表示する」のように、具体的な条件として書きます。

個人開発の規模であれば、3つを分厚い文書にする必要はありません。それぞれ数行〜数十行程度でも十分機能します。大切なのは、書く順番（全体像→詳細→判定基準）を守ることです。

いきなり形式にこだわらず、次の項目を埋めることから始めてみましょう。

• 目的：このアプリ・機能は何のために作るか（1〜2文）
• 想定ユーザー：誰が、どんな場面で使うか
• 主な機能：箇条書きで3〜5個程度
• 入力・出力：ユーザーが何を入力し、何が返ってくるか
• やらないこと：今回のスコープに含めない機能（意外と重要です）
• 受け入れ基準：「〜のとき、〜になれば完成」という文を3〜5個

この文書をAIコーディングエージェントへの最初の指示として渡すと、AIは前提を推測する必要が減り、意図に近い実装を返しやすくなります。仕上がりを見て足りない点があれば、仕様書側に追記して再度渡す——この往復が仕様駆動開発の基本サイクルです。

初心者が仕様を書くとき、最も抜け落ちやすいのが「やらないこと（スコープ外）」の明記です。「掲示板アプリを作って」とだけ伝えると、AIは会員登録・通知・検索・管理画面まで一度に作ろうとすることがあります。結果、範囲が広がりすぎて完成が遠のく、というのはよくある失敗パターンです。

「今回は投稿と一覧表示だけ。会員登録や通知は次のステップ」のように、あえて外す機能を明文化しておくと、AIも人も迷わず進められます。スコープを絞る考え方は個人開発MVPの作り方でも詳しく扱っています。

仕様書を用意すれば、AIの実装が自動的に正しくなるわけではありません。仕様書は「ズレを減らす」道具であり、「確認を省略していい」道具ではない点に注意してください。実装後は受け入れ基準と照らし合わせて、一つずつ満たしているかを確認する作業が欠かせません。この確認・検証の具体的なやり方はAIが書いたコードのテストとレビューで解説しています。

Q1. 仕様駆動開発と要件定義書の違いは何ですか？
要件定義書は「誰のために、何のために作るのか」という全体像を、仕様駆動開発はその全体像から仕様書・受け入れ基準まで一貫して書き、AIへの指示の土台にする考え方全体を指します。要件定義書は仕様駆動開発の最初のステップにあたります。

Q2. 仕様書を書けば、AIの実装は必ず正しくなりますか？
なりません。仕様書は指示と実装のズレを減らす道具であり、確認を省略していい道具ではありません。実装後は受け入れ基準と照らし合わせて一つずつ満たしているかを確認する作業が欠かせません。

Q3. 個人開発でも仕様駆動開発は必要ですか？
分厚い文書は不要ですが、目的・主な機能・やらないこと・受け入れ基準を数行ずつ書いておくだけでも、AIが前提を推測する必要が減り、意図に近い実装を返しやすくなります。小規模でも書く価値があります。

この記事は無料で読める入門です。動画でまとめて学びたい方には、要件定義からDESIGN.mdまでを一気に扱う特別講義仕様駆動開発マスター講義も無料で公開しています。仕様駆動開発は全12週のシラバスの第4〜5週で、実際に自分のアプリ企画の仕様書を書き、それに基づいて実装する形で扱います（成果や収益をお約束するものではありません）。先行案内はこちら。