본문으로 건너뛰기

Gatekit로 글로벌서비스 만들기

위올라이

2026.10.13

하려던 것 📝

AI를 활용하여 외국인 순례자용 다국어 안내 사이트를 구현 전 단계까지 설계·검증한 사례

목적: 2027년 8월 서울 세계청년대회(WYD)에 오는 외국인 순례자에게 한국 생활 도구 사용법과 성지·본당 정보를 12개 언어로 제공하는 사이트 + 순례자 커뮤니티를 만들고자 함

배경: 트래픽 채널이 아직 없어 이번 행사를 계기로 새로 만들려 했고, 수익은 광고·제휴 링크로 계획함. 다만 순례자가 곤란해하는 모습을 직접 보거나 겪은 적은 없고 "이렇겠다"고 짐작하는 수준에서 출발함

해결하고자 한 내용: 코드를 짜기 전에 (1) 짐작과 확인된 것을 구분하고, (2) 구현자가 문서 하나만 읽고 만들 수 있는 PRD와 눌러볼 수 있는 프로토타입을 확보하고, (3) 핵심 위험인 "자동 번역 품질"을 먼저 확인하고자 함

활용한 툴 ⚒️

gatekit 플러그인: 문제 발굴(/gatekit:discover), 인터뷰(/gatekit:interview), 기획서·화면·기술 문서(spec) 작성과 검증에 활용함

클코(Claude Code): Windows 작업 환경 정비, 홈 화면 디자인 개선 착수, 프로토타입·기획 문서 분석에 활용함

Codex: 가이드 글 1편의 한국어 초안과 11개 외국어 번역 샘플 생성에 활용함 (문서에 "Codex 대화에서 생성, Claude API 출력 아님"으로 명시)

HTML 프로토타입: 16개 화면과 화면별 4개 상태(정상/비어 있음/오류/로딩)를 브라우저에서 눌러보는 용도로 활용함

Claude Design: 디자인 목업 시도를 검토 중이며 아직 사용 전임

진행 세부 내용 🔍

1️⃣ gatekit으로 문제 발굴하기

시도한 방법과 접근 방식: 후보 불편 3개를 놓고 대화로 1개를 골랐음. 고른 문제는 "외국인 순례자가 교통·지도·결제 같은 한국 생활 정보와 성지·한국 천주교 역사를 자기 언어로 찾기 어렵다"임. 기한은 4주로 정함.

얻은 결과나 피드백: 고르지 않은 2개는 이유를 남김. 길찾기 도구 자체는 네이버·카카오·구글 지도가 이미 있어 "사용법 안내"로 흡수하고, 숙소·본당 배정은 조직위원회 소관이라 정확성을 보장할 수 없어 제외함. 대화에서 밝혀진 사실·갈래는 25개로 기록됨.

인터뷰어가 한국 특유의 공백(구글 지도 한계, 티머니, 유심·eSIM, 카드 결제, 파파고·카카오T, 교구대회 기간 지방 분산, 8월 더위, 밤샘 기도 준비물 등)을 제안했고 사용자가 범위에 포함하기로 확정함. 이 항목들은 실제 순례자에게 확인된 것이 아니라 추론이라고 문서에 표시함.

정확성은 출처 표기, 게시 전 운영자의 한국어 원문 확인(주 3~5시간), 방문자 오류 신고 세 가지로 챙기기로 함.

2️⃣ 기획서 3종과 구현용 PRD 만들기

시도한 방법과 접근 방식: 발굴 내용을 기획(01)·화면(02)·기술(03) 문서로 풀고, 이를 합쳐 "이 문서 하나만 읽고 구현을 시작할 수 있는" PRD 한 장으로 정리함.

얻은 결과나 피드백: 기능 27개, 화면 16개(각 4개 상태), 컴포넌트 29개, 데이터 모델 11개, 열린 가정 18행이 문서화됨. 지역·본당 상세 화면, 숙소·배정 안내, 자체 지도, 사이트 내 검색·메일 알림, 네이티브 앱은 첫 버전 제외로 못 박음. 구현 순서는 9묶음으로 나누고, 3번 직후에 번역 품질(A2)을 확인하도록 순서에 박아 둠.

3️⃣ 눌러볼 수 있는 HTML 프로토타입 만들기

시도한 방법과 접근 방식: 16개 화면을 하나의 HTML 파일로 만들고, 화면마다 정상/비어 있음/오류/로딩 버튼으로 상태를 바꿔 볼 수 있게 함.

얻은 결과나 피드백: 더블클릭만으로 열려 서버 없이 화면 흐름을 확인할 수 있었음. 글 제목 → 가이드 글, 신고 버튼 → 신고 모달, 관리 첫 화면의 건수 → 각 목록으로 연결됨. 내용은 예시 데이터이며 서버와 연결되어 있지 않음.

