When to use it
When engineers need technical detail beyond the story's acceptance criteria.
Start here
Click "New Dev Spec" and choose the story it is for. Stories with no epic are listed too.
How to use it
- Click "New Dev Spec", search for a story by title or ticket code, and click it. Every story without a dev spec is listed, including stories directly under a feature (tagged "no epic") and stories with no parent (tagged "no parent"). The spec opens in a side panel.
- On step "1. Spec", click "✨ Generate" to have AI write the specification, or "Write manually" to fill in context, acceptance criteria and constraints, one criterion per line, then click "Save Spec".
- On step "2. Plan", click "✨ Generate" or "Write manually" to describe the implementation approach, then click "Save Plan". Generating the plan needs a spec first.
- On step "3. Tasks", click "✨ Generate" for AI-made tasks, or "Add task" to enter a title, a type and estimated hours. Generating tasks needs a plan first.
- Click the checkbox on a task to cycle it between to do, in progress and done. The progress bar in the panel and the "Tasks" column in the table both update at once.
- Click the 🤖 button on a task, then "✨ Get AI Guidance", for an implementation guide, code snippets and edge cases for that task.
- When the spec is Tasks Ready, click "Approve" in the side panel. Use the status boxes above the table to filter the list by Draft, Spec Ready, Plan Ready, Tasks Ready or Approved.
Good to know
- You can also open a story in the Backlog and use its Dev Spec tab, as the empty state suggests.
- While a spec is still a Draft, the Spec step offers "Check story readiness (INVEST)". It scores the story and lists suggested fixes.
- Once a spec has left Draft, the Tasks step offers "✅ Generate Tests", which shows a test strategy with a risk note and coverage targets.
- "Approve" stays disabled until the status is Tasks Ready. Adding a task by hand moves an earlier-stage spec straight to Tasks Ready.
- The table shows each spec's story, status, complexity, task progress and last-updated date. Click a row to open it.
Related
Last updated 6 October 2026