ASDD documentation

ASDD, Agentic Spec-Driven Development, is a standard for running a software project with AI agents: governed, disclosed, secure, and quality-gated. These docs are organised by what you came for.

Start here

• New to ASDD? Read why it exists, then what it is, then how it works.
• Want to run it? Adopt the govern layer, then run the operate layer with Goose or your own runtime.
• Comparing it to other tools? Prior art: how ASDD differs.

The four modes

Mode	For	Where
Explanation	understanding why and what	concepts/
Tutorial	getting a governed loop running	guides/operate-goose.md
How-to guides	a specific setup task	guides/
Reference	precise lookup: the standard, the agents, the CLI	reference/

Guides

• Deploy ASDD with Goose (end to end): the full setup, gates + agents + knowledge + interfaces, with a "what you'll need" checklist. Start here for a full deployment.
• Adopt the govern layer: the CI gates that make a project conformant.
• Operate with Goose: the ready-to-run operate layer, with a free no-keys "prove it runs" step.
• Operate on your own runtime: implement the runtime contract on any platform.
• Share and run the recipes by name: deeplinks, GOOSE_RECIPE_PATH, and fetch-from-GitHub.
• The governance dashboard: a read-only view of PRs by governance stage, lanes, verdicts, and releases.
• Run operate agents in CI: the automation pattern and the security classification it must respect.
• The slash commands: the CLI's front door inside a coding assistant, and how to port them to any assistant.
• Adopt OpenSpec as your spec tool: turn on spec_tool: openspec and govern OpenSpec changes without converting.
• The gates, and how to tune them: every requirement ASDD enforces, the floor vs the knob, and the .asdd.yml key that controls it.
• Troubleshooting: common failures and fixes.

Reference and contributing

• Reference: STANDARD.md, the standards profiles, the agent roles, the CLI and gates.
• Contributing to ASDD: how ASDD is developed under ASDD (dogfood).