Global GTM 구현과 배포 회고 (Part 1): 옵시디언 wiki의 자료를 끌어다가 핵심 질문사항으로 "해외진출 준비도" 프레임웍 만들기
2026.08.05

소개
한국 스타트업의 해외진출 준비도를 진단하는 웹 플랫폼을 만들고 있다. 시작할 때 손에 있던 건 PDF 도식 한 장이었다. 극초기 → 준비중 → 준비완료 3단계에 항목별 배점(20%, 30% …)이 찍힌 그림.
문제는 이 그림이 사람에게 물어볼 수 있는 형태가 아니라는 것이었다. «가치제안 완성정도 25%»는 컨설턴트끼리 쓰는 말이지 창업자에게 던질 질문이 아니다.
반대편에는 옵시디언 볼트에 쌓아둔 진단 프레임워크 v4.0이 있었다. 10개 영역, Level 1~3 질문 트리, Gate A~D, 증거수준 E0~E4. 이쪽은 질문은 많은데 «지금 이 회사가 어느 단계인가»를 한 문장으로 답하지 못했다.
둘을 붙여서 (1) 창업자가 실제로 답할 수 있는 문항으로 바꾸고 (2) 단계 판정 규칙을 만들고 (3) 운영 중인 Next.js 플랫폼의 기존 진단을 통째로 교체하는 것까지가 목표였다. Claude Code 한 세션에서 끝냈다.
운영 서비스: https://global-gtm.vercel.app
진행 방법
도구 — Claude Code (Opus 5), Obsidian, Next.js 15 + Supabase + Vercel
1부. 그림과 프레임워크를 접합했다
첫 프롬프트는 이랬다.
첨부파일은 한국 창업기업의 글로벌 진출의 준비를 확인하는 3가지의 큰 단계를 그 하위 내용들과 중요배점 그리고 설명이 같이 포함되어 있다. 나의 옵시디언 볼트의 "GlobalGoToMarket"의 4개의 Phase에서 이 이미지의 내역에 직접적으로 관련되어 질문 할수 있는 항목들을 추려서 나열하고 mind map으로 그 구조를 그려서 나타내고 그 하부질문들에 대한 배점을 전체상황을 고려하여 배정한다.
결과: 3단계 ↔ 볼트 4 Phase(Plan / Enable / Execute / Expand) 매핑, 12개 항목, 55문항, 100점 배점.
여기서 하나 걸러졌다. 도식의 «회사 개요 — 대표자·설립년도·직원수·투자현황»을 채점에서 뺐다. 볼트 규칙에 «설립연도·인원·투자는 점수 가산요소가 아니라 질문 라우팅 보조정보»라고 못박혀 있었기 때문이다. 같은 9점을 TCE·현금한도·책임자 투입시간으로 대체했다.
[캡처 1: 55문항 배점 마인드맵]
2부. 진짜 전환점 — 열린 질문을 4단계 선택지로
1차로 만든 문항은 볼트의 인터뷰 문체 그대로였다.
최근에 유료 PoC, 첫 주문, 재구매, 갱신, 사용량 증가가 일어난 사례를 시간순으로 3건만 들려주세요.
유료 고객이 0인 창업자는 여기서 막힌다. 답을 못 쓰고, 빈칸으로 두고, 이탈한다. 이 지적이 들어왔다.
일반 창업대표에게 물어 봤을때 그 부분까지 생각을 못했다던지 아니면 그 수준까지 진행을 못했을때 답하기가 어려울수 있는 문항들이 있다
그래서 55문항 전부를 4단계 선택지로 바꿨다.
1 미인지 그 부분까지 생각해보지 못함
2 인지·계획 필요성은 알지만 정리하거나 실행하지 못함
3 실행·사례 실제로 해봤고 사례가 있음 ← 여기부터 «긍정»
4 반복·확인 반복됐거나 외부에서 확인받음같은 문항이 이렇게 바뀌었다.
Q10. 우리 제품이나 서비스에 대한 유료 고객이 있었나요?
① 아직 유료 고객이나 실사용 고객이 없습니다
② 관심을 보인 고객은 있지만 아직 비용을 지불하진 않았습니다
③ 유료 PoC나 첫 주문이 있었습니다
④ 재구매·갱신·사용량 증가가 여러 고객에서 반복됐습니다
①을 고르는 것도 유효한 데이터다. 서술형은 ③·④를 고른 문항에만 이어 묻는다. ①·②를 고른 사람에게 증거를 요구하지 않는다.

