Lovable은 세 곳에서 i18n 규칙을 읽어요. 항상 컨텍스트에 있는 워크스페이스·프로젝트 Knowledge, 프롬프트가 설명과 일치할 때만 로드되는 Skill, 그리고 연결된 저장소의 지침 파일이에요. 저장소에서는 루트의 AGENTS.md를 대화 길이와 상관없이 읽어요. 규칙을 엉뚱한 곳에 두면, 지난주에 번역해 둔 앱도 다음 기능은 영어로 배포돼요. globalize.now는 AI 기반 현지화 인프라라서 이런 실수의 결과를 많은 Lovable 저장소에서 보게 되는데, 해결의 핵심은 어느 시점에 어느 경로를 읽는지 아는 거예요.

번역해 둔 Lovable 앱이 왜 다시 영어로 돌아갈까요?

앱을 다국어로 만든 지침이, 에이전트가 다음 컴포넌트를 쓰는 시점에 눈앞에 없었기 때문이에요. Lovable은 지금 화면에 있는 프롬프트만 풀어요. 프롬프트가 “후기 섹션 추가해 줘”인데 컨텍스트 어디에도 “사용자에게 보이는 모든 문자열은 <Trans>를 거쳐야 한다”는 말이 없으면, 새 프로젝트에서와 똑같이 제목이 리터럴로 들어가요.

이건 코드를 카탈로그가 따라가지 못하는 문제와는 달라요. 그쪽은 Lovable 앱의 번역이 배포할 때마다 깨지는 이유에서 다룬 동기화 실패예요. 동기화는 래핑된 문자열을 로케일 파일로 옮기는 일이라서, 애초에 래핑되지 않은 문자열은 옮길 수 없어요. 더 앞단의 질문은 Lovable이 코드를 쓰는 순간 무엇을 읽고 있었느냐인데, Lovable 문서는 이 부분을 꽤 구체적으로 설명하고 있어요.

Lovable은 코드를 수정하기 전에 실제로 무엇을 읽나요?

Lovable의 Knowledge 문서에 따르면 프로젝트 Knowledge, 워크스페이스 Knowledge, 그리고 Git 저장소의 AGENTS.md나 CLAUDE.md 같은 지침 파일이 모두 프로젝트 코드와 함께 에이전트를 안내해요. Skill은 별도이고 필요할 때 로드돼요.

i18n 관점에서 중요한 차이는 세 가지예요.

읽는 시점. Knowledge는 모든 메시지에 포함돼요. Skill은 요청이 설명과 일치할 때만 포함돼요. 루트의 AGENTS.md는 Lovable의 표현대로 세션 길이와 상관없이 항상 읽어요.

긴 채팅에서의 지속성. Lovable 문서에는 컨텍스트가 많은 아주 긴 대화에서 Knowledge 지침이 항상 일관되게 지켜지지는 않을 수 있다는 단서가 명시돼 있어요. 같은 문서가 루트 AGENTS.md에 대해서는 반대로 말해요. 이 비대칭이 이 글을 쓴 이유예요.

편집 권한. 워크스페이스 Knowledge는 소유자와 관리자만 수정할 수 있어요. 프로젝트 Knowledge는 프로젝트 편집 권한이 있는 사람이면 누구나 수정할 수 있고요. 저장소 파일은 푸시할 수 있는 사람이면 누구든 수정할 수 있는데, Lovable 에이전트도 여기에 포함돼요.

Knowledge는 레벨마다 최대 10,000자까지 담을 수 있어요. 안내 한두 줄을 두기에는 충분하지만, 아키텍처 메모, 데이터베이스 스키마, 브랜드 보이스까지 함께 넣으면 전체 규칙을 담기에는 턱없이 부족해요.

그럼 i18n 규칙은 어디에 둬야 할까요?

저장소에 두고, Knowledge에는 짧은 안내만 남기세요. 위에서 본 차이를 따라가면 자연스럽게 나오는 결론이에요.

저장소 루트의 AGENTS.md에 전체 규칙을 담으세요. 세션 길이와 상관없이 모든 메시지에서 읽히고, Git에 있어서 새 채팅이나 새 협업자, 다른 에이전트로 옮겨 가도 유지돼요. 글자 수 제한도 없어서 프로젝트의 다른 컨텍스트와 자리를 다투지 않아요. lovable-i18n Skill이 설정을 실행하면 세 번째 단계에서 바로 이 파일을 작성해요. <!-- lovable-i18n:rules:start -->와 <!-- lovable-i18n:rules:end --> 마커 사이에 Lingui 규칙 블록을 두고, 파일이 없으면 만들고, 있으면 덧붙이고, 다시 실행하면 마커 사이만 교체해서 중복되지 않아요.

