rubenzarroca/sdd-plugin

README preview

# SDD — Spec Driven Development for Claude Code

**The AI coding framework for people who think in business logic, not in code.**

Stop vibe coding. Start building with specs — and learn to write better ones along the way.

## Why SDD

When AI writes all the code, you ship faster but understand less — until you become a passenger in your own codebase.

**Without SDD** — You tell Claude "build me an OAuth2 login". Claude makes 200 decisions for you: session duration, token storage, error handling, refresh strategy, redirect flows. Each decision is reasonable in isolation, but they don't align with each other or with your architecture. You ship fast, understand little, and the next feature conflicts with the first.

**With SDD** — You specify what you actually need through a guided interview. Claude coaches you on gaps ("You haven't defined token refresh — with your expected 10k daily users, silent refresh with rotation would prevent session drops. Want me to add that?"). Every requirement is explicit before any code is written. You ship at the same speed, but you understand what you shipped and it holds together.

## The learning arc

SDD embeds a learning cycle into the development workflow. You don't study first and build later — you learn *by building*, with scaffolding that adapts to your level and fades as you improve.

**Coached specification** — During `/sdd:specify`, Claude monitors your input for vague requirements, missing edge cases, untestable criteria. Instead of silently fixing your input, it offers a concrete alternative using your actual data. If you say "the system must be fast," Claude will say: "With your current volume of 500 leads per week, a P95 response time of 500ms would keep the team flowing. Want me to set that as the threshold?" The coaching fades as your specs improve — no levels, no badges.

View full repository on GitHub →