Spec-driven development
for AI agents
Define what to build, then let the agent build it right.
Four core commands.
Idea to audited code.
The main pipeline, plus 5 more commands for every workflow.
analyze
Scans your codebase. Learns patterns, conventions, architecture. Builds a local knowledge base.
gen-spec
Generates a spec with binary Definition of Done, scope, anti-scope, and file budget.
implement
Builds from the spec. Follows your patterns, respects budget, runs tests, self-verifies.
audit
Checks every DoD item with evidence. Pattern compliance. Verdict: PASS, PARTIAL, or FAIL.
From vague idea to verified code.
Watch Vibeflow turn a feature request into audited, pattern-compliant implementation.
Built for real workflows.
From solo devs to product teams.
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.
Bug fix with proof and a paper trail
A date formatting bug in the dashboard, with a clear reproduction. Hotfix records the symptom before touching code, writes a regression test that fails on the current code, then fixes it. The trail lives in .vibeflow/hotfixes/.
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.
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.
9 commands. Full toolkit.
Core pipeline plus power tools for every workflow.
Deep-scans your codebase and produces documentation: stack, architecture, patterns, conventions, all with real code examples.
Generates a technical specification with binary Definition of Done (3-7 pass/fail checks), scope, anti-scope, and risks.
Implements a feature from its spec with guardrails. Follows your patterns, respects budget and anti-scope, runs tests, self-verifies DoD.
Verifies implementation against the spec. Checks DoD, patterns, and tests. Produces a PASS, PARTIAL, or FAIL report.
Interactive dialogue that turns a vague idea into a clear PRD. Challenges assumptions, cuts scope, forces decisions.
Creates a self-contained prompt for a coding agent in a separate session. Embeds your real patterns and conventions.
Fast-track for small planned tasks (up to 4 files). Skips discovery, generates spec directly. For changes with clear requirements; a defect with evidence goes to hotfix.
Updates .vibeflow/ with corrections, new conventions, architectural decisions, or patterns. Also imports from external repos.
Compiles statistics from audit reports. Pass/fail rates, most violated patterns, common DoD gaps, quality trends over time.
Choose your agent.
One shared plugin for Codex and Claude, plus native editions for Cursor and Copilot.
Codex
Native plugin with focused skills that Codex discovers from your request.
Claude Code
Plugin with slash commands for Claude Code and Claude Desktop.
- Open Customize in the sidebar
- Click + → Add marketplace
- pe-menezes/vibeflow
- Click Sync
- Browse plugins → Install Vibeflow
Cursor
Rules and skills for Cursor Agent. Slash commands via /skill-name.
GitHub Copilot
Prompts, agents, skills, and instructions for Copilot Chat.
Start building with specs.
Created by Pedro Menezes
Have a question or feedback?
Send a message. I'll get back to you soon.