Como funciona Comandos Edições GitHub Star no GitHub
Open source · Licença MIT

Desenvolvimento spec-driven
para agentes de IA

Defina o que construir, depois deixe o agente construir certo.

vibeflow pipeline
$ analyze           → ✓ 14 padrões · 8 convenções · .vibeflow/ pronto
$ gen-spec "auth"  → ✓ 5 DoD checks · budget ≤4 arquivos · anti-escopo travado
$ implement         → ✓ 3 arquivos alterados · testes passam · DoD auto-verificado
$ audit             → PASS — todos checks verificados, padrões seguidos
Veja como funciona Instalar agora
Pipeline principal

Quatro comandos.
Da ideia ao código auditado.

O pipeline principal — mais 5 comandos para cada workflow.

1

analyze

Varre seu codebase. Aprende padrões, convenções, arquitetura. Constrói uma base de conhecimento local.

2

gen-spec

Gera spec com Definition of Done binário, escopo, anti-escopo e budget de arquivos.

3

implement

Implementa a partir da spec. Segue seus padrões, respeita budget, roda testes, auto-verifica.

4

audit

Checa cada DoD com evidência. Compliance de padrões. Veredicto: PASS, PARTIAL ou FAIL.

Mais 5: discover · prompt-pack · quick · teach · stats — Ver todos os comandos →
Demo ao vivo

De ideia vaga a código verificado.

Veja o Vibeflow transformar um pedido de feature em implementação auditada.

"Preciso de autenticação de usuário no meu app"
fase discover — desafiando escopo:
  • Que tipo? OAuth, magic link ou email/senha?
  • Precisa de reset de senha na v1? São 3 arquivos extras e integração com email.
  • Login social? Isso adiciona complexidade de OAuth que talvez você não precise ainda.
"Só email/senha. Sem reset, sem social. Mantém simples."
questiona:
  • Você disse "simples". Precisa de verificação de email ou confia no input?
  • Rate limiting em tentativas de login? Sem isso, brute force é trivial.
"Sem verificação de email na v1. Sim pro rate limiting, 5 tentativas por minuto."
PRD gerado
Escopo: Escopo: signup + login com email/senha + rate limiting
Anti-escopo: Anti-escopo: OAuth, reset de senha, login social, verificação de email
Spec gerada
☐ ☐ POST /auth/signup retorna 201 + JWT
☐ ☐ POST /auth/login retorna 200 + JWT
☐ ☐ Senhas com hash bcrypt, mín 8 chars
☐ ☐ Login rate-limited a 5 tentativas/min por IP
Budget: Budget: ≤4 arquivos
implement
src/api/auth/auth.controller.ts
src/api/auth/auth.service.ts
src/api/auth/auth.middleware.ts
✓ ✓ 3 arquivos · testes passam · DoD auto-verificado
audit → PASS
✓ ✓ POST /auth/signup retorna 201 + JWT
✓ ✓ POST /auth/login retorna 200 + JWT
✓ ✓ Senhas com hash bcrypt, mín 8 chars
✓ ✓ Login rate-limited a 5 tentativas/min por IP
✓ ✓ Compliance de padrões: estrutura controller/service seguida
PASS — Todos 4 DoD checks verificados com evidência. Pode shipar.
Casos de uso

Feito para workflows reais.

De devs solo a times de produto.

Desenvolvedor

Feature nova em projeto existente

Você precisa adicionar um fluxo de pagamento. Ao invés de deixar a IA adivinhar, você define escopo (só Stripe, sem PayPal), anti-escopo (sem gerenciamento de assinatura), e um DoD com 5 checks. O agent implementa exatamente isso.

analyze → gen-spec → implement → audit
Desenvolvedor

Bug fix rápido com escopo controlado

Um bug de formatação de data no dashboard. Você usa o modo quick, gera uma spec focada em segundos. O agent corrige o bug, nada mais. Audit confirma o fix.

