SpecFlow Guide
Spec-driven multi-agent workflow for Cursor, with optional Linear issue sync.
Install once per project. Activate when a task deserves structure. One agent writes code; the others specify, design, and verify.
Other language: Español
Start here
| I want to… | Read |
|---|---|
| Understand why SpecFlow exists | Introduction |
| Install in my repo | Getting Started |
| Connect Cursor ↔ Linear (MCP) | Linear Integration |
| Run my first full task | Getting Started → Your first flow |
| Start from a Linear issue | Linear Integration → Start from issue |
| See phases, files, and phrases | How It Works |
| Know what each folder is for | Project Layout |
| Teach agents about my project | Project Documentation |
Guide map
| Chapter | What you'll learn |
|---|---|
| Introduction | Problem, solution, when to use it |
| Getting Started | init, verify, first flow walkthrough |
| How It Works | Direct vs Flow, four agents, what to inspect |
| CLI Reference | Commands and flags |
| Project Layout | Tree after install, git & team notes |
| Project Documentation | .agents-docs/ files and tips |
| IDE Adapters | Cursor adapter (default in init) |
| Linear Integration | Cursor plugin, MCP, state mapping |
| Design Principles | Rules the workflow enforces |
| Troubleshooting | Common issues |
Quick install
bash
npx @ceatoleii/specflow init
specflow doctor
specflow linear setup # optional — after Linear plugin in CursorThen in your AI chat: nueva tarea or nueva tarea desde TEAM-123.