Todos os comandos

Modo incremental (padrão): re-analisa apenas o que mudou desde a última execução, detectado via git. Também roda quando só mudou um arquivo de teste, a configuração da CI ou a do test runner.

Rebuild completo do zero. Ignora .vibeflow/ existente, re-analisa tudo.

Deep-dive num módulo ou diretório específico (80%+ dos arquivos). Enriquece padrões globais com exemplos do módulo.

Adiciona checkpoint de review: apresenta padrões encontrados, pergunta sobre falsos positivos e padrões faltando antes de salvar.

Analisa um repo de dependência externa (design system, lib compartilhada). Clona, detecta o que seu repo principal usa, merge padrões relevantes.

Roda uma vez o comando da suíte inteira e o dos testes afetados e grava o tempo de cada um e a data. Sem a flag, o analyze registra os comandos de teste sem rodá-los.

O index.md ganha um bloco de testes e pitfalls: o comando da suíte inteira, o comando mais estreito dos testes afetados com o tempo medido ou unmeasured, e os pitfalls com a fonte.

Proteção de padrões importados: modo incremental pula padrões que têm versão importada (via teach --from). Fonte de verdade externa tem precedência.

Round rápido: se sua primeira resposta tem clareza total (problema concreto, audiência definida, escopo fechável), pula pra 1–2 rounds e gera o PRD.

Fluxo completo: 3–5 rounds de discovery com questionamento estratégico. Explora problema, audiência, critérios de sucesso, escopo e trade-offs.

As perguntas decisivas do diálogo e as respostas vão para a seção ## Clarifications do PRD, e o gen-spec as leva para a spec.

A partir de PRD: passe o caminho para .vibeflow/prds/<slug>.md e ele usa o PRD como base.

A partir de descrição: descreva a feature diretamente e ele gera a spec do zero.

PRD validation gate: quando o input é um PRD (arquivo ou >3 linhas), roda 5 sanity checks (problema concreto, audiência, scope fechável, conflitos com .vibeflow/, viabilidade técnica). Faz até 2 perguntas se achar problemas. Descrições curtas pulam o gate.

Auto-split: se a spec excede limites (>7 DoD checks ou excede budget), divide automaticamente em partes numeradas com tracking de dependências.

O que a spec não consegue decidir vira um marcador [NEEDS CLARIFICATION: <pergunta>], com a meta de no máximo 3 abertos. Antes de salvar, ele confere o próprio rascunho (checks binários, um teste ou Scenarios: em cada check funcional onde o projeto tem test runner, a contagem de marcadores) e pode fazer até 2 perguntas numa rodada só; o marcador que continua aberto fica na spec salva e é citado na resposta.

Registra as perguntas feitas e as respostas em ## Clarifications, no máximo 5 por sessão, mais as que vêm do PRD.

Um check funcional do DoD pode levar linhas Scenarios: na forma EARS (WHEN <condição> THE SYSTEM SHALL <comportamento>), e um check pode ser uma propriedade com o oráculo nomeado. São campos de um check: o DoD continua com 3 a 7.

Fecha a seção ## Risks com a lista Risk code: dos caminhos ou funções que a mudança toca em dinheiro e totais, credenciais e permissões, apagar ou sobrescrever dado, e fronteira de data e hora (Risk code: none quando não há). É onde o audit sabota.

Sem ninguém para responder (claude -p, um pipeline), ele pode terminar nas perguntas sem salvar a spec.

## Clarifications, Scenarios:, Risk code:, [NEEDS CLARIFICATION: …] e as palavras-chave EARS ficam em inglês numa spec ou PRD escrito em qualquer língua, porque outros comandos as casam byte a byte.

Encontrar e validar spec: localiza spec, valida seções obrigatórias, checa dependências de multi-part.

Extrair guardrails: DoD, escopo, anti-escopo, budget e decisões técnicas viram regras rígidas.

Carregar contexto: lê convenções, padrões aplicáveis, index.md. Usa Pattern Resolution pra matching inteligente.

Planejar: identifica arquivos alvo, verifica budget, mapeia DoD para passos de implementação.

Implementar: executa seguindo padrões exatamente. Princípio de mudança mínima. Sem refactoring fora do escopo.

Rodar testes: detecta test runner automaticamente (npm test, pytest, cargo test, etc.). Máx 2 tentativas de fix.

Refinar (simplify no escopo): limpa o diff que escreveu (reuso, nomes, dead code) sobre baseline verde e re-roda os testes; reverte se quebrar.

Auto-verificar DoD: checa cada item do DoD com evidência. Reporta status geral.

Finalizar: resume DoD, budget e testes e sugere /vibeflow:audit como próximo passo.

As fases 0 a 3 rodam como acima e, no lugar das fases 4 a 8, a sessão vira a orquestradora do loop de execução: o executor implementa numa sessão nova e a auditoria independente roda em outra.

No front matter de .vibeflow/loop/config.md, liga o loop para o projeto.

Desliga o loop numa rodada, mesmo com o config ligado.

Sem o kit, ou sem Node.js 18 ou mais novo, o loop para antes da fase 0, diz o que instalar e lembra que o implement sem --loop continua rodando.

Agent-agnostic: funciona com Codex, Copilot, Cursor, Claude Code, Hermes Agent, ou qualquer coding agent.

Padrões embutidos: inclui exemplos reais de código dos seus .vibeflow/patterns/ pra o agent seguir suas convenções.

