Setup & configuration

Initialize the project

Run init at the root of your project:

cd your-projectdraun init

The first init on your machine runs a one-time global setup: pick your AI tools and language, saved to ~/.draun/config.yaml. Each project init then creates .draun/specs/ and a minimal .draun/config.yaml.

What init generates

For each configured tool, init writes two integration layers:

• AGENTS.md managed block. SDD instructions between draun:begin and draun:end markers. Your own content is never touched.
• Agent skills. draun-spec, draun-analyze, draun-break, draun-implement, and draun-archive, installed under each tool's skills folder.

Configuration files

Two layers; the project overrides the global.

~/.draun/config.yaml Global, written by the first init:

tools:            # AI tools to generate integrations for  - claudelanguage: en-US   # en-US | pt-BR

.draun/config.yaml Per project:

# specsRoot: .draun/specs   # where specs live (default)# language: pt-BR           # override the global language

CLI output is always English; language governs the content of specs and issues and the AI conversation.

Supported tools

• Claude Code
• Cursor
• Windsurf
• Codex CLI
• OpenCode

Tools without a native skills convention still get the universal AGENTS.md layer.