[캡처 2: 실제 진단 화면의 4지선다]
3부. Phase Gate — 80% + Critical 차단
긍정 = 선택 ≥ ③
단계 긍정비율 = Σ 긍정문항 배점 ÷ 단계 총배점
단계 통과 = 전 문항 응답 AND 긍정비율 ≥ 80% AND Critical 0건
달성 Phase = 앞에서부터 연속으로 통과한 마지막 단계여기서 Claude가 반대 의견을 냈고 그게 맞았다. 80% 단일 기준은 상쇄를 허용한다. 판매 허가 경로가 없어도 나머지 80%가 «예»면 통과해 버린다. 볼트 v4.0에는 «Critical 결손은 다른 항목의 높은 점수로 상쇄하지 않는다»가 명시돼 있었다. 그래서 Critical 7문항(TCE, 진출 책임자, 유료 전환, 제품분류·법규, 목표환경 시험, 최종 책임자, 에스컬레이션)이 3단계 미만이면 비율과 무관하게 차단하도록 했다.
80%를 문항 수가 아니라 배점 가중으로 센 것도 결정 하나다. 문항 수로 세면 12점짜리 Market testing과 1점짜리 문항이 같은 무게가 된다.
4부. 플랫폼 전면 교체
기존 앱은 15문항·6도메인·0~3레벨이었다. 이걸 55문항·12항목·1~4단계로 바꿔야 했다.
여기서 쓴 방법이 이번 작업에서 제일 쓸모 있었다. 타입 계약을 그대로 두고 안쪽만 갈아끼웠다.
export interface ReadinessResult {
overallScore: number;
domainScores: Record<string, number>; // 6도메인 → 3단계로 의미만 교체
status: ReadinessStatus;
isOnHold: boolean;
gateMessages: string[];
actions: ActionRecommendation[];
stages: StageResult[]; // 추가
achievedStageId: string | null;
currentStageId: string | null;
}대시보드·API·DB 저장이 전부 이 타입 하나를 지나가고 있었다. 계약을 지키니 스키마 변경이 테이블 하나로 끝났고, 기존 문항 세트를 담던 파일은 261줄에서 21줄이 됐다.
액션도 데이터에서 파생시켰다. 55개 액션 객체를 손으로 쓰는 대신 문항당 짧은 문자열 하나만 넣고, 담당자·서비스 태그는 12개 항목 단위로 붙였다. 완료 확인 문구는 이미 있던 followUp을 재사용했다.
5부. 배포
git push → Vercel 자동 빌드. Supabase 마이그레이션은 DB 비밀번호가 없어 직접 실행하지 못하고, SQL을 만들어 SQL Editor에서 돌렸다.
do $$
declare c record;
begin
for c in
select conname from pg_constraint
where conrelid = 'public.readiness_answers'::regclass and contype = 'c'
loop
execute format('alter table public.readiness_answers drop constraint %I', c.conname);
end loop;
end $$;
alter table public.readiness_answers
add constraint readiness_answers_level_check check (level between 1 and 4) not valid;not valid를 쓴 이유는 기존 0~3레벨 응답을 지우지 않기 위해서다. 새 응답만 검사한다.
결과와 배운 점
결과
문항 15개 → 55개, 채점 축 6개 도메인 → 3단계 Gate
기존 문항 세트 파일 261줄 → 21줄
테스트 16개 통과, 프로덕션 빌드 28개 라우트
종이 설문지 docx도 같은 TS 파일에서 생성 — 앱과 종이 문구가 갈라지지 않는다
실제 배포 완료. 진단 → Gate 판정 → 액션 5개 → 로드맵까지 동작
핵심 팁
타입 계약을 유지하면 전면 교체도 국소 변경이 된다. 대시보드·API·DB가 한 타입을 지나가고 있으면 그 타입만 지키면 된다.
문항을 바꿀 땐 번호 대조 검증을 코드로 넣는다. 11개 문구를 고칠 때 «기존 문구가 정확히 일치하는지» assert를 넣고 돌렸다. 번호가 어긋나면 조용히 다른 문항이 바뀐다.
«아직 안 함»을 유효한 선택지로 만들면 응답률이 산다. 그리고 미응답과 «안 함»이 데이터에서 구분된다.
콘텐츠는 코드에, 문서는 코드에서 생성. 55문항이 파일 하나에 있고 docx는 스크립트로 뽑는다.
AI가 «이 요구사항은 기존 규칙과 충돌한다»고 하면 들어볼 만하다. 80% 게이트의 상쇄 문제가 그랬다.
시행착오
CSS의 scroll-behavior: smooth 가 rAF 스크롤을 죽였다. 모바일 자동 스크롤이 안 움직여 한참 팠는데, smooth 때문에 반복 scrollTo 호출이 각각 별도 애니메이션이 되어 서로를 취소하고 있었다. behavior: "instant" 로 덮어 해결.
브라우저 자동화 패널이 백그라운드라 애니메이션 검증을 못 했다. visibilityState 가 hidden 이라 requestAnimationFrame 이 초당 0프레임. 기존 카운터도 0에 멈춰 보였다. 내 코드 문제가 아니라 도구 한계였는데 이걸 확인하는 데 시간을 꽤 썼다.
docx 표가 좁게 나왔다. columnWidths 만 주고 테이블 자체 width 를 안 줘서. macOS 미리보기는 그걸 무시해서 고친 뒤에도 좁게 보였고, 결국 XML을 직접 열어 확인했다.
선택지 폰트가 9px이었다. 원래 15문항 디자인에서 굵은 라벨 아래 붙는 캡션용 스타일이었는데, 55문항으로 바꾸면서 선택지 문장 자체가 그 자리에 들어갔다. 캡션 크기로 본문을 렌더링한 셈.
덤으로 권한 상승 취약점을 찾았다. 마이페이지 설계 중, authenticated 역할에 테이블 단위 UPDATE 가 부여돼 있고 RLS는 행만 검사한다는 걸 발견했다. 로그인 사용자가 자기 role 을 admin 으로 바꿀 수 있었다. 컬럼 단위 GRANT로 막는 걸 다음 작업에 넣었다.
도움이 필요한 부분
80%라는 임계값에 근거가 없다. 배점 30:40:30도, 준비완료 4항목의 9:7:8:6도 실제 진단 사례 없이 설계한 초기값이다. «80%를 넘은 기업이 실제로 다음 단계에서 성공한다»는 검증이 아직 없다. 그러나 경영학에 80:20의 법칙이 통용되고 있어서 이걸 채택했다. 비슷한 준비도 평가를 운영해 보신 분들의 임계값 보정 경험이 궁금하다.
앞으로 할 일
인증·마이페이지·관리자 대시보드를 붙이는 중이다. 비로그인으로 55문항을 풀고 결과를 볼 때 가입시키는 흐름, 전화번호 AES-256-GCM 암호화, 기업별 진단·액션·주문 진행을 보는 운영 대시보드까지 PRD와 14개 태스크 구현 계획을 먼저 만들어 뒀다.
도움 받은 글
Global Class (McDaniel · Wehage) — BMLC, LPA, TCE 도구
OECD · EC JRC 복합지표 구성 지침 — 배점·가중치 설계 근거
진단 프레임워크는 자체 정리본(옵시디언 볼트 v4.0)



