頭の中の完成像は、そのままではAIに伝わりません。
思いつきを短いお願いだけで渡すと、AIは受け取った言葉の範囲で形にします。目の前の出力と自分の認識を比べて、初めて言葉にできる違いがあります。
バイブコーディングでは、最初から完璧な指示を作る必要はありません。まず出してもらい、触って、気づいたズレを返します。
大切なのは、ズレを「失敗」で終わらせないことです。ズレを見つける→言葉にする→直してもらう。この往復が、完成像を少しずつ共有する時間になります。
出てきたものが違う。
だから、次に伝えることが分かる。
最初に決めるのは「何を作るか」と「何を作らないか」です。
要件定義は、作りたいものの輪郭を先に言葉にすることです。最初に埋めるのは、4つの枠だけで構いません。
やりたいことは、機能名ではなく「誰が・いつ・どうなったら嬉しいか」を1〜3行の物語にします。
使う場面は、端末や人数など、実際に使う状況です。完成の条件は、できたかどうかを判断する合格ラインです。
やらないことは、作りたいものが膨らむのを防ぐ柵です。後から足せることでも、今回は入れないと決められます。
- ひとことで言うと
- 要件定義 = 作る範囲と、完成の判断基準を先にそろえること。
機能名でなく、場面と合格ラインを書きます。
例えば、架空の教材として「買い物リストアプリ」を考えます。機能名だけでなく、使う場面と、完成したか確かめる条件まで言葉にします。
やりたいことは、アプリ名や機能名だけで終わらせず、使う人・場面・得たい変化を入れます。これだけで「何のための機能か」が見えます。
買い物リストアプリを作る。
買い物の前にリストを作り、店でチェックして、買い忘れをなくす。
使う場面は、「買い物の前に家で作り、店でスマートフォンから見る」のように、いつ・どこで・どう使うかを書きます。
完成の条件は、あとで確かめられる形にします。例えば「品を足せる・消せる・画面を閉じても残る」と書けば、できたかを判断できます。
やらないことには、今回は広げない範囲を書きます。例えば「家族との共有」と「値段の記録」を外せば、作る範囲がぶれません。
仕様が先、コードが後。作る途中も仕様に戻ります。
仕様駆動開発は、先に決めた仕様を地図にして進める作り方です。決める・計画する・作るだけでなく、AIの確認と人の確認を分けます。
作る係のAIには、仕様をもとに計画を出してもらい、その順番で形にしてもらいます。壊れていないかの確認も、AIに繰り返してもらいます。
ただし、確認項目を全部通っても「良いアプリ」になったとは限りません。使いやすいか、目的を満たしたかは、人が触って判断します。
つまり仕様は、最初に一度書いて終わる文書ではありません。作る途中でズレたとき、戻る場所です。
AIは壊れていないかを見る。
人は作りたかったものかを見る。
作りたいことを、機能へ。機能を、画面とデータへ分けます。
大きな思いつきのままでは、何から作るか決めにくいものです。まず「できること」に分け、さらに画面に見える部品と、裏側で持つデータへ下ろします。
例えば買い物リストなら、目的は「買い忘れをなくす」です。そこから「品を足す」「チェックで消す」「次回も残る」という、利用する人ができる機能へ分けます。
さらに機能を、入力欄・一覧・チェックなどの画面に見えるものと、品目・チェック状態などの裏側で覚えるものへ分けます。
- 機能 — 利用する人が「できること」
- 画面・部品 — 見るもの、押すもの、入力するもの
- データ・状態 — 裏側で覚える内容と、いまの動き
作業は「土台→つなぐ→仕上げ」の3段に分けます。
要素が見えたら、次は作る順番です。機能を細切れに並べるだけでなく、各段の終わりに「ここまで動く」を確かめる節目を置きます。
土台は、まず骨組みが動く段です。買い物リストなら、「品を足して一覧に出る」までを確かめます。
つなぐは、部品どうしを結ぶ段です。買い物リストなら、「チェックすると表示と状態が変わる」までを確かめます。
仕上げは、自動の確認と公開の準備を整える段です。買い物リストなら、「閉じても残るか確かめ、公開を準備する」までを扱います。
一気に完成させない。
動く節目を、順に越える。
最後の節目は、人が決めます。
計画は、仕様を作業へ並べ替えた道順です。AIに案を出してもらい、依存する順番と動作確認の節目を、人が確かめます。
4枠の要件が、そのまま作業の一覧になるわけではありません。仕様をもとに、先に必要な土台から、後で結ぶ機能、最後の確認へと、依存する順に並べ直します。
各フェーズの終わりには、そこまでの動作を確かめる節目を置きます。途中でズレが見つかったら、次へ進む前に仕様や計画へ戻ります。
自動の確認まではAIに任せられても、公開や本番反映は外へ影響します。そこには、人の承認を待つゲートを置きます。
まず4枠を埋めれば、あなたの仕様づくりが始まります。
文章をきれいにする必要はありません。思いついた言葉のまま書き、動くものを見た後で直してください。
最初は、4枠すべてに自信がなくても構いません。分からない場所が見えたら、それもAIへ質問する材料になります。
書いた後は、まず動くものを見せてもらいます。そして「思っていたのと違う」と感じた場所を、ひとつずつ返します。
- やりたいことを、使う人の短い物語で書く
- 完成したか判断できる条件を置く
- 今回はやらないことを宣言する
- 動くものと比べ、ズレた言葉を書き直す