코드 패턴이 AI 가이드라인을 이겼다: Firefox 확장 프로그램을 Chrome으로 포팅하기

r/ClaudeAI의 한 개발자가 AI 코딩 에이전트를 사용한 크로스 브라우저 확장 프로그램 구축에 관한 구체적인 사례 연구를 공유했습니다. 프로젝트는 사람이 안내한 아키텍처로 구축된 Firefox 확장 프로그램이었습니다. AI 프롬프트를 통해 Chrome으로 포팅하려는 두 번의 시도는 실패했습니다. 근본 원인은 프롬프트가 훈련 격차를 보완했지만 모델 버전에 결합되어 확장 시 성능이 저하되었기 때문입니다.

해결책은 브라우저에 독립적인 로직을 BrowserShell 인터페이스를 가진 핵심 패키지로 추출하는 것이었습니다. 각 확장 프로그램은 얇은 셸이 되었고, Chrome 버전의 최종 코드는 Firefox 버전과 단 5줄의 의미 있는 차이만 있었습니다. 핵심 통찰은 코드 패턴이 추상적인 지침보다 낫다는 것입니다. 명확하고 테스트 가능한 코드베이스는 모델이 패턴을 안정적으로 복제할 수 있게 하는 반면, 추상적인 프롬프트는 모델의 훈련 분포와 싸우게 됩니다. Humble Object 패턴은 경계 코드를 얇게 유지합니다.

실용적인 요점

• tabs, storage, messaging과 같은 API를 추상화하는 브라우저 중립적 핵심(예: BrowserShell)을 정의하세요.
• 플랫폼별 어댑터(예: FirefoxShell, ChromeShell)로 해당 인터페이스를 구현하세요.
• AI에게 규칙을 나열하는 대신 기존 패턴을 따르도록 프롬프트하세요. 작동하는 어댑터를 보여주고 새 브라우저에 대해 패턴을 복제하도록 요청하세요.
• 테스트 가능성에 집중하세요. 핵심 로직은 브라우저 API 없이도 단위 테스트가 가능해야 합니다.

이 접근 방식은 패턴이 모델에 대해 결정론적인 반면, 지침은 모호하고 모델 업데이트에 따라 변동하기 때문에 확장 가능합니다. AI를 사용하여 플랫폼 간에 코드를 포팅하는 경우, 모델이 가장 잘하는 패턴 매칭을 수행할 수 있는 아키텍처에 투자하세요.