번역 파일이 어긋나는 이유는 두 시스템이 같은 데이터를 소유하는데 어느 쪽도 우위가 없기 때문이에요. 저장소는 개발자가 머지할 때 바뀌고, 번역 파일은 누군가 기억해서 갱신할 때 바뀌어요. 서로 다른 시계예요. 그 간격에 누락된 키, 고아 키, 오래된 문자열이 생겨요. globalize.now는 AI 기반 현지화 인프라로, 코드를 작성하는 시점에 키와 로케일 파일을 생성해서 이 간격을 없애요. 뒤처질 두 번째 시계가 없어요.

로케일 파일이 동기화에서 벗어나는 진짜 원인은 무엇인가요?

파일 하나는 작성하고 나머지는 유지보수하는데, 이 둘은 서로 다른 작업이에요.

기능을 만드는 개발자는 문자열이 들어갈 파일이므로 en.json를 수정해요. 다른 로케일은 다른 사람의 문제이고, 다른 사람의 일정이에요. 이 패턴을 DEV에 쓴 한 개발자는 실패의 두 가지 모양을 설명했어요. 영어 파일에만 키가 추가되고 다른 파일에서는 잊혀서 앱 일부가 조용히 영어로 폴백되는 경우, 그리고 한 로케일에서는 키가 삭제됐는데 다른 로케일에는 남아서 죽은 항목이 쌓이는 경우예요. 두 경우 모두 몇 주 뒤 고객 불만으로 발견돼요.

둘 다 번역 문제가 아니에요. 잘못 번역된 건 없어요. 문자열이 어디로도 전달되지 않았을 뿐이에요.

이 실패는 어떤 도구를 업그레이드해도 사라지지 않아요. 도구가 문자열이 만들어지는 지점의 하류에 있기 때문이에요. 문자열이 파이프라인에 들어가지 않으면 더 좋은 파이프라인도 도움이 안 돼요. 같은 근본 원인은 더 앞 단계에서도 나타나요. 코딩 에이전트가 키를 전혀 붙이지 않은 문자열을 작성할 때예요.

로케일 파일에서 머지 충돌이 이렇게 자주 생기는 이유가 뭔가요?

기계가 쓰도록 만든 포맷의 생성 데이터를 사람이 직접 편집하기 때문이에요.

로케일 파일은 키와 문자열을 매핑한 평평한 맵이에요. 기능을 추가한 두 브랜치는 둘 다 이 맵에 항목을 덧붙이고, 보통 같은 위치 근처, 알파벳순으로 비슷한 자리에 넣어요. Git은 의미 구조를 이해할 수 없는 파일에서 인접한 줄 두 곳이 수정된 것으로 보고, 사람에게 해결을 요청해요.

충돌을 해결하는 사람은 대상 언어를 읽지 못하는 개발자예요. 안전한 선택은 양쪽을 모두 남기는 건데, 이렇게 해서 중복 키가 생겨요. 빠른 선택은 한쪽만 남기는 건데, 이렇게 해서 번역이 조용히 삭제돼요.

락파일의 충돌을 손으로 해결하는 사람은 없어요. 다시 생성해요. 로케일 파일도 사람이 쓰는 문서가 아니게 되는 순간부터 같은 대우를 받아야 해요.

번역이 리뷰에서 대기하는 동안 얼마나 낡아지나요?

제품을 설명하지 못할 만큼 낡아져요. 이는 공개적으로 측정할 수 있어요.

DevOps.com에 게재된 현장 보고서는 오픈 소스 프로젝트의 실제 현지화 PR 다섯 건을 따라가요. 가장 시사적인 사례는 Kilo Code PR #8377이에요. 자동 검사는 깨끗하게 통과했지만 메인테이너 리뷰는 한참 뒤에 도착했고, 그사이 저장소는 이미 달라져 있었어요. PR은 현재 아키텍처에 맞춰 다시 제출해 달라는 요청과 함께 닫혔어요. 같은 보고서에는 OpenClaw 이슈도 나와요. 자원봉사자들이 스페인어, 일본어, 포르투갈어, 한국어, 중국어, 베트남어 번역을 제안했지만 메인테이너는 이를 받아들일 방법이 없다고 답했어요.

이 사례들은 품질 보고서가 아니라 지연 보고서로 읽어야 해요. 번역은 작성했을 때는 맞았어요. 대기하는 동안 인터페이스가 바뀐 거예요.

현지화 도구를 비교할 때 아무도 값을 매기지 않는 비용이에요. 모두가 번역은 측정해요. 하지만 문자열이 이동 중에 얼마나 오래 머무는지, 그사이 인터페이스가 어떻게 바뀌는지는 거의 아무도 측정하지 않아요.

왕복 과정에는 실제로 얼마의 비용이 드나요?

번역보다 조율에 더 많이 들어요. 그래서 청구서만 봐서는 고통의 이유를 알 수 없어요.

