Skip to content
The 7-day roadmapDay 5 · Spec-Driven Development№ 03 / 04

Spec-kit: The Open Toolkit

A hands-on look at GitHub's Spec Kit how it structures the Specify → Plan → Tasks workflow and integrates with PR review gates.

  • 1 min read
  • Theory and practice
  • Day 5 of 7

Theory

Spec-kit is an open-source toolkit from GitHub that operationalizes Spec-Driven Development inside a standard GitHub workflow.

What Spec-kit provides

  • A structured template set: spec files, plan files, and task checklists
  • PR workflow integration specs live alongside code and are reviewed like code
  • Review gates that keep product intent aligned with what's actually shipped
  • A lightweight, file-based approach that works in any repo without additional tooling

The Spec-kit workflow

  1. Specify Write a spec file describing intent, constraints, and acceptance criteria
  2. Plan Generate or author a plan file with the implementation approach
  3. Tasks Break the plan into atomic, checkable tasks
  4. PR Open a pull request; the spec is the contract reviewers check against

When Spec-kit shines

Spec-kit works well for teams that want a low-ceremony, Git-native SDD approach without adopting a full framework. It integrates naturally into existing GitHub workflows and is a good starting point before evaluating heavier frameworks like BMAD.

Practice

Run this in a repository you already know, not a toy project. The point is to feel where the practice helps and where it gets in the way on code that has history.

  1. Install Spec-kit in a test repository following the official getting-started guide.
  2. Pick a small, real feature (a new API endpoint, a UI component, or a CLI command).
  3. Use Spec-kit's templates to write a spec, generate a plan, and break it into tasks.
  4. Hand the tasks file to an AI agent and have it implement the first task.
  5. Open a draft PR and verify the spec is visible in the PR description.

The rest of day 5

  1. 01Why Spec-Driven Development?
  2. 02SDD as a Pillar of AI-Native Engineering
  3. 03Spec-kit: The Open ToolkitYou are here
  4. 04Spec-kit Under the Hood
Day 5 overviewAll 7 days
Where this comes from

This path is the shortest route to the ideas. AI-Native Software Engineering (O'Reilly Media) is where each one is worked out in full, with the patterns, the trade-offs and the failure modes. The pillars cover the foundations one long essay at a time.