4️⃣ A2 번역 품질 검증 샘플 만들기

시도한 방법과 접근 방식: 가이드 1편(티머니 카드 구매·충전)의 한국어 원문과 11개 외국어 번역을 만들고, 번역에서 반드시 지켜야 할 것을 먼저 정함. 숫자 3,000~5,000원, 판매처 GS25/CU/7-ELEVEN, 카드값과 잔액의 구분, 승하차 태그, 비공식 안내라는 의미임.

얻은 결과나 피드백: 11개 언어 모두 형식 검사에서 문제 0건이었으나, 의미 검토는 수행하지 않았고 독립 검토자 확인도 대기 중이라 A2는 계속 미충족으로 유지함. 형식 검사 통과가 번역의 자연스러움이나 사실 정확성을 보증하지 않는다고 문서에 명시함.

5️⃣ 디자인 1차 개선하기

시도한 방법과 접근 방식: 기획 범위(기능 27개, 화면 16개·4상태)는 그대로 두고 홈 화면만 개선함. 성지·성인 5장 캐러셀, 생활 가이드 10편 카드, 성지 카드, 게시판 4개×3개 예시 글, 헤더 아래·푸터의 민간 비공식 고지를 넣음.

얻은 결과나 피드백: 1440·390·320px에서 16개 화면의 각 상태를 확인했고, 가로 넘침과 JS 오류가 없었음. 5장 이동, 자동 재생, 방향키 이동이 동작했고 reduced-motion에서는 자동 재생이 멈춤. 색 토큰(초록·노랑·코랄)은 시안일 뿐 제품 채택은 미결정으로 기록함.

6️⃣ "디자인이 구려서" — 2차 개선 착수하기 (진행 중)

시도한 방법과 접근 방식: 현재 캡처를 보고 문제를 진단함. 프로토타입 도구(상단 배너·S1~S16 탭)가 사이트를 덮고 있음, 히어로 컨트롤이 디버그 버튼 같음, 가이드 카드 9장이 전부 같은 모양이라 위계가 없음, 카드 윗선 색이 의미 없이 돌아감, 본문이 작고 옅음. 방향은 "청년 축제 · 밝고 볼드"로, 범위는 "홈 화면 먼저"로 정함.

얻은 결과나 피드백: 변경 전 파일을 백업(prototype-wyd-pilgrim.before-bold.html)하고 착수함. 캐러셀 JS와 필수 고지문은 유지하는 조건을 정함. 결과물은 완성 후 업데이트 예정임.

7️⃣ Claude Code 작업 환경 정비하기

시도한 방법과 접근 방식: npm으로 쓰던 Claude Code를 네이티브 설치로 전환하고, VS Code + PowerShell 7 기준으로 설정을 정리함. 시작 프로그램과 메모리 점유를 조사해 불필요한 것을 정리함.

얻은 결과나 피드백: 2.1.214(npm) → 2.1.296(네이티브)로 전환함. 응답 없이 쌓여 있던 UpdaterSetup 프로세스 51개(636MB)를 정리하는 등 약 1GB 이상의 RAM을 회수함. 은행·정부 사이트용 보안 프로그램은 임의로 끄지 않고 유지함. gsudo, oh-my-posh, fzf, zoxide를 설치해 관리자 권한 실행 같은 반복 작업을 줄임.

시행착오 ⚠️

문제 자체가 짐작에서 출발: 순례자가 정보를 찾는 빈도와 1회 소요 시간은 측정된 적이 없음. 그래서 문서에 "개선 폭을 숫자로 주장하지 말 것"이라고 적어 둠. 월 방문자 10만 명이 광고 수익으로 얼마가 되는지도 검토하지 못함.

번역 샘플의 한계: 샘플 번역을 만든 엔진이 최종 엔진과 다를 수 있어, 이 결과를 최종 품질의 근거로 쓸 수 없음. 성인명·교리·미사·고해성사 같은 가톨릭 용어는 이 샘플로 충분히 시험하지 못함. 승하차 안내는 2021년 자료라 게시 전 운영사 자료로 재확인이 필요함.

디자인 1차 결과에 만족하지 못함: 확인용 도구 화면이 실제 사이트보다 먼저 보이는 구조였고, 카드에 위계가 없었음. 확인 항목(가로 넘침, JS 오류)은 통과했지만 "보기에 좋은가"는 별개의 문제였음.

샌드박스 오류: Windows sandbox setup refresh 오류를 우회한 실행으로 파일 접근을 복구했으며, 원인이 해결되었다고 판정하지 않음.

