第3章 企画と仕様 — インタビューを受けてSPEC.mdを書く
必須 この段階を進めるなら、必ず読んでください。一言まとめ: 何を作るかがまだぼんやりしているときは、ひとりで全部まとめようとせず、Claudeに自分をインタビューさせましょう。インタビューが終わったら、Claudeがその内容をSPEC.md(仕様書)に書きます。 仕様は「どう作るか」ではなく、「何ができていなければならないか」の約束です。この約束が、第4〜6章で作り、確認し、レビューするときの基準になります。
この章は、2026年11月1日に確認したClaude CodeとGitHubの公式ドキュメント、およびspec-kitとOpenSpecのリポジトリの説明をもとに書きました。何を任せるかを具体的に伝えるコツは、Claude Code 第5章で学びました。この章では、そのコツを「作る前の段階」に広げます。
なぜ企画から始めるのか
第1章で見たように、AIが自分の頭の中とは違うものを作るよくある理由は、リポジトリを読むだけではわからない情報が抜けているからです。[1] その情報は、自分の頭の中にしかありません。誰が使うのか、何が不便なのか、何はやらないのか、といったことです。
GitHubの入門チュートリアルも、コードを書く前に、作りたいものを書き留めて、進み具合を追うように言っています。[2]
具体的に伝えるほど、直すやり取りの往復が減ります。公式ドキュメントは、ファイルを指し示し、症状を伝え、「できた」がどんな状態かを最初に伝えるよう言っています。[3]
| 惜しい例 | よりよい例 |
|---|---|
| やることを見せるページを作って | 議事録のやること表を集めて、担当・期限ごとに見せるページ。できたら、メモのやること5つがすべて見えるようにして |
出典: このガイドの例(コツは公式ドキュメント)[3:1]
理解度チェック
AI が自分の頭の中と違うものを作るよくある理由として、公式ドキュメントがあげているものはどれでしょうか?
インタビューを受けてSPEC.mdを書く
ほしいものがまだはっきりしていなくても大丈夫です。公式ドキュメントは、プロンプトを書く前にすべてを整理する必要はなく、Claudeに自分をインタビューさせるよう言っています。[4] ドキュメントの例を日本語にすると、こんな形です。
こういうものを作りたいんだけど、まだ深く考えていないんだ。仕様を書けるようになるまで私にインタビューして、終わったらSPEC.mdに書いて。
すると、Claudeはまだ決まっていない部分を選択式の質問(選択肢の中から選ぶ質問)で聞き返してきます。[5] たとえば「やることを担当ごとにまとめますか、期限ごとにまとめますか?」のように、選ぶだけでいい質問です。実際の質問はそのときどきで違うので、選択肢のひとつを選ぶか、自分の言葉で答えればOKです。
やることボードなら、こんな依頼になります。
ステップ3の整理ツールが作った議事録のやること表を集めて見せるWebページを作りたいんだ。まだ深く考えていないんだ。仕様を書けるようになるまで私にインタビューして、終わったらSPEC.mdに書いて。SPEC.mdができたら、新しいセッションで、そのファイルを見て作らせます。まっさらな文脈と、文章で書かれた「完了の定義」から始めるためです。[6] インタビューでやり取りした長い会話が、作る作業に混ざらないようにするのです。
作り終わったあとは、SPEC.mdと照らし合わせて確認します。 この話は、第6章のレビューでもう一度します。
理解度チェック
何を作るかまだぼんやりしているときに、公式ドキュメントがすすめる方法はどれでしょうか?
よい仕様の形
仕様には、外から見える動作を書きます。画面を見る人が気づけることだけを書く、という意味です。やることボードのSPEC.mdなら、こんな行が入ります。
| よい行 | 惜しい行 |
|---|---|
| 議事録のやることが、ひとつも漏れずに見える | JavaScriptで表を読む |
| 期限が過ぎたやることは、表示が違う | きれいに見える |
| 個人名の代わりに、役割だけが見える | すっきりしたコードで作る |
出典: このガイドの例
左の行は、はい/いいえで確認できます。 第5章で、この行がそのまま確認の仕組みになります。
右の行は、どう作るか(技術)や、ばくぜんとした感じです。次の節で見る仕様ツールの説明書も、同じことを言っています。OpenSpecの説明書は、仕様を「実装計画ではなく、動作の約束」だと言い、外から見える動作を変えない実装の話は、ふつう仕様に入れないと説明しています。[7] spec-kitも、仕様の段階では技術ではなく何を、なぜに集中し、技術の選択は次の計画の段階に回すよう言っています。[8]
理解度チェック
やること一覧ボードの SPEC.md に入れるのに向いている行はどれでしょうか?
スペック駆動開発のツール
仕様を中心に置いて開発する方法を、スペック駆動開発(Spec-Driven Development)と呼びます。何をなぜ作るのかを先に決め、その仕様を計画・作業・コードに変えていく方法です。[9] これを助けるツールに、spec-kitとOpenSpecがあります。
このガイドでは、2つのツールをインストールしません。 上で学んだ「インタビュー → SPEC.md → 新しいセッション」という流れだけでも、同じ考え方を実践できます。この節は、名前だけ知っておいて先に進んでもかまいません。
どちらのツールも、人が途中で確認する場面を設けています。
- spec-kit(GitHubが作ったツール): 仕様 → 計画 → 作業リスト → 実装を1段階ずつ実行し、結果を確認してから次に進むよう言っています。[10]
- OpenSpec(Fission-AIが作ったツール): AIが文書を書き、人はコードが書かれる前に計画を確認します。[11]
このガイドの流れで、SPEC.mdを読んで承認するのと同じ考え方です。
2つのツールをもっと知る(クリックして開く)
| ツール | 作った組織 | することの内容 |
|---|---|---|
| spec-kit | GitHub | 仕様 → 計画 → 作業リスト → 実装を段階ごとに進める |
| OpenSpec | Fission-AI | 変更ごとに、提案・仕様・設計・作業のフォルダを作る |
インストールには、開発用のツールが別に必要です。spec-kitにはPython 3.11以上とuvというツールが必要で[13]、OpenSpecにはターミナルでのインストール(またはNode.js 22.12以上)が必要です。[14] Python・uv・Node.jsは、プログラムを動かすのに使う開発用のツールです。このガイドを進めるには、どれも必要ありません。もっと大きなプロジェクトに取り組むときに、見てみてください。
理解度チェック
このガイドが spec-kit と OpenSpec を扱う方法はどれでしょうか?
やってみましょう
- 第2章で作った
todo-boardフォルダを、Claude Codeアプリで開く。 - 上のインタビューの依頼を送って、Claudeの質問に答える。わからなければ、「おすすめを教えて」と言ってもよい。
- できあがったSPEC.mdを読んで、行ごとに「はい/いいえで確認できるか?」と自分に問う。そうでなければ、直してもらう。
- SPEC.mdに実名や連絡先が入っていないか確認する(公開リポジトリなので)。
- 気に入ったら、記録(コミット)する。
続きの課題: 第4章では、新しいセッションでSPEC.mdをもとに計画を出してもらい、ブランチで最初の画面を作ります。
まとめ
- AIが見当違いのものを作るよくある理由は、自分の頭の中の情報が抜けているから。作る前に書く。
- わからなければ、Claudeに自分をインタビューさせて、結果をSPEC.mdで受け取る。
- SPEC.mdができたら、新しいセッションで作る。作り終わったあと、SPEC.mdと照らし合わせる。
- 仕様には、外から見える動作を、はい/いいえで確認できるように書く。
- spec-kitとOpenSpecは、同じ考え方を助けるツール。このガイドではインストールしない。
用語まとめ
| 用語 | 読み方 | 一言でいうと |
|---|---|---|
| Spec | スペック | 何ができていなければならないかを書いた約束(仕様) |
| SPEC.md | スペック・エムディー | 仕様を書いたファイル |
| Spec-Driven Development | スペック・ドリブン・ディベロップメント | 仕様を先に決めて、それをもとに作る方法 |
| Definition of done | ディフィニション・オブ・ダン | 「できた」の基準 |
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: 第4章 作る
参考資料(14件)
Claude Code 公式ドキュメント「Best practices for Claude Code」。"Claude built something different from what you had in mind, or it has to rediscover the same fact at the start of every session. It's missing information it can't get from reading the repo." code.claude.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント「Planning your work」。"Before you write code, capture what you want to build and track your progress." docs.github.com (確認日 2026-11-01) ↩︎
Claude Code 公式ドキュメント「Best practices for Claude Code」。"If you name the file, describe the symptom, and say what "fixed" looks like up front, you usually save yourself a round of corrections later." code.claude.com (確認日 2026-11-01) ↩︎
Claude Code 公式ドキュメント「Best practices for Claude Code」。"When you don't know exactly what you want yet, you don't have to work it all out before you prompt. Ask Claude to interview you instead:" code.claude.com (確認日 2026-11-01) ↩︎
Claude Code 公式ドキュメント「Best practices for Claude Code」。"Claude comes back with multiple-choice questions about the parts you haven't pinned down: per-user versus per-key limits, what happens to requests over the limit, what's out of scope." code.claude.com (確認日 2026-11-01) ↩︎
Claude Code 公式ドキュメント「Best practices for Claude Code」。"Once
SPEC.mdexists, start a fresh session to build from it, so the build begins with a clean context and a written definition of done." code.claude.com (確認日 2026-11-01) ↩︎OpenSpec ドキュメント「Concepts」。"A spec is a behavior contract, not an implementation plan." / "If implementation can change without changing externally visible behavior, it likely does not belong in the spec." github.com (確認日 2026-11-01) ↩︎
spec-kit ドキュメント「Spec-Driven Development Quickstart」。"Creates the feature specification from a natural-language description. Focus on the what and why, not the tech stack." github.com (確認日 2026-11-01) ↩︎
spec-kit README。"Define what to build and why, then turn the specification into a plan, tasks, and working code." github.com (確認日 2026-11-01) ↩︎
spec-kit README。"Create a constitution once per project and repeat the remaining steps for each feature. Run these skills in your agent's chat, not your terminal, one at a time, reviewing each result before continuing." github.com (確認日 2026-11-01) ↩︎
OpenSpec README。"Stay organized — each change gets its own folder with proposal, specs, design, and tasks" / "Your AI writes these; you review the plan before any code is written." github.com (確認日 2026-11-01) ↩︎
spec-kit README。"Spec Kit is an open source toolkit that gives AI coding agents structured processes, reusable templates, and documented outcomes." github.com (確認日 2026-11-01) ↩︎
spec-kit README。"You need Python 3.11+, uv, and a supported AI coding agent on Linux, macOS, or Windows." github.com (確認日 2026-11-01) ↩︎
OpenSpec README。"Install OpenSpec. On macOS or Linux, in your terminal:" / "(needs Node.js 22.12.0 or higher)" github.com (確認日 2026-11-01) ↩︎