에이전트는 UI 문자열 후보 28개를 추출하고, 여러 파일에 걸친 번역 항목 41개를 재작성하고, 미들웨어와 라우팅을 설정하고, 대상 언어 5개의 로케일 파일을 생성했어요. 설정, 전환, 번역까지 처음부터 끝까지 약 90분이 걸렸어요. globalize.now는 AI 기반 현지화 인프라예요. 실제로 어떤 결과가 나오는지 보려고 프로덕션 모노레포에서 돌려 봤어요. 잘 다듬은 데모도, 안전장치도 없이 복잡도까지 그대로인 실제 코드베이스로요.

이 코드베이스는 선도적인 번역 관리 플랫폼에서 10년 넘게 아키텍트로 일한 현지화 업계 베테랑의 프로젝트였어요.

모노레포에는 무엇이 들어 있었나요?

튜토리얼용 프로젝트가 아니었어요. 이 모노레포에는 Next.js 웹 애플리케이션, Android 앱, MCP 서버, 서드파티 서비스로 렌더링되는 문서가 들어 있었어요. 개발자는 매일 Claude Code를 쓰고 AI 도구로 처음부터 끝까지 개발하며, 전체 스택을 3개월 만에 구축했어요.

대상은 Next.js 프론트엔드였어요. Android 앱, MCP 서버, Mintlify로 만든 문서 사이트는 건드리면 안 됐죠. 핵심은 AI 에이전트가 따로 알려 주지 않아도 이걸 알아서 판단할 수 있느냐였어요.

충분히 가능했어요. 에이전트는 전체 저장소를 스캔한 뒤 Next.js 애플리케이션에 집중했어요. 실제로는 범위를 따로 지정할 필요가 없었지만, 개발자는 마음 편하게 쓰려면 “/apps/web만 변환” 같은 지정 기능이 있으면 좋겠다고 했어요. 맞는 지적이라 추가를 검토할 만해요. 다만 이 때문에 전환이 막히지는 않았어요.

설정은 어떻게 진행했나요?

개발자는 과정을 이해하려고 가이드 모드를 선택했어요. 설정에서 정한 건 다섯 가지예요. 패키지 매니저(레거시 PNPM 락 파일이 있었지만 NPM), 카탈로그 형식(주석을 지원해서 권장되는 PO/GetText), 설정 모드(가이드), 소스 언어(영어), 대상 언어(스페인어, 이탈리아어, 헝가리어, 체코어, 슬로바키아어)예요.

짚고 넘어갈 점이 하나 있어요. 현지화에 깊은 전문성이 있는 사람조차 카탈로그 형식을 묻는 질문에서 망설였어요. 그의 반응은 단호했어요. 사용자에게 물어볼 만큼 중요한 선택이 아니라는 거예요. 자동으로 정하라고요.

라우팅 전략은 경로 기반으로 정했어요. 개발자에게 추가 도메인이 없어서 도메인 기반 라우팅은 쓰지 않았어요. 이 앱은 OAuth 기반 인증을 쓰기 때문에 로그인 흐름은 의도적으로 영어로 유지했고, 에이전트도 이를 정확히 처리했어요.

전환 단계에서는 실제로 어떤 일을 하나요?

여기가 핵심이에요. 에이전트는 Next.js 앱 전반에서 UI 문자열 후보 28개를 찾아내고 번역 항목 41개를 처리했어요. 파일 구조를 정리하고, 미들웨어를 수정하고, 컴포넌트 import를 고치고, 대상 언어 5개의 PO 로케일 파일을 생성했어요.

전환 단계만 약 30분이 걸렸어요. 앞선 설정과 구성, 그리고 이후 개발자가 직접 마친 번역 연결까지 합치면 전체 과정은 90분에 가까웠어요. 즉시 끝나는 건 아니에요. 참고로 페이지가 몇 개 안 되는 단순한 앱은 전체 과정이 15분 안에 끝나요. 번역 대상 화면이 수십 개인 복잡한 앱은 더 오래 걸리고요. 시간은 저장소 크기가 아니라 문자열 수에 비례해요.

전환 단계가 실행되는 걸 지켜본 개발자는 이렇게 말했어요. 문자열 추출과 코드 재작성이 가장 힘든 일이고, 개발자가 가장 하기 싫어하는 작업이라고요. 이전 직장인 선도적인 TMS 기업에서도 저장소의 번역 파일은 빙산의 일각이었고, 진짜 고통은 준비와 국제화 작업이었다고 해요. AI 에이전트가 바로 그 부분을 처리했어요.

i18n을 수동으로 해 본 개발자라면 누구나 하는 얘기와 같아요. 번역 자체를 불평하는 사람은 없어요. 문자열을 t() 호출로 감싸려고 파일 40개를 고치고, 의미 있는 키를 만들고, import를 재구성하고, 미들웨어를 설정하는 일을 불평하죠. globalize.now가 자동화하는 작업이 바로 이거예요.

처음부터 끝까지 실제로 동작했나요?

네, 끝까지 잘 동작했어요. 라이브 세션이 끝난 뒤 개발자는 나머지 단계를 직접 마무리했어요. globalize.now Git 브랜치를 게시하고, 앱을 웹 플랫폼에 연결하고, 모니터링 대상을 globalize.now 브랜치로 설정한 다음, 파일이 업로드되고 번역도 올바르게 됐는지 확인했어요.

체코어 번역 품질에 대한 그의 평가는 거의 완벽하다는 거였어요. 평생 현지화 결과물을 전문적으로 평가해 온 사람의 말이에요. 의례적인 칭찬이 아니라, 만만치 않은 언어 쌍에서 프로덕션에 쓸 수 있는 품질이라고 도메인 전문가가 확인해 준 거예요.

