Padrões de Código Superam Diretrizes de IA: Portando uma Extensão do Firefox para o Chrome

Um desenvolvedor no r/ClaudeAI compartilhou um estudo de caso concreto sobre a criação de extensões cross-browser com agentes de codificação de IA. O projeto: uma extensão Firefox construída com arquitetura guiada por humanos. Duas tentativas de portá-la para o Chrome via prompts de IA falharam. A causa raiz: os prompts compensavam lacunas de treinamento, mas estavam acoplados a versões do modelo e degradavam em escala.

A solução foi extrair a lógica independente de navegador para um pacote principal com uma interface BrowserShell. Cada extensão tornou-se uma casca fina — o código final da versão Chrome diferia do Firefox por apenas 5 linhas significativas. Insight chave: padrões de código superam diretrizes abstratas. Uma base de código clara e testável permite que o modelo replique padrões de forma confiável, enquanto prompts abstratos lutam contra a distribuição de treinamento do modelo. O padrão Humble Object mantém o código de fronteira enxuto.

Lições Práticas

• Defina um núcleo independente de navegador (ex.: BrowserShell) que abstraia APIs como abas, armazenamento e mensagens.
• Implemente essa interface com adaptadores específicos de plataforma (ex.: FirefoxShell, ChromeShell).
• Instrua a IA a seguir o padrão estabelecido em vez de listar regras. Mostre a ela um adaptador funcional e peça para replicar o padrão para um novo navegador.
• Foque na testabilidade — a lógica principal deve ser testável unitariamente sem APIs de navegador.

A abordagem escala porque padrões são determinísticos para o modelo, enquanto diretrizes são difusas e mudam com atualizações do modelo. Se você está usando IA para portar código entre plataformas, invista em uma arquitetura que permita ao modelo fazer o que faz de melhor: correspondência de padrões.