본문으로 건너뛰기

gatekit으로 "에어비앤비 게스트 가이드(2주차) " 프로토타입까지 왔어요 (실제 대화 249개 분석 포함)

쏠레일

2026.10.13

gatekit으로 "에어비앤비 게스트 가이드(2주차) " 프로토타입까지 왔어요 (실제 대화 249개 분석 포함) 본문 이미지

1편(discover → interview)에 이어, 이번에는 mockup 단계와 실제 게스트 대화 분석까지 한 내용이에요.

지난 편 요약

Claude Code 스터디 숙제로 gatekit 플러그인을 써서 "나나 다른 사람에게 필요한 걸 만들어 보기"를

하고 있어요. 저는 개발자가 아니라서, 명동에서 에어비앤비 슈퍼호스트로 숙소를 운영하는 남편의

업무에서 출발했어요.

문제는 이거였어요. 예약부터 체크인까지 게스트 문의(도어락, 짐 보관, 얼리 체크인, 배달 등)를

남편이 매일 10~20건씩 전화·문자로 혼자 받고 있고, 미리 보낸 구글드라이브 안내는 잘 안 읽힌다는

것. discover로 문제를 좁히고 interview로 PRD와 아키텍처 문서까지 썼어요.


이번에 한 일

| 단계 | 한 일 | 결과 |

gatekit 단계에 따라 작업하고 있어요.

| mockup | 화면 4개(게스트, 로그인, 목록, 편집)와 상태 4종(정상/비어있음/오류/로딩) 설계 | spec/02-screens.md, 디자인 토큰 |

| 프로토타입 v1 | 클릭 가능한 HTML 프로토타입 | 화면 이동, 상태 전환, 언어 전환 |

| Aside 작업 | 에어비앤비 게스트 메시지 1개월치(249개 대화) 수집, FAQ 분석, 개인정보 마스킹 | 숙소_FAQ_마스킹본.xlsx |

| 분석팀 | 서브 에이전트 3명이 시트를 나눠 병렬 분석 | 분석 문서, 호스트 확인 목록 |

| 프로토타입 v2 | 분석 결과를 반영해 다시 제작 | 질문 순서, 단계 탭, 긴급 연락 등 |



Claude Code와 Aside를 나눠 쓴 방식

워크플로우를 그리고 작업을 둘로 나눴어요.

- Aside(브라우저에서 제 계정을 쓰는 쪽): 에어비앤비 메시지처럼 로그인이 필요한 곳에서

데이터를 모으고, 구글 드라이브의 콘텐츠 수집 템플릿 시트를 읽고 쓰는 일. 249개 대화를 모아

FAQ를 분석하고 비밀번호·연락처·게스트 개인정보를 {토큰}으로 바꾼 마스킹 파일까지 만들었어요.

- Claude Code(코드 폴더에서 일하는 쪽): 마스킹된 파일을 받아 분석하고, 화면 명세와

프로토타입을 만들고, 스펙 문서를 고치는 일.

Claude Code는 터미널 도구라 구글 드라이브에 직접 접근하지 못해요.

(남편 계정으로 방문 고객들에게 공유한 구글 드라이브 문서)

그래서 시트 데이터가 필요하면

Aside가 읽어서 파일로 내려주고, 그 파일을 Claude Code가 이어받는 식으로 연결했어요. 이 인수인계를

HANDOFF.md에 적어두니 세션이 바뀌어도 이어갈 수 있었어요.

한 가지 좋았던 점은 개인정보가 Claude Code로 넘어오기 전에 마스킹됐다는 거예요. 게스트 대화에는

비밀번호와 연락처가 많이 섞여 있는데, 원본은 Aside 쪽에만 두고 마스킹본만 코드 폴더로 가져왔어요.


Aside로 한 작업 상세

Aside에서 직접 한 일을 좀 더 정리하면요.

1. 에어비앤비 메시지 수집: 브라우저로 에어비앤비에 로그인해서 1개월치 게스트 대화 249건을

모았어요. 이건 로그인이 필요한 작업이라 Claude Code로는 못 해요.

2. 개인정보 마스킹: 비밀번호는 {ROOM_CODE_101}, 와이파이는 {WIFI_PW_SUM},

