Skip to main content

devspecs docs

DevSpecs is a local-first CLI for bounded AI coding work. It turns repo intent into task slices, packed context, one-target prompts, checkpoints, and decision gates.

Start with the task when you know the goal:

ds task "fix Swagger OAuth redirect"

ds apply next
ds task checkpoint A01 --decision promote
ds apply next

Use the trust layer when the target is unclear:

ds map
ds recent
ds find "oauth redirect"

Core Jobs

JobCommand
Bound an agent taskds task "<goal>"
Emit the next one-slice promptds apply next
Inspect packed context evidenceds find "<topic>"
Understand system boundariesds map
Recover recent local directionds recent

Start Here

What DevSpecs Is Not

DevSpecs is not a hosted memory layer, task board, autonomous agent, or SaaS workspace. The CLI is the canonical product. Agent adapter files, slash command recipes, and future MCP servers should wrap the same CLI primitives.