"뭘 만들지 모르겠어"에서 실제 서비스까지: gatekit 파이프라인으로 스터디 결과물 갤러리 만들기
2026.10.05

소개
시도하고자 했던 것과 그 이유를 알려주세요.
지피터스 24기 Claude Code 스터디를 준비하면서, 스터디에서 쓸 플러그인 gatekit으로 실제 서비스를 처음부터 끝까지 만들어 봤습니다. 만든 것은 스터디원들이 결과물을 올리고 하트·따봉·댓글로 반응하는 스터디 결과물 갤러리(study-gallery)입니다.
목표는 두 가지였습니다.
"뭘 만들지 모르겠다"에서 시작해도 서비스까지 갈 수 있는지. 저도 처음에는 만들 게 없었습니다. 그래서 아이디어 없이
/gatekit:discover부터 시작했습니다.디자인 참고 화면이 목업을 거쳐 실제 화면까지 얼마나 이어지는지. Figma 커뮤니티의 UI 키트 하나를 참고 디자인으로 주고, 목업과 최종 화면을 나란히 비교해 봤습니다.
첫 프롬프트부터 첫 배포까지 3시간 21분이 걸렸고, 지금은 스터디원 20명이 명단에 등록돼 있습니다.
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
사용한 도구
Claude Code + gatekit 플러그인: 명령 8개로 기획부터 구현까지 진행합니다. 스펙 없이 코드를 쓰면 막고, "완료"를 실행 가능한 명령으로 정의하게 하는 플러그인입니다.
Figma MCP: 디자인 단계에서 Figma 커뮤니티 UI 키트의 색, 글꼴, 부품을 읽어 왔습니다.
스택(인터뷰 중 gatekit이 제안): Next.js + Supabase + Vercel, 테스트는 Vitest와 Playwright(360px 모바일)
1. discover: 만들 문제 찾기 (6.5분)
프롬프트/gatekit:discover 뭘 만들지 모르겠는데, 이번 지피터스 클코스터디에서 한달 동안 서비스를 만들어 보고 싶은데 고민이야
gatekit은 기능을 묻지 않고 최근에 실제로 있었던 일을 물었습니다. 첫 질문은 "어제 컴퓨터나 휴대폰으로 한 일 중에 제일 오래 붙잡고 있었던 일이 뭐였어요?"였습니다. 15번을 주고받은 뒤 문제가 하나로 좁혀졌습니다. "결과물이 카톡 대화와 게시판에 흩어져 묻혀 있어서, 스터디장이 매번 30분 넘게 거슬러 찾아 모아야 한다."
2. interview: 무엇을 만들지 정하기 (12분)
프롬프트/gatekit:interview 위에서 발굴한 스터디용 웹사이트 만들이 귀한 인터뷰 진행하고 싶어
모든 질문에 추천 답이 붙어 있어서 대부분 번호로 답했습니다. 추천과 다르게 고른 것이 오히려 서비스의 성격을 만들었습니다.
반응 버튼: 추천은 하트 하나 → 하트와 따봉 따로
댓글: 추천은 답글 없음 → 답글까지
로그인: "구글 이메일이 아닌 사람을 위해 미리 등록하고 로그인 패스워드 방식도 추가해줘"
비슷한 서비스를 웹에서 조사해 기능 6개를 제안했고(추천은 4개), 저는 "1번부터 6번까지 다 넣어줘"라고 답했습니다.
결과는 기능 17개(F1~F17)입니다. 확인되지 않은 판단은 지어내지 않고 가정 원장에 번호로 남겼고, 최종 38개가 됐습니다. 예를 들어 "가정 14: 비밀번호 변경은 로그인 직후 별도 화면"이 그대로 구현됐습니다.

3. design: 참고 디자인에서 규칙 뽑기 (3.3분)
프롬프트/gatekit:design https://www.figma.com/design/zRijThkc7FZA5A8yCEpVT8/Task-management---to-do-list-app--Community-?node-id=1-87
참고한 Figma는 제 작업물이 아니라 커뮤니티의 "Task management & to-do list app" UI 키트입니다. gatekit은 Figma MCP로 화면 4장을 읽고 디자인 규칙 11개, 디자인 값 42개, 부품 14개를 뽑았습니다. 주 색 #5F33E1, 카드 모서리 15px, 하단 막대와 가운데 둥근 + 버튼 같은 것들입니다. 원본에 없는 것(한글 글꼴, 이미지 카드, 댓글 등)은 따로 표시해 두었습니다.
4. mockup: 코딩 전에 눌러 보기 (10분)
프롬프트/gatekit:mockup
시안 출처 질문에 대한 답방금 읽은 피그마 (추천)
확정없어, 이대로 확정해줘
화면 7개를 상태 4개(정상, 비어 있음, 오류, 로딩)와 역할 2개(스터디원, 스터디장)로 전환해 볼 수 있는 HTML 프로토타입 한 장이 나왔습니다. gatekit은 "피그마에서 가져온 건 색, 글꼴, 카드·버튼·칩·하단 메뉴 모양이에요. 일곱 화면의 배치와 빈 상태·오류·로딩 모양은 모두 제가 설계한 것이에요."라고 설명했습니다. 저는 고칠 것 없이 한 번에 확정했는데, 이것이 나중에 아쉬운 점이 됐습니다(아래 "배운 점").
5. tasks: 자기완결 작업으로 쪼개기 (7분)
작업 10개, 5라운드로 나뉘었습니다. 각 작업에는 건드려도 되는 파일(write_scope), 구체적인 화면 문구까지 담긴 지시, 그리고 끝났는지 판정하는 명령(gates)이 붙습니다. 범위 밖의 파일을 쓰려 하면 게이트가 막습니다.

