우리는 번역 인프라를 팔아요. 우리 마케팅 사이트도 5개 로케일로 나가고요. 실제로 서비스 중인 JSON을 감사했더니 가장 먼저 걸린 건 톤 문제가 아니었어요. 얼핏 보면 멀쩡한 독일어 복합어 안에 문자 하나가 잘못 들어가 있었어요. 라틴 문자가 와야 할 자리에 키릴 문자가 있었던 거예요. 코드 포인트를 확인하기 전까지는 그냥 정상적인 용어처럼 보였어요. 우리 번역조차 이렇게 깨져 있다면, 누가 이 제품을 믿겠어요?
배포되면 안 됐던 실패 5가지
독일어 UI 문구에 섞인 키릴 문자. 용어집의 한 줄에 서로 다른 문자 체계가 섞여 있었어요. 접미사가 라틴 문자 “ar”처럼 보였지만 한 글자는 아니었어요. 원어민은 바로 알아채요. 맞춤법 검사는 못 잡고요.
**The string:** …"Übersetzungsglossар"… (Cyrillic "р" in the compound)
**What it should be:** "Übersetzungsglossar"
**Why it matters:** It reads as corrupted text. It signals automated output nobody proofread in the target language.
독일어와 프랑스어의 말투 뒤바뀜. 이 사이트는 개발 도구예요. 말투는 엔지니어가 실제 제품 UI에서 쓰는 방식이어야 하고요. 그런데 de와 fr 전체에 격식체를 배포했어요. 사소한 문제가 아니에요. 기본 번역 경로가 일부 예외 문자열이 아니라 전체 화면에서 잘못된 말투를 골랐다는 뜻이에요.
**The string:** "… wie Sie …" / "vous pouvez …"
**What it should be:** informal "du" / "tu" voice for product and FAQ
**Why it matters:** Every screen sounded like enterprise procurement, not like the product we sell to vibe coders.
통화 불일치. 영어 원문에는 독일어 버전과 다른 통화가 표시됐고, 독일어 버전에는 월 단위 라벨이 표시됐어요. 우리는 국가별로 다른 가격을 청구하지 않고, 모든 가격은 EUR 기준이에요. 그런데 JSON은 그렇지 않은 것처럼 보였어요.
**The string:** "20 €/Monat" (and similar) next to "$20/mo" elsewhere
**What it should be:** one USD amount, formatted per locale via code (e.g. Intl), not hand-invented symbols in JSON
**Why it matters:** Pricing trust. Mixed symbols read as either a bug or a hidden price change.
“coding”을 인코딩으로 오해한 번역. 세 언어에서 “coding environment”가 인코딩을 뜻하는 단어로 번역됐어요. FAQ가 “인코딩 환경”에 머물러도 된다고 안내한 셈이에요. 제품을 어떻게 읽어도 틀린 말이에요.
**The string:** Spanish "codificación", Italian "codifica", German "Codierung" in the wrong sense
**What it should be:** development environment wording (e.g. entorno de desarrollo / ambiente di sviluppo / Entwicklungsumgebung)
**Why it matters:** It is a semantic bug. It reads like we do not understand our own domain.
“Ship”을 택배 배송으로 읽은 번역. 독일어와 이탈리아어 문자열에는 소프트웨어 릴리스가 아니라 소포를 떠올리게 하는 동사가 쓰였어요. 영어 원문은 같은데 어휘 영역이 틀렸어요. 의도한 스타일 선택이 아니라, 고치지 않은 기계 번역 제안에서 나온 결과였어요.
**The string:** parcel-shipping verbs applied to "ship your app"
**What it should be:** release / deploy / deliver software wording
**Why it matters:** Developer trust. One wrong verb tells the reader the copy was never read by a developer in that language.
자동 생성 번역이 어긋나는 이유
번역가를 탓하려는 게 아니에요. 사이트 대부분은 문자열마다 사람이 검수한 적이 없어요. 범용 모델은 기본적으로 격식체를 써요. 웹에 있는 대량의 이중 언어 텍스트가 그런 모양이니까요. 목표가 “올바른 문자 체계”가 아니라 “그럴듯한 문자”일 때는 문자 체계가 다른 유사 글자도 섞어 쓰고요. 용어집이 없으면 인접한 키 사이에서 단어 선택이 흔들려요. 통화 규칙이 없으면 모델은 그럴듯한 현지 기호를 지어내요. 도메인 검사가 없으면 인코딩과 코딩이 뒤섞이고요. 우리가 줄이려는 실패 방식이 바로 이거예요. 그런데 우리 사이트도 고객 입장에서 직접 점검해 보기 전까지는 그대로 나가고 있었어요.
정리한 뒤에 만든 것
문구를 한 번 고친다고 시스템이 되는 건 아니에요. 오래가는 건 팀 전체와 이후의 자동 번역 배치가 규칙으로 따를 작은 정책 파일, 그리고 머지 전에 돌릴 수 있는 검증 스크립트예요.
정책. i18n/LOCALIZATION_POLICY.md에는 로케일별 말투, JSON의 USD 전용 가격 표기, 외래어 결정(예: vibe coders는 영어 그대로 유지), coding과 encoding의 false friend 규칙, 인라인 리터럴 타이포그래피가 적혀 있어요. 일부러 짧게 썼어요. 적어 두지 않은 규칙은 모델이 일관되게 추론하지 못하니까요.
## Currency
- USD only in all locales. Use {monthlyPrice} and {overageRate} placeholders…
## False friends
- Coding environment is not encoding: Spanish desarrollo / Italian sviluppo / German Entwicklung…
검증. scripts/verify-translations.sh은 라틴 계열 로케일 파일의 키릴 문자, 유로 기호, 예전 false friend 부분 문자열을 grep으로 찾고, 가격 플레이스홀더가 messages/en.json과 일치하는지도 확인해요. ripgrep이 설치돼 있으면 선택 검사에 사용해요. 이 스크립트는 최소 기준일 뿐 상한이 아니에요. “한 번 고쳤으니 됐다”가 다음 대량 수정에서 조용히 무너지지 않게 하려고 만들었어요.
JSON 추측 대신 코드로. 화면에 나오는 USD 금액을 lib/pricing.ts에 모으고 formatUsdPerMonth와 formatUsdOveragePer1k를 홈페이지와 FAQ에 연결해서, 로케일 파일이 숫자를 지어내지 못하게 했어요. 문제는 잘못된 문자열만이 아니었어요. 규모를 키우기 전에 정책과 포맷터를 갖추지 않았던 게 진짜 문제였어요.
AI의 도움을 받는 i18n에 훔쳐 가도 좋은 것들
모델로 번역을 생성한다면 말투가 가장 변동이 큰 변수예요. 언어를 더 늘리기 전에 로케일별로 말투를 고정하세요. 통화는 문구가 아니라 코드에서 고정하고, 브랜드 토큰과 개발자 용어도 고정하세요. “나중에 눈으로 확인하자”고 하지 말고, 자동 검사가 배치를 실패시키게 하세요. 나중에 하는 확인은 처음 작업할 때만큼의 품질 기준을 지키지 못해요.
이 감사의 밑바탕이 된 아키텍처는 AI로 만든 앱을 현지화하는 방법에서, 도구 비교는 globalize.now vs Lokalise vs Crowdin에서 볼 수 있어요. 직접 운영하는 저장소에 i18n을 붙이면서 같은 안전장치를 쓰고 싶다면 globalize.now에서 저장소를 연결하세요. 변환은 앱에서 한 번만 실행돼요. npx skills add globalize-now/globalize-skills는 코드 옆에 설치되는 Skill용으로 문서화한 진입점이에요. 솔직하게 마무리하면, 우리는 직접 만든 것을 직접 써 보며 골치 아픈 버그를 찾았고, 정책을 쓰고, 검사 게이트를 추가했어요. 모든 다국어 출시가 이 정도 기준은 넘어야 한다고 생각해요.
globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.
globalize.now 무료로 시작하기