.claude/agents/reviewer.md

@@ -28,6 +28,32 @@ maxTurns: 12
 4. 미사용 코드 — 미사용 import, 변수, 함수
 5. 팀 정책 — team-policy.md 위반 사항
 6. 일관성 — 기존 코드 패턴과의 불일치
+7. import/export 정합성 — default import와 named export 불일치 검증 (아래 상세 절차 참고)
+
+## import/export 정합성 검증 절차
+
+tsc는 `esModuleInterop` 덕분에 통과하지만 Vite/Rollup 프로덕션 빌드에서 실패하는 케이스를 잡는다.
+
+**검증 대상**: 변경된 파일 중 `import ... from` 구문이 포함된 모든 파일
+
+**검증 방법**:
+1. 변경 파일에서 `import <식별자> from '<경로>'` (중괄호 없는 default import) 패턴을 추출한다
+2. 해당 `<경로>` 모듈을 열어 `export default`가 실제로 존재하는지 확인한다
+3. 모듈이 `export const <식별자>` (named export)만 제공하면 **FAIL** — `import { <식별자> } from` 으로 수정 필요
+
+**판정 기준**:
+- `export default` 없는 모듈을 default import → **FAIL (Critical)** — 빌드 실패 유발
+- `export default` 있는 모듈을 default import → PASS
+- `import { ... } from` (named import) → 검증 불필요
+
+**실전 예시** (프로젝트에서 발생했던 사례):
+```typescript
+// ❌ FAIL — api.ts에는 export default 없음
+import api from '@common/services/api';
+
+// ✅ PASS — named import
+import { api } from '@common/services/api';
+```
 
 ## 출력 형식