본문으로 건너뛰기

클로드 코드(Claude Code)와 게이트킷(gatekit)으로 웨딩스냅 비교 서비스의 기획을 실제 화면으로 옮겼어요.

박기성

2026.10.13

기획서 다음에 만든 비교 화면

업체 목록에서 상세로 들어가 후보를 담고 비교 창을 여는 흐름이 생겼습니다. 개별 작업 점검 뒤에는 전체 화면을 잇는 별도 점검도 남겼어요.

평범한 회사원이자 지피터스 24기 클코서비스 멤버 박기성이에요. 제가 웨딩스냅 업체를 고르며 겪은 불편에서 시작한 프로젝트를 계속 만들고 있습니다.

지난 글 클로드 코드 게이트킷으로 웨딩스냅 비교 서비스 기획하기에서는 기능 17개와 화면 9개를 정했습니다. 이번에는 업체 목록, 상세 화면, 나란히 비교하는 창, 내 후보 화면을 연결하는 개발로 이어졌어요.

처음 불편은 엑셀에 업체를 적어도 사진의 느낌이 기억나지 않는다는 것이었습니다. 가격과 촬영 구성도 업체마다 달라서, 후보를 좁힐 때마다 인스타그램을 다시 열어야 했어요. 그래서 이번 구현의 중심은 업체를 같은 항목으로 비교하고, 제 판단을 별점과 메모로 남기는 흐름입니다.

기획 단계에서 정한 운영자용 화면도 함께 만들었습니다. 업체 정보를 등록하는 화면, 사진을 정리하는 화면, 사용자 요청을 확인하는 화면이 프로젝트에 들어 있어요. 사용자가 비교할 정보를 누가 채우고 관리할지도 구현 범위에 포함됐습니다.

클로드 코드 개발 작업 나누기

기획서의 기능 수와 개발 작업 수는 다릅니다. 이번 작업 목록은 기능 17개를 개발 작업 13개로 묶고, 앞 작업이 끝나야 할 수 있는 일을 기준으로 네 단계에 배치했습니다.

시작은 앱의 공통 화면과 데이터 저장 기반입니다. 그다음 업체 목록, 로그인, 업체 상세, 친구 초대, 운영자 등록, 요청함, 통계 집계가 이어집니다. 마지막에는 사진 관리, 비교 창, 별점·메모, 내 후보처럼 앞에서 만든 기능에 붙는 작업을 두었습니다.

각 작업에는 바꿀 수 있는 파일과 끝나는 기준이 들어 있습니다. 업체 목록 작업이면 목록 화면만 적는 것이 아니라, 데이터를 가져오는 동작과 그것을 확인하는 테스트까지 함께 묶었습니다. 한 화면을 눌렀을 때 실제로 동작하는 단위로 작업을 나눈 셈이에요.

프로젝트에는 넥스트제이에스(Next.js)로 만든 화면과 수파베이스(Supabase)를 사용하는 데이터·인증 코드가 있습니다. 기본 동작을 확인하는 비테스트(Vitest), 브라우저에서 버튼을 눌러 보는 플레이라이트(Playwright) 테스트도 함께 들어 있습니다.

작업 설정에는 동시에 진행할 수 있는 구분이 있지만, 남아 있는 실행 기록은 같은 대화에서 구현하는 방식입니다. 여러 AI가 동시에 개발했다고 쓰지는 않겠습니다. 문서에 적힌 실행 가능성과 실제로 남은 실행 기록은 구분해서 봤어요.

웨딩스냅 비교와 후보 저장

비교 화면에서 중요한 것은 여러 업체를 같은 줄에서 보는 일입니다. 업체별 정보를 나란히 보는 창을 두고, 목록에서 비교함에 담은 업체를 이 창으로 이어지게 했습니다. 최저가 같은 항목을 찾아서 확인할 수 있도록 구성돼 있어요.

업체 상세에는 추가 비용을 확인하는 부분과 후보 담기, 별점, 메모가 붙습니다. 예전에는 머릿속으로 어느 업체가 더 나은지 판단했지만, 이제는 업체마다 판단을 저장할 자리가 생겼습니다. 후보를 담는 기능과 지금 나란히 비교할 업체를 고르는 기능은 각각 화면에 연결돼 있습니다.

로그인 전후의 차이도 구현 대상입니다. 목록을 둘러보다 상세보기를 누르면 로그인 안내가 뜨고, 로그인한 뒤에는 보려고 했던 업체 상세로 돌아오는 흐름입니다. 가격을 가리는 규칙은 화면에 블러만 씌우는 데서 끝내지 않고, 로그인 전 목록 응답에 제한된 가격이 들어 있지 않은지도 테스트에 넣었습니다.

친구와 같이 보는 내 후보 화면은 사람별로 담은 업체와 평가를 합쳐 보여주는 구성입니다. 작업 목록에는 친구 프로필을 켜고 끄며 볼 사람을 선택하고, 같은 업체를 담은 사람들의 별점과 메모를 한 카드에 모으는 기준이 적혀 있어요. 친구 초대와 후보 합치기를 별도 작업으로 나누어 연결했습니다.

비교 서비스 사용 흐름 점검

기능별 테스트와 별도로, 처음부터 끝까지 이어지는 사용 흐름을 확인하는 테스트가 있습니다. 남아 있는 결과에서는 이 테스트가 통과했습니다.