6gate: "완료"를 먼저 정하고 승인하기 (6.5분)
프롬프트/gatekit:gate
승인이대로 승인
완료 기준 26개가 나왔습니다. 작업별 e2e 테스트, 화면 캡처 10장, 처음부터 끝까지 한 번에 도는 여정 테스트, 타입 검사가 들어 있습니다. 승인하면 SHA-256 해시가 박혀서, 나중에 기준 파일을 고치면 승인이 자동으로 무효가 됩니다. 저는 "완료로 보지 않는 조건"이 특히 마음에 들었습니다.

7. build: 게이트가 판정하는 구현 (50분)
프롬프트/gatekit:build
지금 대화하는 세션이 작업을 하나씩 구현하고, 작업이 끝날 때마다 그 작업의 게이트가 통과 여부를 판정했습니다. 결과는 10개 작업 모두 통과였고, 그중 2개는 재시도 끝에 통과했습니다.
project-detail: 게이트의 파일 패턴
[id]가 문자 묶음으로 읽혀 파일을 못 찾았습니다. 패턴을 고쳐 다시 판정했습니다.gallery: 게이트의 60초 상한에 걸렸습니다. 테스트를 합쳐 43초로 통과했습니다.
전체 회귀 테스트에서 실제 버그를 하나 찾았습니다. 하트를 누른 직후 따봉을 누르면 따봉이 무시되던 문제였습니다.
승인된 여정 테스트 자체에도 결함이 있었습니다. "로그인" 버튼을 찾는 코드가 "Google로 로그인"까지 잡았습니다. gatekit은 승인된 파일을 마음대로 고치지 않고 물었고, 저는 "테스트 한 줄 고치기 (추천)"를 골랐습니다.
완료 기준 26개가 모두 통과한 뒤, GitHub에 올리고 Vercel과 Supabase(서울)로 배포했습니다.
프롬프트study-gallery 깃헙 배포해줘
배포 설정 질문에 대한 답1. (스터디장 이메일) 2.이메일 비밀번호 로그인으로 하자 3.서울 리전으로 해줘
결과와 배운 점
결과: 참고 디자인 → 목업 → 실제 화면
배포된 서비스는 study-gallery.vercel.app입니다(명단에 등록된 사람만 로그인할 수 있습니다). 아래 비교에서 빌드 화면은 gatekit이 완료 기준을 확인하면서 360px 폭으로 직접 찍은 캡처입니다. 그래서 테스트용 데이터와 체크무늬 이미지가 보이고, 개발 서버 표시(N)가 남아 있습니다.








