sdd-run

Execute software specifications with test-first implementation and automated verification against acceptance criteria.

2|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/chichex/skills --skill sdd-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-run
Source: https://github.com/chichex/skills/tree/main/claude/sdd-run
Command: npx skills add https://github.com/chichex/skills --skill sdd-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the ambiguity of software development by enforcing a strict Spec-Driven Development (SDD) workflow where the definition of done is based on verifiable criteria rather than subjective feeling.

Core Features & Use Cases

  • Verifiable Execution: Implements specifications by ensuring every acceptance criterion is verified through its declared mechanism, such as unit tests, integration tests, or automated probes.
  • Adversarial Verification: Includes an optional Ultracode mode that employs multi-agent orchestration to attempt to refute verified criteria, ensuring the highest level of code integrity.
  • Use Case: When you have a feature specification in your .sdd/specs/ directory, use this skill to automatically branch, implement the code using a test-first approach, verify all criteria, and generate a pull request with the evidence attached.

Quick Start

Use the sdd-run skill to implement the specification located at .sdd/specs/feature-name.md.

Frequently Asked Questions about sdd-run

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate test-first implementation from a feature specification?

Automated test-first implementation executes your specification by branching, writing code against acceptance criteria, and verifying results through declared mechanisms like unit or integration tests. It coordinates the entire workflow automatically to ensure verifiable definition of done.

What is spec-driven development and how does it enforce verifiable acceptance criteria?

Spec-driven development enforces a strict workflow where the definition of done relies on verifiable criteria rather than subjective feeling. It ensures every acceptance criterion is verified through declared automated mechanisms such as unit tests, integration tests, or automated probes.

How do I generate a pull request with automated regression testing evidence attached?

Generating a pull request with regression testing evidence is accomplished by automatically implementing the specification, verifying all acceptance criteria via automated probes, and attaching the validation evidence directly to the PR for policy compliance.

Can I use adversarial code validation to refute verified acceptance criteria?

Adversarial code validation is available through an optional Ultracode mode that employs multi-agent orchestration to actively attempt to refute verified criteria. This ensures the highest level of code integrity beyond standard automated verification.

Does spec-driven development work with existing contracts in my .sdd/specs/ directory?

Spec-driven development works directly with feature specifications located in your .sdd/specs/ directory. It requires strict adherence to defined contracts and applies automated regression testing to verify your code against those declared policies.

When should I not use deterministic TDD for software development?

Deterministic TDD should be avoided when your development workflow lacks strict specifications or defined acceptance criteria. Without verifiable contracts or automated probes to validate against, the enforced spec-driven workflow cannot establish a reliable definition of done.