CLI 하나를 설치하고 Cursor에 프롬프트 한 번만 보내면, 영어로만 된 JSX였던 Next.js 프로젝트가 [locale] 라우팅, 자동 생성된 키, 푸시마다 돌아가는 자동 동기화까지 갖춘 다국어 앱으로 바뀌어요. globalize.now는 Cursor가 건너뛴 i18n 작업을 맡는 AI 기반 현지화 인프라예요. 하드코딩된 문자열을 추출하고, next-intl 키와 로케일 파일을 생성하고, Git 푸시마다 번역을 동기화해요. 아래 과정은 표준 App Router 프로젝트를 기준으로 해요. 테스트 저장소에서 걸린 총 시간은 13분 40초였어요.
Cursor로 Next.js UI를 만들면 정확히 뭐가 문제일까요?
Cursor는 아키텍처가 아니라 동작하는 UI에 맞춰 최적화해요. 자연어 지시로 코드를 생성하고 프롬프트로 코드 일부를 수정하기 때문에, JSX도 사람이 빠르게 프로토타입을 짤 때처럼 나와요. 텍스트는 인라인으로 박히고, 키도 로케일 파일도 [locale] 세그먼트도 없어요.
Cursor가 생성한 전형적인 Next.js 페이지는 이렇게 생겼어요.
// app/page.tsx
export default function Home() {
return (
<main>
<h1>Welcome to Acme</h1>
<p>Get started in seconds.</p>
<button>Sign up</button>
</main>
)
}
페이지 하나에만 하드코딩된 문자열이 3개예요. 실제 앱은 수십 개 컴포넌트에 걸쳐 수백 개가 있어요. Pages Router에는 내장 i18n 설정이 있었지만, App Router가 기본이 되면서 사라졌어요. 그래서 미들웨어, 동적 라우트 세그먼트, next-intl 같은 외부 라이브러리 연결을 개발자가 직접 해야 해요. Cursor의 기본 동작은 이 중 어느 것도 대신 해주지 않아요.
결과는 Lovable 앱의 번역이 배포할 때마다 깨지는 이유에서 다룬 패턴 그대로예요. 코드베이스가 커질수록 하드코딩된 문자열이 쌓이고, “다음 달에 스페인어 추가하자”는 몇 주짜리 리팩터링으로 바뀌어요.
Cursor 프로젝트에 globalize.now를 어떻게 설정하나요?
globalize.now에서 저장소를 연결하세요. 첫 변환은 앱에서 한 번만 실행돼요. 저장소를 읽고, 하드코딩된 문자열을 키로 바꾸고, 검토할 PR을 열어요. 이후 푸시부터는 새로 추가된 내용만 번역해요.
첫 변환을 Cursor에서 진행하려면 프로젝트 루트에서 Skill을 설치하세요.
npx skills add globalize-now/globalize-skills
CLI가 스택을 감지하고, Cursor에 맞는 프리셋을 골라 에이전트 규칙을 프로젝트에 설치해요. Next.js 16 App Router 프로젝트에서는 출력이 이렇게 나와요.
✓ Stack detected: Next.js 16 (App Router)
✓ Editor detected: Cursor
✓ Preset selected: globalize-guide + next-intl
✓ Installed 4 skill files to .cursor/rules/
Done in 1.2s
Skill 파일은 기존 Cursor 규칙 옆에 놓여요. 문자열을 어떻게 추출할지, next-intl 컨벤션에 맞는 키를 어떻게 만들지, [locale] 라우트 세그먼트를 어떻게 연결할지 Cursor 에이전트에 알려줘요. 모든 작업은 로컬에서 이뤄지고, 코드는 업로드되지 않아요.
Cursor 대신 Claude Code나 Codex를 쓴다면 CLI가 해당 도구용 Skill 파일을 설치해요. 이후 흐름은 똑같아요.
에이전트는 Cursor 코드베이스에서 하드코딩된 문자열을 어떻게 추출하나요?
Cursor의 에이전트 패널을 열고 프롬프트를 하나 보내세요.
Set up i18n for this project. Use English, Spanish, German, and Arabic.
에이전트는 설치된 규칙을 불러오고 app/와 components/ 디렉터리를 스캔한 뒤 결과를 보고해요. 12페이지짜리 마케팅 사이트라면 보통 이런 보고서가 나와요.
Detected Next.js 16 with App Router.
Found 47 hardcoded strings across 12 components.
Best fit: next-intl. RTL required for Arabic.
Plan:
- Install next-intl
- Move app/* into app/[locale]/*
- Generate i18n/request.ts and middleware.ts
- Extract 47 strings to messages/en.json
- Convert JSX to useTranslations / getTranslations calls
Proceed? (y/n)
에이전트는 next-intl 문서가 가장 번거로운 부분이라고 말하는 작업을 해요. 미들웨어, 동적 라우트 세그먼트, 요청 설정, 그리고 번역 훅을 쓰도록 컴포넌트를 하나씩 변환하는 일이에요. 계획을 검토하고 확인하면, 에이전트가 여러 파일을 한 번에 수정해요. Cursor의 diff 보기에서 수락하거나 거절할 수 있어요.
next-intl 키와 로케일 파일은 어떻게 생성하나요?
계획을 승인하면 에이전트가 표준 next-intl 구조를 생성해요. 저장소에 네 가지가 새로 생겨요.
i18n/
request.ts
routing.ts
middleware.ts
messages/
en.json
es.json
de.json
ar.json
app/
[locale]/
layout.tsx
page.tsx
...
messages/en.json 안에서는 추출된 문자열 47개가 컴포넌트나 라우트별로 묶인 네임스페이스 키가 돼요.
{
"Home": {
"heading": "Welcome to Acme",
"lede": "Get started in seconds.",
"signupCta": "Sign up"
}
}
기존 page.tsx는 클라이언트 컴포넌트에서는 useTranslations, 서버 컴포넌트에서는 getTranslations를 쓰도록 다시 작성돼요. 구분은 자동이에요. 에이전트가 어떤 컴포넌트에 "use client" 지시어가 있는지 읽고 알맞은 훅을 골라요.
스페인어, 독일어, 아랍어 JSON 파일은 초벌 번역으로 생성되고, 이때 에이전트가 컴포넌트와 prop 이름에서 만든 용어집을 따라요. 브랜드 용어는 영어로 유지돼요. RTL 처리도 레이아웃에 포함돼요. dir 속성은 로케일에서 가져와 설정하고, 에이전트가 감지할 수 있는 곳에서는 고정된 left/right 유틸리티 대신 CSS 논리 속성을 써요.
프로덕션 모노레포에서 돌려본 AI 에이전트가 실제 모노레포를 국제화하면 어떻게 될까요?와 같은 end-to-end 방식이에요. 과정은 같고 입력만 달라요.
첫 실행 이후 Git 푸시 동기화는 어떻게 동작하나요?
첫 실행은 한 번뿐이고, 동기화는 계속 이어져요.
에이전트가 작업을 마치면 대시보드에서 저장소를 globalize.now에 연결하세요. 그때부터는 이렇게 동작해요.
Push to main
↓
globalize.now diffs against last synced state
↓
New hardcoded strings get extracted + keyed
↓
Translations generated for every configured locale
↓
PR opened with locale file updates
Cursor를 열어둘 필요도, Claude Code를 실행해둘 필요도 없어요. 동기화는 Git 레이어에서 일어나서, 다음 UI를 어떤 도구로 작성하든 상관없어요. 다음 주에 Cursor가 컴포넌트를 다시 생성해 버튼이 3개 늘어나도, 그 버튼들은 다음 PR에 번역된 채로 들어와요.
수동 내보내기도, 검토 대기열도, CSV 왕복도 없어요. globalize.now로 앱 글로벌화하기에서 소개한 약속 그대로예요. 한 번 설정하면 푸시마다 자동으로 동기화돼요.
이미 직접 만든 next-intl 설정이 있다면 어떻게 되나요?
에이전트가 기존 설정을 먼저 읽어요.
i18n/request.ts이 있으면 에이전트는 설정을 덮어쓰지 않고 그대로 따라요. messages/en.json에 이미 Pricing.heading가 있으면 새 키를 만들지 않고 그 키를 재사용해요. 네임스페이스 컨벤션이 Pricing.heading(PascalCase, 중첩) 대신 pricing.heading(소문자, 점 구분)이어도 그에 맞춰요.
에이전트가 하지 않는 일은 기존 로케일 파일을 조용히 덮어쓰는 것 하나뿐이에요. 키가 충돌하면 멈추고 물어봐요. 이 동작은 npx skills add globalize-now/globalize-skills이 설치하는 Skill 규칙에 들어 있어서 따로 설정할 필요가 없어요.
globalize.now가 이 작업을 처리해요. Next.js 저장소를 연결하면 변환이 앱에서 한 번 실행되고, 이후 에디터에서 하는 작업은 npx skills add globalize-now/globalize-skills Skill이 맡아요. 자세한 내용은 globalize.now에서 확인하세요.
globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.
globalize.now 무료로 시작하기