Automate Spec-Driven Development with a collection of agents and skills for seamless integration.

Agents Orchestrator

A distribution pack of multi-agent definitions and Claude Code skills for fully automatic Spec-Driven Development using OpenSpec.

Highlights

6 coordinated agents that run a full SDD cycle automatically — from spec to merge commit
16 standalone skills for everyday dev tasks (testing, documentation, refactoring, agile, media transcription)
OpenCode platform: agent definitions for OpenCode
Zero runtime dependencies — copy Markdown files into your project and go
Parallel-safe: multiple SDD cycles can run concurrently on separate worktrees
Built on OpenSpec for structured, scenario-based specifications (GIVEN/WHEN/THEN)

What's Included
Quick Start
Project Structure
How SDD Works
Skills Reference
Prerequisites
Installation
Customization
Contributing
License

What's Included

SDD Agent Pack

Six agents that work together to run a complete Spec-Driven Development cycle:

Agent	Phase	Role
`sdd-orchestrator`	All	Master coordinator — delegates, manages git, never writes code
`sdd-scanner`	1	Read-only codebase and spec analysis
`sdd-spec-writer`	2	Creates proposal, delta specs, design, and task breakdown
`sdd-coder`	4	Implements code following specs and design
`sdd-test-writer`	4	Generates tests from spec scenarios
`sdd-verifier`	5	Validates code matches specs, runs tests

All agents use Opus 4.6 for maximum reasoning quality.

See the full agent documentation: agents/sdd-agent-pack/README.md

Skills

Sixteen Claude Code skills for common development workflows:

Skill	Category	Description
`adr`	Documentation	Generate Architecture Decision Records in Markdown
`prd`	Documentation	Interactive PRD generator with phase-by-phase validation
`prd-light`	Documentation	Fast 5-phase PRD for MVPs, internal tools, and small features
`rfc`	Documentation	Interactive RFC document generator
`sdd-issue`	Agile Workflow	Agent-ready GitHub issues structured for SDD orchestration
`spike`	Documentation	Jira Spike ticket generator for investigations
`summarize`	Documentation	Pedagogical book chapter synthesis with Cornell method
`unit-tests`	Testing	Unit test generator following project conventions
`unit-tests-java`	Testing	JUnit 5 + Mockito + AssertJ test generator for Java
`test-legacy`	Testing	Legacy code testing techniques (Feathers methodology)
`test-legacy-java`	Testing	Java-specific legacy testing with JUnit 4/5, Mockito, and seam analysis
`tcr`	Testing	Test && Commit \|\| Revert for ultra-short safe commits
`refactor`	Code Quality	Cross-language refactoring catalog with 62+ techniques (Fowler + Refactoring Guru)
`refactor-java`	Code Quality	Java-specific 62+ refactoring techniques with Java 8 and Java 11+ examples
`write-ac`	Agile Workflow	Acceptance criteria in Gherkin format (Given/When/Then)
`whisper-extract`	Media	Transcribe audio/video with Whisper and generate a `.md` with summary + full transcript

Quick Start

# 1. Install OpenSpec globally
npm install -g @fission-ai/openspec@latest

# 2. Initialize OpenSpec in your target project
cd your-project
openspec init

