// Claude Skills
spec-flow
A Claude Code skill for structured, spec-driven development with phase-by-phase workflow and living documentation
// Claude Skills[ api ][ claude ]#claude#ai-skill#claude-code#claude-code-skills#claude-skill#development-workflow#documentation#project-planning#skills◷ MIT$open-sourceupdated 21 days ago
Dormant
49/100
last commit 6 months ago
last release none
releases 0
open issues 0
// star history
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
⚠ Unverified source (community-unclaimed, low activity) — reveal the prompt
⚠ Unverified source (community-unclaimed, low activity). Inspect the repo before letting your agent install it. Install and set up spec-flow (claude-skill project) into my current project. Found on https://claudeers.com/spec-flow-2 Repo: https://github.com/echoVic/spec-flow Homepage/docs: — Detected install method: claude-skill → # copy this skill into .claude/skills/spec-flow/ Category: skills. Platforms: api. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: dormant; community-verified: false. Confirm the source before running anything.
// or install directly (claude-skill)
# copy the skill dir into your project: # .claude/skills/spec-flow/ (or ~/.claude/skills/spec-flow/ for all projects)
// or clone · unverified · not recently updated
git clone https://github.com/echoVic/spec-flow
// compatibility
| Platforms | api |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Shell |
Spec-Flow
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 │
└──────────┘ └──────────────┘ └────────┘ └───────┘ └────────────────┘
WHY WHAT HOW EXECUTE BUILD
| Phase | Goal | Output |
|---|---|---|
| Proposal | Define WHY | Background, goals, non-goals, risks |
| Requirements | Define WHAT | FR/NFR in EARS format, acceptance criteria |
| Design | Define HOW | Architecture, API, data model (Mermaid) |
| Tasks | Break down | Granular tasks with dependencies |
| Implementation | Build | Code, tests, documentation |
Execution Modes
| Mode | Trigger | Behavior |
|---|---|---|
| Step (default) | "start implementation" | One task → confirm → next |
| Batch | "execute all" / "全部执行" | All tasks consecutively |
| Phase | "execute setup phase" | All tasks in one phase → confirm |
Directory Structure
.spec-flow/
├── steering/ # Optional: global project context
│ ├── constitution.md
│ ├── product.md
│ ├── tech.md
│ └── structure.md
├── active/ # Work in progress
│ └── <feature>/
│ ├── proposal.md
│ ├── requirements.md
│ ├── design.md
│ └── tasks.md
└── archive/ # Completed features
File Structure
spec-flow/
├── SKILL.md # Checklist workflow
├── references/
│ ├── ears-format.md # EARS requirement syntax
│ ├── task-decomposition.md # Task breakdown patterns
│ ├── workflow.md # Detailed workflow guide
│ ├── interaction-rules.md # Confirmation rules
│ ├── execution-modes.md # Step/Batch/Phase modes
│ └── examples/
├── templates/ # Document templates
│ ├── proposal.md.template
│ ├── requirements.md.template
│ ├── design.md.template
│ ├── tasks.md.template
│ └── steering/
└── scripts/
├── init-spec-flow.sh # Initialize spec directory
├── validate-spec-flow.py # Validate completeness
└── execute-task.sh # Execute a task
Language
- Workflow instructions: English
- Generated documents: Chinese (中文) by default
License
MIT
// faq
What is spec-flow?
A Claude Code skill for structured, spec-driven development with phase-by-phase workflow and living documentation. It is open-source on GitHub.
Is spec-flow free to use?
spec-flow is open-source under the MIT license, so it is free to use.
What category does spec-flow belong to?
spec-flow is listed under skills in the Claudeers registry of Claude-compatible tools.
2 views
★ 33 stars
unclaimed
updated 21 days ago
// embed badge
[](https://claudeers.com/spec-flow-2)
// retro hit counter
[](https://claudeers.com/spec-flow-2)
// reviews
// guestbook
0/500
// related in Claude Skills
🔓An agentic skills framework & software development methodology that works.
// skillsobra/⟨Shell⟩★ 272,506◷ MIT[ claude ]
🔓
🔓💫 Toolkit to help you get started with Spec-Driven Development
// skillsgithub/⟨Python⟩★ 129,208◷ MIT[ claude ]
🔓AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
// skillsGraphify-Labs/⟨Python⟩★ 106,387◷ MIT[ claude ]