Spec Flow

Spec-Flow

[](https://opensource.org/licenses/MIT)

**Spec-driven development workflow for AI coding agents**

Spec-Flow transforms complex feature development into a guided, phase-by-phase workflow with living documentation. Works with any AI agent that supports the Skills format.

Features

• Phase-by-Phase Workflow: Proposal → Requirements → Design → Tasks → Implementation
• Interactive Confirmation: Each phase waits for your approval before proceeding
• Living Documentation: Creates .spec-flow/ directory with Markdown docs that guide implementation
• EARS Requirements: Industry-standard Easy Approach to Requirements Syntax
• 3 Execution Modes: Step (default), Batch, Phase — choose your speed
• Team Collaboration: Git-friendly, commit specs with your project

Installation

# Claude Code
cd ~/.claude/skills && git clone https://github.com/echoVic/spec-flow.git

# OpenClaw
cd ~/.openclaw/workspace/skills && git clone https://github.com/echoVic/spec-flow.git

# Blade
cd ~/.blade/skills && git clone https://github.com/echoVic/spec-flow.git

# Or any agent's skills directory

Quick Start

Trigger with: `spec-flow`, `spec mode`, `need a plan`, `structured development`, `写个方案`, `做个规划`

User: spec-flow — add user authentication

AI: [Creates proposal.md] → waits for confirmation
User: continue
AI: [Creates requirements.md] → waits for confirmation
User: continue
AI: [Creates design.md] → waits for confirmation
User: continue
AI: [Creates tasks.md] → waits for confirmation
User: execute all tasks
AI: [Implements everything]

Parameters: `--fast` (skip confirmations), `--skip-design` (simple features)

Five-Phase Workflow

┌──────────┐    ┌──────────────┐    ┌────────┐    ┌───────┐    ┌────────────────┐
│ Proposal │ → │ Requirements │ → │ Design │ → │ Tasks │ → │ Implementation │
└──────────┘    └──────────────┘    └────────┘    └───────┘    └