連載「業務SEのための仕様駆動開発」で紹介してきた道具を使ったあと、実際の案件をどう進めていくかを説明します。
チェックは終わった。さて、次は何から始める?
連載では、仕事で生成AIを使うときに役立つ道具を、各回で1つずつ紹介してきました。
たとえば、こんなものです。
- 使う前の確認リスト(情報・置き場・コスト・根拠・最終判断・出所)
- バイブコーディングで進めてよいかを見る判断表(試作か、納品・保守・本番か)
どちらも、コピーしてそのまま使えます。
使ってみると、「確認が抜けていた」「試作と納品を混ぜていた」といったミスは、かなり減ります。
一方で、こうした道具を使ったあとに、別のところでつまずくことがあります。
「確認は終わった。では、今日の案件は何から書けばいいのか」
「判断表では納品側になった。雰囲気で一気に作らせるのはやめた。その先の順番は」
道具は、その場で必要な判断を助けるものです。
一方で、案件全体をどのような順序で進めていけばよいかまでは、示してくれません。
この記事では、道具を使ったあとに、次に何をするかを選ぶためのマップを1枚渡します。
ここでいう 壁打ち は、AIと対話しながら要求を整理し、あいまいな部分を具体化していく作業です。
仕様駆動開発(SDD)では、この壁打ちから入ります。
連載で紹介すること、本で解説すること
ここで、連載と本の役割を一度だけ整理します。
それぞれ扱っている内容が違うためです。
連載で紹介すること
- 1回につき1つの道具(チェックリスト、判断表、観点表、分け方の基準など)
- その使い方と、短い一人称の判断例
- 仕様を先に明確にし、それを基準に開発を進める「仕様駆動開発(SDD)」という考え方
本で解説すること
- 5つの工程を、実際の案件でどのような順序で進めるか
- 各工程でAIに渡す依頼文の、そのまま使える形
- 変更が入ったときの進め方
- ひとつの案件を通して見た実例
簡単に言うと、連載では個々の判断に使う道具を紹介し、本では、それらを使って案件全体をどう進めるかを解説しています。
本の第1章は無料です。この記事のマップは、その第1章に入る前の分岐です。
次の一手マップ:状況に応じて次の作業を選ぶ
現在の作業状況や困っていることに応じて、次に取り組む作業を選ぶための表です。
必要に応じてコピーして使ってください。
この表では、確認した内容を書き残す先として 目的確定メモ を使います。
目的確定メモとは、「何のためか/何ができたら合格か/何をしてはいけないか」を書いておくメモです。
連載の第1回でも扱っている、いちばん最初の文書だと考えてください。
# 次の一手マップ(連載の道具 → 案件全体の進め方)
## A. AIに渡す情報の範囲が不安なとき(確認リストを使う)
- [ ] 確認6つ(情報・置き場・コスト・根拠・最終判断・出所)に答えた
- [ ] 確認した内容を、目的確定メモの「制約」と「やってはいけないこと」に記入した
- 次の作業:制約を整理できたら、あいまいな要求を具体化する「壁打ち」に進む
(必要以上に安全面の確認を繰り返すより、まずは確認した内容を制約として整理する)
## B. バイブコーディングで進めてよいか判断できないとき(判断表を使う)
- [ ] 判断表の6問で、試作か、納品・保守・本番かを分けた
- 試作の場合:あくまで検討用のたたき台として扱う。試作を通じて分かったことは、目的確定メモに反映する
- 納品・保守・本番で使う場合:その場の雰囲気や感覚だけで一気に作らせるのは避ける。
まず壁打ちを行い、目的・合格ライン・制約を明確にする
## C. 個々の道具は分かったが、案件全体の進め方が分からないとき
- [ ] 連載一覧で、自分が使っていない回を1つだけ開く
- 案件全体の進め方を知りたい場合:本の第1章(無料)を読む。
具体的な依頼文の例や、仕様変更が発生した場合の進め方、実案件を通した事例は、本の後半で解説している
大切なのは、つまずいている内容によって、次に取り組むべきことが異なる、という点です。
- 情報管理や安全面の確認が不十分なまま、実装に入らない
- 試作と、実際に納品・運用する開発を混同しない
- 個々の判断に使う道具が足りないのか、案件全体の進め方を知りたいのかを区別する
表は、上から全部やる必要はありません。
いま一番つっかえている行だけ選んでください。
AとBの両方が気になる場合は、先にAの情報管理や安全面の確認を済ませてから、Bの開発方法の判断に進む方がよいでしょう。
AIに渡してよい情報の範囲が決まっていないまま壁打ちを始めると、途中で確認や判断が必要になり、作業が止まってしまいます。
使い方:判断表から読むとき/確認リストから読むとき
判断表から(連載第7回)
判断表で、試作ではなく「納品・保守・本番で使う」という結果になった、とします。
ここでよくあるのが、勢いでコードを書き始めるのはやめたものの、今度は何を整理し、何から書き始めればよいのか分からず、手が止まってしまうことです。
次の一手は、いきなり設計書を厚くすることではありません。
先にやるのは、あいまいな要求を言葉にすることです。
つまり、先に定義した 壁打ち です。
壁打ちでは、次の3つを言葉にします。
- 何を解決するために作るのか(目的)
- どのような状態になれば完成といえるのか(合格ライン)
- 守るべき制約や、やってはいけないことは何か(制約)
この3つが書けてから、設計やテストの道具に進みます。
判断表は「どう作らせるか」を選ぶ道具です。
壁打ちは「何を作るか」を固める作業です。
このふたつは、別物です。
試作という結果になったときも、終わり方を決めておくと安心です。
試作で得られた気づきはメモに残し、試作したコードをそのまま本番用の開発に流用しないようにします。
試作したコードをそのまま改良し続けると、いつの間にか納品物としての品質や保守性が求められるようになります。
試作で画面の雰囲気だけ確かめたなら、その気づきを合格ラインの文に書き直してから、納品用の作業に入りましょう。
確認リストから(連載第4回)
確認リストに「分からない」という項目が残っている場合は、AIへの作業依頼を進めない方がよいでしょう。
答えが出るまで調べるか、関係する人に聞いてください。
確認できた内容は、口頭で済ませず、目的確定メモの「制約」の項目に記録しておきます。
ここまでが、第4回で紹介した確認リストの基本的な使い方です。
その先で「では今日、何から頼むか」がぼんやりしているなら、やはり壁打ちに戻ります。
AIに渡してよい情報を確認することと、AIに何を達成してほしいのかを明確にすることは、別の問題です。
情報管理や安全面の確認だけを済ませても、AIへの指示があいまいなままでは、期待した成果物は得られません。
現場では、このふたつが交互に出ます。
壁打ちで依頼の範囲が広がると、渡す情報も変わるので、確認リストを見直す番が来ます。
案件の進行に合わせて、マップのAとBを必要に応じて行き来する。
まずは、そのような使い方で十分です。
第1章(無料)で、先に分かること
本の第1章は無料です。
ここでは、第1章で分かることを簡単に紹介します。
- あいまいな指示からは、あいまいなものしか出にくい、という原則
- それは、人への依頼と同じだと考えていること
- 第一歩としての壁打ち(AIと対話しながら要求を具体化する作業)の位置づけ
- 業務でAIを本格的に利用していないSEにも、これから仕様駆動開発を身につけるうえでの強みがある、という考え方
第1章を読んだあと、多くの人が次に知りたくなるのは、「具体的に各工程をどう進めればよいのか」という点でしょう。
そこから先(依頼文の例、変更時の進め方、実案件を通した事例)は、本の有料側にあります。
連載の各回では、本で解説する開発工程の中で使える個別の道具を紹介しています。
まとめ
- 連載では個々の判断に使う道具を紹介している。案件全体の進め方を示すものではない
- 次に取り組むことは、情報管理の確認が必要なのか、試作か納品かの判断が必要なのか、案件全体の進め方を知りたいのかによって異なる
- 納品・保守・本番で使うものを開発する場合は、壁打ちを通じて目的・合格ライン・制約を明確にする
- 案件全体の進め方は本で解説している。第1章は無料で読め、壁打ちについて理解できる
連載「業務SEのための仕様駆動開発」
一覧はこちら → https://qiita.com/sha44444/stocks/3c9167054a4a82837bb3
- 第4回(6つの確認)→ https://qiita.com/sha44444/items/8e4a67a5e24bafcf98c5
- 第7回(判断表)→ https://qiita.com/sha44444/items/6cfa721d3b107799a244
連載では、仕様駆動開発の道具を1回に1つずつ紹介しています。
5つの工程を実案件でどう進めるか(各工程でAIに渡す依頼文、変更が入ったときの進め方、実案件を通した事例)は、1冊の本にまとめました。
第1章は無料です。壁打ちの入り口から読めます。
→ https://zenn.dev/shin4/books/31499dd20de8ac/viewer