How it works Commands Editions GitHub Star on GitHub
Open source · MIT License

Spec-driven development
for AI agents

Define what to build, then let the agent build it right.

vibeflow pipeline
$ analyze           → ✓ 14 patterns · 8 conventions · .vibeflow/ ready
$ gen-spec "auth"  → ✓ 5 DoD checks · budget ≤4 files · anti-scope locked
$ implement         → ✓ 3 files changed · tests pass · DoD self-verified
$ audit             → PASS — all checks verified, patterns followed
See how it works Install now
Core pipeline

Four core commands.
Idea to audited code.

The main pipeline — plus 5 more commands for every workflow.

1

analyze

Scans your codebase. Learns patterns, conventions, architecture. Builds a local knowledge base.

2

gen-spec

Generates a spec with binary Definition of Done, scope, anti-scope, and file budget.

3

implement

Builds from the spec. Follows your patterns, respects budget, runs tests, self-verifies.

4

audit

Checks every DoD item with evidence. Pattern compliance. Verdict: PASS, PARTIAL, or FAIL.

Plus 5 more: discover · prompt-pack · quick · teach · stats — See all commands →
Live Demo

From vague idea to verified code.

Watch Vibeflow turn a feature request into audited, pattern-compliant implementation.

"I need user authentication for my app"
discover phase — challenging scope:
  • What kind? OAuth, magic link, or email/password?
  • Do you need password reset in v1? That's 3 extra files and email integration.
  • Social login? That adds OAuth complexity you might not need yet.
"Just email/password. No reset, no social. Keep it simple."
pushes back:
  • You said "simple". Do you need email verification or just trust the input?
  • Rate limiting on login attempts? Without it, brute force is trivial.
"No email verification for v1. Yes to rate limiting, 5 attempts per minute."
PRD generated
Scope: Scope: email/password signup + login + rate limiting
Anti-scope: Anti-scope: OAuth, password reset, social login, email verification
Spec generated
☐ ☐ POST /auth/signup returns 201 + JWT
☐ ☐ POST /auth/login returns 200 + JWT
☐ ☐ Passwords hashed with bcrypt, min 8 chars
☐ ☐ Login rate-limited to 5 attempts/min per IP
Budget: Budget: ≤4 files
implement
src/api/auth/auth.controller.ts
src/api/auth/auth.service.ts
src/api/auth/auth.middleware.ts
✓ ✓ 3 files · tests pass · DoD self-verified
audit → PASS
✓ ✓ POST /auth/signup returns 201 + JWT
✓ ✓ POST /auth/login returns 200 + JWT
✓ ✓ Passwords hashed with bcrypt, min 8 chars
✓ ✓ Login rate-limited to 5 attempts/min per IP
✓ ✓ Pattern compliance: controller/service structure followed
PASS — All 4 DoD checks verified with evidence. Ship it.
Use Cases

Built for real workflows.

From solo devs to product teams.

Developer

New feature in an existing project

You need to add a payment flow. Instead of letting AI guess, you define scope (Stripe only, no PayPal), anti-scope (no subscription management), and a 5-check DoD. The agent implements exactly that.

analyze → gen-spec → implement → audit
Developer

Quick bug fix with controlled scope

A date formatting bug in the dashboard. You use quick mode, it generates a focused spec in seconds. The agent fixes the bug, nothing else. Audit confirms the fix.

quick → implement → audit
Product Manager

Defining requirements before handing off

You have a feature idea but need to clarify scope before the dev team starts. Discover walks you through the hard questions and produces a clear PRD. No code involved.

discover → hand off PRD to team
Tech Lead

Onboarding a new developer

New dev joins the team. Instead of reading 200 files, they run analyze. Vibeflow produces a comprehensive guide to the project: architecture, patterns, conventions, all with real code examples.

analyze → dev reads .vibeflow/
Commands

9 commands. Full toolkit.

Core pipeline plus power tools for every workflow.

Core
analyze
Understand your codebase

Deep-scans your codebase and produces documentation: stack, architecture, patterns, conventions, all with real code examples.

--fresh--scope--satellite--interactive
Details →
Core
gen-spec
Define what to build

Generates a technical specification with binary Definition of Done (3-7 pass/fail checks), scope, anti-scope, and risks.

auto-splitfrom PRD or idea
Details →
Core
implement
Build with guardrails

Implements a feature from its spec with guardrails. Follows your patterns, respects budget and anti-scope, runs tests, self-verifies DoD.

7-phase pipelinepattern resolutionself-verify DoD
Details →
Core
audit
Verify the result

Verifies implementation against the spec. Checks DoD, patterns, and tests. Produces a PASS, PARTIAL, or FAIL report.

PASS / PARTIAL / FAILincremental fix
Details →
Tool
discover
Clarify the idea

Interactive dialogue that turns a vague idea into a clear PRD. Challenges assumptions, cuts scope, forces decisions.

2–5 roundsscope cutting
Details →
Tool
prompt-pack
Delegate to another agent

Creates a self-contained prompt for a coding agent in a separate session. Embeds your real patterns and conventions.

agent-agnosticembedded patterns
Details →
Tool
quick
Small tasks, fast

Fast-track for small tasks (under 4 files). Skips discovery, generates spec directly. For bug fixes and quick changes.

≤4 files budgetephemeral spec
Details →
Tool
teach
Update knowledge base

Updates .vibeflow/ with corrections, new conventions, architectural decisions, or patterns. Also imports from external repos.

--from <url>conflict detection
Details →
Tool
stats
Track quality trends

Compiles statistics from audit reports. Pass/fail rates, most violated patterns, common DoD gaps, quality trends over time.

chat output only≥3 audits for trends
Details →
See full reference — flags, modes & outputs →
Editions

Choose your agent.

Same methodology, adapted to your workflow.

Claude Code

Plugin with slash commands for Claude Code and Claude Desktop.

  1. Open Customize in the sidebar
  2. Click + → Add marketplace
  3. pe-menezes/vibeflow-claude
  4. Click Sync
  5. Browse plugins → Install Vibeflow
/plugin marketplace add pe-menezes/vibeflow-claude
/plugin install vibeflow@vibeflow-marketplace

Cursor

Rules and skills for Cursor Agent. Slash commands via /skill-name.

npx setup-vibeflow@latest --cursor

GitHub Copilot

Prompts, agents, skills, and instructions for Copilot Chat.

npx setup-vibeflow@latest --copilot
Same methodology. Your agent.

Start building with specs.

Open source MIT License Free forever
View on GitHub

Created by Pedro Menezes

Get in touch

Have a question or feedback?

Send a message. I'll get back to you soon.

Message sent! I'll get back to you soon.