Шаблоны кода превосходят руководства по ИИ: перенос расширения Firefox в Chrome

Разработчик на r/ClaudeAI поделился конкретным примером создания кросс-браузерных расширений с использованием ИИ-агентов кодирования. Проект: расширение для Firefox, созданное с архитектурой, управляемой человеком. Две попытки перенести его на Chrome с помощью подсказок ИИ провалились. Коренная причина: подсказки компенсировали пробелы в обучении, но были привязаны к версиям моделей и ухудшались с масштабом.

Решение заключалось в выделении браузерно-независимой логики в основной пакет с интерфейсом BrowserShell. Каждое расширение стало тонкой оболочкой — финальный код версии для Chrome отличался от Firefox только на 5 значимых строк. Ключевая идея: шаблоны кода превосходят абстрактные рекомендации. Четкая, тестируемая кодовая база позволяет модели надежно воспроизводить шаблоны, в то время как абстрактные подсказки противоречат распределению обучающих данных модели. Шаблон Humble Object позволяет сделать граничный код тонким.

Практические выводы

• Определите браузерно-независимую основу (например, BrowserShell), которая абстрагирует API, такие как вкладки, хранилище и обмен сообщениями.
• Реализуйте этот интерфейс с помощью платформенно-специфичных адаптеров (например, FirefoxShell, ChromeShell).
• Попросите ИИ следовать установленному шаблону, а не перечислять правила. Покажите рабочий адаптер и попросите воспроизвести шаблон для нового браузера.
• Сосредоточьтесь на тестируемости — основная логика должна быть юнит-тестируемой без браузерных API.

Этот подход масштабируется, потому что шаблоны детерминированы для модели, тогда как рекомендации размыты и смещаются с обновлениями модели. Если вы используете ИИ для переноса кода между платформами, инвестируйте в архитектуру, которая позволяет модели делать то, что у нее получается лучше всего: сопоставление шаблонов.