Agents Lookup

Use cases / Software development

Spec-first feature work: requirements, design, then tasks

The agent writes requirements and a design doc for review, then breaks them into tasks it implements one by one.

DifficultyIntermediate
Setup time1-2 hours
CategorySoftware development

The use case

Prompting an agent straight into code works for small fixes but drifts on larger features. Kiro and GitHub's open-source Spec Kit push a spec-first flow: the agent drafts requirements, then a technical design, then a task list, and only then writes code task by task. Each document is a checkpoint a developer can edit. This makes it clearer what the agent is about to build and gives reviewers something to compare the code against. The developer still approves the requirements and design before coding starts, and reviews each task's diff.

Example workflow

  1. Describe the feature in a short prompt
  2. Review and edit the generated requirements
  3. Review and edit the technical design
  4. Approve the task list
  5. Agent implements tasks one by one for review

Tools

Risks and guardrails

Sources

Written by Agents Lookup. Credits and official pages for the tools this use case names: