bdd
The new Specification-Driven Development in the AI era
A native CLI — and a 60-minute workshop — for spec → Gherkin → RED → GREEN → REFACTOR. The requirements spec is the source of truth. The human owns intent. The agent iterates. The tools refuse a red-bar refactor.
RED
GREEN
REFACTOR
Install bdd
macOS and Linux
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/davidparry/tdd-bdd-agentic/releases/latest/download/bdd-cli-installer.sh | sh
Windows (PowerShell)
powershell -ExecutionPolicy Bypass -c "irm https://github.com/davidparry/tdd-bdd-agentic/releases/latest/download/bdd-cli-installer.ps1 | iex"
Uninstall
curl -LsSf https://github.com/davidparry/tdd-bdd-agentic/releases/latest/download/bdd-cli-uninstaller.sh | sh -s -- -y
Download a binary
Prebuilt archives from the latest GitHub Release. Each row has the archive and its checksum.
| Platform | Archive | Checksum |
|---|---|---|
| Apple Silicon macOS | bdd-cli-aarch64-apple-darwin.tar.xz |
sha256 |
| Intel macOS | bdd-cli-x86_64-apple-darwin.tar.xz |
sha256 |
| x64 Windows | bdd-cli-x86_64-pc-windows-msvc.zip |
sha256 |
| ARM64 Linux | bdd-cli-aarch64-unknown-linux-gnu.tar.xz |
sha256 |
| x64 Linux | bdd-cli-x86_64-unknown-linux-gnu.tar.xz |
sha256 |
Three altitudes, one discipline
Not “just TDD.” Spec-first at three altitudes, then tests generated from the spec — not the other way around.
| Methodology | Pins | Canonical artifact |
|---|---|---|
| SDD (spec-driven) | the feature | versioned spec + acceptance criteria |
| BDD (behavior-driven) | one behavior | Gherkin scenario (Given / When / Then) |
| TDD (test-driven) | one unit | failing unit test |
Learn the loop
Talk
The 60-minute reveal.js deck. Open it and present.
Workshop
Student follow-along: commands, prompts, expected output.
Write-up
Spec-first was always right. Agents just made it fast.
CLI
How bdd automates the same loop the class teaches.
MCP setup
Wire the workflow server into Cursor, Claude, and others.
Greenfield
The file-creation order if you started from zero.