quick → implement → audit
Product Manager

Definir requisitos antes de passar pro time

Você tem uma ideia de feature mas precisa clarificar escopo antes do time de dev começar. O discover te guia pelas perguntas difíceis e produz um PRD claro. Sem código envolvido.

discover → entregar PRD ao time
Tech Lead

Onboarding de dev novo

Dev novo entra no time. Ao invés de ler 200 arquivos, roda analyze. O Vibeflow produz um guia completo do projeto: arquitetura, padrões, convenções, tudo com exemplos reais de código.

analyze → dev lê .vibeflow/
Comandos

9 comandos. Toolkit completo.

Pipeline principal mais ferramentas para cada workflow.

Core
analyze
Entenda seu codebase

Deep-scan do codebase que produz documentação: stack, arquitetura, padrões, convenções, tudo com exemplos reais de código.

--fresh--scope--satellite--interactive
Detalhes →
Core
gen-spec
Defina o que construir

Gera especificação técnica com Definition of Done binário (3-7 checks pass/fail), escopo, anti-escopo e riscos.

auto-splitde PRD ou ideia
Detalhes →
Core
implement
Construa com guardrails

Implementa uma feature a partir da spec com guardrails. Segue seus padrões, respeita budget e anti-escopo, roda testes, auto-verifica DoD.

pipeline de 7 fasespattern resolutionauto-verifica DoD
Detalhes →
Core
audit
Verifique o resultado

Verifica a implementação contra a spec. Checa DoD, padrões e testes. Produz relatório PASS, PARTIAL ou FAIL.

PASS / PARTIAL / FAILfix incremental
Detalhes →
Tool
discover
Clarifique a ideia

Diálogo interativo que transforma ideia vaga em PRD claro. Desafia premissas, corta escopo, força decisões.

2–5 roundscorte de escopo
Detalhes →
Tool
prompt-pack
Delegue para outro agente

Cria um prompt auto-contido para um coding agent em sessão separada. Embute seus padrões e convenções reais.

agent-agnosticpadrões embutidos
Detalhes →
Tool
quick
Tasks pequenas, rápido

Fast-track para tasks pequenas (até 4 arquivos). Pula discovery, gera spec direto. Para bug fixes e mudanças rápidas.

budget ≤4 arquivosspec efêmera
Detalhes →
Tool
teach
Atualizar knowledge base

Atualiza .vibeflow/ com correções, novas convenções, decisões arquiteturais ou padrões. Também importa de repos externos.

--from <url>detecção de conflito
Detalhes →
Tool
stats
Acompanhar qualidade

Compila estatísticas dos relatórios de audit. Taxas pass/fail, padrões mais violados, gaps de DoD, tendências de qualidade.

output no chat≥3 audits pra trends
Detalhes →
Ver referência completa — flags, modos e outputs →
Edições

Escolha seu agente.

Mesma metodologia, adaptada ao seu workflow.

Claude Code

Plugin com slash commands para Claude Code e Claude Desktop.

  1. Abra Customize na sidebar
  2. Clique + → Add marketplace
  3. pe-menezes/vibeflow-claude
  4. Clique Sync
  5. Browse plugins → Instale o Vibeflow
/plugin marketplace add pe-menezes/vibeflow-claude
/plugin install vibeflow@vibeflow-marketplace

Cursor

Rules e skills para Cursor Agent. Slash commands via /skill-name.

npx setup-vibeflow@latest --cursor

GitHub Copilot

Prompts, agents, skills e instructions para Copilot Chat.

npx setup-vibeflow@latest --copilot
Mesma metodologia. Seu agente.

Comece a construir com specs.

Open source Licença MIT Grátis pra sempre
Ver no GitHub

Criado por Pedro Menezes

Entre em contato

Tem uma dúvida ou feedback?

Manda uma mensagem. Te respondo em breve.

Mensagem enviada! Te respondo em breve.