sdd-mcp

🌱 仕様駆動開発テンプレート

仕様駆動開発を学び、実際のプロジェクトで活用しましょう。
ルールはひとつ。書面の仕様を承認するまで、コードを書きません。スクリプトを実行するたびにルールがチェックされ、確認対象が正確に表示されます。

🇺🇸 English · 🇪🇸 Español

技術者以外の方向けのスタートガイド · クイックスタート · AI エージェント向けスタートガイド · コマンド · コミュニティ

これは何ですか？

**仕様駆動開発（SDD）**とは、コードを書く前に、明確な仕様を書いて承認することです。決定した内容はファイルに残るため、閉じたあと二度と見つからないチャットの中に埋もれません。2026年までには、AI エージェントを使ったソフトウェア開発の主流となっています。

このリポジトリには、二つの役割があります。

ひとつは学びの場です。ガイド、インタラクティブコース、会話できるチューターを備えた、ゼロから始められるバイリンガル（EN/ES）の学習パスです。最後まで学ぶのに、プログラミングの知識は必要ありません。

もうひとつは、実務で使えるツールキットです。ルールをチェックするスクリプト、AI アシスタントが読む指示ファイル、AI ツールがワークフローを自ら実行できるようにするコネクター（MCP、Model Context Protocol）、そしてコードのある既存プロジェクトに、コードを移動することなく追加できる単一の spec/ フォルダーを備えています。

ステップごとのコマンドはGitHub Spec Kitに基づいています。このリポジトリでは、それらにガイド、チェック機能、テンプレートを追加しています。

実際のワークフロー — 仕様を作成し、検証して、ゲートを通過する (リリースごとに再生成)：

実際に変わること：決定事項はチャット履歴に残るのではなく、specs/に記録されます。spec.mdとplan.mdが存在して内容が一致し、同意を記録するまではゲートが閉じたままです。人の記憶に頼らず、スクリプトがそれをチェックします。新しいチームメンバーやエージェントは、すでに見慣れたフォルダー構成から作業を始められます。また、bitacora/にはセッションログが残るため、半年後でも、なぜそのように作業したのかを確認できます。

業界の全体像を知りたい方は、2026年のSDD：最新動向とこのテンプレートの比較をご覧ください。

どの入り口を選びますか

• 技術者以外の方（創業者、PM、興味がある方）：START_HERE_NON_TECH.md — 専門用語を使わずに進められるガイド付きのスタートです。
• 開発者：QUICKSTART.md — 足場の作成と検証に使うコマンドを紹介します。所要時間は約5分です。
• AI エージェント、またはエージェントに貼り付けて使う方：AI_START_HERE.md — 運用ルールと、各レベルで使えるコピー＆ペースト用プロンプトを紹介します。

次に、学習レベルを選んでください。ドキュメントサイトの各ガイドには、レベルバッジが付いています。

• 🟢 初級：プログラマー以外の方向けクイックガイド
• 🟡 中級：チームの規律に関するガイド
• 🔴 上級：ガバナンスと標準化

ヒント

実践しながら学びたい場合は、インタラクティブコース（GitHub Skills 形式）をご利用ください。4ステップ、約35分で、Actions による自動採点があります。試験では、実際の SDD ゲートを使用します。

30秒で始める

このプロンプトを AI アシスタント（Claude、Cursor、Copilot、Gemini など）にコピー＆ペーストしてください。

Using https://github.com/juanklagos/spec-driven-development-template, guide me step by step with SDD for my project.
My project is: [describe your project in plain language].
If my project is new, initialize from this template and GitHub Spec Kit as the base workflow.
If it already exists, adapt it without breaking current behavior.
No code before approved spec and consistent plan.

AI エージェント用の組み込みコマンド

Claude Codeを使用している場合、このリポジトリにはスラッシュコマンドがあらかじめ用意されています。/sdd:helpから始めてください。

プラグインとして任意のプロジェクトにインストールできます（クローン不要）。

/plugin marketplace add juanklagos/spec-driven-development-template
/plugin install sdd@sdd-template

• **VS Code / Copilot：**同じワークフローをプロンプトファイルとして.github/prompts/に用意しています。
• **任意のエージェント（39個のツール）：**移植可能なエージェントスキルをskills/sdd-workflow/SKILL.mdで利用できます。
• **AI コンテキスト：llms.txt**には、コーディングエージェント向けの全ドキュメントがまとめられています（./scripts/generate-llms-txt.shで再生成できます）。

