Los Patrones de Código Superan las Guías de IA: Portando una Extensión de Firefox a Chrome

Un desarrollador en r/ClaudeAI compartió un caso de estudio concreto sobre la creación de extensiones multiplataforma con agentes de codificación de IA. El proyecto: una extensión de Firefox construida con arquitectura guiada por humanos. Dos intentos de portarla a Chrome mediante indicaciones de IA fracasaron. La causa raíz: las indicaciones compensaban las brechas de entrenamiento pero se acoplaban a versiones del modelo y se degradaban a escala.

La solución fue extraer la lógica independiente del navegador en un paquete central con una interfaz BrowserShell. Cada extensión se convirtió en una capa fina: la versión final de Chrome difería de la de Firefox en solo 5 líneas significativas. Conclusión clave: los patrones de código superan a las directrices abstractas. Una base de código clara y testeable permite que el modelo replique patrones de manera confiable, mientras que las indicaciones abstractas luchan contra la distribución de entrenamiento del modelo. El patrón Humble Object mantiene delgado el código de límite.

Lecciones prácticas

• Define un núcleo independiente del navegador (ej., BrowserShell) que abstraiga APIs como pestañas, almacenamiento y mensajería.
• Implementa esa interfaz con adaptadores específicos de plataforma (ej., FirefoxShell, ChromeShell).
• Indica a la IA que siga el patrón establecido en lugar de enumerar reglas. Muéstrale un adaptador funcional y pídele que replique el patrón para un nuevo navegador.
• Enfócate en la testabilidad: la lógica central debe ser comprobable mediante tests unitarios sin APIs del navegador.

El enfoque escala porque los patrones son deterministas para el modelo, mientras que las directrices son difusas y se desvían con las actualizaciones del modelo. Si usas IA para portar código entre plataformas, invierte en una arquitectura que permita al modelo hacer lo que mejor sabe: reconocer patrones.