Chrome 확장 MV3 AGENTS.md 만들기

브라우저 확장 프로그램은 popup UI, background 로직, content scripts, manifest permissions가 각각 다른 실패 지점을 가집니다.

이 프리셋은 extension surface, 패키징, 권한 민감 변경에 대해 더 단단한 계약을 제공합니다.

저장소를 일반 웹앱처럼 다루지 않고 MV3 제약을 존중하는 에이전트 가이드가 필요할 때 적합합니다.

대표 명령

  • 설치: npm install
  • 개발: npm run dev
  • 린트: npm run lint
  • 타입체크: npm run typecheck
  • 빌드: npm run build:extension
  • 테스트: npm run test

대표 금지 사항

  • 원격 코드 로딩이나 eval류 동작을 추가하지 않습니다.
  • 기능에 필요한 범위를 넘는 host permissions를 요청하지 않습니다.
  • 권한 변경을 무관한 커밋 속에 숨기지 않습니다.

왜 이 프리셋에는 맞춤 가이드가 필요한가

Manifest V3 저장소는 권한과 surface 경계를 분명히 적어 두어야, 위험한 확장 변경이 평범한 UI 작업 속에 숨지 않습니다.