프로젝트 Knowledge에는 두 줄짜리 안내를 넣으세요. 예를 들면 이런 식이에요.

Localization
- This app is localized with Lingui. Every user-visible string is wrapped
  (<Trans>, t``, msg``) and new strings are appended to src/locales/*/messages.po.
- The full rules are in AGENTS.md at the repo root. Follow them on every edit.

이 안내는 문서가 경고하는 상황을 위한 안전장치예요. 긴 대화에서 Knowledge 블록의 효과가 희석돼도 에이전트에게는 저장소 파일이 남아 있고, 어떤 이유로 저장소 파일이 컨텍스트에 없더라도 안내가 제약을 알려 줘요. 경로는 둘이고, 규칙은 하나예요.

워크스페이스 Knowledge는 모든 프로젝트가 같은 라이브러리를 쓸 때만 쓰세요. 워크스페이스 Knowledge는 워크스페이스의 모든 프로젝트에 적용되고, 워크스페이스당 하나뿐이에요. 프로젝트의 절반은 Lingui이고 나머지 절반은 다른 라이브러리라면, 워크스페이스 수준의 Lingui 규칙은 절반에게는 틀린 규칙이에요. 어차피 충돌하면 Lovable이 프로젝트 Knowledge를 우선하도록 권장되기도 하고요. 워크스페이스 Knowledge에는 어디서나 참인 규칙만 두세요. 버튼은 문장형 대문자 표기, console.log 금지, 코드 주석은 영어 같은 것들이에요.

Skill은 규칙을 두는 곳이 아니에요. 막 가져온 사람들이 흔히 놀라는 부분이에요. Skill은 프롬프트가 설명과 일치할 때 로드되므로, lovable-i18n는 i18n 설정을 요청할 때는 컨텍스트에 있고 결제 페이지를 요청할 때는 없어요. 의도된 동작이에요. 모든 메시지에 로드되는 Skill이라면 그냥 Knowledge일 테니까요. Skill의 역할은 상시 적용될 규칙을 저장소에 한 번 써 두고 물러나는 거예요.

AGENTS.md의 규칙에는 무엇이 들어 있나요?

에이전트에게 그냥 “i18n을 써”라고만 했을 때 틀리기 쉬운 질문에 답하는 내용이에요. Skill이 작성하는 블록은 여섯 부분으로 구성돼요.

어떤 매크로를 쓸지. 판단 목록으로 정리돼 있어요. 숫자에 따라 바뀌는 텍스트는 <Plural> 또는 ICU plural을, JSX 텍스트는 <Trans>를, 속성값과 토스트 같은 이벤트 핸들러 문자열은 useLingui()가 반환하는 t를, 모듈 스코프 상수는 msg를 쓰고 컴포넌트 안에서 해석해요. 각각 어떤 import 경로에서 가져오는지도 규칙에 적혀 있어요. 잘못된 t를 import하면 앱이 로드하지 않는 전역 인스턴스에 바인딩되기 때문이에요.

보간. 추출되는 메시지에서 자기 슬롯 이름을 갖는 건 단순 변수뿐이에요. 다른 표현식은 {0}로 추출되는데 번역가가 다룰 수 없으므로, 규칙에서는 ph()로 이름을 붙이도록 요구해요.

복수형. other는 항상 필요하고, 카테고리는 CLDR을 따르며, 문자열 두 개 사이의 삼항 연산자는 영어 복수 규칙을 컴포넌트에 박아 넣기 때문에 금지돼요. 배경이 궁금하다면 복수형이 컴파일되는 문법을 다룬 ICU MessageFormat이란을 참고하세요.

숫자와 날짜. i18n.number()와 i18n.date()를 쓰고, toFixed()나 값에 통화 기호를 이어 붙이는 방식은 쓰지 않아요. Lovable의 워크스페이스 Knowledge 예시에도 날짜 형식과 유럽식 숫자 표기를 지정하는 현지화 섹션이 있는데, 좋은 접근이지만 이건 래핑 규칙이 아니라 형식 규칙이에요. 이 규칙을 완벽히 지키면서도 모든 제목이 영어로 나가는 앱이 나올 수 있어요.

번역가용 주석. 해석이 여러 가지인 짧은 문자열, 단독 액션 라벨, 도메인 용어에는 문자열이 나타나는 위치를 설명하는 comment=를 달아요. context=는 같은 텍스트가 위치에 따라 다르게 번역되어야 할 때만 써요.

카탈로그 관리. 새 문자열은 모두 래핑한 뒤 각 src/locales/*/messages.po에 빈 msgstr와 함께 추가해서, 번역이 도착할 때까지 Lingui가 원문으로 대체하게 해요. Lovable에는 터미널이 없으므로 에이전트는 lingui extract를 실행하지 않아요. 동기화 후에 GitHub Action이 실행해요. 기존 항목의 #.와 #: 주석 줄도 수정하지 않아요. 추출할 때 다시 생성되기 때문이에요.

