Nos últimos meses, usei o Claude Code — o agente de IA da Anthropic que roda direto no terminal — como meu principal parceiro de engenharia. Não usei a ferramenta apenas para "gerar funções isoladas", mas para desenvolver, auditar e lançar dois projetos reais para o Grupo Tema Organização Contábil: um site institucional de alta performance e o CondoAssembleia (um sistema full-stack complexo de votação eletrônica utilizando Next.js, TypeScript e Supabase).
A grande virada de chave foi perceber que a diferença entre pedir para a IA "fazer algo" e trabalhar com ela como um dev sênior ao seu lado está na estrutura e na disciplina dos seus prompts. Abaixo, compartilho as estratégias e os prompts reais que funcionaram nesses dois cenários.
🏗️ Cenário 1: O Site Institucional (Contexto de Negócio e UX)
O site institucional é uma landing page one-page estática. Em vez de apenas pedir a estrutura técnica, o resultado mudou quando passei o contexto real do negócio:
"É um escritório de contabilidade em Goiás, com mais de 30 anos de mercado. Preciso de uma seção de serviços, diferenciais, depoimentos, FAQ e contato, com CTA de WhatsApp em vez de formulário tradicional, porque é assim que os clientes daqui preferem falar com a gente."
Para o refinamento visual e eliminação de redundâncias, o prompt que funcionou como um briefing de design foi:
"Atue como um UX/UI Designer Sênior especializado em produtos SaaS modernos. Sua missão NÃO é redesenhar o site. É reduzir a carga visual, melhorar a hierarquia de informações e tornar a experiência mais elegante. Avalie: hierarquia visual, espaçamento, grid, tipografia, contraste e responsividade. NÃO adicionar seções e NÃO alterar SEO. Antes de implementar, explique o motivo da mudança."
⚙️ Cenário 2: O CondoAssembleia (Auditoria, Carga e Segurança)
Quando o desafio subiu de nível para um sistema com banco de dados e regras de negócio sensíveis (votos ponderados por frações ideais), o erro comum seria pedir para a IA "corrigir os bugs". Para evitar regressões ou alterações inesperadas, adotei um fluxo rígido dividindo o processo em fases.
🧠 1. Separar Auditoria de Correção
"Realize uma auditoria de segurança completa no CondoAssembleia, considerando que a aplicação já está em produção. [Listar escopo: rotas, tokens, SQL injection, etc]. Valide especificamente: um proprietário não pode votar por outro e links de votação não podem ser reutilizados. Não implemente melhorias de UX. Foque exclusivamente em segurança. Corrigir apenas após minha aprovação."
📊 2. Simulação em Escala Real vs. Testes Isolados
Em vez de testar cenários felizes e pequenos, exigi testes com volume real de produção para estressar a arquitetura antes do deploy:
"Simule um condomínio com 100 unidades, 65 proprietários com diferentes quantidades de unidades. Fluxo: importar planilha, criar assembleia, criar pautas, simular votação de dezenas de proprietários, votos ponderados, abstenções e tentativa de voto duplicado. Valide: soma dos pesos, quórum, integridade dos dados e desempenho."
> 💡 Resultado prático: Essa simulação revelou que a importação de 100 unidades demorava quase 70 segundos no banco. Após a otimização guiada pelo relatório, o tempo caiu para 19,7 segundos.
🛡️ 3. Blindar Regras de Negócio ao Mexer na UI
Ao refatorar componentes visuais, desenhei "linhas vermelhas" explícitas para o agente:
"Quero refatorar a tela 'Proprietários' com base em feedback real. IMPORTANTE: Não alterar nenhuma regra de negócio, não alterar o banco de dados, não alterar APIs e não alterar cálculo do peso. A alteração deve ser exclusivamente de layout e usabilidade."
🏁 O Checklist Binário de Release
No fechamento de ambos os projetos, para eliminar respostas subjetivas da IA (como "a performance está boa"), forcei uma tomada de decisão usando lógica binária:
"Ao final, responda SIM ou NÃO para cada item do checklist (compila sem erros, sem vulnerabilidades críticas, sem regressões) e emita apenas uma conclusão: APROVADO PARA PRODUÇÃO, APROVADO COM RESSALVAS, ou REPROVADO PARA PRODUÇÃO — justificando tecnicamente a decisão."
🔥 Lições Práticas para o seu Workflow com IA
Diga o Porquê: Contextos comerciais guiam a IA a tomar decisões de design e escrita muito melhores do que instruções puramente técnicas.
Prefira Auditorias Temáticas: Em vez de "melhore o código", faça rodadas específicas (uma sessão para acessibilidade WCAG, uma para segurança de rotas, uma para refatoração de CSS).
Trave a IA no Modo Exploratório: Use o sufixo `[Sua ideia]. Me responda e não aplique nada ainda` para debater arquitetura sem o risco de alterações acidentais nos seus arquivos locais.
Peça Números, Não Adjetivos: Monitore métricas exatas de tempo de resposta e performance antes e depois de qualquer alteração de código.
Comentários
Postar um comentário