"타입 계약을 그대로 두고 안쪽만 갈아끼웠다"는 방법, 15문항→55문항 전면 교체를 스키마 변경 테이블 하나로 끝낸 결과가 잘 납득됐어요. ReadinessResult 한 타입이 대시보드·API·DB를 모두 지나가고 있다는 구조를 먼저 파악한 게 핵심이었던 것 같아요. Critical 7문항이 3단계 미만이면 80% 비율과 무관하게 차단하도록 한 결정, Claude가 반대 의견을 냈고 그게 맞았다고 쓰신 부분도 솔직하게 읽혔어요. 배점 가중으로 긍정비율을 세신 이유(12점짜리와 1점짜리가 같은 무게가 되면 안 된다)도 설득력 있었어요. scroll-behavior: smooth 때문에 반복 scrollTo 호출이 서로를 취소하고 있었다는 시행착오, 내 코드 문제가 아니라 도구 한계였는데 확인하는 데 시간을 썼다는 것도 공감이 됐어요. authenticated 역할에 테이블 단위 UPDATE가 있고 RLS는 행만 검사해서 role을 admin으로 바꿀 수 있었던 권한상승 취약점 발견까지 — 꼼꼼히 짚으셨네요.
기지개 한 번 켜고 다음 파트도 기다릴게요 🐈⬛