Ir para o conteúdo

Corrigir um bug

Use /n45-fix quando algo estiver quebrado, com comportamento incorreto ou lento. O N45 investiga, identifica a causa raiz e propõe uma correção — aplicada na hora ou planejada em detalhe.

Como /n45-feat, o N45 escolhe entre hot fix e fix estruturado com base no que a investigação encontra.

As três condições

Todas as três precisam ser verdadeiras pro caminho hot fix. Se qualquer uma falhar, o N45 escala pra um fix estruturado.

Condição O que significa
Causa raiz clara Diagnóstico confirmado. Sem investigação pendente.
Sem mudança arquitetural A correção toca só caminhos de código existentes — sem novos módulos ou mudanças de padrão.
Sem schema ou migration A correção não exige mudança de banco.

O fluxo

flowchart TD
    Start([/n45-fix]) --> Investigate[Investigar]
    Investigate --> Project[Lê padrões do projeto]
    Project --> Ask[Clarificar sintomas e esperado]
    Ask --> Diagnose[Diagnosticar causa raiz]
    Diagnose --> Decision{Condições do
hot fix?}
    Decision -->|todas as 3 atendidas| Hot[Hot fix
branch + executor]
    Decision -->|alguma falha| Structured[Fix estruturado
discovery + spec + roadmap]
    Hot --> Validation
    Structured --> Validation
    Validation([Validação])

Hot fix — exemplo

"O botão de login não faz nada quando clico."

  1. O N45 lê PATTERNS e os componentes relevantes
  2. Investiga: encontra que o handler de submit nunca é ligado
  3. Diagnostica: causa raiz clara, arquivo único
  4. Confirma que todas as três condições estão atendidas
  5. Decide: hot fix
  6. Cria uma branch dedicada (hot-fix/login-button-no-submit)
  7. Dispara o executor com o diagnóstico e o escopo do arquivo
  8. Retorna: arquivos modificados, resumo, como testar
  9. Você valida → commit → merge

Tempo total: 1–2 minutos.

Fix estruturado — exemplo

"Nossa migration corrompeu registros de usuário. Algumas sessões mostram dados errados."

  1. O N45 investiga e identifica um bug de update parcial numa migration
  2. Detecta: exige script de recovery e verificação de schema — falha a condição 3
  3. Decide: fix estruturado
  4. Roda discovery: mapeia registros afetados, causa raiz, estratégia de recuperação
  5. Gera uma spec cobrindo o plano de correção dos dados, log de auditoria, rollback
  6. Você revisa a spec
  7. Gera um roadmap (recuperar → verificar → backfill → testes)
  8. Cada task é executada e revisada antes de seguir adiante
  9. Validação → aprovação → merge

Como difere do /n45-feat

/n45-feat /n45-fix
Nome do caminho rápido Quick Feat Hot Fix
Prefixo da branch quick-feat/... hot-fix/...
Tag do commit [quick-feat] [hot-fix]
Gatilho Novo comportamento desejado Comportamento existente errado

No resto: mesma triagem, mesma validação, mesmo merge.

Veja também