仕様書から始める個人開発。提案書→仕様→計画→実装(CCMT v5.2 を例に)
Claude Code に「いい感じに作って」と頼むより、先に文章で決めておくほうが、結局は速くて確実でした。CCMT で開発中の新機能「セッションのアーカイブ」を例に、4段階の進め方を紹介します。

Claude Code と開発していて、いちばん効いたのは「書いてから作る」ことでした。今日は、CCMT の次の版(v5.2.0)に向けて作った「セッションのアーカイブ」機能を例に、その進め方を具体的に紹介します。
作りたかったもの
Claude Code の会話の記録(セッション)は ~/.claude/projects/ の下に保存されますが、既定では30日を過ぎると自動で消えます。過去のセッションを失わずに取っておいて、必要なときに戻して再開できるようにしたい。これが出発点です。
4つの文書
- 提案書(HTML)… 何のために、何を作るか。画面のイメージや選択肢を並べて、決めるべきことを確認する。2026年9月4日に承認。
- 仕様書(
SPEC-archiver.md)… 目的・達成する状態・中身の決まりごと。「まだ確かめていない仮定」もここに書く。 - 実装計画(
plans/2026-09-04-session-archiver.md)… 仕様を22個のタスクに分けたもの。377行。 - チェックリスト(
SPEC_v5.2.0.md)… フェーズごとのやることを[ ]で並べ、終わったら[x]にする。
提案書で「何を」、仕様書で「どういう決まりで」、計画で「どの順番で」、チェックリストで「どこまで終わったか」。役割を分けておくと、途中で迷子になりません。
チェックリストはこんな形
# SPEC v5.2.0 — セッションアーカイブ機能
実装完了時に各項目を [x] にすること。
## Phase 0: 実機検証(A1〜A4)
- [x] P0-1 使い捨てプロジェクトで claude -p により
セッションを作成し、退避 → 削除 → 復元 → 再開 を確認
- [x] P0-6 結果を docs/verification-log.md に記録
## Phase 1: Archiver ライブラリ + テスト
- [x] P1-4 ClaudeHomeLocator + テスト
- [x] P1-5 ProjectDirEncoder + テスト
……
そして、プロジェクトの CLAUDE.md に「SPEC_v5.2.0.md の実装が終わったらチェックを入れること」と書いておきます。こうすると、Claude Code が作業のたびに自分でチェックを付けていくので、進み具合がひと目で分かります。
先に「確かめる」フェーズを置く
claude -p を使って実際に試し、4つの仮定(A1〜A4)の結果を記録してから、中身の設計を確定させました。仮定のまま作り始めると、あとで土台からやり直しになることがあります。最初に小さく試して、結果を文書に残す。この一手間で、そのあとがずっと楽になります。
結果
チェックリストは Phase 0 から 5 まで、ほぼすべて [x] になりました。残っているのは、NAS の実機とつないで確かめる1項目だけです。


まとめ
- 頼む前に、目的と決まりごとを文章にする
- 文書は役割ごとに分ける(提案・仕様・計画・チェックリスト)
- 不確かなことは、作る前に小さく試す
- 進み具合はチェックボックスで、Claude Code に付けてもらう
ちなみに、このホームページもまったく同じやり方で作っています。仕様書(implementation.md)を書いて、そこから少しずつ形にしています。