# 3. Copy agents (OpenCode)
mkdir -p .opencode/agents
cp path/to/agents-orchestrator/agents/sdd-agent-pack/opencode/*.md .opencode/agents/

# 4. Copy skills (optional, Claude Code only)
mkdir -p .claude/skills
cp -r path/to/agents-orchestrator/skills/* .claude/skills/

# 5. Run your first SDD cycle
# In OpenCode:
@sdd-orchestrator Add user authentication with OAuth

Project Structure

agents-orchestrator/
├── agents/
│   └── sdd-agent-pack/
│       ├── README.md                ← Detailed agent documentation
│       └── opencode/                ← OpenCode agents
│           ├── sdd-orchestrator.md
│           ├── sdd-scanner.md
│           ├── sdd-spec-writer.md
│           ├── sdd-coder.md
│           ├── sdd-test-writer.md
│           └── sdd-verifier.md
├── skills/                          ← Claude Code skills
│   ├── adr/                         ← Architecture Decision Records
│   ├── prd/                         ← Product Requirements Documents
│   ├── refactor/                     ← Cross-language refactoring catalog
│   ├── refactor-java/               ← Java-specific refactoring techniques
│   ├── rfc/                         ← RFC document generator
│   ├── sdd-issue/                   ← Agent-ready GitHub issues for SDD
│   ├── spike/                       ← Spike ticket generator
│   ├── summarize/                   ← Book chapter synthesis
│   ├── tcr/                         ← Test && Commit || Revert
│   ├── test-legacy/                 ← Legacy code testing
│   ├── test-legacy-java/            ← Java-specific legacy testing
│   ├── unit-tests/                  ← Unit test generator
│   ├── unit-tests-java/             ← JUnit 5 + Mockito + AssertJ
│   ├── write-ac/                    ← Acceptance criteria (Gherkin)
│   └── whisper-extract/             ← Audio/video transcription with Whisper
├── CLAUDE.md                        ← Development guidance for this repo
├── LICENSE                          ← MIT
└── README.md                        ← You are here

How SDD Works

Spec-Driven Development ensures every code change starts with a specification. The orchestrator manages an 8-phase cycle, delegating each phase to the appropriate subagent:

Setup → Explore → Propose → Review → Implement → Verify → Archive → Merge

Fully automatic — the orchestrator advances through all phases without manual approval; stops only on unresolvable errors
Progress tracking — each cycle writes status to .sdd-status/<change-name>.md for live monitoring
Parallel-safe — multiple cycles run on isolated worktrees; the orchestrator detects spec domain overlap and warns
Clean output — every cycle produces a merge commit preserving full commit history with verified spec artifacts

Note: The OpenCode orchestrator is currently missing Phases 1 (Explore), 3 (Review), and 5 (Verify).

Full phase diagram, conflict handling, monitoring commands, and parallel execution examples: agents/sdd-agent-pack/README.md

Skills Reference

All skills are invoked via slash commands in Claude Code (e.g., /adr, /spike).

Documentation

Command	What it does
`/adr`	Generates Architecture Decision Records with status tracking and RACI matrix
`/prd`	Interactive PRD creation with phase-by-phase validation and complete document output
`/rfc`	Interactive RFC creation with problem statement, proposed solution, and alternatives
`/spike`	Creates structured Jira Spike tickets for technical investigations
`/summarize`	Synthesizes book chapters using Cornell method, key concepts, and reflection questions

Testing

Command	What it does
`/unit-tests`	Generates unit tests following your project's naming and assertion conventions
`/unit-tests-java`	JUnit 5 + Mockito + AssertJ test generator for Java projects (Java 8–21+)
`/test-legacy`	Applies techniques from "Working Effectively with Legacy Code" (Feathers) to add test coverage
`/test-legacy-java`	Java-specific legacy testing with seam analysis, JUnit 4/5, Mockito, and dependency-breaking
`/tcr`	Runs the Test && Commit \|\| Revert loop for safe micro-refactoring commits

Code Quality

Command	What it does
`/refactor`	Cross-language catalog of 62+ refactoring techniques with multi-language examples (Python, TypeScript, Go, Rust)
`/refactor-java`	Java-specific 62+ refactoring techniques with Java 8 and Java 11+ examples

Agile Workflow

Command	What it does
`/sdd-issue`	Creates agent-ready GitHub issues with all context needed for SDD orchestration
`/write-ac`	Generates acceptance criteria in Gherkin format (Given/When/Then) for Jira tickets

Media

Command	What it does
`/whisper-extract`	Transcribes audio or video files using OpenAI Whisper and generates a `.md` with an AI summary followed by the full literal transcript

Prerequisites

Requirement	Minimum Version	Purpose
Node.js	20.19.0+	Required by OpenSpec CLI
Git	2.20+	Worktree support for isolated SDD cycles
OpenSpec	latest	Spec framework used by all agents
Claude Code or OpenCode	latest	Agent execution platform

Installation

Install with skills CLI

The fastest way to install skills using skills.sh:

# Install all skills at once
npx skills add andresnator/agents-orchestrator

# Or install a single skill
npx skills add andresnator/agents-orchestrator/skills/tcr
npx skills add andresnator/agents-orchestrator/skills/unit-tests-java

Installing Agents

OpenCode

mkdir -p .opencode/agents
cp path/to/agents-orchestrator/agents/sdd-agent-pack/opencode/*.md .opencode/agents/

echo ".opencode/worktrees/" >> .gitignore
echo ".sdd-status/" >> .gitignore

openspec init

Installing Skills

Skills are Claude Code only and can be installed independently of agents.

# Install all skills
mkdir -p .claude/skills
cp -r path/to/agents-orchestrator/skills/* .claude/skills/

# Or cherry-pick individual skills
cp -r path/to/agents-orchestrator/skills/unit-tests .claude/skills/
cp -r path/to/agents-orchestrator/skills/refactor-java .claude/skills/

Verify: run /skills in Claude Code to see installed skills.

Customization

Change the model: edit the model: field in each agent's YAML frontmatter
Cherry-pick skills: copy only the skill directories you need
Add new agents: create .md files in .claude/agents/ and reference them from the orchestrator via Task
Agent definitions: edit agent files directly in agents/sdd-agent-pack/opencode/

Contributing

Contributions are welcome. When submitting changes:

Agent logic: edit agent files in agents/sdd-agent-pack/opencode/
New skills: follow the SKILL.md convention (see any existing skill as a template)
Keep it Markdown: this repo has no build system, no tests, no runtime code — keep it that way

Open an issue or pull request on GitHub.

Agents Orchestrator

Agents Orchestrator

Highlights

Table of Contents

What's Included

SDD Agent Pack

Skills

Quick Start

Project Structure

How SDD Works

Skills Reference

Documentation

Testing

Code Quality

Agile Workflow

Media

Prerequisites

Installation

Install with skills CLI

Installing Agents

OpenCode

Installing Skills

Customization

Contributing

License