Referência completa de cada comando do Vibeflow: flags, modos e outputs.
Deep-scan do codebase que aprende seus padrões, convenções e arquitetura. Gera documentação curada em .vibeflow/ que persiste e pode ser commitada no git.
Uso /vibeflow:analyze [--fresh] [--scope <path>] [--interactive] [--satellite <url>]
Flags e modos (sem flags) Modo incremental (padrão): re-analisa apenas arquivos alterados desde a última execução via git diff.
--fresh Rebuild completo do zero. Ignora .vibeflow/ existente, re-analisa tudo.
--scope <path> Deep-dive num módulo ou diretório específico (80%+ dos arquivos). Enriquece padrões globais com exemplos do módulo.
--interactive Adiciona checkpoint de review: apresenta padrões encontrados, pergunta sobre falsos positivos e padrões faltando antes de salvar.
--satellite <url> Analisa um repo de dependência externa (design system, lib compartilhada). Clona, detecta o que seu repo principal usa, merge padrões relevantes.
Output .vibeflow/index.md, conventions.md, patterns/, decisions.md
Diálogo interativo que transforma uma ideia vaga em PRD claro e acionável. Desafia premissas, corta escopo agressivamente e força decisões.
Uso /vibeflow:discover <ideia ou área>
Flags e modos Round rápido 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 Fluxo completo: 3–5 rounds de discovery com questionamento estratégico. Explora problema, audiência, critérios de sucesso, escopo e trade-offs.
Output .vibeflow/prds/<slug>.md
Gera spec técnica com Definition of Done binário (3–7 checks pass/fail), escopo, anti-escopo, decisões técnicas e riscos. Baseada nos padrões reais do seu projeto.
Uso /vibeflow:gen-spec <descrição da feature ou caminho do PRD>
Flags e modos A partir de PRD A partir de PRD: passe o caminho para .vibeflow/prds/<slug>.md e ele usa o PRD como base.
A partir de descrição A partir de descrição: descreva a feature diretamente e ele gera a spec do zero.
Auto-split Auto-split: se a spec excede limites (>7 DoD checks ou excede budget), divide automaticamente em partes numeradas com tracking de dependências.
Output .vibeflow/specs/<slug>.md (ou <slug>-part-N.md se dividida)
Implementa uma feature a partir da spec com guardrails rígidos. Segue seus padrões exatamente, respeita budget e anti-escopo, roda testes e auto-verifica cada DoD check.
Uso /vibeflow:implement <arquivo de spec ou nome da feature>
Pipeline Fase 1 Encontrar e validar spec: localiza spec, valida seções obrigatórias, checa dependências de multi-part.
Fase 2 Extrair guardrails: DoD, escopo, anti-escopo, budget e decisões técnicas viram regras rígidas.
Fase 3 Carregar contexto: lê convenções, padrões aplicáveis, index.md. Usa Pattern Resolution pra matching inteligente.
Fase 4 Planejar: identifica arquivos alvo, verifica budget, mapeia DoD para passos de implementação.
Fase 5 Implementar: executa seguindo padrões exatamente. Princípio de mudança mínima. Sem refactoring fora do escopo.
Fase 6 Rodar testes: detecta test runner automaticamente (npm test, pytest, cargo test, etc.). Máx 2 tentativas de fix.
Fase 7 Auto-verificar DoD: checa cada item do DoD com evidência. Reporta status geral.
Output Alterações de código dentro do escopo e budget, com relatório de verificação do DoD.
Apenas Claude Code. Budget é limite rígido. Anti-escopo é sagrado.
Gera um prompt auto-contido para um coding agent em sessão separada. O agent recebe tudo que precisa: padrões, convenções, caminhos de arquivos, comandos de teste. Zero contexto externo.
Uso /vibeflow:prompt-pack <arquivo de spec ou feature>
Flags e modos Agent-agnostic Agent-agnostic: funciona com Copilot, Cursor, Claude Code, ou qualquer coding agent.
Padrões embutidos Padrões embutidos: inclui exemplos reais de código dos seus .vibeflow/patterns/ pra o agent seguir suas convenções.
Validação Validação: rejeita specs com >7 DoD checks ou que excedem budget. Exige split antes.
Output .vibeflow/prompt-packs/<slug>.md
Audita a implementação contra a spec em duas dimensões: compliance de DoD (cada check pass/fail com evidência) e compliance de padrões (convenções seguidas ou desvios anotados).
Uso /vibeflow:audit <arquivo de spec ou feature>
Flags e modos PASS PASS: todos os DoD checks passam, padrões seguidos, testes passam.
PARTIAL PARTIAL: alguns checks passam, gaps identificados com detalhes específicos.
FAIL FAIL: DoD não atendido ou testes falhando. Testes falhando = FAIL automático independente dos outros checks.
Fix incremental Em PARTIAL ou FAIL, gera prompt pack incremental cobrindo apenas os gaps, pra você corrigir sem reler a spec inteira.
Output .vibeflow/audits/<slug>-audit.md
Fast-track pra tasks pequenas e bem definidas. Pula discovery, gera spec efêmera em memória e produz prompt pack pronto em um comando.
Uso /vibeflow:quick <descrição da task>
Flags e modos Budget ≤4 arquivos 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 Spec efêmera: gerada apenas em memória (não salva em disco). Vai direto pro prompt pack.
Quando usar Use pra bug fixes, features pequenas, mudanças rápidas. Evite se a ideia é vaga ou arquiteturalmente significativa.
Output .vibeflow/prompt-packs/<slug>.md
Atualiza a knowledge base do .vibeflow/ com correções, novas convenções, decisões arquiteturais ou padrões novos a partir de feedback em linguagem natural.
Uso /vibeflow:teach <feedback>
Flags e modos Correção de padrão Correção de padrão: atualiza um doc de padrão existente com sua correção. Sobrevive a updates incrementais.
Nova convenção Nova convenção: adiciona ao conventions.md (ex: "sempre usamos named exports").
Decisão arquitetural Decisão arquitetural: adiciona ao decisions.md com contexto e alternativas descartadas.
Padrão novo Padrão novo: cria novo arquivo .vibeflow/patterns/<nome>.md com estrutura padrão.
Output Atualizações em .vibeflow/ docs (conventions.md, patterns/, decisions.md)
Compila estatísticas de todos os relatórios de audit. Mostra taxas de pass/fail, padrões mais violados, gaps de DoD comuns e tendência de qualidade.
Uso /vibeflow:stats
Flags e modos Métricas Breakdown de verdicts (% PASS/PARTIAL/FAIL), taxa de DoD pass, top 3 checks que mais falham, top 3 padrões mais violados.
Tendência Tendência de qualidade: melhorando, estável ou degradando (requer ≥3 audits).
Output Output no chat (somente leitura, sem arquivos modificados).
