Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Beschreibung vom Entwickler (englisches Original)
Spec-Driven Development workflow: specs, plans, gates, status and logbook tools. Bilingual EN/ES.
Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
SDD_PROJECT_ROOT, SDD_WORKSPACES_ROOTDu brauchst
Welche App nutzt du?
Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.
Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein
{
"mcpServers": {
"sdd": {
"command": "npx",
"args": [
"-y",
"@juanklagos/sdd-mcp"
],
"env": {
"SDD_PROJECT_ROOT": "your-value",
"SDD_WORKSPACES_ROOT": "your-value"
}
}
}
}Führe das in deinem Terminal aus
claude mcp add sdd --env SDD_PROJECT_ROOT=your-value --env SDD_WORKSPACES_ROOT=your-value -- npx -y @juanklagos/sdd-mcpTrag die leeren Werte ein, bevor du ihn startest.
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"mcpServers": {
"sdd": {
"command": "npx",
"args": [
"-y",
"@juanklagos/sdd-mcp"
],
"env": {
"SDD_PROJECT_ROOT": "your-value",
"SDD_WORKSPACES_ROOT": "your-value"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
In .vscode/mcp.json in deinem Projekt einfügen
{
"servers": {
"sdd": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@juanklagos/sdd-mcp"
],
"env": {
"SDD_PROJECT_ROOT": "your-value",
"SDD_WORKSPACES_ROOT": "your-value"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.
Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.
SDD_PROJECT_ROOT envSDD_WORKSPACES_ROOT envDiese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto juanklagos bestätigt, dem das Repo gehört
Dieses Repo haben wir noch nicht von GitHub gelesen
Dieses Repo haben wir noch nicht von GitHub gelesen
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (2.8.0) kam vor 2 Monaten in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, Claude Checkpoint MCP
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
MCP server that checkpoints Claude Code session context to survive crashes and token limits
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Learn Spec-Driven Development, then use it on real projects. One rule: no code until you approve a written spec. A script checks that rule every time you run it, and prints exactly what it looked at.
🇺🇸 English · 🇪🇸 Español
Non-technical start · Quickstart · AI agent start · Commands · Community
Spec-Driven Development (SDD) means writing and approving a clear specification *before* any code exists. What you decided ends up in a file, instead of buried in a chat you will close and never find again. By 2026 it is how most people build software with AI agents.
This repo does double duty.
It is a school: a bilingual (EN/ES) path that starts from zero, with guides, an interactive course and a tutor you can talk to. You do not need to know how to program to get through it.
It is also a toolkit for real work: scripts that check the rule, instruction files your AI assistant reads, a connector so your AI tool can run the workflow itself (MCP, the Model Context Protocol), and a single spec/ folder you add to a project that already has code — without moving any of it.
The step-by-step commands come from GitHub Spec Kit. This repo adds the guides, the checks and the templates on top of them.
The flow in action — create a spec, validate, pass the gate *(regenerated on every release)*:
What changes in practice: decisions stop living in chat history and move into specs/. The gate stays closed until spec.md and plan.md exist, agree, and you record your consent — a script checks that, not somebody's memory. A new teammate or a new agent lands in a folder layout they already recognize. And bitacora/ keeps the session log, so six months later you can still find out why something was done the way it was.
Want the industry map? Read SDD in 2026: state of the art and how this template compares.
Then pick your learning level. Every guide on the docs site carries its level badge:
[!TIP]
If you would rather learn by doing, take the [interactive course](https://github.com/juanklagos/aprende-sdd) (GitHub Skills format): 4 steps, ~35 min, auto-graded by Actions. Your exam is the real SDD gate.
Copy/paste this prompt into your AI assistant (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.
If you use Claude Code, this repo ships slash commands out of the box. Start with /sdd:help:
| Command | What it does |
|---|---|
/sdd:help | Tells you what stage you are in and the single next step |
/sdd:new | Guided start: idea → first spec ready for approval |
/sdd:spec | Create or refine a spec bundle with EARS criteria |
/sdd:gate | Runs the gate — approval, plan consistency, consent — and records yours |
/sdd:decision | One decision, written down in bitacora/decisiones/: what, why, what was rejected, when to revisit |
/sdd:close | Validates and closes the session with the output contract |
/sdd:tutor | A conversational SDD course by levels, graded by the real validation scripts |
Install in any project as a plugin (no cloning):
/plugin marketplace add juanklagos/spec-driven-development-template
/plugin install sdd@sdd-template
.github/prompts/../scripts/generate-llms-txt.sh).[!IMPORTANT]
No code before an approved `spec.md` and a consistent `plan.md`.
A script enforces this, and implementation starts only once your consent is on record.
./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- "User approved scope X"
(In sidecar projects the same scripts live under ./spec/scripts/.)
Enforce it in CI too. This repo doubles as a GitHub Action, listed on the GitHub Marketplace:
- uses: juanklagos/spec-driven-development-template@v2.8.0
with: path: "." # project root (sidecar or standalone auto-detected) strict: "true"
Reference files: 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"]
Every feature gets a numbered spec bundle, and every session leaves a trace in bitacora/ (the logbook):
spec.md — what and why *(approved by you)*plan.md — how *(consistent with the spec)*tasks.md — concrete stepshistory.md — how it evolvedFull walkthrough example: examples/002-mcp-end-to-end
Fastest start (no clone needed):
npx @juanklagos/create-sdd-project@latest my-app
It asks a few questions and scaffolds the recommended spec/ sidecar, or a full workspace, from the latest template.
Three ways to use the template, from lightest to heaviest:
| Mode | When | Command |
|---|---|---|
| Compact `spec/` sidecar ⭐ | Real or existing project: SDD artifacts in ./spec/, code stays in your project root | ./scripts/install-spec-sidecar.sh /path/to/project --profile=recommended |
| Internal workspace `www/` | The runnable project should live inside this template repo | ./scripts/create-www-project.sh my-project codex |
| Full standalone copy | You explicitly want the whole framework as your workspace | ./scripts/init-project.sh /path/to/project --profile=full |
[!TIP]
The professional default is the compact
spec/sidecar and nothing else. Never copy the full framework into a real codebase unless you actually want standalone mode.
Everyday commands (sidecar mode shown; the same scripts exist at root in standalone mode)
| Action | Command |
|---|---|
| New spec | ./spec/scripts/new-spec.sh "my-feature" "Owner" |
| Validate structure | ./spec/scripts/validate-sdd.sh . --strict |
| Policy check | ./spec/scripts/check-sdd-policy.sh . |
| SDD gate | ./spec/scripts/check-sdd-gate.sh . |
| Status dashboard | ./spec/scripts/generate-status.sh |
Folder anatomy and layout details: project organization map
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)"]
Connect via MCP (optional, advanced)
If your AI tool supports MCP (the Model Context Protocol), it can run this workflow itself: create specs, check the gate, write the logbook. One command sets it up, in your project's folder:
npx @juanklagos/sdd-mcp@latest connect
It finds the clients you have — Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, opencode — and writes the configuration into each one's own file. It merges into what you already have and never overwrites it. Add --dry-run first to see what it would touch. Then restart your client.
{"command": "npx", "args": ["-y", "@juanklagos/sdd-mcp@latest"]}. The @latest matters — without it, npx can serve an old cached version with fewer tools.npm install && npm run build && npm run mcp:start runs the server from source.npm run builder:build, then SDD_PROJECT_ROOT=/path/to/your/project npm run mcp:http:start and open http://127.0.0.1:3334/builder — compose your specs as connected cards, where every card is a real specs/NNN/ bundle on disk. Inside this template repository the builder is blocked by design (no target-project work in the template root), so always point SDD_PROJECT_ROOT at a real workspace. See the visual guide.npx @juanklagos/sdd-mcp@latest upgrade --project-root . --dry-run shows what would change before changing it: framework files get repaired, yours are never written without --apply. See the upgrade guide.Nur der Anfang wird gezeigt; den Rest findest du im Repo