검사 순서는 로그인 전 목록을 보는 것부터 시작합니다. 상세보기를 누르면 로그인 안내가 뜨는지 확인하고, 테스트용 계정으로 로그인해 원래 업체 상세로 돌아갑니다. 여기서 추가 비용 표시를 확인한 뒤 후보를 담고 별점을 저장해요.

그다음 업체를 비교함에 넣고 목록으로 돌아옵니다. 비교함 막대에서 ‘나란히 비교하기’를 눌러 창을 열고, 업체명과 최저가 항목이 보이는지 확인합니다. 창을 닫은 뒤 내 후보 화면으로 이동해, 담았던 업체와 저장한 별점이 남아 있는지 봅니다.

이 테스트는 실제 카카오 계정으로 가입해 서비스를 이용했다는 뜻은 아닙니다. 테스트용 로그인 경로를 사용해 화면과 데이터가 이어지는지를 확인한 결과예요. 외부 로그인 설정이나 실제 사용자 운영까지 완료됐다는 근거로 넓혀 쓰지는 않겠습니다.

결과 화면의 모습도 파일로 남아 있습니다. 업체 목록, 업체 상세, 비교 창, 내 후보, 운영자 사진 관리 화면의 캡처가 남아 있습니다. 이번 결과물은 공개 서비스 주소보다 프로젝트 안의 구현 파일과 점검 기록으로 설명할 수 있는 단계입니다.

13개 통과 뒤 남은 실패

개별 작업의 최종 상태는 13개 모두 통과입니다. 중간 진행 문서에는 9개 통과 상태가 남아 있지만, 이후 기록에는 사진 관리와 비교 창, 별점·메모, 내 후보까지 완료 상태가 저장돼 있습니다.

전체 점검 결과는 달랐어요. 기본 기능 테스트는 15개 파일의 81개 항목이 통과했고, 타입 점검과 앞서 설명한 연속 사용 흐름도 통과했습니다. 화면 캡처 테스트는 12개 중 11개가 통과하고, 친구 초대 수락 화면 한 곳이 실패했습니다.

실패한 테스트는 아래 문구가 화면에 보이기를 기다렸습니다. 이 문구는 테스트가 찾던 화면 글자입니다.

후보를 함께 보자고 해요

기록에 남은 오류는 다음과 같습니다.

Error: expect(locator).toBeVisible() failed
Expected: visible
Timeout: 10000ms
Error: element(s) not found

이 결과만으로 초대 기능 전체가 고장 났다고 단정할 수는 없습니다. 테스트가 기대한 문구를 찾지 못한 상태예요. 초대 상태, 테스트 데이터, 화면 문구 중 어느 쪽이 원인인지는 남은 결과에 정리돼 있지 않습니다.

색 사용 규칙 점검에도 문제가 남았습니다. 결과에 ‘파일 0개 검사’가 적혀 있었고, 점검할 대상을 확인하지 못한 상태로 전체 결과는 실패가 됐습니다. 위반이 없다고 나온 숫자를 곧바로 통과로 읽으면 안 되는 장면이었어요.

아직 공개 완료라고 못 쓰는 이유

이번 기록에서 확인한 성과는 기획한 주요 화면과 데이터 흐름을 구현하고, 개별 작업 점검을 통과한 것입니다. 전체 완료 점검은 실패가 남아 있습니다. 모든 기능을 실제 사용자 환경에서 확인했다고 쓰기에는 근거가 부족해요.

일부 작업에는 실패 이후 테스트 파일이 바뀌었다는 표시도 남아 있습니다. 변경 내용의 전후 기록이 없어, 왜 바뀌었는지까지 확인하지 못했어요. 그래서 ‘테스트를 모두 통과했으니 서비스가 완성됐다’는 표현은 쓰지 않겠습니다.

데이터 연동 전체 검사, 전체 브라우저 테스트, 배포용 빌드 검사는 이 전체 점검에서 뒤 단계로 미뤄져 있습니다. 실행하지 않았다는 뜻으로 확대하지 않고, 이번 결과에는 포함되지 않았다고 정리합니다. 배포 주소와 실제 이용자 반응도 확인하지 못했어요.

개발에 걸린 전체 시간은 쓰지 않습니다. 실행 시작과 종료 시각이 있는 작업 기록은 있지만, 디자인을 정하고 준비한 시간까지 합친 수치는 없습니다. 이전 글의 기획 시간과 이번 구현 시간을 직접 비교할 수도 없었습니다.

클로드 코드에 개발을 요청하기

이번 프로젝트에는 화면 명세, 개발 작업 목록, 완료 기준, 개별 결과, 전체 점검 결과가 남았습니다. 기획서의 문장이 어떤 화면과 테스트로 이어졌는지 비교하며 읽을 수 있어요.

같은 방식으로 시작하려면 이렇게 시키면 돼요. 아래는 이번 구조를 바탕으로 새로 정리한 요청이며, 당시 보낸 원문은 아닙니다.

[프로젝트 폴더]의 기획서와 화면 명세를 읽어줘.
[핵심 사용자 흐름]을 실제 화면으로 구현할 작업으로 나눠줘.
각 작업에 바꿀 파일, 앞서 끝나야 할 작업, 점검 기준을 적어줘.
작업별 점검 뒤에는 사용 흐름 전체를 브라우저에서 확인해줘.
통과한 것, 실패한 것, 확인하지 못한 것을 따로 정리해줘.
1

함께 이야기해요 1

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

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

웨딩스냅 데이터는 어떻게 획득하셨는지 궁금합니다 :)

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

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

이런 사례도 있어요

사례 전체 보기