vibeflow

Desenvolvimento spec-driven
para agentes de IA

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

Vibeflow separa o pensar do codar. Você define specs com guardrails. O agente de IA implementa seguindo os padrões reais do seu projeto.

Quick start
analyze → escaneia seu codebase, gera .vibeflow/ knowledge
gen-spec "feature" → gera spec com DoD, escopo, padrões
implement <spec> → implementa com guardrails (budget, DoD, testes)
Veja como funciona Instalar agora

Como o Vibeflow funciona

Três comandos. Da análise do codebase à implementação auditada.

01 analyze
02 gen-spec
03 implement
01 analyze

Deep-scan do codebase e aprende seus padrões, convenções e arquitetura.

Docs .vibeflow/ com convenções reais
02 gen-spec

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

Spec com checks pass/fail
03 implement

Implementa a partir da spec seguindo seus padrões, dentro do budget, respeitando anti-escopo.

Código dentro do escopo e budget

Mais: discover, prompt-pack, audit, quick, teach, stats

Veja na prática

Veja o Vibeflow desafiar uma ideia vaga até virar uma spec fechada.

vibeflow discover → gen-spec
Você "Preciso de autenticação de usuário no meu app"
01 discover
Vibeflow Que tipo? OAuth, magic link ou email/senha?
Vibeflow Precisa de reset de senha na v1? São 3 arquivos extras e integração com email.
Vibeflow Login social? Isso adiciona complexidade de OAuth que talvez você não precise ainda.
Você "Só email/senha. Sem reset, sem social. Mantém simples."
02 discover round 2
Vibeflow Você disse "simples". Precisa de verificação de email ou confia no input?
Vibeflow Rate limiting em tentativas de login? Sem isso, brute force é trivial.
Você "Sem verificação de email na v1. Sim pro rate limiting, 5 tentativas por minuto."
PRD gerado
Escopo: signup + login com email/senha + rate limiting Anti-escopo: OAuth, reset de senha, login social, verificação de email Critérios de sucesso: 4 checks binários
03 gen-spec
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: ≤4 arquivos Patterns: segue estrutura controller/service existente em src/api/ Anti-escopo enforced: SEM OAuth, SEM reset, SEM verificação, SEM social

Casos de uso

Vibeflow se adapta a diferentes papéis e cenários.

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/

Todos os comandos

Pipeline principal mais ferramentas para cada workflow.

analyze

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
Entenda seu codebase gen-spec

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
Defina o que construir implement

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
Construa com guardrails
audit

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

PASS / PARTIAL / FAILfix incremental
Verifique o resultado discover

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

2–5 roundscorte de escopo
Clarifique a ideia prompt-pack

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
Delegue para outro agente quick

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
Tasks pequenas, rápido
Ver todos os comandos →

Escolha sua edição

Mesma metodologia. Adaptada ao seu agente.

GitHub Copilot

Prompts, agents, skills e instructions para Copilot Chat.

npx setup-vibeflow@latest --copilot

Cursor

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

npx setup-vibeflow@latest --cursor

Claude Code

Plugin com slash commands para Claude Code CLI.

pe-menezes/vibeflow-claude

Por padrão o instalador adiciona os arquivos instalados e a pasta .vibeflow/ ao .gitignore, então não entram no commit. Remova o bloco "Vibeflow" do .gitignore se quiser versionar no git.

Comece a construir com specs

Defina o que quer, deixe a IA executar, verifique o resultado.

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

Criado por Pedro Menezes

Entre em contato

Tem uma dúvida, feedback ou quer contribuir? Manda uma mensagem.