SDD Agent Pack

Lightweight installer for SDD (Software Driven Development) workflow assets into application repositories. Installs skills, orchestration scripts, hooks, and templates that AI coding agents use to follow the SDD workflow.

Quick Start

Install into your repo:

npx sdd-agent-pack init

Edit the generated .env file with your API key, then run epics:

bash .sdd-agent-pack/scripts/orchestrate.sh

What gets installed

.sdd-agent-pack/          — Core assets
├── skills/               — SDD workflow skills
├── scripts/              — Epic orchestration scripts
├── prompts/              — Workflow prompts
├── hooks/                — Quality enforcement hooks
├── docs/                 — Workflow documentation
├── templates/            — SDD document templates
└── config/               — Agent configuration

.agents/skills/            — OpenHands skill bridge (auto-installed)
.openhands/                — OpenHands hook bridge (auto-installed)

Commands

| Command | Description | |---------|-------------| | init | Install SDD Agent Pack in the current repository | | update | Update installed assets to the latest version | | uninstall | Remove all SDD Agent Pack assets safely | | doctor | Validate installation and environment | | status | Show installation status | | help | Show all commands |

How to Use

LLM-based agents cannot autonomously iterate through a multi-epic tasks.md — they treat it as a single massive objective and get stuck. The orchestration script solves this by feeding epics one at a time.

First, configure your LLM by editing .env (auto-created by init):

LLM_API_KEY=sk-or-paste-your-api-key-here
LLM_MODEL=openrouter/free
LLM_BASE_URL=https://openrouter.ai/api/v1

Then run the orchestration script from your terminal:

bash .sdd-agent-pack/scripts/orchestrate.sh

The script reads tasks.md, finds incomplete epics, and calls openhands --headless for each one sequentially.

If the OpenHands CLI isn't installed yet, install it:

pip install openhands

For OpenHands Cloud users

The Cloud UI doesn't give you direct terminal access. Feed epics one at a time manually in the chat:

"Implement epic EPIC-001 from tasks.md following the SDD workflow."

Let the agent finish, then repeat for the next epic.

Documentation

• Specification — Project architecture
• Workflow — SDD workflow documentation

License

MIT