ある日の社内研修にて
「これからの時代はバイブコーディングが主流に……」
せやな
「エンジニアはコードを書くよりもAIに指示を出してレビューを……」
さいですか
「というわけでみんなバイブコーディングでいろいろ作って慣れていって……」
うわめんどくさ
要件定義作業も設計作業大嫌いで、白紙を出されて「自由に何か描け」と言われたらガチで吐く自分にとってなんでもいいから自由に作れなんて病院への片道切符でしかないわけで
その辺をオブラートに包み「いやー何か作れと言われましても何も作るもの思いつかないんですよねー」と聞いてみたら
「それもAIに決めてもらえばいいやん」
言質はとったからあとは知らん
というわけでこの記事はAIに「なんか面白いもの作って」とぶん投げてAIが何を作るか観察してバイブコーディングしたことにするという方向で何か作ることにするAI任せの開発記録です。
開発の流れ
AIに「何か作れ」と丸投げするとはいっても直接「何か作れ」だけでコード生成させても(まあ何かしら作ってくれるんですが)何を作ってるのかよくわからない文字通りの何かなので、今回の進め方としては
- あらかじめ作成するドキュメントの種類とそのテンプレートを作成する（本記事）
- ドキュメントのテンプレートに合わせて「何か」の要件定義～設計書を作らせる
- （おまけ）作らせた設計書をもとに「何か」のプレゼン資料を作らせる
- 実際に設計書をもとに作らせてみて実行する
という流れで進めていきます。
使用ツール・環境等
Claude：
- ドキュメント類の作成と何を作るか考えさせる用
- プランはフリープランを使用
NotebookLM：
- 作成されたドキュメントをいい感じに要約させる用
- AIが何作ろうとするのかいい感じにスライド作らせて要約する
Antigravity：
- 実際にプログラムを開発させる用のAI一体型エディタ
- Claudeに作らせたドキュメントをもとに実際に開発させる
プログラムの種類？DBなどの環境？
さぁ？ドキュメント書かせるときにAIがどれ使うか考えるでしょ。
作成するドキュメントを決める
AIに最初から作らせるための設計書って何があればいいんだ？普通の開発なら要件定義書から基本設計に画面定義書にDB定義書に詳細設計……
「AIが作るんだからAIに聞けばいいや」
まずはどんなドキュメントが必要かの一覧を作って。
……
## プロジェクト開始前のドキュメント
**プロジェクト憲章**: プロジェクトの目的、スコープ、ステークホルダー、成功基準を定義します。AIとの協働方針も含めると良いでしょう。
**要件定義書**: 機能要件と非機能要件を明確にします。AIに対して何を実装してもらうか、どのレベルの品質を求めるかを具体的に記載します。
**技術選定書**: 使用する技術スタック、フレームワーク、ライブラリを決定します。AIツールの選定理由も含めます。
## 設計段階のドキュメント
**アーキテクチャ設計書**: システム全体の構造、コンポーネント間の関係、データフローを定義します。
**データベース設計書**: テーブル定義、ER図、インデックス戦略などを記載します。
**API設計書**: エンドポイント、リクエスト/レスポンス形式、認証方式などを定義します。
## 開発中のドキュメント
**AIプロンプトガイドライン**: AIに対する効果的な指示の出し方、コーディング規約の伝え方をまとめます。
**コードレビューチェックリスト**: AIが生成したコードを人間がレビューする際の確認項目を列挙します。
**実装タスクリスト**: 各機能の実装タスクを細分化し、優先順位と担当（人間/AI/協働）を明記します。
## テスト・品質管理のドキュメント
**テスト計画書**: テスト戦略、テストレベル（単体、結合、システム）、AIが生成するテストの範囲を定義します。
**テストケース仕様書**: 具体的なテストケース、期待される結果を記載します。
**バグ管理表**: 発見された問題、優先度、対応状況を追跡します。
## プロジェクト管理のドキュメント
**開発日誌**: AIとの協働での気づき、うまくいった点・改善点を記録します。
**リスク管理表**: 想定されるリスク（AIの誤出力など）と対策を整理します。
これらのドキュメントのうち、特に重要なものや、まず作成したいテンプレートがあれば教えてください。そのテンプレートを具体的に作成します。
多っ！まあ個人で試す用なら設計段階のドキュメントのところまででいいので一個ずつ出力できればいいや
プロジェクト憲章を作成するためのマークダウン形式のテンプレートをアーティファクトで作成して。
これでいい感じにダウンロードできる形式でテンプレートを作ってくれるはず。
うわぁ個人作成のプロジェクトにすさまじくいらなさそうなもの。プロジェクトマネージャー？承認者？今回はAIが全部勝手にやって寄って趣旨だからどっちもAIなんだけど……
ま、まぁあっても困らないのでこの調子でほかの設計書分も指示を出せば
あれ……？なんかAPI前提の設計書になってるような……？
……追加で画面定義書とか作らせればなんかいい感じにしてくれるでしょ。
えっアスキーアートみたいにテキストでER図作って管理するの？作るのはAIだから別にいいけど正気？
おいめちゃくちゃ具体的に設計始めてるけどお前何作る気だ？
というところで無料分を使い切ってしまったため今日はここまで
次へ向けて
今回AIに渡して穴埋めしてもらうためのテンプレートを作らせようとしたが、個人で適当に作るならいらないプロジェクト承認者だのなんだのを出して来たり何を作ってるのかわからないがとりあえずテーブル定義の設計を始めたりと、念入りに指示しないと何でもかんでもやってしまうっぽい。
ということで次回は具体的に何かを作らせる前にClaudeに出力されたテンプレートファイルを渡して余計なところを削らせる作業から入ることにします。
……やっぱりこんなめんどくさいことせずAntigravity君に「なんか面白いもの作って」だけ渡せばよかったのでは？