SDD Template

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.

Start with the guides GitHub

This is what it does

Run the check in any project. It reads your files and tells you, in one screen, whether you are allowed to write code yet — and a real warning, because a perfect run would look like a mockup:

./scripts/check-sdd-gate.shverbatim output

Checking SDD gate in: /Users/jk/my-project
[OK] SDD policy check
[OK] 001-auth has approval status section
[OK] 001-auth approved with minimum plan consistency signals
[OK] 001-auth approved with checklist tasks
[OK] User consent log present for execution stage: .sdd/user-consent.log
[OK] 001-auth has recorded user consent
[WARN] 002-billing not approved yet (implementation gate should remain closed)

Compuerta / Gate: ABIERTA / open — 1 spec(s) aprobada(s) y consentida(s) / approved and consented

The script prints its checks in English; only the closing lines are bilingual. Translating them here would misrepresent what you will see.

I don’t write code

You are a founder, a product manager, or just curious. You will describe what you want and let an AI assistant do the typing.

I write code

You will install it, connect your AI tool and run the checks yourself.

Find a guide by what you need

Learn by doing

Get something done

Look something up

Understand why

Every guide says which of these it is, right under its title. The sidebar is grouped the same way.

Or open the visual board

One command, from your project folder:

npx @juanklagos/sdd-mcp@latest --http

The builder opens in your browser, with the server your agent connects to. If you prefer its own window, SDD Desk is the same board as a desktop app.