Spec-Driven Development

   _____ ____  ____
  / ___// __ \/ __ \
  \__ \/ / / / / / /
 ___/ / /_/ / /_/ /
/____/_____/_____/

          Spec-Driven Development

Agents and configs following a Spec-Driven Development process

This repository is designed for agent harnesses like:

• Claude Code
• Codex
• OpenCode
• Pi

Spec-Driven Development provides a structured workflow for developing applications using agent harnesses, emphasizing specification-first development with comprehensive testing to ensure stability while moving with higher velocity.

Note. The aspiration is to make this toolkit agent harness agnostic. However, it is currently heavily configured for Claude Code.

Workflow

The diagram is generated from workflow.py:

uv run python -I skills/sdd/create_diagram.py skills/sdd/workflow.py workflow.svg

Quick Start

Installation

Choose your agent harness and follow the installation guide:

• Claude Code - Setup for Claude Code users
• Codex - Setup for Codex users
• OpenCode - Setup for OpenCode users
• Pi - Setup for Pi users
• Other Agents - Setup for other agent harnesses

Install as Claude Code Plugin

/plugin marketplace add https://github.com/craigtkhill/spec-driven-development
/plugin install spec-driven-development@spec-driven-development