Skip to content

Conversation

@echoVic
Copy link

@echoVic echoVic commented Jan 4, 2026

Summary

Add spec-flow skill to .experimental folder - a structured development workflow that guides through four phases: Proposal → Requirements → Design → Tasks.

What does this skill do?

Spec-Flow helps developers plan and execute complex features in a structured way:

  1. Proposal Phase: Define WHY (background, goals, scope, risks)
  2. Requirements Phase: Define WHAT (functional/non-functional requirements using EARS format)
  3. Design Phase: Define HOW (architecture, API design, data models)
  4. Tasks Phase: Break down into executable steps with dependencies

Key Features

  • Phase-by-phase confirmation: Each phase requires user approval before proceeding
  • EARS format: Industry-standard requirements format (Event-driven, State-driven, Unwanted behavior)
  • Flexible execution modes: Step-by-step, batch, or phase-based task execution
  • Living documentation: Creates .spec-flow/ directory with all specs (Git-friendly)

Trigger Phrases

  • "spec-flow"
  • "spec mode"
  • "need a plan"
  • "structured development"

Files Included

  • SKILL.md - Main skill instructions (follows OpenAI skills format)
  • LICENSE.txt - Apache 2.0

Comparison with create-plan

Feature create-plan spec-flow
Scope Simple planning Complex multi-phase development
Phases Single plan 4 structured phases
Documentation In-memory Persistent .spec-flow/ directory
Requirements Informal EARS format (testable)
Task tracking Checklist Dependencies + progress

License

Apache 2.0

@echoVic echoVic requested a review from a team January 4, 2026 12:51
@github-actions
Copy link

github-actions bot commented Jan 4, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@echoVic echoVic force-pushed the add-spec-flow-skill branch 2 times, most recently from 92b9496 to 9e054d1 Compare January 4, 2026 13:05
@echoVic
Copy link
Author

echoVic commented Jan 4, 2026

recheck

@echoVic echoVic force-pushed the add-spec-flow-skill branch from 9e054d1 to 064afbc Compare January 4, 2026 13:06
@echoVic
Copy link
Author

echoVic commented Jan 4, 2026

recheck

Add spec-flow to .experimental folder - a structured development workflow
that guides through four phases: Proposal → Requirements → Design → Tasks.

Features:
- Phase-by-phase confirmation workflow
- EARS format for requirements
- Multiple execution modes (Step/Batch/Phase)
- Living documentation in .spec-flow/ directory

Includes:
- SKILL.md: Main skill instructions
- LICENSE.txt: Apache 2.0
- references/: EARS format guide, workflow docs, task decomposition, examples
- scripts/: init-spec-flow.sh, execute-task.sh, validate-spec-flow.py
- templates/: proposal, requirements, design, tasks templates
- templates/steering/: constitution, product, tech, structure templates

Trigger phrases: 'spec-flow', 'spec mode', 'need a plan'
@echoVic echoVic force-pushed the add-spec-flow-skill branch from 064afbc to a4cb939 Compare January 4, 2026 13:07
@echoVic
Copy link
Author

echoVic commented Jan 4, 2026

I have read the CLA Document and I hereby sign the CLA

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant