Desenvolvimento spec-driven
para agentes de IA
Defina o que construir, depois deixe o agente construir certo.
Novo na 1.17: a edição Hermes Agent →Quatro comandos.
Da ideia ao código auditado.
O pipeline principal, mais 6 comandos para cada workflow.
analyze
Varre seu codebase. Aprende padrões, convenções, arquitetura. Constrói uma base de conhecimento local.
gen-spec
Gera spec com Definition of Done binário, escopo, anti-escopo e budget de arquivos.
implement
Implementa a partir da spec. Segue seus padrões, respeita budget, roda testes, auto-verifica. Com --loop, um executor e uma auditoria independente trabalham em sessões novas.
audit
Checa cada DoD com evidência, a partir de um pacote de revisão do diff. Compliance de padrões. Veredicto: PASS, PARTIAL ou FAIL.
Quem implementou
não aprova.
Novo na 1.16 e desligado por padrão, o implement --loop divide o trabalho entre sessões que não avaliam a si mesmas. Um auditor numa sessão que não viu o trabalho acha o que o implementador deixou passar.
- 1
Orquestradora
A sessão onde você chamou o
implement. Corta o trabalho em partes, escreve o briefing de cada rodada, confere de fora e mantém o ledger. Não implementa. - 2
Executor
Implementa uma parte numa sessão nova, vermelho antes do verde, com arquivo de progresso a cada marco. Não commita.
- 3
Audit
Uma auditoria independente confere a parte em outra sessão nova, a partir de um pacote de revisão do diff. PASS fecha a parte.
- 4
Consertos
No máximo duas rodadas de conserto, cada uma reauditada só no próprio diff. A terceira só roda com o seu OK.
- 5
Pull request
Com todas as partes em PASS, o modo empresa abre o pull request com a evidência. Você revisa e faz o merge.
Como liga
- Desligado por padrão. Sem
--loop, oimplementroda as fases 0 a 8 como antes, e as specs escritas antes da 1.16 continuam válidas. implement <spec> --loopnuma rodada, ouloop: trueem.vibeflow/loop/config.mdpara o projeto.--no-loopdesliga numa rodada, mesmo com o config ligado.- Um OK por feature para commitar cada rodada na branch de feature (ou
commit-rounds: true). O loop nunca roda na branch padrão.
Sessão nova em cada host
- Claude Code: os agentes
vibeflow:executorevibeflow:auditordo plugin. - Codex: o subagente nativo, ou uma task nova com o caminho do briefing.
- Hermes: uma task do
delegate_taskpor rodada, com ogoalapontando o briefing. O resultado volta como um turno novo, ou na própria chamada numa execução de um disparo pela CLI ou num cron. - Cursor e Copilot: um chat novo que você abre com a linha que a orquestradora escreve.
Modo empresa
- Com todas as partes em PASS, a orquestradora empurra a branch e abre o pull request com o
gh, com a evidência no corpo, e depois vigia as checagens. - Em rascunho ou pronto, pela convenção do repositório; em rascunho quando não há convenção.
- O agente nunca faz merge, nunca faz deploy, nunca aplica migração em ambiente compartilhado e nunca lê produção.
- Pede um remoto no GitHub (ou GitHub Enterprise) e
gh auth statusok. Sem isso, o loop empurra a branch e grava o corpo em.vibeflow/reviews/<feature>-pr-body.md, para você abrir o pull request à mão.
Requisitos
- No Claude Code, a versão 2.1.69 ou mais nova, para o loop e para o pacote de revisão do audit.
- Node.js 18 ou mais novo para os scripts do kit.
ghsó para o pull request do modo empresa.- O kit: no Codex, no Claude Code e no Hermes ele vem no plugin. No Cursor e no Copilot, o CLI 0.17.0 instala o kit, e uma instalação anterior ganha o kit com
--force.
De ideia vaga a código verificado.
Veja o Vibeflow transformar um pedido de feature em implementação auditada.
Feito para workflows reais.
De devs solo a times de produto.
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.
Bug fix com prova e rastro
Um bug de formatação de data no dashboard, com reprodução clara. O hotfix registra o sintoma antes de tocar no código, escreve um teste de regressão que falha no código atual e então conserta. O rastro fica em .vibeflow/hotfixes/.
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.
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.
10 comandos. Toolkit completo.
Pipeline principal mais ferramentas para cada workflow.
Deep-scan do codebase que produz documentação: stack, arquitetura, padrões, convenções, tudo com exemplos reais de código.
Gera especificação técnica com Definition of Done binário (3-7 checks pass/fail), escopo, anti-escopo e riscos.
Implementa uma feature a partir da spec com guardrails. Segue seus padrões, respeita budget e anti-escopo, roda testes, auto-verifica DoD.
Verifica a implementação contra a spec, a partir de um pacote de revisão do diff. Checa DoD, padrões e testes, testa cenários e dá uma severidade a cada finding. Produz relatório PASS, PARTIAL ou FAIL.
Diálogo interativo que transforma ideia vaga em PRD claro. Desafia premissas, corta escopo, força decisões.
Cria um prompt auto-contido para um coding agent em sessão separada. Embute seus padrões e convenções reais.
Fast-track para tasks pequenas e planejadas (até 4 arquivos). Pula discovery, gera spec direto. Para mudanças com requisitos claros; defeito com evidência vai pro hotfix.
Conserta um defeito observado com evidência reproduzível em uma chamada: escreve um doc de rastro curto antes de tocar no código, implementa o fix e o sustenta com um teste de regressão escrito antes do fix.
Atualiza .vibeflow/ com correções, novas convenções, decisões arquiteturais ou padrões. Também importa de repos externos.
Compila estatísticas dos relatórios de audit e dos ledgers do loop. Taxas pass/fail, padrões mais violados, gaps de DoD, tendências de qualidade e os números do loop.
Escolha seu agente.
Um plugin compartilhado para Codex, Claude e Hermes, mais edições nativas para Cursor e Copilot.
Codex
Plugin nativo com skills focadas que o Codex descobre a partir do seu pedido.
Hermes Agent
O mesmo plugin compartilhado, lido do manifest na raiz do pacote. Peça em linguagem natural, como no Codex: o Hermes não tem slash commands para as skills. Abra uma sessão nova depois de instalar.
Claude Code
Plugin com slash commands para Claude Code e Claude Desktop.
- Abra Customize na sidebar
- Clique + → Add marketplace
- pe-menezes/vibeflow
- Clique Sync
- Browse plugins → Instale o Vibeflow
Cursor
Rules e skills para Cursor Agent. Slash commands via /skill-name.
GitHub Copilot
Prompts, agents, skills e instructions para Copilot Chat.
Kit do loop: desde o CLI 0.17.0, o --cursor também instala o kit em .cursor/skills/vibeflow-implement/loop/ e o --copilot em .github/vibeflow/loop/. Instalação anterior ganha o kit rodando o instalador de novo com --force. No Codex, no Claude Code e no Hermes, o kit vem dentro do plugin.
No Hermes, o scan da instalação lê a descrição do detector de segredos no README do kit como se fosse um segredo; --force instala.
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. Se versionar a .vibeflow/, deixe a .vibeflow/reviews/ de fora, porque ela guarda material de trabalho: os pacotes de revisão, refeitos a cada auditoria, e o corpo do PR.
Comece a construir com specs.
Criado por Pedro Menezes
Tem uma dúvida ou feedback?
Manda uma mensagem. Te respondo em breve.