개발자는 전체 흐름을 직접 마친 뒤 웹 앱에서 문제 두 가지를 짚었어요. 첫째, 번역 작업이 백그라운드에서 실제로 실행 중이었는데도 저장소를 다시 스캔하면 “i18n 파일을 찾을 수 없음”이라고 표시됐어요. 실제 실패가 아니라 오해를 부르는 UI 상태예요. 둘째, 명시적인 동의 없이 번역 작업이 시작됐어요. 크레딧이 소모되는 작업은 반드시 확인을 받아야 해요. 둘 다 타당한 UX 문제이고, 개선 중이에요.

무엇이 잘못됐나요?

문제가 생긴 부분이 있었어요. 실제 테스트였던 만큼 솔직하게 공개할게요.

설치 명령(npx skills add globalize-now/globalize-skills)이 Windows PowerShell에서 실패했어요. 이 도구를 Windows에서 테스트한 건 처음이었어요. Google이 이메일 첨부를 막아서 스킬을 zip 파일로 만들어 Swiss Transfer로 보내야 했어요. 실제 작업을 시작하기 전까지 설정에서만 약 15분이 걸렸어요.

전환 도중 ES 모듈과 CommonJS 충돌이 발생했어요. 프로젝트는 CommonJS를 쓰는데 에이전트가 한 곳에서 ES 모듈을 가정한 코드를 출력했어요. 진행을 막을 정도는 아니었지만, 설정 단계에서 감지해 미리 처리해야 하는 문제예요.

세션이 끝날 무렵 globalize.now 웹 앱에서 GitHub 저장소를 연결하자 빈 페이지가 나왔어요. 개발자는 Opera를 쓰고 있었어요. 로그인 화면도, 오류도, 내용도 없었어요. 해결하기 전에 세션이 끝났어요.

버그는 세 가지였고, 모두 실제 문제예요. 모두 수정했거나 수정 중이에요.

문자열 추출이 진짜 병목인 이유는 뭔가요?

i18n을 다룬 글은 대부분 번역 품질, 프레임워크 설정, TMS 기능 비교에 초점을 맞춰요. 개발자가 실제로 시간을 잃는 지점은 놓치고 있어요.

기존 코드베이스에 국제화를 추가하려면 모든 컴포넌트에서 하드코딩된 문자열을 스캔하고, 번역할 문자열을 가려내고, 의미 있는 번역 키를 만들고, 문자열마다 알맞은 t() 또는 <Trans> 호출로 감싸고, 파일 트리 전체의 import를 고치고, 초기 로케일 파일을 만들고, 라우팅 미들웨어를 설정해야 해요. 모노레포라면 코드베이스의 어느 부분에 i18n이 필요한지 가려내는 일까지 더해져요.

지루하고 실수하기 쉬운 이 작업은 AI 에이전트가 특히 잘하는 일이에요. 이 과정을 지켜본 개발자는 이렇게 정리했어요. 개발자 입장에서 이게 가장 힘든 일이었고, 큰 짐을 덜었다고요. AI 도구로 개발하는 vibe coder도 이제 글로벌 진출에서 가장 고된 부분을 건너뛸 수 있어요.

모노레포 범위 지정에서 무엇을 배웠나요?

에이전트는 모노레포 범위를 암묵적으로 처리했어요. 따로 지시하지 않았는데도 Next.js 웹 앱에 집중하고 Android 코드, MCP 서버, Mintlify 문서는 무시했어요. 대부분의 경우 올바른 동작이에요.

하지만 암묵적인 범위 지정과 명시적인 범위 지정은 달라요. 개발자는 “내 Next.js 앱만 변환”을 설정 단계에서 지정할 수 있기를 원했어요. 고객용 앱과 관리자 대시보드처럼 웹 프론트엔드가 여러 개인 모노레포라면 어느 프론트엔드를 먼저 국제화할지 정밀하게 제어하고 싶을 거예요.

이건 우리가 메우고 있는 제품 공백이에요. 지금은 에이전트가 실제로 올바르게 처리하지만, 특히 수십 개 파일을 건드리는 전환이라면 명시적인 범위 지정을 설정 단계로 두는 게 맞아요.

수동 i18n 설정과 비교하면 어떤가요?

이 정도 복잡도의 코드베이스에서 수동으로 i18n을 설정하면 며칠이 걸려요. 단계 하나하나가 어려워서가 아니라, 수십 개 단계마다 신경을 써야 해서예요. 문자열 하나를 놓치면 반쯤만 번역된 페이지가 배포돼요. 키 이름을 잘못 지으면 중복 항목이 생겨 몇 달 동안 발목을 잡아요. 미들웨어 수정을 빠뜨리면 로케일 라우팅이 조용히 깨져요.

AI 에이전트는 같은 작업을 처음부터 끝까지 약 90분 만에 마쳤어요. 업계에서 수천 건의 i18n 구현을 봐 온 개발자가 우아하다고 평가했어요.

AI 도구로 개발하는 개발자에게는 언어를 언제 추가할지의 계산이 달라져요. i18n 설정에 일주일이 걸린다면 제품-시장 적합성을 확인할 때까지 미루겠지만, 90분이면 첫날부터 다국어로 출시할 수 있어요.

이 과정을 globalize.now가 처리해요. 저장소를 연결하면 앱에서 전환이 한 번 실행되고, 이후 작업은 에디터에서 npx skills add globalize-now/globalize-skills Skill이 이어받아요. 작동 방식은 globalize.now에서 확인해 보세요.

globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.

globalize.now 무료로 시작하기