hook 오류의 반쪽짜리 해결: 환경 변수 값(CLAUDE_PLUGIN_ROOT)의 깨진 경로를 고쳤지만 hook 오류는 계속됨. 이 변수는 플러그인 자체 hooks.json에서만 해석되고 settings.json에 직접 쓴 명령에서는 치환되지 않았음. hook 명령 안의 변수를 실제 경로로 직접 치환(26곳)해서 해결함.

이름만 보고 판단할 뻔함: 메모리를 차지하던 LGThinQService를 "가전 앱"으로 보고 끄려 했으나, 실행 경로를 확인하니 LG gram 노트북 자체 유틸리티(My gram 폴더)였음. 사용자에게 다시 확인한 뒤 진행하고, 배터리 케어·드라이버 서비스는 건드리지 않음.

원본과 복사본의 어긋남 위험: 기획 문서의 원본은 WSL에 있고 Windows 폴더는 복사본이라, 복사본만 고치면 원본과 달라짐. 고칠 때는 원본을 고친 뒤 다시 복사하기로 함.

배운 점 📚

가장 큰 위험은 문서에 순서로 박아 두기: 번역 품질(A2)을 "구현 순서 3번 직후에 확인"으로 못 박아, 구현자가 번역을 빼먹고 먼저 달려가지 못하게 함. 위험을 말로만 두지 않고 작업 순서에 넣는 것이 효과적이었음.

짐작과 확인을 나눠 적으면 과장이 줄어듦: 미확인 항목을 "남은 것"과 가정 원장으로 따로 모아 두니, 공유·발표 때 "확인된 것처럼" 말하지 않게 됨.

상태 4종을 처음부터 그리기: 비어 있음·오류·로딩을 화면마다 같이 그려 두면 나중에 빠진 화면을 찾는 일이 없음.

통과한 점검과 만족은 다름: 가로 넘침·JS 오류 같은 기계 점검을 통과해도 디자인은 따로 눈으로 봐야 함. 화면 캡처를 직접 보고 문제를 진단한 것이 2차 개선의 출발점이 됨.

설정 오류는 값이 아니라 "어디서 해석되는지"가 원인일 수 있음: 값을 고쳐도 같은 에러가 나면 그 변수가 해석되는 위치부터 의심해야 함.

AI 도구라도 이름이 아니라 실제 경로와 출처를 확인하기: 프로세스 이름(LGThinQService), 번역 생성 출처(Codex 대화) 모두 확인 없이는 잘못 판단할 수 있었음.

향후 계획 🧭

디자인 2차 완성: 홈 화면을 "청년 축제 · 밝고 볼드" 방향으로 완성한 뒤, 같은 시스템을 나머지 15개 화면에 적용함. 완성본 캡처를 Claude Design에 넘겨 변형 시안도 받아볼 계획임.

A2 판정까지 이어가기: 한국어 원문 승인 → 번역 엔진 결정 → 같은 원문을 실제 엔진으로 실행 → 언어별 검토·수정 → 검토자·날짜·문제 기록 → A2 판정 순서로 진행함.

미결정 가정 확정: 지원 언어(A1), 주제 적합성(A3), 지역 분류(A5), 기술 스택(A6)을 정함.

순례자 확인: 지난 대회 참가자나 한국에 온 외국인 가톨릭 신자에게 실제로 어떤 정보를 찾는지 확인함.

구현: PRD 15장의 9단계 순서대로 진행하되, 3번 직후에 A2를 다시 확인함.

도움이 필요한 점 🤝

번역 검토자: 영어·스페인어·프랑스어·이탈리아어·포르투갈어·폴란드어·독일어·중국어·일본어·베트남어·타갈로그어 원어민 또는 해당 언어 가톨릭 신자가 번역 샘플을 읽어 줄 수 있으면 큰 도움이 됨. 특히 가톨릭 용어의 적절성을 봐 줄 분이 필요함.

순례자 경험 확인: 지난 세계청년대회(리스본 2023 등)에 다녀온 분께, 현지에서 어떤 정보를 어디서 찾았고 어디서 막혔는지 듣고 싶음.

대량 자동 번역 콘텐츠 경험: 12개 언어 자동 공개가 대량 자동 생성 정책 위반으로 판정되지 않는지(A8), 비슷하게 운영해 본 경험이 있으면 듣고 싶음.

번역 엔진 선택 경험: 다국어 콘텐츠를 자동 번역해 운영해 본 분의 엔진 선택 기준을 듣고 싶음.

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

이수진 프로필 이미지
이수진2026.10.13

디자인 2차 완성되시면 화면도 자랑해주세요 :) 궁금합니다 :)

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기