連載「業務SEのための仕様駆動開発」第7回
デモは速い。でも、業務システムも同じやり方で作ってよいのか
Claude Codeなどで、雰囲気を伝えただけで動くものができあがるデモを見ると、その開発スピードには驚かされます。いわゆるバイブコーディングです。自分の手元でも、試しにやるとすぐに形になります。
一方で、納品が必要な案件や、本番環境で使う業務システムとなると、同じやり方で開発してよいのか迷います。しかし、開発が速いことと、業務案件で安心して使えることは別問題です。全否定したいわけではない。でも、どこまでなら使ってよいのかが、はっきりしない。
結論:試作には向く。納品物は仕様を固めてから作る
そこで、私は次のように使い分けています。
- 試作品として割り切れるたたき台・探索:バイブコーディングを使ってよい
- 納品する/他人が保守する/本番に載せるもの:仕様を先に固めてから作る
後者で使うのが、この連載で説明している仕様駆動開発(SDD)です。目的を確定し、設計とテストの観点を文書にまとめてから実装に進みます。工程を順番に進める点では、従来のウォーターフォール開発に近い部分があります。
バイブコーディング自体が悪い、という話ではありません。向いている場面と、向いていない場面がある、という話です。
型:バイブコーディング使い分けの判断表
コピーして使ってください。実装を頼む前に、作ろうとしているものについて各項目を確認します。
# バイブコーディング使い分けの判断表
対象:____________
- [ ] 1. 試作品として扱えるか:できあがったものを完成品として使わず、必要なら作り直せるか
- [ ] 2. 探索段階か:何を作るか、どんな機能が必要かを、まだ具体的に決めきれていないか
- [ ] 3. 納品か:顧客や社内への納品物になるか
- [ ] 4. 保守か:自分以外の人が、あとから直したり引き継いだりするか
- [ ] 5. 本番か:本番環境に載せるか、本番データに触るか
- [ ] 6. 仕様を決める人:仕様を自分だけで決められるか(顧客・他部署との合意が必要か)
振り分けの目安は、次のとおりです。
| 判断結果 | 進め方 |
|---|---|
| 試作品として割り切れ、納品・保守・本番の予定がない | バイブコーディングで試作する。出たものを見て考え、必要なら作り直す |
| 納品・保守・本番利用のいずれかがある | 仕様を先に固める(SDD)。雰囲気だけで一気に完成させない |
| 顧客や他部署との合意が必要 | まず要求・仕様を整理する。試作そのものは探索用にとどめる |
迷ったら、納品・保守・本番の側を優先します。たたき台で得た気づきは残してよいですが、たたき台そのものを納品物や本番の土台にしない、が基本です。
6つ目は、単独で進み方を決める項目というより、仕様を先に固める必要があるかを見る補助です。顧客や他部署の合意が必要な案件では、雰囲気の共有だけでは足りません。合意した内容を文書に残す必要があります。一方で、合意前の画面イメージを試すだけなら、試作品として割り切れる範囲でバイブコーディングを使って構いません。
使い方:まず「試作品として扱えるか」を見る
判断表を使うときは、最初に1つ目を見ます。「できあがったものを完成品として使わず、作り直せるか」。
ここが「はい」なら、探索や試作です。何を作るかを自分でもまだ言葉にできていないとき、一度ざっくり形にして眺める用途です。試作品を動かしてみて、必要な機能や改善点が見えたら、その気づきを目的や合格ラインのメモに反映します。コードはそのまま残さず、改めて仕様を固めて作り直して構いません。
ここが「いいえ」なら、すでに完成品として使うことを想定しています。その場合は、3・4・5・6を確認します。納品になる、他人が触る、本番に載る、仕様が自分だけで決まらない——どれかに当てはまるなら、雰囲気だけで一気に作らせる進め方は向きません。先に目的・合格ライン・制約を決め、設計とテストの観点を文書にしてから実装に進みます。連載の第1回から第3回で扱った型が、そのための道具です。
バイブコーディングでたたき台を出したあとも、そこで終わりにはしません。出たものを見て要件が見えてきたら、目的確定のメモに戻ります。合格ラインと制約を書き、設計書とテストの観点を先に固めてから、実装し直します。大事なのは、たたき台を「だいたい動いているから」とそのまま育てないことです。育て始めると、試作の前提が崩れて、いつの間にか納品物側の条件(保守・本番・説明)が乗ってきます。探索で得たのは気づきであり、完成品ではない、と区切っておくと判断に迷いにくくなります。
たとえば、連載で使っている「受注CSVを取り込む」の話なら、画面の雰囲気を確かめる試作は試作品側です。一方、現場に渡す取り込み処理や、本番のファイルを扱う処理は、納品・保守・本番の側です。同じテーマでも、試作なのか実際に使う処理なのかによって、判断表の答えも変わります。
Claude Codeに頼むときも、同じです。「全体をいい感じに」と丸投げするのか、「この部品だけ。受け取るものはこれ、出すものはこれ」と渡すのか。前者は探索向き、後者は仕様を先に決めたあとの実装向きです。第6回の部品の切り方も、後者のような進め方で役立ちます。
私の場合:案件の納品物には使っていない
私は、案件の仕事でもAIをよく使います。設計書の下書き、テスト観点の洗い出し、実装方法の検討などです。
ただし、バイブコーディングで作ったものを、そのまま納品物にしたことはありません。
理由は、案件ではコードが動くだけでは足りないからです。仕様どおりに動くこと、他の人が保守できること、問題が起きたときに原因を追えることなども求められます。
そのため、私の場合は、探索にはバイブコーディングを使い、納品するものは仕様を固めてから作る、という使い分けになっています。「手戻りして後悔したからやめた」という話ではありません。持ち込もうとするたびに、納品・保守・本番の条件を考えると、判断表の右側(仕様を先に固める側)に倒れる、というだけです。デモの速さは認めたうえで、案件の条件に応じて使い分けています。
AIを使うことと、雰囲気だけで完成させることは、分けて考えています。前者は案件でもやる。後者は、試作品として割り切れる範囲に限る。この線引きのために、上の判断表を使います。
まとめ
- バイブコーディングは全否定しない。試作品として割り切れる探索・たたき台には向く
- 納品・保守・本番があるなら、仕様を先に固める(SDD)
- 判断表の6問で、今作ろうとしているものがどちら側かを確認する
次回は、AIを「同時に何人も使える部下」として扱う話で、連載を締めます。
連載「業務SEのための仕様駆動開発」
一覧はこちら → https://qiita.com/sha44444/stocks/3c9167054a4a82837bb3
この連載では、仕様駆動開発の「型」を1回に1つずつ紹介しています。
5つの工程を実案件でどう回しているか(各工程でAIに渡す依頼文、変更が入ったときの回し方、通しの実例)は、1冊の本にまとめました。第1章は無料で読めます。
→ https://zenn.dev/shin4/books/31499dd20de8ac/viewer