Nuxt.js에서 Next.js로 — 프론트엔드 기술 전환, 하네스 엔지니어링과 이해 부채

AI 요약

mediba의 프론트엔드 엔지니어 나카하타가 Nuxt.js에서 Next.js로의 기술 리플레이스 프로젝트에서 Claude Code를 활용한 사례를 공유했습니다. 완료 기한이 필수인 가운데 현행 개발 경험자가 없는 팀이 4명의 프론트엔드 엔지니어로 진행하며, 5년 이상 축적된 기술 부채를 AI 코딩으로 해결하고 있습니다. 하네스 엔지니어링(규칙·컨텍스트·피드백 설계)과 개발 흐름의 스킬화를 핵심 전략으로 삼았으며, 새로운 과제로 '이해 부채'에 주목했습니다.

핵심 포인트

• Nuxt.js → Next.js 리플레이스, CSR에서 SSR로 전환, 서비스 사양은 원칙적 불변
• Claude Code(Sonnet 5 중심) 활용, 4명의 프론트엔드 엔지니어가 전담
• rules 디렉터리(architecture/code/migration/test)와 약 100행 CLAUDE.md 운영
• ESLint·Prettier를 Claude Hook으로 실행, 개발 흐름 전체를 스킬화

향후 전망

• 마크다운 기반 문서 관리로 구현-문서 괴리 자동 검출·수정 기대
• AI 코딩 확산에 따라 '이해 부채' 관리가 새로운 핵심 과제로 부상