要件定義書の書き方：AIに伝わる「目的・スコープ・やらないこと」
「いい感じのアプリを作って」だけでは、AIコーディングエージェントは何をどこまで作ればいいのか判断できません。実装を任せる前に書いておくべき要件定義書の中身と、初心者がやりがちな失敗パターンを整理します。
最終更新: 2026-07-23・読了目安 約3分
要件定義書はなぜ必要か
要件定義書とは、「誰のために、何のために、何を作るのか」を言葉にした文書です。AIコーディングエージェントは指示された内容を素直に形にしようとしますが、指示があいまいだと、AIなりの解釈で機能を補い、こちらが想定していなかったものを作ってしまうことがあります。
要件定義書を先に書く目的は、AIに正確な指示を出すことだけではありません。自分自身の頭の中にある「なんとなく作りたいもの」を、具体的な言葉として確認できる形に変換する作業でもあります。書き出す過程で、自分でも気づいていなかった前提や矛盾に気づくことは珍しくありません。本格的なシステム開発における要件定義の考え方は、IPA（情報処理推進機構）「ユーザのための要件定義ガイド 第2版」でも詳しく整理されており、個人開発でも押さえておきたい観点が参考になります。
書くべき5つの項目
個人開発の規模であれば、分厚い文書は不要です。次の5項目を数行ずつ埋めるだけで、AIに渡す最初の指示として十分機能します。
- 目的：このアプリ・機能は何のために作るのか（1〜2文で言い切る）
- 想定ユーザー：誰が、どんな場面で使うのか
- 解決したい課題：今何が不便で、それがどう解消されれば成功か
- 主な機能：箇条書きで3〜5個程度に絞る
- やらないこと：今回のスコープに含めない機能
この5項目は、詳細な仕様よりも一段抽象度の高い「全体像」を担います。具体的な画面設計や入出力の形は、この後の仕様書側で詳細化します。仕様書の書き方はDESIGN.mdテンプレート実例で扱っています。
「目的」を1〜2文に絞り込む練習
目的の欄でありがちな失敗は、「便利なタスク管理アプリを作る」のように抽象的なまま止めてしまうことです。抽象的な目的は、AIにとっても人にとっても判断基準になりません。「毎日の作業を細切れのタスクに分解し、今日やることだけを表示して迷わせないようにする」のように、状況と結果がセットで見える1〜2文まで絞り込みましょう。
目的が具体的であれば、後の「主な機能」を選ぶときにも「これは目的に沿っているか」という判断基準として使えます。目的に沿わない機能は、たとえ思いついても「やらないこと」側に回す判断がしやすくなります。
「やらないこと」を書く重要性
初心者が最も書き漏らしやすいのが「やらないこと」の欄です。「掲示板アプリを作って」とだけ伝えると、AIは会員登録・通知・検索・管理画面まで一度に作ろうとすることがあります。範囲が広がりすぎて、いつまでも完成に辿り着かない——これは個人開発で非常によくある失敗パターンです。
「今回は投稿と一覧表示だけ。会員登録や通知は次のステップ」のように、あえて外す機能を明文化しておくと、AIも人も同じ範囲を見て進められます。スコープを絞る考え方の詳細は個人開発のアイデアの見つけ方やシラバスの仕様駆動開発の週でも扱っています。
よくある失敗パターンとチェックリスト
要件定義書を書くときに陥りやすい失敗を、チェックリストとしてまとめます。
- 目的が抽象的すぎる：「使いやすい」「便利な」など評価が人によって変わる言葉だけで終わっていないか
- 想定ユーザーが「誰でも」になっている：対象を絞らないと、機能の優先順位も決められない
- やらないことを書いていない：スコープが際限なく広がる原因になる
- 主な機能が10個以上ある：1つの成果物に詰め込みすぎている可能性が高い
- 完成の定義があいまい：「動けば完成」なのか「特定の操作ができれば完成」なのかが曖昧なまま進めていないか
これらは書いた直後には気づきにくいものです。書き終えたら一晩置いてから読み返す、あるいは他の人に読んでもらうだけでも、抜け漏れに気づきやすくなります。要件定義書ができたら、それをもとに機能や画面をより詳細化する仕様駆動開発のステップに進みます。
よくある質問
Q1. 要件定義書と仕様書は何が違いますか？
要件定義書は「誰のために、何のために作るのか」という全体像を言葉にしたものです。仕様書はそれをもとに、具体的な機能や画面、入出力の形を詳細化したものです。書く順番は全体像（要件定義書）→詳細（仕様書）の順が基本です。
Q2. 要件定義書はどのくらいの分量で書けばいいですか？
個人開発の規模であれば分厚い文書は不要です。目的・想定ユーザー・解決したい課題・主な機能・やらないことの5項目を数行ずつ埋めるだけで、AIへの最初の指示として十分機能します。
Q3. 「やらないこと」を書かないとどうなりますか？
AIが会員登録・通知・検索・管理画面など、こちらが想定していなかった機能まで一度に作ろうとすることがあります。スコープが広がりすぎて完成が遠のく、というのが個人開発でよくある失敗パターンです。