Validação: rejeita specs com >7 DoD checks ou que excedem budget. Exige split antes.

O audit lê a mudança de um arquivo só, para que a revisão e o Critical Gate julguem o mesmo diff. Com --package <path>, lê esse pacote; sem ele, monta um em .vibeflow/reviews/<feature-slug>-round-0.md a partir de --base <ref> quando dado, senão do merge-base com a branch padrão (ou de HEAD, para trabalho não commitado na branch padrão). O diff vai dessa base até a árvore de trabalho, então os commits da branch e o que não foi commitado são julgados juntos. Com --package, --base ou --reaudit, ou numa parte do loop, pacote vazio termina em FAIL ("nothing to audit"). No audit rodado à mão sem diff para empacotar, ou sem o kit ou sem Node.js 18+, não há pacote, e o relatório grava Review package: none (<motivo>).

Confere uma rodada de conserto só no diff dela: roda a suíte e as sondas do audit, fecha ou mantém cada finding aberto e procura defeito novo só no diff do conserto.

Escreve sondas de comportamento como testes em <pasta de testes>/audit/ e sabota código de risco, cada sabotagem desfeita a partir de uma cópia conferida por hash. À mão, sondas e sabotagem só rodam com a flag; sem ela, o relatório lista as sondas como código e grava Sabotage: skipped.

Todo finding tem severidade (defect, risk-gap, low), causa e confiança. Um defect ou risk-gap aberto segura o veredicto abaixo de PASS seja qual for a confiança, então espere PARTIAL onde a 1.15 dava PASS. Um finding low vai para ### Follow-ups e não bloqueia.

PASS: todos os DoD checks passam, padrões seguidos, testes passam, gate limpo e nenhum defect ou risk-gap aberto.

PARTIAL: alguns checks passam, gaps identificados com detalhes específicos.

FAIL: DoD não atendido, testes falhando, finding CRITICAL/HIGH do Critical Gate sem justificativa, ou pacote vazio onde se esperava mudança. Testes falhando = FAIL automático independente dos outros checks.

Em PARTIAL ou FAIL, gera prompt pack incremental cobrindo apenas os gaps, pra você corrigir sem reler a spec inteira.

O alvo vira .vibeflow/hotfixes/ em vez de uma spec: re-executa os checks do DoD e o teste de regressão de cada doc contra o código atual e classifica como still-holds, promote ou regressed. Sem veredicto PASS/PARTIAL/FAIL.

Budget ≤4 arquivos: mais restrito que o padrão ≤6. Se a task precisa de mais, avisa pra usar o pipeline completo.

Spec efêmera: gerada apenas em memória (não salva em disco). Vai direto pro prompt pack.

Use pra tasks pequenas e planejadas, com requisitos claros. Defeito observado com evidência vai pro hotfix, independente do tamanho. Evite se a ideia é vaga ou arquiteturalmente significativa.

Doc curto em .vibeflow/hotfixes/, escrito em 2 tempos: sintoma, hipótese e propriedades a preservar antes de qualquer código; causa raiz, DoD e regressão depois do fix.

O teste de regressão entra na suíte antes do fix e tem que falhar no código atual, pela razão que a hipótese aponta. Escrito depois, ele só poderia concordar com o fix.

Dois desfechos: done, ou um HALT nomeado de um conjunto fechado de 6 (ex: cannot-reproduce, exceeds-hotfix-budget). Todo HALT salva o doc com o próximo passo humano; retome passando o caminho do doc.

verified exige os 4: reprodução real, teste de regressão red→green, suíte do projeto verde e Critical Gate limpo. Qualquer coisa a menos vira partial, com o motivo visível no doc.

Depois, audit --consolidate-hotfixes reclassifica os docs de rastro contra o código atual.

Use quando um defeito observado tem evidência reproduzível, mesmo pequeno. Tarefa planejada sem defeito vai pro quick; ideia vaga vai pro discover.

Correção de padrão: atualiza um doc de padrão existente com sua correção. Sobrevive a updates incrementais.

Nova convenção: adiciona ao conventions.md (ex: "sempre usamos named exports").

Decisão arquitetural: adiciona ao decisions.md com contexto e alternativas descartadas.

Padrão novo: cria novo arquivo .vibeflow/patterns/<nome>.md com estrutura padrão.

--from <url|path>: importa padrões e convenções de um repo externo de referência (ex: guidelines de arquitetura, convenções compartilhadas). Review interativo para escolher o que importar. Salva em .vibeflow/patterns/external-<nome>/.

Detecção de conflito: ao importar ou criar padrões, detecta colisões de nome com padrões locais ou importados. Pergunta qual versão manter, sem sobrescrita silenciosa.

Breakdown de verdicts (% PASS/PARTIAL/FAIL), taxa de DoD pass, top 3 checks que mais falham, top 3 padrões mais violados.

Tendência de qualidade: melhorando, estável ou degradando (requer ≥3 audits).

Quando .vibeflow/loop/ tem ledgers (os .md da pasta, menos o config.md), o relatório ganha a seção ### Loop com os números do loop-stats.mjs do kit (partes, taxa de PASS no primeiro audit, média de rodadas de conserto, mediana do relógio do despacho ao PASS) e os findings por severidade e por causa, contados nos relatórios de audit. Sem ledgers, o relatório é o de antes.

Um relatório com Verdict: pending é um audit em andamento ou interrompido: o stats conta esses à parte ("N audits in progress or interrupted") e os deixa fora de todas as outras contagens.