Atlas WSSConhecimento
Lições e casos
O que funciona, o que evitar e o que já deu errado.
Validar desktop, notebook e mobile
Nunca considerar o site pronto com uma única visualização.
Ver SOP-008Usar a ferramenta conforme a tarefa
Lovable integra, Codex implementa e investiga, Claude refina, humano julga.
Ver Manual 1Centralizar correções em ajustes.md
Lista persistente reduz pedido perdido e conflito entre ajustes.
Ver SOP-011Comparar Base e legado antes de portar
A Base é referência funcional, não ordem para sobrescrever.
Ver SOP-007Não obedecer auditoria automaticamente
Relatório pode estar antigo, não ver CSR ou pedir algo resolvido.
Ver SOP-010Restaurar produção antes de investigar
Com o site amplamente fora, disponibilidade vem primeiro.
Ver SOP-012Troubleshooting
Sintoma → causa → ação
- Sintoma
- Servidor dev saudável, rotas do artefato publicado respondem 500.
- Causa conhecida
- Chunking/bundling no stack de produção.
- Ação
- Gerar build real, subir o artefato, testar rotas e bloquear publish quando o smoke falha.
- Sintoma
- Relatório externo contradiz o navegador.
- Causa conhecida
- Conteúdo materializado client-side, invisível ao crawler.
- Ação
- Comparar HTML bruto com a UI e corrigir a causa real, não “adicionar H1”.
- Sintoma
- Funcionalidade estável deixa de operar.
- Causa conhecida
- URL/key do Supabase ausente ou incorreta.
- Ação
- Console, env, keys e conexão antes de reescrever o módulo.
- Sintoma
- Clique navega para rota inexistente.
- Causa conhecida
- CTA usava /sobre-mim; a rota era /sobre.
- Ação
- Comparar href com a tabela real de rotas e ajustar só o path.
- Sintoma
- Diferenças extensas entre Base e destino.
- Causa conhecida
- Tratar evolução como substituição integral.
- Ação
- Inventariar equivalentes, deltas, features novas e dependências; portar só o delta aprovado.
- Sintoma
- Plano incompatível com o estado atual.
- Causa conhecida
- Relatório baseado em build anterior.
- Ação
- Comparar com a main, reproduzir e classificar antes de alterar.
- Sintoma
- Desktop muda em tarefa mobile, requisito novo aparece.
- Causa conhecida
- Contexto fraco ou escopo de prompt amplo demais.
- Ação
- Interromper, reforçar contexto, limitar escopo, dividir e revalidar a área preservada.
- Sintoma
- Overflow, scroll horizontal, borda quebrada, 3D instável.
- Causa conhecida
- Efeito levado literalmente entre breakpoints.
- Ação
- Adaptar, simplificar/substituir e remover só se continuar inviável.
- Sintoma
- Versões divergem ou mudança é sobrescrita.
- Causa conhecida
- Edição simultânea sem lock formal.
- Ação
- Identificar os dois lados e preservar a versão funcional com menor dano.
Casos reais
Dr. Guilherme Mendonça
A integração híbrida acelera, mas produção precisa ser validada como ambiente próprio.
Não generalizar: O esboço antecipado antes das definições do cliente foi exceção e não integra o método.
Dr. Guilherme Maia
A Base é referência para evolução, não autoridade para substituição integral.
Não generalizar: Stack, módulos e migrations do caso não definem todo legado.
Daniel P
Sofisticação coexiste com reuso e contenção, mas não dispensa QA básico.
Não generalizar: Nem todo site precisa de 3D, GSAP ou do checklist AEO/GEO do projeto.
Mirela Albuquerque
Antes de reescrever código funcional, verificar configuração, env e conexão.
Não generalizar: Nem todo problema de Blog é Supabase.