Skip to content
SpecFlow SpecFlow
🚧 This documentation is a draft and is currently under review. 🚧

Getting Started

SpecFlow is a lightweight, spec-driven workflow for building software with AI. It provides a structured catalog of skills (100-402 series) and optional worker agents that guide you through project setup, feature design, implementation, correction, and cleanup without replacing your coding standards or framework rules.

1. Install the skills

Section titled “1. Install the skills”

Install interactively and choose only the skills you want:

Terminal window
npx skills add ajelinek/SpecFlow

Install the full catalog:

Terminal window
npx skills add ajelinek/SpecFlow --skill '*'

Use npx skills add ajelinek/SpecFlow --list if you want to preview the available skills first.

2. Install the optional worker agents

Section titled “2. Install the optional worker agents”

If you want the supporting coder, execution-agent, and designer workers, use Custom Agents next.

3. Run the lean default

Section titled “3. Run the lean default”

If the repo already has enough context, the lean path is the fastest clean start. You can use the skill numbers as a shorthand in your prompts (e.g., saying “Run 301” instead of the full name):

Run this
Run 201 for invoice approval.
Use 202 for invoice approval with balanced coverage.
Run 301 for the invoice approval feature.
Run 401 on the changed source files.

Run 401-cleanup again later for changed test files if you want a separate test cleanup pass too.

4. Pick the right path when the lean flow is not enough

Section titled “4. Pick the right path when the lean flow is not enough”
  • Read Project Foundation for the larger lifecycle, groupings, and why the 100 series helps on both new and existing projects.
  • Use the homepage flow visualization when you want to compare the full, conservative, lean, and implementation-first paths side by side.

Next

Section titled “Next”