게스트 이름은 [게스트 이름] 같은 토큰으로 바꿨어요. 원본은 Aside 세션에만

남기고 마스킹본만 Claude Code 폴더로 보냈어요.

3. 구글 드라이브 접근 확인: 콘텐츠 수집 템플릿 시트와 드라이브 폴더에 접속해서

Aside는 읽기/쓰기가 되지만 Claude Code는 안 된다는 걸 확인했어요. 시트는 4개 탭

중 안내 탭만 작성되어 있고, 실제 데이터 탭(숙소기본정보, 체크인후안내,

사진영상체크리스트)은 아직 비어 있어요.

4. HANDOFF.md 업데이트: 워크플로우 시각화를 만들어 전체 진행 상황을 정리하고,

결정된 사항들(가정 #1 확정, #2·#4 연기, 에어비앤비 1차 집중)을 HANDOFF.md에

반영했어요. 드라이브 접근 방법과 시트 URL도 기록해서 Claude Code가 다음 세션에서

열면 바로 상황 파악할 수 있게 했어요.

5. 워크플로우 시각화: gatekit 6단계 파이프라인, 도구별 역할 분담, 데이터 흐름,

다음 액션 순서를 한눈에 볼 수 있는 다이어그램을 만들었어요.


분석 결과: 제가 틀렸던 것

남편도 저도 "도어락 문의"가 제일 큰 문제라고 생각했는데, 데이터는 달랐어요.

| 주제 | 문의한 대화 수 |

| 공항 픽업/교통 | 90 (전체의 36%) |

| 체크인 전 짐 보관 | 66 |

| 주소·층·엘리베이터 | 39 |

| 퇴실 후 짐 보관 | 30 |

| 출입 코드/잠김 | 21 |

공항 이동과 짐 보관, 얼리 체크인을 합치면 도착 전 질문이 약 200건이에요. 도어락은 21건이라

빈도로는 5위였어요. 다만 운영중인 게스트 하우스 중 한 곳 에서 게스트가 밤새 건물 밖에서 기다리다 환불을 요구한 사례처럼

한 번 터지면 훨씬 심각한 문제라서, 도어락은 맨 위에 두되 질문 버튼 순서는 문의량 순으로

바꿨어요.

그 밖에 새로 알게 된 것들이에요.

- 숙소마다 도어락 방식이 달라요. 스튜디오는 패드 터치, 우디스는 커버를 밀어 올리는 방식인데,

"커버를 손잡이로 오해"하거나 "레인커버를 안 내려서 고장 난" 사례가 있었어요.

- 예전 비밀번호가 안내문에 남아 있어서 게스트가 입력하자 경보가 울린 일이 있었어요. 그래서

관리자 화면에는 옛 비밀번호를 아예 저장하지 않게 했어요.

- 숙소 두 곳은 주소가 서로 다르게 적혀 있어요. 그래서 "확인 필요" 표시를 넣고, 확정 전에는

게스트 화면에서 주소를 숨기고 "확인 중"이라고 보여주게 했어요.

- 언어는 영어가 압도적이고 중국어, 일본어, 스페인어 순이라 현재 계획이 데이터와 맞았어요.


서브 에이전트 3명으로 병렬 분석

시트가 8개, 가장 큰 시트는 1,300행이라 혼자 보면 오래 걸려서 에이전트 3명에게 나눠 맡겼어요.

| 담당 | 맡은 시트 |

| A | 빠른답변 원문, 단계별 FAQ 분류 |

| B | 숙소별 정보, 확인필요·불일치 |

| C | 게스트 원문 대화, 숙소별 집계 |

세 명 다 읽기 전용으로 돌렸고, 결과를 제가 합쳐서 정리했어요. 두 팀의 의견이 갈린 부분도

있었는데(도어락 우선순위), 그대로 섞지 않고 "질문 버튼은 문의량 순, 도어락 카드는 상단 고정"으로

정리하고 이유를 문서에 남겼어요.

분석 때 지킨 원칙도 있어요. 시트마다 숫자의 기준이 달라서(대화 수 vs 메시지 수) 섞지 않았고,

키워드로 자동 분류한 값이라 오차가 있다는 것과 일부는 샘플링으로만 봤다는 한계를 문서에 적었어요.

막혔던 것과 해결

- 안전장치 훅: gatekit은 게이트 승인 전에는 코드 파일 쓰기를 막아요. 처음엔 답답했는데,

분석 단계에서 코드를 쓰지 않게 해주는 안전장치라고 이해하니 오히려 편했어요. 서브 에이전트를

띄울 때도 쓰기 범위를 선언해야 해서, 읽기 전용 분석은 범위를 선언하고 "쓰지 말라"고 못 박았어요.

- 엑셀 읽기: 스크립트를 못 쓰는 상태라 엑셀을 파이썬으로 못 읽었어요. 대신 읽기 전용 명령으로

엑셀 내부를 풀어서 읽는 방법을 찾아 에이전트들에게 알려줬어요.

- 미리보기 화면: 브라우저 패널이 파일을 특수한 주소로 열어서 링크 이동이 안 됐는데, 임시

로컬 서버로 띄워서 해결했어요.

- PR 요청: 화면에서 "PR 만들기"를 눌렀는데 저는 PR이 뭔지 몰랐어요. 설명을 듣고 보니 혼자

하는 지금 단계엔 필요 없어서 멈췄어요. 모르는 건 일단 멈추고 물어보는 게 맞더라고요.

범위를 줄였어요

분석하고 나니 욕심을 덜어내야 한다는 게 보였어요.

- 1차는 에어비앤비 위주로 집중. 부킹닷컴·아고다 자동 발송은 1차 이후로 미뤘어요.

- 자동 번역과 자동 발송은 Phase 2 챗봇 단계로. 챗봇은 텔레그램 같은 별도 채널에서 할

예정이고, 이번에 정리한 FAQ 구조를 그대로 답변 소스로 쓸 거예요.

- 에어비앤비 안내 템플릿 복사는 1차에 포함해요(수동 발송이라 계정 제재 위험이 없어요).

- 가정 정리: 게스트 링크는 로그인 없이 슬러그만으로 접근하도록 호스트 동의를 받았고, 번역 비용과

PMS 연락처 범위는 Phase 2로 연기해서 막혀 있던 조건이 풀렸어요.

- 이 결정들을 Aside에서 HANDOFF.md의 가정 원장에 바로 반영했어요. 가정 #1은

Confirmed:y로, #2·#4는 Blocking을 n으로 바꿔서, Claude Code가 다음 세션에서

열면 Gate 차단 이슈가 해소된 걸 바로 확인할 수 있어요.

배운 점

- 데이터를 보기 전의 확신은 틀릴 수 있어요. 가장 큰 문제가 도어락일 거라는 제 확신은 틀렸고,

실제로는 도착 전 질문(공항, 짐)이 압도적이었어요. 프로토타입 순서가 통째로 바뀌었어요.

- 작업 도구를 나눠 쓰면 안전해요. 로그인이 필요한 데이터는 Aside가, 코드와 문서는 Claude Code가

맡고, 개인정보는 마스킹한 뒤에만 넘겼어요.

- 분석은 쪼개서 병렬로, 결론은 합쳐서 한 곳에. 에이전트 셋이 따로 읽고 제가 합치니 빠르고

빠뜨림이 적었어요. 대신 서로 다른 결론을 그냥 섞지 말고 이유와 함께 정리해야 해요.

- 내가 정할 수 없는 건 호스트에게 돌려요. 어느 주소가 맞는지, 비밀번호를 링크만으로 보여줘도

되는지는 AI가 정할 수 없어서 확인 목록(16개)으로 만들어 Aside에서 원본과 대조하기로 했어요.

지금 상태와 다음 계획

지금은 프로토타입 v2를 직접 보면서 "빠진 게 없는지" 확인하는 단계예요. 확정되면 /gatekit:tasks로

작업을 쪼개고 /gatekit:gate로 완료 조건을 정한 뒤 /gatekit:build로 실제 개발에 들어가요.

1. 프로토타입 v2 확정 → 작업 목록 작성

2. 호스트 확인 목록을 Aside로 대조해 주소·도어락 정보 확정

3. 구글 드라이브 콘텐츠 수집 시트 채우기(Aside와 함께)

4. 실제 숙소에 적용하고, 도착 전 질문이 줄었는지 확인해서 후기로 올릴게요

함께 이야기해요 0

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

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

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

이런 사례도 있어요

사례 전체 보기