Welcome to the draun docs

Install the CLI, connect your AI agents, and run the spec-driven cycle from your terminal.

What is draun?

Draun is a Spec-Driven Development CLI. You describe a feature in plain words, and draun keeps the markdown specs and issues as the single source of truth. It parses and edits those files, it never replaces them.

.draun/specs/payment-retries/  SPEC.md  issues/    INDEX.md    01-idempotency-key.md

Draun principles

Markdown is the source of truth

Specs and issues live in .draun/specs/ as plain markdown. The CLI reads and edits them; your own content is never overwritten.

Deterministic and trackable

Every issue carries a state and its blockers in INDEX.md, and each command accepts --json for machine-readable output.

What you can do

Write the spec

Describe a feature and let your agent scaffold SPEC.md following the project template.

Analyze the spec

Run a read-only review for ambiguities, missing edge cases, and scope risks before you break it down.

Break into issues

Turn the spec into small, independently verifiable issues with a dependency graph.

Implement

Work through the ready issues manually, with sequential subagents, or a parallel multi-agent run.

Track progress

See a progress overview across specs, or per-issue detail for a single spec, at any time.

First steps

Overview

Install the CLI and confirm it's on your PATH.

Setup & configuration

Initialize your repository and connect your AI coding agents.

The workflow

The four stages: write, break, implement, archive.

Commands and Skills

A reference for every draun CLI command.

Learn more about draun

Repository

Read the source, open issues, and star the project on GitHub.

npm package

Install draun straight from the npm registry.

Report an issue

Found a bug or have an idea? Open an issue on GitHub.