목업 → 빌드는 거의 그대로 이어졌습니다. 배치, 문구, 버튼 위치, 빈 상태까지 목업에서 정한 대로 나왔습니다. 반면 피그마 → 목업 단계에서 빠진 것이 보입니다. 피그마 홈의 보라 요약 카드(HeroCard), 진행률 링, 파스텔 아이콘 타일이 목업에 없었고, 그래서 최종 화면에도 없습니다. 반응·조회 아이콘도 피그마 아이콘이 아니라 이모지로 들어갔습니다.
배운 점과 꿀팁
고칠 거라면 목업에서 고치세요. 배포 뒤에 홈 버튼을 두 번 바꿨습니다(로고형 버튼 → "흠, 미안해 그냥 록백하자" → 네모 로고 → "미안한데 로고 없애줘, 엄밸런스 하다"). 그러고 나서 물었습니다. "이런 작업을 목업에서도 프롬프트로 변경할 수 있는 거지? 코딩 전에..." 답은 "네"였습니다. 목업 단계에서는 문서 한 줄이면 끝나는 수정입니다. 저는 목업을 수정 0회로 확정했는데, 한두 번은 눌러 보고 고쳤어야 했습니다.
참고 디자인의 "부품"은 이름을 불러서 넣어 달라고 하세요. 나중에 "왜 저렇게 디테일하게 뽑지 못했던 걸까?"라고 물었더니, design 단계는 HeroCard·IconTile을 이미 뽑아 두었는데 화면 명세와 작업으로 넘어가는 과정에서 빠졌다는 답이 돌아왔습니다. 게이트는 동작을 검사할 뿐, 디자인이 얼마나 충실한지는 보지 않습니다. 목업 단계에서 "피그마 홈의 보라 요약 카드를 갤러리 위에 넣어줘"처럼 부품 이름을 대는 것이 가장 확실합니다. 이 경험은 gatekit의 다음 설계 과제(ADR-0025 초안: 디자인 요소 추적)가 됐습니다.
인터뷰에서 추천과 다르게 답한 곳이 서비스의 개성이 됩니다. 하트·따봉 분리, 답글, 이메일 로그인 추가는 모두 추천을 거절한 답이었고, 실제 화면에 그대로 남았습니다.
게이트가 실제 버그를 잡습니다. 하트 직후 따봉이 무시되던 문제, 검색한 뒤 상세로 가면 갤러리로 되돌아가던 문제는 사람이 화면을 보기 전에 게이트 실패를 따라가다 찾았습니다.
"완료로 보지 않는 조건"을 먼저 써 두면 AI의 "다 됐습니다"를 덜 믿어도 됩니다. 테스트 skip, 시간 초과, 자리표시 컴포넌트, 화면에서 닿을 수 없는 기능을 미리 적어 두었습니다.
시행착오
빌드가 끝난 뒤 세션이 3시간 47분을 더 돌았습니다. 코딩은 50분이었는데, 빌드가 끝난 뒤에도 질문할 때마다 Stop 게이트가 완료 기준 26개를 전부 다시 돌렸습니다. 한 번에 348~483초씩 걸렸고, 제가 7번 중단했습니다. 결국 "hook 작업 다 지워줘"까지 말했습니다. 이 측정을 바탕으로 gatekit을 고쳤습니다. 0.13.0에서는 결과 재사용과 기준 재구성으로 26개를 7개(161초)로 줄였고, 0.16.0부터는 빌드가 끝나면 Stop 게이트가 물러납니다.
verify(독립 검증)를 건너뛰었습니다. 위 문제 때문에 지쳐서 "검증 없이 완료된 산출물 확인해 보자"로 넘어갔습니다. 다른 세션이 채점하는 단계를 실제로는 돌리지 않은 셈이라, 다음 프로젝트에서는 꼭 돌려 볼 생각입니다.
배포 후 사이트가 느렸습니다. Vercel 함수는 미국 동부, DB는 서울이었습니다. 함수를 서울(
icn1)로 옮겨 첫 응답이 0.62초에서 0.17초가 됐습니다.CSV 업로드 때 한글이 깨졌습니다. 엑셀이 저장한 EUC-KR 인코딩 때문이었습니다. 인코딩을 자동으로 판별하게 하고, 붙여넣기 입력도 추가했습니다.
구글 로그인 설정을 여러 번 왕복했습니다. Supabase에서 Google 토글을 켜고 저장하지 않아 "provider is not enabled" 오류가 났습니다.

도움이 필요한 부분
Figma 같은 참고 디자인을 목업과 최종 화면까지 충실하게 이어 가는 각자의 방법이 궁금합니다.
study-gallery를 쓰면서 불편한 점이 있으면 알려 주세요. 스터디 결과물을 올리는 곳으로 계속 쓸 예정입니다.
앞으로의 계획
다음 프로젝트에서는 목업을 최소 한 번 고쳐 보고, verify까지 실제로 돌려 보겠습니다.
gatekit에 디자인 요소를 화면 명세와 작업까지 추적하는 기능(ADR-0025)을 넣을 계획입니다.
스터디 4주차에 실제 사용 기록(올린 결과물 수, 반응 수)을 정리해 공유하겠습니다.
도움 받은 글 (옵션)
참고 디자인: Figma Community "Task management & to-do list app" UI 키트
gatekit 저장소: github.com/gatebound/gatebound (스터디 후 gatebound로 이름 변경 예정)
완성된 서비스: study-gallery.vercel.app


로미오님, “뭘 만들지 모르겠다”에서 스터디 결과물이 흩어지는 문제를 발견해 갤러리로 이어 간 흐름이 생생해요.
추천안을 그대로 따르지 않고 하트·따봉을 나누고 답글과 이메일 로그인까지 정하신 선택이 서비스의 개성을 만든 것 같아요.
Stop 게이트가 빌드 뒤에도 26개 기준을 반복해 시간이 늘어난 경험을 7개 기준으로 줄인 개선까지 공유해 주신 점도 유익해요. 다음에는 목업 수정과 독립 검증까지 해 보신다는 계획을 응원해요.
스터디원들이 결과물을 쌓아 갈 모습이 기대되네요. 고롱고롱, 다음 사용 기록도 기다릴게요 ✨