開発 2026年5月3日 6分

仕様駆動開発とは？Claude Code / Codex時代に仕様書が重要になる理由

AIエージェントにコードを書かせる時代に、なぜ仕様書がより重要になるのか。バイブコーディングの限界と、軽量Markdownによる仕様駆動開発（SDD）の考え方を整理します。

Claude CodeやOpenAI Codexを使えば、コードベースを読み込み、ファイルを編集し、テストを走らせることができます。プロンプトひとつで、驚くほど早く動くものができます。

ただし、しばらく使うと気づきます。AIは「どう書くか」には強い一方で、「何を作るか」「何を作らないか」「どこで判断を止めるか」は、教えてもらわないとわかりません。それを伝えるのが仕様です。

プロンプトは指示文であり、仕様ではありません。「ログイン機能を作って」と伝えれば何かはできあがります。しかし、どの認証方式にするのか、失敗時の挙動はどうするのか、既存のユーザーテーブルとの関係はどうするのか。こうした前提がなければ、AIは合理的に見えるけれど意図とずれた実装を返します。

「バイブコーディング」という言葉があります。雰囲気でプロンプトを渡し、出てきたコードを触りながら進める開発スタイルです。PoCや個人プロジェクトの初速には確かに有効で、アイデアを素早く形にできます。

問題は、その先です。

バイブコーディングで作ったPoCを継続開発に持ち込むには、遅かれ早かれ仕様を書き直すことになります。最初から軽くでも仕様があれば、そのコストは大きく下がります。

仕様駆動開発（Spec-Driven Development、SDD）は、実装より先に仕様を置き、それをAIエージェントへの入力として使うアプローチです。Spec Kit も、この考え方を実践するためのフレームワークとして注目されています。

重要なのは、仕様書が重厚なWordやExcelである必要はないという点です。AIと人間が同じ前提を持つための、軽いMarkdownで構いません。次の3点が書いてあれば、十分に機能します。

この3点があれば、Claude CodeやCodexに渡したとき、AIは推測ではなく根拠を持って実装を選択できます。レビューも「仕様に照らして合っているか」という軸で進められます。

多くのチームで仕様が書かれない理由はシンプルです。会議で話したことをドキュメントに落とす手間が、開発を始める勢いを削いでしまうからです。

AI議事録ツールは会議の内容を記録します。しかし、「会議を読み返すための成果物」と「開発を進めるための入力」は別物です。議事録を読んでも、Claude CodeやCodexに渡せる仕様にはなりません。

v2pは、このギャップを埋めることを目的としています。会議で決まった内容をもとに、仕様・設計・タスクのMarkdownと、モックやPoCに使えるプロンプトを生成する。会議が終わったとき、次のAI開発を始めるための入口がすでにある状態をつくります。

仕様をClaude CodeやCodexに渡すと、具体的には次のような変化があります。

AI駆動開発においては、コードを書く速度よりも、仕様を確定させる速度がボトルネックになります。仕様があれば実装はAIに任せやすくなります。仕様がなければ、AIが速くても人間の確認コストが増え続けます。

仕様駆動開発は、AI時代の開発を遅くするものではありません。むしろAIエージェントの能力を引き出すための前提条件です。

重厚なドキュメントは不要です。会議で決まったことを、AIと人間が共有できる軽いMarkdownに変換するだけで、AI開発の始まり方は変わります。

v2pが会議からAI開発の入力をどう残すかは、サービスページをご覧ください。

関連記事