README.md

April 9, 2026 Β· View on GitHub

🌐 Read in: English | EspaΓ±ol | PortuguΓͺs

Don Cheli β€” SDD Framework

Stop guessing. Start engineering.
The only framework where TDD is law, not a suggestion.

Install npm Commands Skills License VS Code
CI Codecov


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 // 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

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
PhaseCommandWhat happens
Specify/dc:specifyYour idea β†’ Gherkin specs with test scenarios
Clarify/dc:clarifyQA finds ambiguities before you code
Plan/dc:tech-planArchitecture + API contracts + schema
Break Down/dc:breakdownTDD tasks with parallelism markers
Implement/dc:implementTest FIRST β†’ code β†’ refactor (Iron Law)
Review/dc:review7-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.

LawRuleEnforcement
TDDNo code without testsBlocks merge if tests don't exist
No StubsNo // TODO in productionScans and rejects
EvidenceProof, not promisesCoverage >= 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 β†’


Platforms

PlatformInstallDetails
Claude Code--tools claude93 /dc:* commands (full native)
OpenCode--tools opencode28 /doncheli-* slash commands + 28 skills
Antigravity--tools antigravityGEMINI.md + .agent/skills/
Cursor--tools cursor.cursorrules
Codex / Qwen--tools codexAGENTS.md

IDE setup details β†’


Community


License

Apache 2.0 β€” Copyright 2026 Jose Luis Oronoz Troconis (@DonCheli)


Guide GitHub

Made with ❀️ in Latin America β€” Don Cheli SDD Framework