발견: 준용 (PR 리뷰) · 해결: PR #10 (bc1592c)

증상: npm install 실행 시 eslint 관련 ERESOLVE 에러 발생. --legacy-peer-deps 플래그 없이는 설치 불가.

npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! Could not resolve dependency: eslint@...

신규 팀원이 프로젝트 클론 후 환경 셋팅 시 즉시 실패하는 상황.

원인: eslint 관련 패키지 간 peer dependency 버전 충돌. Next.js가 요구하는 eslint 버전과 프로젝트의 eslint-config 패키지가 요구하는 버전이 호환되지 않았음.

해결: PR #10에서 패키지 버전 호환성 수정. --legacy-peer-deps 없이 정상 설치되도록 함.

교훈:

• 패키지 추가 시 클린 상태에서 npm install 정상 동작 확인 필수
• --legacy-peer-deps는 임시 우회일 뿐, 근본 해결 필요