本文へスキップ
hdknr blog
戻る

SDD は Planモードと何が違うのか — 仕様書を「書く」だけでなく「保守する」かで決まる

はじめに

CodeZine に「仕様駆動開発への期待と誤解 ~「仕様」とは、結局何なのか~」という記事が掲載されました。2026 年 4 月 23 日の掲載で、著者は NTT テクノクロスの渡邉洋平氏です。コーディングエージェントを使った開発手法を扱う連載の 1 本で、仕様駆動開発(Spec-driven Development、SDD)を「Vibe Coding」や「Planモード」と比べながら、その利点と懸念を整理しています。

この記事を紹介した和田卓人(t_wada)氏のポストが、論点を短くまとめています。

SDDへの過剰な期待や誤解、現実がよく整理されている。最近のPlanモードとSDDの違いは、作成された仕様書をどのように扱うか(Spec-first なのか Spec-anchored/Spec-as-source なのか)という一点に絞られてきている

先に結論を書くと、Planモードと SDD は実装前には同じことをしていて、違いは実装の後で仕様書を保守し続けるかどうかだけ です。本記事では、このポストの見立てを軸に次の 3 点を整理します。

用語

用語意味
Vibe Coding仕様を固めずに AI と対話しながら、動くものを直接作っていく進め方
PlanモードClaude Code などのコーディングエージェントが持つ、実装の前に計画を立てて人間の承認を取るモード
仕様駆動開発(SDD)仕様書を先に書いてレビューし、それを入力として AI に実装させる進め方
Spec-first / Spec-anchored / Spec-as-source実装の後で仕様書をどう扱うかによる SDD の 3 つのレベル(後述)
正本食い違いがあったときに正しいとみなす、拠り所の文書(Single Source of Truth)

Planモードと SDD は「実装前」では同じことをしている

CodeZine の記事は、Planモードを、実装したがる AI エージェントにまず考えさせ、実装前に人間の意図をはっきりさせるためのブレーキのような機能として説明しています。SDD も、要求から設計・タスクへと書き下したものを人間がレビューし、承認してから実装に進みます。Vibe Coding には、AI がいきなり書き始めて意図とずれたものを量産するという弱点があり、どちらもそれを補う手段です。

つまり 実装前の段階だけを見ると、Planモードと SDD はほとんど同じことをしています。意図を言語化し、AI に計画を出させ、人間がゲートとして承認する、という流れです。

違いが出るのは実装が終わった後、つまり 書いたものを次の変更のときにどう扱うか です。t_wada 氏のポストが「一点に絞られてきている」と言っているのは、この部分です。

実装後の扱いで分かれる SDD の 3 つのレベル(Spec-first / Spec-anchored / Spec-as-source)

この 3 つの分類は、Thoughtworks の Birgitta Böckeler 氏が martinfowler.com で公開した「Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl」によるものです。

Planモードと仕様駆動開発の3つのレベルについて、実装前・実装・次の変更のときに計画や仕様書がどう扱われるかを比べた図

レベル実装後の仕様書人が編集するもの
Spec-first目の前のタスクのために書くが、その後は保守しない主にコード
Spec-anchored残して、その機能の変更や保守のたびに更新する仕様書とコードの両方
Spec-as-source長期にわたって保守する主な成果物(正本)にする仕様書だけ(コードは生成物)

Böckeler 氏によると、調べた SDD のアプローチや定義はどれも Spec-first に当てはまります。一方、Spec-anchored や Spec-as-source まで目指しているものは一部にとどまります。また、仕様書を長期にわたってどう保守するかは、曖昧なまま残されがちだとも述べています。

ここで Planモードを並べると、Planモードは Spec-first をさらに軽くしたもの と見ることができます。計画はセッションの中で合意して実装に使い、終われば役目を終えます。ファイルとして残る場合でも、次の変更のときに正本として読み直す前提はありません。

Spec-first は Planモードに吸収されつつある

CodeZine の記事の著者である渡邉氏は、別の発表資料「仕様駆動開発の消費期限」で、Spec-first のスタイルは Planモードに合流し、多くのコーディングエージェントに備わった当たり前のものになりつつある、と述べています。

そうなると、「SDD を導入する」と言ったときに Planモードと区別できる中身は、Spec-anchored か Spec-as-source の部分だけになります。

SDD によくある期待と、実際に起きること

SDD に寄せられる期待のうち、実装後の扱いを決めないと裏切られるものを挙げます。

