Postagem no Reddit: Desenvolvedores Precisam de Melhores Práticas de Codificação com IA, Não Apenas Melhores Ferramentas
O Problema: Prompting Bruto
O autor identifica um padrão comum em que os desenvolvedores abordam as ferramentas de codificação por IA com o que chamam de "prompting bruto". Isso envolve dar instruções vagas e abertas como "Adicione autenticação a este aplicativo" sem fornecer contexto, estrutura ou limites. Quando a IA faz suposições, ignora o estilo de código existente, pula a cobertura de testes e produz o que a comunidade chama de "lixo", os desenvolvedores tendem a culpar a ferramenta em vez de sua própria abordagem.
A Solução: Abordagens Estruturadas
A publicação descreve dois níveis de melhoria para obter lógica adequada ao propósito do Claude:
Nível 1: Estrutura de Suporte (CLAUDE.md)
Pare de fazer a IA adivinhar suas preferências. Defina princípios fundamentais no projeto documentando:
- Estilo de commit
- Abordagem de desenvolvimento
- Metodologia de teste
- Padrões de revisão de código
Estabeleça expectativas básicas antes de pedir à IA para escrever qualquer código.
Nível 2: Habilidades e Fluxos de Trabalho
Em vez de tarefas abertas, use estruturas opinativas como o conjunto de habilidades Superpowers no GitHub. Force a IA a:
- Analisar o contexto e fazer perguntas esclarecedoras primeiro
- Propor 3 abordagens distintas e permitir que você escolha/ajuste a arquitetura
- Passar pelo design uma peça de cada vez
- Executar, rodar testes isoladamente e criticar seu próprio trabalho em relação ao plano original
Insight Principal
O autor compara a situação a trabalhar com um desenvolvedor júnior humano: se você dissesse a ele para "adicionar autenticação" com zero contexto, você também teria uma bagunça. A IA não é uma leitora de mentes. Para obter código pronto para produção, você precisa fornecer gerenciamento e responsabilidade por meio de práticas adequadas de prompting.
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also
Opus 4.7 quebrou 40% dos prompts; a correção foi estruturar CLAUDE.md e Skills
Após o Opus 4.7 degradar ~40% dos prompts em 6 configurações, um head fractional de IA resolveu substituindo prompts ad-hoc por arquivos Skill estruturados, CLAUDE.md hierárquico e arquivos de memória separados — reduzindo o uso de tokens em 22% e as iterações de 3-4 para 1-2.
As regras do SOUL.md desviam-se em sessões longas de agentes de IA e como corrigir isso
As regras do SOUL.md funcionam perfeitamente nas primeiras 10-15 mensagens, mas começam a se desviar por volta da mensagem 20-30, conforme o contexto da conversa sobrepõe o prompt inicial do sistema. A solução é usar /new de forma mais agressiva para redefinir as sessões antes de cada tarefa distinta.
Estrutura Prática para Escolher entre os Modelos Haiku, Sonnet e Opus da Claude
Um desenvolvedor testou os três modelos do Claude em uma tarefa de refatoração de 400 linhas em Express.js e descobriu que a diferença principal está na profundidade do raciocínio, não na inteligência. O Haiku 4.5 lidou com partes diretas, mas perdeu a ordenação do middleware, o Sonnet 4.6 capturou o problema de ordenação e adicionou tipos TypeScript, enquanto o Opus 4.6 identificou uma falha de segurança no middleware de autenticação.
Executando OmniCoder-9B localmente com detalhes de configuração do llama.cpp
Um desenvolvedor alcançou uma pontuação média de 96,7% no HumanEval com o OmniCoder-9B em hardware de médio porte usando flags específicas do llama.cpp, incluindo --reasoning-budget 0 para desativar a saída de chain-of-thought. A configuração utilizou um modelo quantizado Q6_K rodando em uma RTX 3080 com 10GB de VRAM.