이 마지막 섹션이 이 규칙을 Lovable 전용으로 만들어요. Cursor나 Claude Code의 규칙 파일은 “linter를 실행해”로 끝낼 수 있어요. Lovable 규칙 파일은 그럴 수 없으니, 대신 손으로 할 일과 CI에 맡길 일을 직접 적어야 해요.

Lovable이 아무것도 실행하지 못할 때 규칙은 누가 강제하나요?

GitHub 워크플로뿐이에요. Lovable에는 터미널이 없어서, 에이전트가 리터럴을 쓰고 변경이 저장소에 동기화되기까지 lint 단계가 전혀 없어요. IDE 에이전트와의 구조적인 차이가 바로 이 부분이에요. IDE 에이전트에서는 CI의 lint 규칙이 하드코딩된 문자열에서 빌드를 실패시켜요.

설정할 때 선택하면 Skill이 GitHub Actions 워크플로를 추가해요. 이 워크플로는 Lovable의 동기화가 반영되는 기본 브랜치에 푸시될 때 실행되어, 래핑된 문자열을 카탈로그로 추출하고 카탈로그 동기화를 다시 커밋해요. GitHub 앱에 workflows 권한이 없으면, Skill이 GitHub에서 파일을 직접 추가하라고 안내해요. 에이전트가 래핑한 문자열은 이걸로 처리가 끝나요. 래핑하지 않은 문자열에는 효과가 없어요. 추출은 매크로만 보기 때문이에요.

정리하면 이래요. AGENTS.md의 규칙은 래핑되지 않은 리터럴이 나타나는 빈도를 낮추고, Knowledge 안내는 긴 채팅에서 이를 받쳐 주고, 나머지는 GitHub의 diff에서 잡아내요. 나머지까지 기계가 잡아 주길 원한다면 같은 워크플로에 eslint-plugin-i18next의 no-literal-string 규칙을 단계로 추가하세요. Lovable 프로젝트에서 뭐라도 실행할 수 있는 유일한 곳, 즉 저장소에서 돌아가요.

래핑된 문자열은 이후에 어떻게 되나요?

번역이 필요하고, 이 부분이야말로 다시 프롬프트를 보내는 대신 자동화할 가치가 있어요. 변환은 앱에서 한 번만 하면 돼요. 저장소를 연결하면 globalize.now가 코드베이스를 한 번 변환하고, 카탈로그를 검토할 수 있는 풀 리퀘스트로 전달해요. 이후에는 푸시 작업이 새 카탈로그 단위를 번역해서, 화요일에 Lovable이 작성한 <Trans>의 번역이 수요일에는 PR로 올라와요. 대시보드 작업도, 내보내기도, 승인 대기열도 없어요. 이런 구조가 맞는 이유는 대시보드 없이 Lovable 앱 현지화하기에 더 자세히 있고, GitHub 연결과 globalize 커넥터를 포함한 정확한 설정 방법은 Lovable 연동 페이지에 있어요.

이 문제가 일부 Lovable 빌더에게 새롭게 느껴지는 이유를 알려 주는 배경도 하나 있어요. Lovalingo는 브라우저에서 런타임으로 Lovable 앱을 번역해서, 새로 생성된 영어 컴포넌트도 로드할 때 그냥 다시 번역되었고 이 문제가 드러나지 않았어요. Lovalingo는 2026년 8월 31일에 서비스를 종료했고, 마이그레이션 가이드로 커밋된 카탈로그 방식으로 옮긴 앱들은 이 근본적인 질문을 처음 마주하고 있어요. 카탈로그 방식은 옳은 선택이에요. 번역된 마크업이 내 것이고 색인도 되니까요. 다만 에이전트가 번역 가능한 코드를 쓰게 해야 하고, 그러려면 규칙이 어디에 있는지 알려 줘야 해요.

규칙은 Lovable이 읽는 곳에 두세요

Skill을 한 번 실행해서 AGENTS.md에 전체 블록을 채우고, 두 줄짜리 안내를 프로젝트 Knowledge에 붙여 넣고, 에디터가 못 하는 추출은 GitHub 워크플로에 맡기세요. Lovable로 개발하면서 카탈로그에 들어오는 모든 문자열의 번역을 직접 관리하는 대신 맡기고 싶다면, 개요는 vibe coder 페이지에서, 요금은 별도 요금 페이지에서 확인하세요.

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

globalize.now 무료로 시작하기