Quando usar: A mudança toca mais de 3 arquivos ou tem escopo pouco claro.
Fluxo
-
Planejar
Use claude-best-practice. Escreva um plano para refatorar auth: escopo, sequência, riscos, rollback. Não escreva código ainda.✓ Copiado
→ Documento de plano; sem código
-
Criticar
Critique seu próprio plano como se você fosse o revisor sênior. O que está faltando?✓ Copiado
→ Crítica com correções concretas
-
Executar
Agora execute o passo 1 do plano revisado. Pare após esse passo.✓ Copiado
→ Passo 1 concluído; aguarda aprovação
Resultado: Refatoração que aterra de forma limpa porque foi pensada.
Armadilhas
- Plano muito abstrato — Insista em granularidade em nível de arquivo no plano
Quando usar: Algo deu errado e você precisa documentar.
Fluxo
-
Coletar
Use o template de post-mortem. Extraia a linha do tempo de /logs e commits recentes.✓ Copiado
→ Linha do tempo construída automaticamente
-
Cinco porquês
Percorra os cinco porquês da causa raiz. Distinga proximal de contribuinte.✓ Copiado
→ Causas em camadas
-
Itens de ação
Gere itens de ação com responsáveis e datas de vencimento.✓ Copiado
→ Lista de ações com responsáveis sinalizados para revisão
Resultado: Documento de post-mortem que ajuda na próxima vez, não culpa.
Armadilhas
- Responsáveis atribuídos automaticamente estão errados — Sempre revise as atribuições de responsáveis antes de publicar
Quando usar: A migração abrange muitos arquivos; você quer não perder etapas.
Fluxo
-
Adotar
Aplique o template de migração para React 18→19. Personalize para nosso código-base.✓ Copiado
→ Checklist customizado
-
Rastrear
Percorra o checklist, marcando concluído/bloqueado para cada item.✓ Copiado
→ Log de progresso
Resultado: Sem surpresas de 'esquecemos de atualizar X' após a migração.
Armadilhas
- Checklist fica desatualizado — Atualize para cada versão major; a skill fornece o esqueleto