don-cheli-sdd-framework
Full SDD (Spec-Driven Development) framework that turns requirements into tested, documented, production-ready code through 7 disciplined li
Open source Repository Open in the app JSON README (API)
About
Full SDD (Spec-Driven Development) framework that turns requirements into tested, documented, production-ready code through 7 disciplined lifecycle phases. Includes 72+ slash commands (/dc:*), 14 reusable skills, 15 reasoning models, 4 estimation models, OWASP security audits, and adversarial code review. TDD enforced as an iron law. Multilingual: Spanish, English, Portuguese.
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- doncheli
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 57
- Forks
- 11
- Last push
- 2026-08-10T17:11:12Z
- Repository state
- ativo
- Language
- TypeScript
- License
- Apache-2.0
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
doncheli/don-cheli-sdd/don-cheli-sdd-framework
README
> 🌐 Read in: [English](README.md) | [Español](README.es.md) | [Português](README.pt.md)
<p align="center">
<h1 align="center">Don Cheli — SDD Framework</h1>
<p align="center">
<strong>Stop guessing. Start engineering.</strong><br/>
<sub>The only framework where TDD is law, not a suggestion.</sub>
</p>
<p align="center">
<a href="#install"><img src="https://img.shields.io/badge/install-2_minutes-brightgreen" alt="Install"></a>
<img src="https://img.shields.io/npm/v/don-cheli-sdd" alt="npm">
<img src="https://img.shields.io/badge/commands-93+-purple" alt="Commands">
<img src="https://img.shields.io/badge/skills-51+-orange" alt="Skills">
<img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="License">
<a href="https://marketplace.visualstudio.com/items?itemName=doncheli.don-cheli-sdd"><img src="https://img.shields.io/visual-studio-marketplace/v/doncheli.don-cheli-sdd?label=VS%20Code&color=007ACC" alt="VS Code"></a>
<br/>
<a href="https://github.com/doncheli/don-cheli-sdd/actions/workflows/validar.yml"><img src="https://github.com/doncheli/don-cheli-sdd/actions/workflows/validar.yml/badge.svg" alt="CI"></a>
<a href="https://codecov.io/gh/doncheli/don-cheli-sdd"><img src="https://codecov.io/gh/doncheli/don-cheli-sdd/branch/main/graph/badge.svg" alt="Codecov"></a>
</p>
</p>
---
## One command. Verified code.
```bash
/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
```bash
npm install -g don-cheli-sdd
don-cheli install --global
```
<details>
<summary>Other install methods</summary>
```bash
# 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
```
</details>
---
## 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 `// TODO` stubs?
- Is coverage >= 85%?
- Do your custom rules in `.dc/gates/*.yml` pass?
**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
```mermaid
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
```bash
# 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
[Full feature comparison →](https://doncheli.tv/comousar.html)
---
## 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` |
[IDE setup details →](https://doncheli.tv/comousar.html)
---
## Community
- [GitHub](https://github.com/doncheli/don-cheli-sdd) · [npm](https://www.npmjs.com/package/don-cheli-sdd) · [VS Code](https://marketplace.visualstudio.com/items?itemName=doncheli.don-cheli-sdd)
- [Full Documentation](https://doncheli.tv/comousar.html) · [YouTube](https://youtube.com/@doncheli) · [Instagram](https://instagram.com/doncheli.tv)
---
## License
[Apache 2.0](LICENSE) — Copyright 2026 Jose Luis Oronoz Troconis ([@DonCheli](https://github.com/doncheli))
---
<p align="center">
<a href="https://doncheli.tv/comousar.html"><img src="https://img.shields.io/badge/📖_Full_Guide-doncheli.tv-6c5ce7?style=for-the-badge" alt="Guide"></a>
<a href="https://github.com/doncheli/don-cheli-sdd"><img src="https://img.shields.io/badge/⭐_Star_on-GitHub-181717?style=for-the-badge&logo=github" alt="GitHub"></a>
<br/><br/>
<sub>Made with ❤️ in Latin America — Don Cheli SDD Framework</sub>
</p>