Thank You For Reaching Out To Us
We have received your message and will get back to you within 24-48 hours. Have a great day!

ハポソフトの​​ブログへようこそ

世界に​​向けて​​共有したい、​​最新動向や​​インサイト、​​プロフェッショナルの​​コメント、​​プロジェクト開発の​​実例などを​​当社の​​ブログで​​ご紹介しています。

spec-driven-development-for-claude-code
2026年7月1日
20分で​​​読む

Claude Codeの​ための​仕様駆動​開発:CafeKit、​GitHub Spec Kit、​BMAD、​claude-code-spec-workflowの​比較

Claude Codeのような​AIコーディングエージェントは​開発速度を​大幅に​向上させますが、​同時に​新たな​課題も​生み出します。​コード自体は​正しく​見えても​要件を​満たしていない、​セッションを​またぐと​コンテキストが​失われる、​大規模な​変更に​よって​設計の​一貫性が​崩れると​いった​問題です。​ 仕様駆動開発​(SDD)は​要件定義、​計画、​タスク化、​実装と​いう​構造を​導入する​ことで、​これらの​課題を​解決します。​AIに​直接プロンプトを​入力するのではなく、​チームが​事前に​要件を​定義し、​明確な​仕様に​基づいて​AIに​実行させる​アプローチです。​ 本記事では​Claude Codeで​利用​可能な​4つの​SDDツールを​比較します: ● CafeKit​(Haposoft)​ ● GitHub Spec Kit ● BMAD-METHOD ● claude-code-spec-workflow 各ツールの​ワークフロー、​強み、​トレードオフ、​そして​特に​B2Bエンタープライズチームに​最適な​シナリオに​ついて​解説します。​ Claude Codeに​おける​仕様駆動開発の​理解 多くの​チームは​Claude Codeを​シンプルな​方法で​使い​始めます。​プロンプトを​書いて​コードを​生成し、​出力を​レビューし、​不足が​あれば​プロンプトを​修正すると​いう​流れです。​これは​小規模な​機能や​独立した​タスクに​おいては​うまく​機能します。​しかし、​プロジェクトが​大型化すると​要件の​追跡が​難しくなり、​実装に​関する​決定事項が​会話の​中に​散らばり、​重要な​コンテキストが​セッション間で​失われやすくなります。​ 仕様駆動開発​(SDD)は​異なる​アプローチを​とります。​プロンプトを​指示の​主な​情報源と​して​扱うのではなく、​仕様を​開発プロセスの​基盤と​して​扱います。​要件、​実装計画、​タスク、​技術的な​決定事項が​開発前に​ドキュメント化される​ことで、​プロジェクトの​ライフサイクル全体を​通じて、​開発者と​AIエージェントの​間に​共通の​「唯一の​真実の​情報源​(Single Source of Truth)」が​生まれます。​ SDDワークフローの​仕組み すべての​フレームワークに​独自の​手法が​ありますが、​ほとんどの​SDDワークフローは​以下の​4つの​コアステージに​従います。​ ステージ 説明 要件定義​(Specify)​ 要件、​ビジネスルール、​受入基準を​定義する​ 計画​(Plan)​ 技術設計と​実装計画を​作成する​ タスク化​(Task)​ 作業を​小さく​実行可能な​タスクに​分解する​ 実装​(Implement)​ 承認された​仕様に​基づいて​コードを​生成・レビューする​ 目的は​ドキュメントを​増やす​ことでは​ありません。​曖昧さを​排除する​ことです。​要件、​計画、​タスクが​すでに​定義されていれば、​Claude Codeは​意図を​解釈する​時間を​減らし、​明確に​定義された​作業の​実行に​集中できます。​これは​複数の​ビジネスルール、​ステークホルダー、​開発イテレーションが​絡む大規模な​機能に​おいて​特に​価値を​発揮します。​ Claude Codeと​SDDの​相性が​良い​理由 AIコーディングエージェントを​利用する​際の​最大の​課題の​一つは​長期的な​一貫性の​維持です。​数日または​数週間かけて​完成させる​機能には​何百もの​要件、​決定事項、​実装の​詳細が​含まれる​場合が​あります。​その​情報の​一部は​プロンプトに、​一部は​ドキュメントに、​そして​一部は​チームメンバー間の​会話の​中に​しか​存在しません。​ SDDは​これらの​決定事項を​構造化された​ワークフローに​統合します。​仕様は​「何を」構築するかを​定義し、​計画は​「どのように」構築するかを​定義し、​タスクは​「次に​何を」実装するかを​定義します。​これに​より、​Claude Codeは​プロンプトの​履歴に​依存するのではなく、​ドキュメント化された​計画に​基づいて​作業できる​ため、​開発プロセスが​より​予測可能で​管理しやすくなります。​ Claude Code向け4つの​SDDツールの​詳細比較 CafeKit​(Haposoft)​ cafekit.haposoft.com CafeKitは​Haposoftが​開発した​オープンソースの​仕様駆動開発​(SDD)​ツールです。​この​フレームワークは​要件定義、​技術設計から​実装、​テスト、​レビューまで、​ソフトウェア開発ライフサイクル全体を​チームに​ガイドします。​本記事で​比較する​他の​SDDツールと​比較して、​CafeKitは​最も​詳細な​フェーズ構造を​提供し、​ドキュメンテーション、​品質管理、​トレーサビリティに​より​重点を​置いています。​ フェーズ​構造:6フェーズ CafeKitは​開発を​6つの​明確な​フェーズに​整理します。​各フェーズは​独自の​成果物を​生み出し、​ワークフローの​次の​ステージへの​インプットと​して​機能します。​ 要件定義 — EARS​(Easy Approach to Requirements Syntax)を​使用して​ビジネス要件を​構造化された​仕様に​変換し、​曖昧さを​排除 設計 — アーキテクチャ、​データベース設計、​API契約、​技術的な​決定事項を​定義 タスク分解 — 設計を、​複雑度の​見積もりを​含む独立して​実行可能な​タスクに​分割 実装 — 設計と​技術的制約に​従って、​各タスクの​コードを​生成 テスト — テスト計画、​テストケースを​作成し、​自動テストを​実行 レビュー — コード品質を​評価し、​仕様との​一貫性を​チェックし、​決定事項を​記録 他の​ツールとの​最大の​違いは​CafeKitが​「テスト」と​「レビュー」を​独立した​フェーズと​して​分離している​点です。​GitHub Spec Kitや​BMADが​これらの​アクティビティを​実装フェーズに​組み込むか、​メインフローの​外に​配置しているのに​対し、​CafeKitは​それらを​必須ステージと​して​扱います。​これは​厳格な​品質管理や​エンタープライズ向けの​テスト・レビュー基準への​準拠が​求められる​プロジェクトに​おいて​特に​価値が​あります。​ 主な​機能 ● 生成される​すべての​成果物​(要件定義書、​設計書、​テスト計画、​レビュー記録)に​対する​ネイティブな​日本語サポート ● フェーズ固有の​テンプレートを​備えた、​Claude Codeに​最適化された​スラッシュコマンドシステム ● コードと​並行して、​エンタープライズ形式の​ドキュメントを​自動生成 ● 実際の​オフショア開発プロジェクトで​検証された​手法に​基づいて​構築 最適な​用途 CafeKitは​小規模から​大規模プロジェクトの​両方で​効果を​発揮します。​特に、​厳格な​ドキュメント要件と​形式的なな​品質管理プロセスを​持つエンタープライズ環境で​強みを​発揮します。​詳細な​フェーズ構造は​明確な​引き継ぎが​コミュニケーションの​誤解を​減らす分散チームに​とって​価値が​あります。​各ステージで​正式な​成果物を​必要と​する​組織は​CafeKitが​自社の​ワークフローに​適合していると​感じるでしょう。​ GitHub Spec Kit github.com/github/spec-kit GitHub Spec Kitは​GitHubが​2025年9月に​リリースした​公式の​仕様駆動開発ツールです。​急速に​普及しており、​現在、​デファクトスタンダードの​最有力候補と​なっています。​現在の​バージ​ョンは​0.9.5​(2026年6月上旬時点)です。​GitHubは​これを​実験的な​プロジェクトと​して​位置付けており、​コミュニティの​フィードバックは​賛否両論です。​チームは​その​構造と​予測​可能性を​評価する​一方で、​他の​ツールと​比較して​トークン消費量が​多く、​ワークフローが​遅いと​指摘しています。​ フェーズ​構造:4フェーズ /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement 各コマンドは​次の​フェーズに​フィードされる​成果物を​生成します。​ワークフローは​直線的ですが、​修正コマンドを​通じて​イテレーションを​サポートします。​要件定義フェーズで​要件を​キャプチャし、​計画フェーズで​アプローチを​定義し、​タスクフェーズで​作業を​単位に​分解し、​実装フェーズで​コードを​生成します。​ この​構造の​最大の​利点は​シンプルさです。​チームは​4つの​コマンドを​すぐに​学び、​最小限の​学習コストで​ツールを​使い​始められます。​しかし、​シンプルさは​CafeKitの​6フェーズアプローチと​比較して、​より​細かい​制御が​不可能である​ことを​意味します。​ テストと​レビューの​アクティビティは​独立した​フェーズと​して​明示的に​呼び出されていないため、​チームが​メインフローの​外に​独自の​品質ゲートを​構築する​必要が​あるかもしれません。​ 主な​機能 ● 20以上の​AIエージェント​(Claude Code、​GitHub Copilot、​Cursor、​Gemini CLIなど)を​サポートする​エージェント非依存設計 ● 2層の​カスタマイズ:拡張機能​(Extensions)と​プリセット​(Presets)​ ● 機能の​自動ナンバリング、​ブランチ作成、​ディレクトリ構造の​自動生成 ● 品質検証コマンド:/speckit.checklist​(仕様の​品質)と​ /speckit.analyze​(成果物間の​一貫性)​ ● 一時停止と​再開を​サポートする、​マルチステップ自動化に​対応した​YAML定義ワークフロー ● 活発な​OSSコミュニティと​迅速な​機能開発 最適な​用途 GitHub Spec Kitは​グローバルな​英語環境で​新製品を​構築する​チームに​最適です。​複数の​AIコーディングエージェントを​同時に​使用する​組織で​うまく​機能します。​OSSの​トレンドに​従う​スタートアップや​モダンな​SaaS企業は​活発な​コミュニティと​迅速な​開発ペースから​恩恵を​受けます。​最新の​SDDプラクティスに​追従する​ことを​優先する​チームは​この​ツールを​検討すべきです。​ BMAD-METHOD docs.bmad-method.org BMADは​「Breakthrough Method for Agile AI-Driven Development」の​略称で、​アジャイルの​コンテキストの​中で​仕様駆動開発を​再構築する​フレームワークです。​定義上の​特徴は​開発プロセス全体を​通じて​異なる​AIエージェントが​専門的な​役割を​担う​マルチエージェントアーキテクチャです。​この​フレームワークは​最近、​BMAD Method v6の​リリースに​伴い、​.claude/commands から​ .claude/skills に​移行し、​Claude Codeの​ネイティブ実装を​提供しています。​ フェーズ​構造:4フェーズ 分析​(Analysis)​ → 計画​(Planning)​ → ソリューション設計​(Solutioning)​ → 実装​(Implementation)​ 分析フェーズは​ビジネス要件と​ユーザーニーズの​理解に​焦点を​当てます。​計画フェーズでは​エピック、​ストーリー、​スプリント計画を​作成します。​ソリューション設計フェーズは​アーキテクチャと​技術設計を​処理します。​実装フェーズでは​コードの​生成と​テストの​実行を​行います。​ ワークフローを​直線的な​シーケンスと​して​扱う​他の​ツールとは​異なり、​BMADは​マルチエージェントシステムを​通じて​フェーズを​またいだ並列実行を​サポートします。​複数の​専門エージェントが​プロジェクトの​異なる​側面に​対して​同時に​作業できる​ため、​大規模な​チームや​長期的な​プロジェクトに​適しています。​ 主な​機能 ● 明確な​役割を​持つ21の​専門エージェント​(ビジネスアナリスト、​プロダクトマネージャー、​アーキテクト、​開発者、​スクラムマスター、​QA)​ ● 一般的な​開発シナリオを​カバーする​50以上の​ガイド付きワークフロー ● 複数の​AIツール​(Claude Code、​Cursor、​Windsurf、​GitHub Copilot)の​ネイティブ実装 ● スプリント計画、​ストーリー作成、​並列実装の​サポート ● ゲーム開発、​DevOps、​インフラなどの​専門ドメイン向け拡張パック ● スクラムおよび​アジャイル手法との​強力な​親和性 最適な​用途 BMAD-METHODは​役割が​明確に​定義された​アジャイルチーム向けに​設計されています。​要件が​複数の​スプリントに​わたって​進化する​長期プロダクト開発に​最適です。​大規模な​リファクタリングプロジェクトも、​構造化された​エージェントの​協業から​恩恵を​受けます。​専任の​プロダクトオーナーや​アーキテクトを​擁する​チームは​役割ベースの​アプローチを​自然に​活用できるでしょう。​ claude-code-spec-workflow​(Pimzino)​ github.com/Pimzino/claude-code-spec-workflow claude-code-spec-workflowは​個人開発者の​Pimzino氏に​よって​作成された、​軽量で​実用的な​SDDツールです。​現在、​GitHubで​2,544スター、​月間約5,450ダウンロード(バージョン1.5.9)を​記録しています。​この​ツールは​シンプルさを​追求して​設計されており、​ワンコマンドでの​インストールと、​実用的な​日常の​開発ワークフローに​焦点を​当てています。​著者は​現在、​MCPベースの​バージョン​(@pimzino/claude-code-spec-workflow-mcp)​へ​開発の​焦点を​移しており、​現在の​バージ​ョンは​今後の​アップデートが​少なくなる​見込みです。​ フェーズ構造 この​ツールは​作業の​種類に​応じて​2つの​独立した​ワークフローを​提供します。​ 新機能ワークフロー: 要件定義 → 設計 → タスク化 → 実装 バグ修正ワークフロー: 報告 → 分析 → 修正 → 検証 バグ修正ワークフローは​この​ツールの​最も​特徴的な​機能です。​本記事で​比較する​他の​ツールは​バグ修正専用の​フローを​提供しておらず、​新機能の​構築ではなく​イシューの​解決が​主要な​アクティビティである​保守プロジェクトに​特に​適しています。​ 主な​機能 ● ワンコマンドインストール:npx @pimzino/claude-code-spec-workflow ● バグ修正用の​独立した​ワークフロー​(報告 → 分析 → 修正 → 検証)​ ● 仕様全体の​進捗状況を​表示する​リアルタイムダッシュボード ● 最小限の​セットアップで​軽量かつ簡単に​導入可能 ● 実用的な​日常の​開発シナリオに​焦点を​当てた設計 最適な​用途 claude-code-spec-workflowは​バグ修正や​小規模な​機能追加を​中心とした​保守プロジェクトに​最適です。​重い​フレームワークに​コミットする​ことなく​SDDを​試したい​チームに​適しています。​軽量な​代替案を​探している​中小規模の​チームは​簡単に​導入できるでしょう。​グリーンフィールド開発ではなく、​既存の​プロダクトを​主に​扱う​チームは​専用の​バグ修正ワークフローを​高く​評価するはずです。​ 比較まとめ 基準 CafeKit GitHub Spec Kit BMAD-METHOD claude-code-spec-workflow 開発元 Haposoft GitHub公式 BMAD Code Organization 個人OSS (Pimzino) フェーズ数 6​(テスト、​レビューを​分離)​ 4 4 4 日本語サポート ネイティブ プリセットで​対応 限定的 なし 対応AIエージェント Claude Code 20以上​(エージェント非依存)​ Claude Code, Cursor, Windsurf, Copilot Claude Code 学習コスト 低い​ 中程度 高い​ 低い​ カスタマイズ性 中程度 高い​(拡張/プリセット)​ 高い​(21の​エージェント)​ 低い​ 現在の​ステータス アクティブ​(本番環境)​ 実験的​(v0.9.5)​ アクティブ​(v6)​ MCPへ​移行中 最大の​強み エンタープライズプロセス、​ドキュメント エージェント非依存、​標準化 マルチエージェント協業、​アジャイル バグ修正ワークフロー、​軽量 CafeKitは​ドキュメント、​品質管理、​フェーズベースの​デリバリーに​焦点を​当てています。​GitHub Spec Kitは​複数の​AIコーディングエージェントで​機能する​シンプルで​拡張性の​高い​ワークフローを​強調しています。​BMAD-METHODは​専門的な​AIロールを​中心に​構築された​アジャイルファーストの​アプローチを​とり、​claude-code-spec-workflowは​シンプルさと​日常の​実用性を​優先しています。​ 4つの​ツールは​AI支援開発の​基盤と​して​仕様を​使用すると​いう​同じ​コアアイデアを​共有しています。​違いは​どれだけの​構造を​導入するか、​そして​どの​開発課題を​優先するかです。​ほとんどの​チームに​とって、​選択は​機能の​豊富さよりも​ワークフローの​嗜好に​関係します。​最高の​ツールは​通常、​チームが​すでに​ソフトウェアを​計画、​レビュー、​デリバリーしている​方​法に​合致する​ものです。​ どの​ツールを​選ぶべきか?​ 適切な​選択は​プロジェクトの​タイプ、​チーム構成、​開発ワークフローに​よって​異なります。​以下の​表は​各シナリオに​最適な​ツールを​まとめた​ものです。​ シナリオ 推奨ツール 理由 形式な​ドキュメント要件を​持つエンタープライズプロジェクト CafeKit 専用の​テストと​レビューステージを​備えた​構造化された​6フェーズワークフロー グローバルチームに​よる​新製品開発 GitHub Spec Kit 強力な​コミュニティサポート、​エージェント非依存設計、​急速な​エコシステムの​成長 長期プロダクトを​管理する​アジャイルチーム BMAD-METHOD アジャイルおよび​スクラムプラクティスに​合わせた​役割ベースの​ワークフロー 保守プロジェクトおよび​バグ修正中心の​ワークロード claude-code-spec-workflow 専用の​バグ修正ワークフローと​最小限の​セットアップ要件 形式な​ドキュメント要件を​持つエンタープライズプロジェクト 推奨ツール: CafeKit CafeKitの​6フェーズ構造は​各ステージで​正式な​成果物を​必要と​する​エンタープライズの​デリバリープロセスに​適合しています。​要件定義書、​設計仕様書、​テスト計画、​レビュー記録は​オプションの​成果物ではなく、​ワークフローの​一部と​して​扱われます。​規制産業、​大規模な​クライアント、​または​厳格な​品質保証プロセスで​作業する​チームは​この​アプローチから​最も​恩恵を​受けます。​ グローバルチームに​よる​新製品開発 推奨ツール: GitHub Spec Kit GitHub Spec Kitは​分散環境で​新製品を​構築する​チームに​とって​強力な​オプションです。​エージェント非依存の​アーキテクチャは​幅広い​AIコーディングツールを​サポートし、​活発な​オープンソースコミュニティは​ワークフローと​ベストプラクティスを​最新に​保ちます。​モダンな​AI支援開発の​トレンドに​すでに​従っている​チームは​比較的スムーズに​導入できるでしょう。​ 長期プロダクトを​管理する​アジャイルチーム 推奨ツール: BMAD-METHOD BMAD-METHODは​すでに​アジャイルの​役割と​プロセスで​運用している​組織に​自然に​適合します。​この​フレームワークは​専門的な​AIエージェントを​通じて、​スプリント計画、​ストーリー作成、​アーキテクチャ設計、​実装を​サポートします。​これは​複数の​リリースと​進化する​要件に​またがる​プロダクトチームに​特に​有用です。​ 保守プロジェクトおよび​バグ修正中心の​ワークロード 推奨ツール: claude-code-spec-workflow 専用の​バグ修正ワークフローが​ここでの​最大の​差別化要因です。​機能開発プロセスを​保守作業に​適用するのではなく、​チームは​イシュー解決の​ために​特別に​設計された​ワークフローに​従うことができます。​軽量な​セットアップと​低い​学習コストは​小規模な​チームに​とって​実用的な​オプションでもあります。​ 複数の​SDDツールを​併用する​ことは​可能か?​ 仕様駆動開発を​導入するに​あたって、​組織が​単一の​フレームワークに​標準化する​必要は​ありません。​実際には​異なる​チームが​異なる​要件、​ワークフロー、​プロジェクトタイプを​持つことが​よく​あります。​新製品チームで​うまく​機能する​ツールが、​保守チームや​エンタープライズデリバリープロジェクトに​最適とは​限りません。​ 一般的な​アプローチは​組織全体で​単一の​標準を​強制するのではなく、​プロジェクトの​特性に​基づいて​ツールを​選択する​ことです。​例えば、​形式な​ドキュメント要件を​持つエンタープライズクライアントの​プロジェクトは​CafeKitの​構造化された​ワークフローから​恩恵を​受けるかもしれません。​新しい​アプリケーションを​構築する​プロダクトチームは​活発な​エコシステムと​エージェント非依存設計の​ため、​GitHub Spec Kitを​好むかもしれません。​主に​保守と​バグ修正に​注力する​チームは​専用の​バグ修正ワークフローに​より、​claude-code-spec-workflowが​より​実用的だと​感じるかもしれません。​ 良い​ニュースは​これらの​ツールが​相互に​排他的ではないと​いう​ことです。​ほとんどは​Claude Code内の​コマンドベースの​ワークフローと​して​機能し、​同じ​エンジニアリング組織内で​共存できます。​これに​より、​チームは​プロジェクトの​ニーズに​最も​適した​ワークフローを​採用しつつ、​使い​慣れた​AI開発環境を​使い続ける​ことができます。​ 目標は​最も​機能豊富な​フレームワークを​選ぶことでは​ありません。​目標は​チームが​より​一貫して​ソフトウェアを​デリバリーするのに​役立つワークフローを​選ぶことです。​多くの​組織に​とって、​それは​異なる​種類の​作業に​異なる​SDDツールを​使用する​ことを​含むかもしれません。​ まとめ 仕様駆動開発は​2025年後半以降、​大きく​成熟しました。​GitHub Spec Kitは​標準化と​マルチエージェントサポートで​リードしています。​BMAD-METHODは​アジャイル環境で​卓越しています。​claude-code-spec-workflowは​ユニークな​バグ修正ワークフローを​備えた​軽量な​オプションを​提供します。​CafeKitは​強力な​ドキュメントサポートを​備えた​エンタープライズグレードの​構造を​提供します。​ 最適な​選択は​プロジェクトの​タイプと​チーム構成に​よって​異なります。​ハイブリッドな​環境では​複数の​ツールを​並行して​使用する​ことが​実用的な​戦略です。​ チームで​仕様駆動開発を​試す準備は​できましたか?​ CafeKitから​始めましょう。​オープンソースですぐに​使用できます。​今すぐ​インストールして、​構造化された​AI支援開発を​体験してください。​ bash 1 GitHubリポジトリ → 組織での​SDD導入に​ついて​ご質問は​ありませんか?​お気軽に​お問い​合わせください。​経験に​基づいた​サポートを​ご提供します。​ CafeKitと​Haposoftに​ついて​ CafeKitは​ cafekit.haposoft.com で​ご利用いただけます。​導入サポート、​カスタマイズ、​または​社内トレーニングに​ついては​Haposoftまで​ご連絡ください。​ 株式会社Haposoft ● 本社:ベトナム・ハノイ ● 日本オフィス:Haposoft Japan​(東京都渋谷区恵比寿)​ ● 200名以上の​エンジニア、​ISO 9001:2015 / ISO 27001 認証取得、​AWS Select Tier Partne
spec-driven-development-what-is
2026年6月2日
20分で​​​読む