黄金律

重要

承認済みのspec.mdと、整合性の取れたplan.mdができるまでは、コードを書かないでください。 スクリプトがこれを強制し、同意が記録された後にのみ実装を開始します。

./scripts/check-sdd-policy.sh .   # multi-agent policy files are aligned
./scripts/check-sdd-gate.sh .     # spec approved + plan consistent + consent recorded
./scripts/confirm-user-consent.sh --spec 001-<slug> "User approved scope X"

（サイドカープロジェクトでは、同じスクリプトが./spec/scripts/にあります。）

CI でもこれを強制しましょう。このリポジトリは GitHub Action としても利用でき、GitHub Marketplaceに掲載されています。

- uses: juanklagos/[email protected]
  with:
    path: "."      # project root (sidecar or standalone auto-detected)
    strict: "true"

参考ファイル：sdd.policy.yaml · INSTRUCTIONS.md · AGENT_OPERATING_SYSTEM.md

仕組み

flowchart LR
  A["💡 Idea in plain language"] --> B["📋 spec.md approved"]
  B --> C["🗺️ plan.md consistent"]
  C --> D["✅ tasks.md prioritized"]
  D --> E["🚦 Gate + explicit consent"]
  E --> F["⚙️ Implementation"]
  F --> G["🔍 Validation + logbook"]

各機能には番号付きの仕様バンドルを作成し、各セッションの記録をbitacora/（作業記録）に残します。

1. spec.md — 何を、なぜ行うか (あなたが承認)
2. plan.md — どのように行うか (仕様との整合性を保つ)
3. tasks.md — 具体的な手順
4. history.md — どのように進化したか

手順全体の例：examples/002-mcp-end-to-end

実際のプロジェクトに適用する

最も手軽な始め方（クローン不要）：

npx @juanklagos/create-sdd-project@latest my-app

いくつか質問に答えると、最新のテンプレートから、推奨されるspec/サイドカーまたはワークスペース全体を作成します。

軽い方法から重い方法まで、テンプレートの使い方は3通りあります。

ヒント

プロフェッショナル向けのデフォルトは、コンパクトな spec/ サイドカーのみです。スタンドアロンモードを実際に使用する場合を除き、実際のコードベースにフレームワーク全体をコピーしないでください。

flowchart TD
  A["Your project root (code)"] --> B["spec/"]
  B --> C["idea/"]
  B --> D["specs/ (numbered bundles)"]
  B --> E["bitacora/ (logbook)"]
  B --> F["scripts/ (gate + validation)"]

npx @juanklagos/sdd-mcp@latest connect

注：無料のリモートサービスである GitMCP は、AI がこの公開リポジトリを読むのに役立ちます。ローカルの sdd-mcp は、実際のガイド付きワークフローを実行します。両者は互いを補完します：GitMCP ガイド。

ドキュメント

オンラインで見る： ドキュメントサイトでは、検索機能、EN/ES 言語切り替え、レベルバッジ付きで、すべてのガイドを参照できます。

3つだけ読むなら：

1. ワークフロー — SDD の流れをステップごとに解説
2. 構成 — 各フォルダーの用途
3. 2026 年の SDD：最新動向 — 業界の全体像と、このテンプレートの位置付け

そのほかのドキュメント： ドキュメントの全インデックスでは、全 53 件のガイド（EN/ES）をトピック別に整理しています。

コミュニティ

• ドキュメントサイト：juanklagos.github.io/spec-driven-development-template
• 質問、アイデア、成果の共有：GitHub Discussions
• バグや具体的な提案：Issues
• インタラクティブコース：aprende-sdd — 実践しながら学び、Actions による自動採点を受けられます
• チューターのレベルを修了しましたか？/sdd:tutor に記録すると、ログブックに修了が記載され、README に掲載できる修了バッジが発行されます

法務と著作権

• ライセンス：MIT — 商用利用や社内利用を含め、どこでも無料で、許可を得ずに使用できます。著作権表示は残してください。法務ガイド
• テンプレートを使って作成したものは、あなたのものです：TEMPLATE-OUTPUT.md
• リリースの公開 / リリースの公開：RELEASING.md
• 変更履歴：CHANGELOG.md · 最新リリース：v2.8.0
• 著作権 (c) 2026 Juan Carlos Alvarez Lagos（AUTHORS.md）