Not in the top 1,000 by GitHub stars

echoVic/spec-flow

A Claude Code skill for structured, spec-driven development with phase-by-phase workflow and living documentation

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

3ae2516ec921 → 3ae2516ec921

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 3ae2516ec921

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 3ae2516ec9216fd42ef6b83176c128f0165981eb

34GitHub stars
0stars in 7 days
1skill in this repository
0commits in 30 days

Heat

0.3
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Oct 25, 202634

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

spec-flow

When your agent uses it

Spec-driven development workflow. Interactive phase-by-phase confirmation from proposal to implementation. Trigger: 'spec-flow', 'spec mode', 'need a plan', 'structured development', 'write a spec', 'feature spec', 'technical spec', '需求文档', '技术方案', '任务拆解', '规格驱动', '写个方案', '做个规划', '结构化开发', 'plan this feature', 'break this down', 'design doc'. Creates .spec-flow/ directory with proposal, requirements, design, and tasks.

What it loads into context

Frontmatter

136 tokens

Always available to the agent

SKILL.md

1,585 tokens

When the skill is activated

Reference documents

10,885 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Core Principles
  2. Parameters
  3. Language Rule
  4. Interaction Rules
  5. Five-Phase Workflow
  6. Directory Structure
  7. Steering Documents (Optional)
  8. Phase Transitions
  9. Compatibility

Scripts executed separately

  • scripts/execute-task.sh
  • scripts/init-spec-flow.sh
  • scripts/validate-spec-flow.py

Files

  • .gitignoreasset359 bytes
  • CONTRIBUTING.mddoc4,987 bytes
  • LICENSEasset1,064 bytes
  • README.mddoc4,694 bytes
  • SKILL.mdcore5,755 bytes
  • references/ears-format.mddoc6,610 bytes
  • references/examples/feature-example.mddoc8,782 bytes
  • references/execution-modes.mddoc2,088 bytes
  • references/interaction-rules.mddoc1,354 bytes
  • references/task-decomposition.mddoc7,440 bytes
  • references/workflow.mddoc7,360 bytes
  • scripts/execute-task.shruns9,514 bytes
  • scripts/init-spec-flow.shruns5,324 bytes
  • scripts/validate-spec-flow.pyruns10,844 bytes
  • templates/design.md.templateasset4,467 bytes
  • templates/proposal.md.templateasset1,911 bytes
  • templates/requirements.md.templateasset3,537 bytes
  • templates/steering/constitution.md.templateasset2,297 bytes
  • templates/steering/product.md.templateasset2,203 bytes
  • templates/steering/structure.md.templateasset4,227 bytes
  • templates/steering/tech.md.templateasset3,294 bytes
  • templates/tasks.md.templateasset5,012 bytes
Read SKILL.md

# Spec-Flow - Structured Development Workflow

Structured workflow for complex feature development. Creates living documentation that guides implementation and serves as team reference.

## Core Principles

1. **One phase at a time** — NEVER generate documents for subsequent phases in advance
2. **Mandatory confirmation** — After each phase, STOP and wait for user confirmation
3. **User-driven progression** — Only proceed when user says "continue"/"ok"/"next"/"继续"/"好"

## Parameters

| 参数 | 说明 |
|------|------|
View the complete source on GitHub

Skills included

  • spec-flow

Repository facts

License
MIT
Created
Jan 5, 2026
Last pushed
Feb 16, 2026
Forks
7
Open issues
0
Project activity
Slowing

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 5, 2026

Show all 14 signals by file

CONTRIBUTING.md

  • Network accessline 19
    # Fork the repository on GitHub, then: git clone https://github.com/YOUR_USERNAME/spec-flow.git
  • Network accessline 20
    git clone https://github.com/YOUR_USERNAME/spec-flow.git

README.md

  • Network accessline 3
    [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  • Network accessline 21
    # Claude Code cd ~/.claude/skills && git clone https://github.com/echoVic/spec-flow.git
  • Network accessline 22
    cd ~/.claude/skills && git clone https://github.com/echoVic/spec-flow.git
  • Network accessline 24
    # OpenClaw cd ~/.openclaw/workspace/skills && git clone https://github.com/echoVic/spec-flow.git
  • Network accessline 25
    cd ~/.openclaw/workspace/skills && git clone https://github.com/echoVic/spec-flow.git
  • Network accessline 27
    # Blade cd ~/.blade/skills && git clone https://github.com/echoVic/spec-flow.git
  • Network accessline 28
    cd ~/.blade/skills && git clone https://github.com/echoVic/spec-flow.git

scripts/execute-task.sh

  • Executable scriptline 1
    #!/bin/bash

scripts/init-spec-flow.sh

  • Executable scriptline 1
    #!/bin/bash

scripts/validate-spec-flow.py

  • Executable scriptline 1
    #!/usr/bin/env python3
  • Network accessline 269
    YELLOW = "\033[1;33m"     BLUE = "\033[0;34m"     NC = "\033[0m"
  • Network accessline 271
    NC = "\033[0m"

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Signal confidence: 14 facts

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeNativeFrontmatter field argument-hint in SKILL.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.