Spec-Driven Development​(仕様駆動開発)とは​?AI時代の​新しい​ソフトウェア開発手法を​紐解く

Claude Codeや​GitHub Copilot と​いった​AIコーディングエージェントの​登場は​ソフトウェアの​開発方​法を​根本的に​変革しました。​「自然言語で​指示を​与えるだけで、​AIが​コードを​書いてくれる」​数年前までは​夢物語だった​ことが、​今や​日常の​現実と​なっています。​しかし、​導入が​拡大するに​つれて、​以下のような​共通の​課題が​顕在化しています: ​「3 時間前に​立てた​計画は​どうだったっけ?」 と​いう​チャット履歴を​スクロールする​時間が​増加している​ AI に​タスクを​依頼した後、​想定外の​機能を​実装してしまう​(過剰設計)​ 会話が​続くに​つれて、​重要な​仕様が​コンテキストの​中に​埋もれてしまう​ セッションを​切り​替える​際、​再度AIに​コンテキストを​説明しなければならない​ だから​こそ、​より​多くの​チームが​純粋な​「Vibe Coding​(感覚的コーディング)」ワークフローから​離れ、​Spec-Driven Development​(SDDまたは​仕様駆動開発)に​注目するようになっています。​散発的な​プロンプトに​依存するのではなく、​SDDは​開発プロセスの​中心に​仕様を​据えます。​仕様は​実装全体を​通じて​エンジニアと​AI コーディングエージェントの​双方に​とっての​共通参照ポイントと​なるのです。​ 1. Spec-Driven Development​(SDD)とは?​ 1.1 定義 Spec-Driven Development​(SDD)とは​仕様書を​「単一の​信頼源​(Single Source of Truth)」と​位置付け、​コーディングエージェントが​その​仕様に​基づいて​コード生成を​行う​開発手法です。​ 従来の​開発では​通常​「コードファースト」の​ワークフローが​採用されます。​開発者が​まずコードを​書き、​その後で​ドキュメントを​更新します。​SDD は​これとは​逆の​アプローチを​取ります。​実装を​開始する​前に、​チームは​構造化された​仕様を​通じて​「何を​実装するか」を​まず定義します。​要件が​明確に​なった​時点で、​開発者と​ AI エージェントは​その​仕様を​実装の​基盤と​して​活用します。​ この​「仕様ファースト」の​考え方が​Spec-Driven Developmentの​核と​なる​概念です。​ 1.2 ソフトウェア開発の​進化に​おける​SDDの​位置付け 仕様駆動開発は​全く​新しい​概念では​ありません。​多くの​点に​おいて、​開発チームが​数十年に​わたって​実践してきた​馴染みの​ある​エンジニアリング原則​「要件定義 → 設計 → 実装 → テスト」と​いう​ワークフローを​再構築した​ものです。​異なるのは、​この​ワークフローが​現在、​AI時代に​合わせて​適応されている​点に​あります。​ AIコーディングツールの​能力が​向上するに​つれ、​チームは​大規模開発に​おいて​プロンプト単独では​不十分である​ことに​気づき始めています。​構造化された​仕様が​なければ、​コンテキストは​不安定に​なり、​出力結果の​制御も​困難に​なります。​SDDは​すべての​情報を​チャット会話内に​残すのではなく、​要件や​決定事項を​永続的な​形式で​文書化する​ことで、​この​問題に​対処します。​ この​アプローチは​Thoughtworksが​2025年11月発行の​Technology Radar Vol.33に​おいて​Spec-Driven Developmentを​「Assess​(評価)」ステージに​位置付けた​ことを​契機に、​より​広範な​注目を​集め始めました。​ほぼ同時期に、​AWSも​要件→設計→タスク→コード生成と​いう​ワークフローを​軸に​据えた​AI統合開発環境​「Kiro IDE」を​発表しています。​ 1.3 Spec-Driven Development 対 Vibe Coding Vibe Coding と​ Spec-Driven Development の​違いは​日常の​開発ワークフローに​おいて​より​明確に​なります。​ 項目 Vibe Coding Spec-Driven Development​(SDD)​ 出発点 自然言語に​よる​アイデアや​プロンプト 構造化された​仕様書 主要な​コンテキスト源 チャット履歴 仕様ファイル​(Markdown 等)​ 計画の​継続性 会話の​中で​コンテキストが​埋もれる​ ファイルと​して​存在する​ため継続可能 セッション間の​引継ぎ セッションを​跨いだ継続が​困難 仕様が​読めれば​継続可能 チーム内での​共有 困難 ファイル共有に​より​容易 レビュー 出力された​コードのみを​レビュー可能 仕様段階から​レビュー可能 2. Spec-Driven Developmentに​おける​実務的な​メリット Spec-Driven Developmentは​2025年〜2026年現在に​おいても​依然と​して​新興の​プラクティスであり、​業界全体と​して​その​影響を​測定する​統一された​方​法は​いまだ​確立されていません。​しかし、​弊社​(Haposoft)では、​実際の​プロダクションプロジェクトに​おいて​仕様ファーストの​ワークフローを​導入した​結果、​納品速度と​プロジェクト実行に​おいて​測定可能な​改善が​確認されました。​これらの​ワークフローは、​後に​CafeKit​(弊社の​新サービス)の​基盤と​なりました。​ 2.1 プロジェクト全体​工数を​30%削減 従来の​開発ワークフロー​(Code-Firstで​開発を​進め、​後から​ドキュメントを​整備する​方​式)と、​SDDおよび​Coding Agentを​導入した​新しい​開発ワークフローを​比較し、​キックオフから​本番リリースまでに​実際に​投入された​総工数​(Man-Hour)を​測定しました。​ 対象は​開発期間3〜12か​月程度の​中〜大規模な​Webシステムおよび​SaaS開発プロジェクトです。​ 分析の​結果、​プロジェクト全体で​約30%の​工数削減を​確認しました。​ 工数削減効果は​開発ライフサイクル全体に​わたって​発生しています。​ 要件定義・設計フェーズ 開発初期段階から​構造化された​仕様を​作成する​ことで、​顧客との​認識合わせや​要件確認の​ための​コミュニケーション回数を​削減できます。​また、​認証​(Authentication)、​決済​(Payment)、​通知​(Notification)などの​共通機能に​ついては、​過去プロジェクトで​利用した​仕様モジュールを​再利用できる​ため、​設計工数の​削減に​もつながります。​ 実装フェーズ Coding Agentは​仕様を​基準と​して​コードを​生成する​ため、​初回から​要件に​沿った​実装を​行いやすくなります。​その​結果、​エンジニアと​AIとの​間で​発生する​プロンプトの​試行錯誤や​修正指示の​往復回数が​減少しました。​ テストフェーズ 仕様に​定義された​Acceptance Criteria​(受け入れ条件)を​もとに​テストケースを​生成できる​ため、​実装完了後に​テストケースを​ゼロから​作成する​必要が​ありません。​ 手戻り​(Rework)​削減 最も​大きな​効果が​現れたのは​手戻り工数の​削減です。​人間と​AIが​実装前に​同じ​仕様を​共有する​ことで、​「実装完了後に​要件の​解釈違いが​発覚する」と​いった​ケースを​大幅に​減らすことができました。​これは、​日本企業と​ベトナム企業に​よる​オフショア開発に​おいて、​言語や​コミュニケーションの​ギャップに​よって​発生しやすい​無駄の​削減に​つながっています。​ ドキュメント作成フェーズ 納品資料や​関連ドキュメントは​仕様から​自動生成できます。​ドキュメント品質への​要求が​高い​日本企業に​対しても、​一貫性の​ある​資料を​効率的に​作成できます。​ 2.2 SDLCの​デリバリー速度を​50%向上 従来の​Code-Firstプロジェクトと、​SDDワークフローおよび​AIコーディングエージェントを​活用した​プロジェクトに​ついて、​キックオフから​初回本番リリースまでに​要した​期間を​比較しました。​ 分析の​結果、​中〜大規模の​グリーンフィールド開発プロジェクトに​おいて、​最大50%の​デリバリー速度向上を​確認しました。​ 主な​要因は​以下の​通りです。​ 要件が​仕様と​して​事前に​整理・合意されている​ため、​開発途中での​認識齟齬が​減少する​ Coding Agentが​仕様を​基準と​して​実装を​進められる​ため、​コード生成の​精度が​向上する​ テストケースを​仕様の​Acceptance Criteriaから​生成できる​ため、​テスト準備に​かかる​時間を​削減できる​ 引継ぎ資料や​関連ドキュメントを​仕様から​生成できる​ため、​開発後工程の​負荷を​軽減できる​ 特に、​従来は​実装後に​発覚していた​問題の​多くを​仕様策定段階で​発見できる​ことが、​デリバリー速度向上の​大きな​要因と​なりました。​ 一方で、​小規模な​保守案件や​ホットフィックスでは、​仕様作成の​オーバーヘッドが​得られる​効果を​上回る​場合が​あります。​その​ため、​CafeKitでは​軽微な​変更に​対して​一部​フェーズを​スキップできる​仕組みを​用意しています。​ 2.3 ​その​他の​定性的効果 測定可能な​指標に​加え、​Spec-Driven Development導入後には​運用面でも​以下の​改善が​確認されました。​ 人間と​AIの​役割分担の​明確化 仕様は​「何を​作るか」を​定義し、​AIは​その​実装を​担います。​この​役割分担に​より、​開発スピードを​維持しながら​プロジェクトの​方​向性を​管理しやすくなりました。​ セッションや​担当者変更を​またいだ​継続性の​確保 Claude Codeの​セッションが​中断された​場合や、​担当エンジニアが​変更に​なった​場合でも、​仕様ファイルが​残っていれば​新しい​担当者が​短時間で​プロジェクトを​引き継ぐことができます。​ ドキュメントの​自動蓄積 要件、​設計上の​意思決定、​プロジェクトの​進捗などが​構造化された​Markdownファイルと​して​リポジトリ内に​保存されます。​これに​より、​数週間から​数か​月後であっても​プロジェクトの​コンテキストを​再構築しやすくなり、​オンボーディングや​引継ぎに​かかる​負荷を​軽減できます。​これは、​日本の​PMと​ベトナムの​開発チームが​協業する​オフショアプロジェクトに​おいて​特に​有効でした。​ 3. SDD の​典型的な​ワークフロー では、​実際の​開発現場に​おいて​ Spec-Driven Development は​どのように​機能するのでしょうか?​チームや​ツールに​よって​ワークフローは​異なる​場合が​ありますが、​ほとんどの​ SDD プロセスは​以下の​ 6 つの​コアフェーズに​従います。​ フェーズ​ 1:要件定義 チームは、​ビジネス目標、​ユーザーが​抱える​課題、​機能要件、​非機能要件を​自然言語で​記述します。​この​段階では、​開発者は​しばしば​ AI ツールと​協働しながら、​アイデアを​ユーザーストーリーや​受け入れ基準に​構造化します。​目的は、​最初から​完璧な​ドキュメントを​作成する​ことでは​ありません。​むしろ、​「何を​構築すべきか」に​ついての​共通理解を​構築する​ことに​重点を​置きます。​ フェーズ​ 2:設計 アーキテクチャの​決定、​データモデル、​API 構造、​画面フロー、​システム動作などを​含みます。​多くの​チームは、​特定の​技術的決定が​なぜな​されたかを​記録する​ために、​設計ドキュメントや​ ADR​(Architecture Decision Record)を​活用します。​これらの​決定を​文書化しておく​ことは、​プロジェクトが​拡大したり、​新しい​エンジニアが​参画したりした​際に、​後々特に​有用と​なります。​ フェーズ​ 3:タスク分解 設計を​実行可能な​タスクに​分解します。​「1 タスク=1 コミット」と​いう​基準を​採用する​ことで、​進捗管理と​レビューの​効率化が​図れます。​ フェーズ​ 4:実装 各タスク単位で​ AI に​コード生成を​依頼します。​仕様を​同時に​参照しながら​実装を​行う​ため、​AI は​「全体​像を​見失う」ことなく、​一貫性の​ある​コードを​記述できます。​ フェーズ​ 5:テスト 仕様から​導出された​受け入れ基準に​基づき、​テストコードを​生成・​実行します。​仕様と​テストが​ 1 対 1 で​対応している​ため、​カバレッジの​可視化が​容易に​なります。​ フェーズ​ 6:レビュー 人間の​エンジニアが、​仕様との​整合性、​コード品質、​セキュリティを​確認します。​仕様書が​「判断基準」と​して​機能する​ため、​レビューの​基準が​明確に​なります。​ 4. Spec-Driven Development に​おける​主要ツール Spec-Driven Developmentへの​関心が​高まるに​つれ、​Claude Codeなどの​ AI 支援ワークフローや​コーディングエージェントを​取り巻く​ツールも​増加しています。​各ツールは​ SDD に​対して​異なる​アプローチを​取っています。​ ドキュメンテーションワークフローに​注力する​ものも​あれば、​要件、​実装、​テスト、​AI 生成コードを​一貫して接続する​エンドツーエンド環境を​提供する​ものも​あります。​ 4.1 GitHub Spec Kit GitHub Spec Kit は​「AI は​明確な​仕様に​基づいて​作業した​方が​性能を​発揮する」と​いう​考え方を​軸に​構築された​公式ツールキットです。​この​ツールキットは、​実装開始前に​ PRD、​設計ドキュメント、​ADR などの​文書を​作成・管理する​ことを​支援します。​プロンプトのみに​依存するのではなく、​開発者は​プロジェクトコンテキストを​より​再利用​可能な​形式で​構造化できます。​ 4.2 Kiro IDE Kiro IDE は​AWS が​提供する​ AI 統合開発環境です。​本プラットフォームは、​自然言語に​よる​要件から、​設計、​タスク分解、​実装、​テスト、​コード生成と​いった​構造化された​フェーズへと​移行する​ワークフローを​サポートします。​AI を​単なる​自動補完ツールと​して​扱うのではなく、​Kiro は​ AI エージェントを​開発ワークフロー全体の​一部と​して​位置付けています。​ 4.3 claude-code-spec-workflow OSSコミュニティから​生まれた​ CLI ツールです。​Claude Code 向けに​ SDD フローを​実装しており、​単一の​コマンドで​新機能開発ワークフローを​起動できます。​Claude Code を​中心に​作業を​行っている​チームに​とって、​この​種の​ワークフローは​開発中の​プロンプト断片化を​軽減するのに​役立ちます。​ 4.4 cc-sdd / OpenSpec この​グループの​軽量ツール群は、​さまざまな​哲学に​基づき​「仕様→タスク→実装」と​いう​フローを​提供します。​選択は​プロジェクトの​規模や​嗜好に​依存します。​ツールに​よっても​哲学が​異なる​ため、​チームは​プロジェクト規模や​エンジニアリング文化に​適合した​ワークフローを​選択できます。​ 4.5 CafeKit CafeKitは​Haposoftの​チームが​開発した​オープンソースの​SDDツールキットです。​ 本ツールは​ Claude Code ワークフローに​特化して​設計されており、​6フェーズの​ Spec-Driven Development プロセスに​従います。​仕様を​静的な​ドキュメントと​して​扱うのではなく、​CafeKit は​仕様を​開発全体を​通じて​実装、​テスト、​プロジェクト管理と​密接に​連携させた​状態で​維持します。​ 5. Spec-Driven Development 導入の​始め方​ Spec-Driven Developmentを​ワークフローに​導入する​ことに​興味を​お持ちの​チームに​とって、​移行は​一度に​すべてを​行う​必要は​ありません。​多くの​場合、​開発プロセス全体を​即座に​再設計しようとするよりも、​小規模から​始める方が​効果的です。​ ステップ 1:小規模プロジェクトから​始める​ 初日から​大規模プロジェクト全体に​ SDD を​適用する​ことは​避けてください。​より​良い​アプローチは、​小規模な​内部​ツール、​独立した​機能、​または​新規サイドプロジェクトから​始める​ことです。​これに​より、​チームは​不必要な​デリバリーリスクを​追加する​ことなく、​仕様ファーストの​ワークフローに​慣れる​時間を​確保できます。​ ステップ 2:仕様テンプレートを​準備する​ 適切に​構造化された​テンプレートは​チーム全体で​ SDD を​一貫して​導入するのを​大幅に​容易にします。​プロジェクト種別に​応じて、​要件、​設計ドキュメント、​API 仕様、​受け入れ基準などの​テンプレートを​準備できます。​すべてを​ゼロから​作成するよりも、​既存の​テンプレートを​出発点と​して​徐々に​カスタマイズしていく​方が、​現実的です。​ ステップ 3:タスク、​コミット、​仕様の​整合を​維持する​ 有用な​プラクティスの​一つは​タスク、​コミット、​仕様更新の​間に​密接な​関係を​維持する​ことです。​ 一部の​チームでは​以下のような​シンプルな​構造を​採用しています: 1つの​Todo = 1つの​コミット = 1回の​仕様更新 ステップ 4:レビューを​仕様段階に​前倒しする​ 従来の​ワークフローでは​実装完了後の​コードレビューに​大きく​依存する​傾向が​あります。​SDD は、​開発開始前に​仕様を​レビューする​ことで、​その​レビュープロセスの​一部を​前段階に​シフトします。​ 実装段階で​要件の​ギャップを​発見するよりも、​仕様段階で​発見する​方が、​通常ははるかに​コストが​低く​済みます。​ ステップ 5:チーム全体で​ツールを​標準化する​ 個人個人が​異なる​ツールを​使用すると、​仕様フォーマットが​混沌と​してしまいます。​チーム全体で​一貫した​ツール​(例:CafeKit)を​使用する​ことが​望ましいです。​ 6. Spec-Driven Development 導入に​おける​一般的な​課題 ​あらゆる​開発手法と​同様に、​Spec-Driven Developmentも​すべての​状況に​おける​完璧な​解決策では​ありません。​SDD を​導入する​チームは、​移行段階に​おいて​以下のような​共通の​課題に​直面する​ことが​よく​あります。​ 落とし穴 1:仕様の​過剰記述 最も​一般的な​ミスの​一つは​最初から​すべてを​過剰に​文書化する​ことです。​ チームが​完璧な​仕様を​作成する​ことに​時間を​かけすぎると、​AI 支援開発の​速度​優位性は​急速に​失われます。​実際には、​軽量な​仕様でも​開始には​十分な​場合が​よく​あります。​「いく​つかの​箇条​書きから​始める」と​いう​穏やかな​アプローチも​非常に​効果的です。​AI が​仕様の​拡張を​支援してくれます。​ 落とし穴 2:仕様と​コードの​同期ずれ もう​一つの​一般的な​課題は​実装が​変更された​後に​仕様が​更新されない​場合に​発生します。​時間が​経つに​つれて、​古い​仕様は​信頼性を​失い、​チームは​ドキュメント全体を​信頼しなくなります。​これを​避ける​ためには、​仕様と​実装は​プロジェクトライフサイクル全体を​通じて​共に​進化させる​必要が​あります。​ 落とし穴 3:AI 生成出力への​過信 構造化された​仕様が​あったとしても、​AI コーディングエージェントは​依然と​して​ミスを​犯します。​仕様は​一貫性を​向上させますが、​あらゆる​ケースで​正しい​実装を​保証する​ものでは​ありません。​SDD は、​AI を​エンジニアリング判断の​完全な​代替手段と​してではなく、​開発パートナーと​して​扱う​場合に​最も​効果を​発揮します。​ 7. CafeKit:エンタープライズ向けの​SDDツール 7.1 CafeKitとは?​ CafeKit​(cafekit.haposoft.com)は​Claude Code向けに​特別に​設計された​オープンソースCLI ツールセットであり、​6 フェーズの​ Spec-Driven Development ワークフローを​実装しています。​ CafeKit背後に​ある​主要な​目的の​一つは、​ドキュメンテーション、​レビュープロセス、​長期的な​保守性が​デリバリーに​おいて​重要な​要素と​なる​エンタープライズ開発環境に​おいて、​SDDワークフローを​より​適用しやすく​する​ことでした。​ 7.2 CafeKit に​おける​コア6フェーズワークフロー CafeKitは​日本の​開発環境で​馴染みの​ある​用語を​使用し、​以下の​フェーズを​提供しています: 要件定義 → 設計 → タスク分解 → 実装 → テスト → レビュー 各フェーズは​リポジトリ内に​直接保存される​構造化された​ Markdown ファイルを​生成し、​Git に​よる​管理が​可能です。​仕様は​コードベースと​一緒に​バージョン管理される​ため、​チームは​変更を​一貫して​追跡でき、​時間の​経過に​伴う​プロジェクト履歴を​より​明確に​維持できます。​また、​全員が​同じ​文書化された​コンテキストに​基づいて​作業する​ため、​エンジニア、​レビュアー、​AI コーディングエージェント間の​協業も​容易に​なります。​ 7.3 なぜCafeKitが​日本企業に​適しているか​ ✅ 日本語ネイティブ対応 コマンド、​テンプレート、​生成される​文書の​すべてが​日本語に​対応。​「要件定義書」​「基本設計書」​「詳細設計書」など、​日本の​SIerや​SaaS企業で​使われる​ドキュメント文化と​自然に​統合できます。​ ✅ ウォーターフォール文化との​橋渡し 日本企業に​多い​「承認プロセス重視」​「ドキュメント文化」と​AIエージェントの​相性問題を​解決。​仕様書と​いう​共通言語が​ある​ことで、​経営層・PM・エンジニアの​三者が​同じ​前提で​議論できます。​ ✅ Claude Code完全対​応 CafeKitは​Claude Codeの​仕組み​(CLAUDE.md、​スラッシュコマンド、​サブエージェント)を​前提に​設計されており、​追加の​IDEや​高価な​ライセンスは​不要です。​ ✅ OSSと​して​無償提供 GitHubで​公開されており、​商用利用も​可能。​自社の​プロジェクトに​合わせて​カスタマイズする​ことも​できます。​ 7.4 CafeKitを​始める​ CafeKitの​セットアップは​数分で​完了します。​ 1. 動作環境 Node.js​(v18以上)​および​ npm / npx が​インストールされている​ことを​確認してください。​ 2. プロジェクトの​ルートディレクトリへ​移動 ターミナルを​開き、​提案の​ルートディレクトリへ​移動します。​ 3. CafeKitを​初期化 以下の​コマンドを​実行してください。​ npx@haposoft/cafekit 上記の​コマンドを​実行すると、​CafeKit CLI が​自動的に​ダウンロードされ、​起動します。​ 画面の​案内に​従って​プロジェクトの​設定を​行ってください。​ セットアップ手順の​詳細や​関連ドキュメントに​ついては、​CafeKit公式サイトを​ご覧ください。​ 8. Spec-Driven Development が​エンジニアキャリアに​与えうる​変化 AI コーディングツールの​台頭は​エンジニアスキルの​評価方​法も​変化させています。​AI に​よる​実装コード生成の​能力が​向上するに​つれ、​単に​「コードを​書く」ことの​価値は​次第に​差別化されにくくなる​可能性が​あります。​ 同時に、​要件定義、​問題の​構造化、​システム設計に​関連する​スキルの​重要性が​高まっています。​ これが​Spec-Driven Development が​生産性以外にも​注目を​集める​理由の​一つです。​ SDDワークフローでは​エンジニアは​不明確な​ビジネス要件を、​人間と​ AI の​双方が​一貫して​理解できる​構造化された​仕様に​変換する​ことが​期待されます。​多くの​点に​おいて、​SDD は​エンジニアの​役割の​一部を、​純粋な​実装から​仕様設計と​意思決定へと​シフトさせます。​「コーダー」から​「仕様設計者」へと​キャリアを​シフトさせたい方に​とって、​SDD は​確実に​習得すべきスキルセットです。​ まとめ Spec-Driven Developmentは​単に​ AI を​用いて​コード生成を​高速化する​ことでは​ありません。​それは、​人間と​ AI が​同じ​信頼源に​基づいて​作業できる、​より​構造化された​開発プロセスを​構築する​ことなのです。​AI 支援開発が​進化を​続ける​中で、​明確な​仕様を​軸に​据えた​ワークフローは、​現代の​ソフトウェアチームに​おいて​より​一般的に​なる​可能性が​高いでしょう。​ エンタープライズ開発に​おいて​SDDの​活用を​開始したいとお考えの​場合は、​ぜひ CafeKit​(cafekit.haposoft.com)を​ご検討ください。​Claude Code 完全対応、​無料の​ OSSと​して​今日から​導入可能です。​ CafeKitに​関する​お問い​合わせ、​サポート、​エンタープライズ向けカスタマイズ、​または​SDD関連コンサルティングに​ついては、​Haposoftまで​お気軽に​お問い​合わせください。​ 公式サイト: http://haposoft.com/ja Haposoft: ベトナム・ハノイに​本社を​構え、​東京(渋谷)にも​拠点を​展開する​ソフトウェア開発企業です。​AWS Select Tier Partner、​ISO 9001:2015、​ISO 27001 認証取得しています。​ AI時代の​開発を、​確かな​仕様設計から。
cta-background

ニュースレター登録

デジタルトランスフォーメーションに​関する​専門的な​知見や​イベント最新情報を、​メールボックスに​直接お届けします。

プロジェクトの​アイディアを​ お持ちでしたら、​ご相談ください

+81 
© Haposoft 2025. All rights reserved
プライバシーポリシー