Skip to content
BENIBIX Learn

Spec-Driven Development

AI🛠️ Working with AIAI-Assisted Coding

Also known as Spec-First AI Coding, Spec-Driven AI Coding

Write what to build first. The AI plans and codes from that written spec.

Think of it like

It is like drawing a plan of a house first. Then the builders follow it.

Example

GitHub's free Spec Kit runs it as steps. You give the agent the spec, then the plan, then the tasks. Last, it writes the code.

Why it matters

An agent guesses less when the goal is written down. The spec also tells you what to check at the end.

Definition

Spec-driven development is a way to code with AI that starts from a written plan. First you write a spec: what to build, for whom and how you will know it works. Then the AI turns the spec into a plan and a list of small tasks. The AI writes code one task at a time. The spec stays in the project, so later changes start from it. It is the opposite of vibe coding.

Example code

markdown
# Feature: Password reset

## Who
A user who forgot their password.

## Done when
- The user gets a reset link by email.
- The link stops working after one use.
A short spec: what the feature is, who it is for, and how you know it is done.
This way starts at the spec. So every later step has a clear target.

Common mistake

Writing a spec once and never updating it. When the plan changes, change the spec first.

Key takeaways

  1. 1
    Spec first. What, for whom, and when it is done.
  2. 2
    Then plan and tasks. Small steps the AI can finish.
  3. 3
    Spec stays. Changes start from the written plan.

Learn it properly