don-cheli-sdd
doncheli · doncheli/don-cheli-sdd
This framework enables AI agents to deliver verified, tested code automatically using a TypeScript orchestrator and Specification-Driven Development.
Don Cheli — SDD Framework. The most comprehensive Specification-Driven Development framework for AI agents. 88+ commands, 51 skills, 15 reasoning models. TDD mandatory, OWASP audit, Autonomous Mode, Crash Recovery, PRD Generator. Works with Claude Code, Gemini/Antigravity, Cursor, Codex, Warp, Amp, OpenCode, Continue.dev. ES/EN/PT.
Preview
What you can do with it
- Implement new features with guaranteed test coverage and automatic review.
- Develop code where TDD is mandatory and automatically enforced.
- Generate Product Requirement Documents (PRDs) and have agents automatically develop the solution.
Safety check
Usable, but read the notes first.
- ●npm package runs a script automatically on install.
package.json - ●Installer downloads a remote script and pipes it to the shell.
README.md
Automated scan of the repo files. Always review code you run.
From the README
Don Cheli — SDD Framework
<strong>Stop guessing. Start engineering.</strong>
The only framework where TDD is law, not a suggestion.
One command. Verified code.
/dc:auto "Implement JWT authentication with refresh tokens"
Don Cheli takes your idea and delivers tested, reviewed, verified code — automatically.
✅ /dc:specify 8 Gherkin scenarios generated
✅ /dc:clarify 2 ambiguities resolved
✅ /dc:tech-plan Blueprint: 3-layer architecture
✅ /dc:breakdown 7 TDD tasks created
✅ /dc:implement 14 tests pass, 91% coverage
✅ /dc:review 7/7 review dimensions passed
Result: ALL PASSED — Project updated with verified code
Your project is untouched until everything passes. If anything fails, nothing changes.
Install
npm install -g don-cheli-sdd
don-cheli install --global
Other install methods
# Git clone
git clone https://github.com/doncheli/don-cheli-sdd.git
cd don-cheli-sdd && bash scripts/instalar.sh
# One liner
curl -fsSL https://raw.githubusercontent.com/doncheli/don-cheli-sdd/main/scripts/instalar.sh | bash -s -- --global --lang en
# VS Code Extension
code --install-extension doncheli.don-cheli-sdd
The Runtime — Your code never breaks
Other frameworks give you prompts and hope the AI follows them. Don Cheli has a real TypeScript orchestrator that makes it impossible to skip rules.
How it works in 4 steps:
Step 1: The runtime creates a copy of your project (git worktree). Your real project is never touched.
Step 2: It spins up a Docker container and runs each /dc:* command inside — completely isolated.
Step 3: After each phase, real quality gates verify the output:
- Does the Gherkin spec exist? Does it have P1 scenarios?
- Do tests exist? Do they pass? Are there zero
// TODOstubs? - Is coverage >= 85%?
- Do your custom rules in
.dc/gates/*.ymlpass?
Step 4: Only when ALL 6 phases pass ALL gates does the code merge into your project. If anything fails → your project stays exactly as it was.
3 providers: Use your Claude Code subscription (free), OpenAI Codex, or Ollama for 100% free local execution.
How it works
flowchart LR
P["📋 PRD"] -.->|optional| B
A["💡 Idea"] --> B["/dc:specify"]
B --> C["/dc:clarify"]
C --> D["/dc:tech-plan"]
D --> E["/dc:breakdown"]
E --> F["/dc:implement"]
F --> G["/dc:review"]
G --> H["✅ Verified"]
style P fill:#2d3436,color:#dfe6e9,stroke:#6c5ce7,stroke-dasharray: 5 5
style F fill:#e17055,color:#fff
style H fill:#00b894,color:#fff
| Phase | Command | What happens |
|---|---|---|
| Specify | /dc:specify | Your idea → Gherkin specs with test scenarios |
| Clarify | /dc:clarify | QA finds ambiguities before you code |
| Plan | /dc:tech-plan | Architecture + API contracts + schema |
| Break Down | /dc:breakdown | TDD tasks with parallelism markers |
| Implement | /dc:implement | Test FIRST → code → refactor (Iron Law) |
| Review | /dc:review | 7-dimension peer review |
Each phase has a quality gate. You don't advance without passing. No shortcuts.
3 ways to use it
# Interactive — you drive each phase
/dc:start "JWT auth"
# Autonomous — runtime drives everything, Docker isolates
/dc:auto "JWT auth"
# Terminal — without AI agent open
don-cheli auto "JWT auth"
The Iron Laws
These are not suggestions. The runtime enforces them.
| Law | Rule | Enforcement |
|---|---|---|
| TDD | No code without tests | Blocks merge if tests don't exist |
| No Stubs | No // TODO in production | Scans and rejects |
| Evidence | Proof, not promises | Coverage >= 85% verified |
Why Don Cheli
93 commands · 51 skills · 15 reasoning models · 9 IDEs · 3 languages
The only SDD framework with all of these:
- ✅ TDD as unbreakable law (not optional)
- ✅ Autonomous mode with Docker isolation
- ✅ OWASP security audit in the pipeline
- ✅ 15 reasoning models (Pre-mortem, 5 Whys, Pareto, RLM...)
- ✅ PRD Generator (reads Figma designs)
- ✅ Pre-flight cost simulation
- ✅ Crash recovery (resume where you left off)
- ✅ Custom quality gates (YAML plugins)
- ✅ Drift detection (spec vs code watcher)
- ✅ SDD Certification badges
- ✅ Works with Claude, Cursor, Gemini, Codex, OpenCode, Qwen, Amp, Windsurf
- ✅ ES / EN / PT
Platforms
| Platform | Install | Details |
|---|---|---|
| Claude Code | --tools claude | 93 /dc:* commands (full native) |
| OpenCode | --tools opencode | 28 /doncheli-* slash commands + 28 skills |
| Antigravity | --tools antigravity | GEMINI.md + .agent/skills/ |
| Cursor | --tools cursor | .cursorrules |
| Codex / Qwen | --tools codex | AGENTS.md |
Community
License
Apache 2.0 — Copyright 2026 Jose Luis Oronoz Troconis (@DonCheli)
Made with ❤️ in Latin America — Don Cheli SDD Framework