sdd

---

What is this?

Spec-Driven Development (SDD) means writing and approving a clear specification before any code exists, so that scope and decisions outlive the chat window they were born in. 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: enforcement scripts, rules your agent reads, an MCP server, and a compact spec/ sidecar you drop into a codebase that already exists.

The workflow engine underneath is GitHub Spec Kit. This repo is the practical layer around it.

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.

Choose your door

• Non-technical (founder, PM, curious): START_HERE_NON_TECH.md — a guided start with no jargon in it.
• Developer: QUICKSTART.md — the commands to scaffold and validate, about five minutes.
• AI agent, or you pasting into one: AI_START_HERE.md — operating rules plus copy/paste prompts for each level.

Then pick your learning level. Every guide on the docs site carries its level badge:

• 🟢 Beginner: quick guide for non-programmers
• 🟡 Intermediate: team discipline guide
• 🔴 Advanced: governance and standardization

[!TIP] If you would rather learn by doing, take the interactive course (GitHub Skills format): 4 steps, ~35 min, auto-graded by Actions. Your exam is the real SDD gate.

Start in 30 seconds

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.

Built-in commands for your AI agent