期待実際に起きること
仕様書を書けばドキュメントが揃うSpec-first のままだと、最初の変更から仕様書とコードがずれ始める。古い仕様書は、無いより悪い誤情報になる
ツールを入れれば SDD になるBöckeler 氏の評価では、Kiro は主に Spec-first。Spec Kit も GitHub は Spec-anchored を志向しているように見えるが、仕様ごとにブランチを作る設計から、Böckeler 氏は Spec-first にとどまると評価している。ツールが仕様書の保守まで強制してくれるわけではない
仕様書が詳しいほど AI の出力が安定する仕様書が長くなるほど、人間のレビューが追いつかなくなる。読まれずに承認される仕様書は、ゲートとして機能しない
仕様書があればコードを読まなくてよいそれが成り立つのは Spec-as-source だけで、生成の再現性が前提になる。Spec-anchored では人もコードを編集する

「仕様書を書くこと」と「仕様書を保守すること」は別の作業で、SDD の効果の大半は後者から来ます。書くだけなら Planモードで足ります。では、保守すべき「仕様」とは何でしょうか。

「仕様」とは結局何なのか

CodeZine の記事の副題でもあるこの問いに、実装後の扱いという観点から答えるなら、こう言えます。

仕様とは、次の変更のときに正本として読み直され、更新される(あるいは版を重ねる)もの です。一度きりの合意に使って捨てるものは、計画(プラン)と呼ぶほうが実態に合っています。

「更新」には 2 つの形があります。1 つは仕様書をその場で書き換える形です。もう 1 つは、リリースした版の仕様は凍結して直さず、次の変更を新しい版の差分として積み重ねる形です。後者なら、どの版のコードがどの仕様に基づいていたかを後から辿れます。

この線を引くと、プロジェクトの中にある成果物を次のように仕分けられます。

成果物扱い置き場所の例
実装計画・タスクリスト使い捨て(計画)Planモードの出力、PR の説明
機能の振る舞い・業務ルール保守する(仕様)docs/spec/ 配下の Markdown など
受け入れ条件保守し、実行できる形にする受け入れテスト、Gherkin(Given/When/Then で振る舞いを書く記法)のシナリオ
設計判断の理由追記していくADR(Architecture Decision Record)

仕様を保守する仕組みとして最も確実なのは、仕様から導いたテストを CI で回すこと です。文章の仕様書はコードと黙ってずれていきますが、テストはずれた時点で落ちます。Spec-anchored を名乗るなら、少なくとも受け入れ条件はテストとして実行できる形にしておくのが現実的です。

表の「機能の振る舞い・業務ルール」のさらに上流には、誰の課題を解くのか、何をもって成功とするのかを決める要件定義書があります。詳細な仕様書は薄くしてよくても、要件定義書はむしろ重くなる、という見方は「AI 時代こそ要件定義書が重くなる」で整理しました。

Planモードか SDD か:プロジェクト別の選び方

判断の軸は「そのコードを何回変更するか」と「仕様を読み直す人が自分以外にいるか」です。

3 つのレベルは、プロジェクト全体でどれか 1 つを選ぶものとは限りません。テストや型は仕様から生成して手で直さない(Spec-as-source)一方、実装は人や AI が書いて仕様に合わせ続ける(Spec-anchored)、というように成果物ごとに混在させられます。

仕様の持ち主が開発チーム自身であれば、Spec-anchored のルールは、たとえば PR テンプレートに次のようなチェック項目として入れておくと、日々の運用に乗せやすくなります。

## 仕様との整合

- [ ] 振る舞いが変わる場合、`docs/spec/` の該当箇所を同じ PR で更新した
- [ ] 実装を追加する前に、仕様書の差分をレビューしてもらった
- [ ] 受け入れ条件に対応するテストを追加・更新した

仕様の持ち主が利用者側にある場合

受託開発のように、仕様を承認するのが利用者や予算の責任者である場合は、開発者が実装の PR で仕様書を直すわけにはいきません。開発者が直せるのは実装だけで、仕様の変更には承認を取り直す必要があるからです。この場合は、次のように役割を分けます。

筆者が作っている Claude Code プラグインの spec-loop は、この型で要求確定・仕様レビュー・テストの生成までを回します。詳しくは 要求仕様ループを Claude Code プラグインにする — dev-loop と分けて 1 プラグイン・複数スキルで組む を参照してください。

同じ Spec-anchored でも、仕様の持ち主が開発チームか利用者側かによって、誰がどこで仕様を直すかが変わります。導入の前に、まず仕様の持ち主を決めておくことが大切です。

まとめ

SDD の 3 つのレベルや代表的なツールの全体像は、仕様駆動開発(SDD)とは? 3 つのアプローチ・EARS 記法・Kiro / Spec Kit・TDD との違い でも整理しています。

参考リンク



前の記事
形式検証 Skill を作る前に状態遷移をモデルにする — 図は描かせずレンダリングする(pstack /statechart・TLA+・SCXML)
次の記事
仕様駆動開発(SDD)の実践事例 — PRD から PR まで AI に渡す設計書と 2 つの課題