눈에 보이는 비용은 단어당, 키당, 또는 좌석당으로 매겨져 한 달에 한 번 청구서에 찍혀요. 눈에 보이지 않는 비용은 따로 있어요. “어떤 파일을 고쳐야 하지?”라고 묻는 개발자, 읽을 수 없는 언어로 된 충돌을 해결하는 두 번째 개발자, 독일어 빌드에 키가 11개 빠진 걸 발견하는 세 번째 개발자, 5주 전에 자기가 쓴 문자열에 대해 질문받는 원래 기능 작성자까지요.

이 중 어느 것도 요금 비교표에는 나오지 않아요. 전부 개발자의 시간으로, 개발자 단가로, 스프린트마다 지불하고 있어요. 정가는 싸도 엔지니어 두 명이 매주 하루씩 쓰게 만드는 도구라면 저렴한 게 아니에요.

이 비용을 만드는 건 왕복 과정이에요. 문자열이 만들어지는 곳과 번역되는 곳 사이에서 파일을 옮기는 단계가 가장 비싸고, 어느 업체를 쓰든 그 비용은 그대로예요. 현지화가 계속 개발 루프 안쪽으로 올라오는 이유도 여기에 있어요.

코드를 작성하는 자리에서 키가 만들어지면 무엇이 달라질까요?

두 번째 시계가 사라지고, 드리프트가 생길 곳도 없어져요.

지금까지는 이런 순서였어요. 개발자가 하드코딩된 문자열을 쓰면, 누군가 나중에 찾아내고, 누군가 키를 만들고, 누군가 파일을 내보내고, 누군가 번역하고, 누군가 다시 가져와요. 이제는 이렇게 바뀌어요. 문자열을 기능과 같은 커밋에서 값이 있는 키로 작성하면, 번역은 거기서부터 이어져요.

globalize.now에서는 한 번의 변환으로 시작해요. 앱에서 저장소를 연결하면 기존 하드코딩된 문자열이 한 번에 키와 로케일 파일로 추출돼요. 그 뒤에는 에이전트 Skill 덕분에 Cursor, Claude Code 같은 코딩 에이전트가 처음부터 하드코딩 대신 키 기반 문자열을 작성하고, 푸시 작업이 새로 생기는 카탈로그 단위를 번역해요.

핵심은 ‘한 번’이에요. 어려운 부분은 변환이고, 변환은 딱 한 번만 일어나요. 그 이후는 예전엔 수작업이던 단계로, 코드와 같은 시계로 돌아가요. 이게 바로 현지화를 개발 워크플로 안에 두는 이유예요. 옆에 두는 게 아니라요.

런타임 라이브러리는 영향을 받지 않아요. i18next와 next-intl은 이전과 똑같이 로케일 파일을 읽어요. 번역을 제공하는 방식은 하나도 바뀌지 않고, 바뀌는 건 파일을 쓰는 주체뿐이에요.

드리프트와 진짜 번역 문제는 어떻게 구분하나요?

번역가가 그 문자열을 본 적이 있는지 따져 보세요.

독일어 파일에 키가 빠져 있다면 번역가가 잘못한 게 아니에요. 문자열이 번역가에게 도달하지 못한 거예요. 이건 라우팅 실패이고, 검토 단계를 더하면 오히려 악화돼요. 이미 지연이 문제인 프로세스에 대기 시간만 더하는 셈이니까요.

독일어 파일에 키가 있는데 문맥에 맞지 않는 표현이라면, 그건 진짜 번역 문제예요. 독일어를 할 줄 알고 문자열이 렌더링되는 위치를 볼 수 있는 사람이 필요해요. 이런 건 시간을 들일 가치가 있어요.

대부분의 팀은 첫 번째 유형이 두 번째보다 훨씬 많은데도 둘을 같은 문제로 취급해요. 그래서 현지화가 끝없이 느껴지는 거예요. 둘을 분리하면 작업량이 줄어요. 라우팅 쪽은 더 이상 사람이 할 일이 아니거든요. 이 구분은 팀이 작을수록 더 중요해서, 빠르게 출시하는 1인 개발자와 소규모 팀에서 특히 뚜렷하게 드러나요.

간단한 테스트가 있어요. 최근 현지화 버그 10건 중 몇 건이 틀린 표현이고 몇 건이 빠진 표현이었는지 세어 보세요. 대부분 빠진 쪽이라면 번역 문제가 아니에요. 배관 문제이고, 배관은 판단과 달리 자동화할 수 있어요. 현지화에 실제로 얼마를 써야 하는지 따질 때도 같은 논리가 적용돼요.

로케일 파일 드리프트는 번역 문제의 탈을 쓴 라우팅 문제예요. 저장소를 한 번 연결하면 라우팅은 더 이상 직접 챙길 일이 아니에요.

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

globalize.now 무료로 시작하기