본문으로 건너뛰기

[Claude Code + gatekit] 여러 AI 한 팀으로 굴린 2주, 가이드 밖에서 배운 것

냐옹냐옹

2026.10.13

[Claude Code + gatekit] 여러 AI 한 팀으로 굴린 2주, 가이드 밖에서 배운 것 본문 이미지

「연산 놀이터」(초등 연산 웹앱)를 Claude Code, Codex, gatekit으로 2주 동안 만들었습니다. 분해, first cut, 커밋은 가이드에 잘 나와 있어서 짧게만 적고, 실제로 부딪힌 것 위주로 씁니다.

과제 결과

  • 작업 49개(6라운드)로 쪼갰습니다. 첫날 놀이터 1곳이 홈 → 5문제 → 결과 → 스티커까지 돌게 만든 것이 first cut입니다.

  • 게이트를 통과한 작업만 커밋했습니다. 그런데 고치기 작업 9개의 게이트가 아무것도 안 고쳐도 통과했습니다. 이미 있던 시험을 가리키고 있었기 때문입니다. 작업 전에 게이트가 실패하는지부터 봤어야 했습니다.

  • verify에서 작업 38개는 모두 통과했지만 완료 기준은 7/8이었고, 화면 캡처 25장은 전부 지적을 받았습니다.

1. 만드는 AI와 판정하는 AI를 나눴다

처음엔 Claude 에이전트 13개로 놀이터를 한꺼번에 만들었습니다. 사용량 한도에 이틀 동안 네 번 걸렸어요. 10/7부터는 구현을 Codex가 맡고, 게이트 실행과 커밋과 검증은 Claude가 맡았습니다. 한도가 따로라서 한쪽이 멈춰도 다른 쪽은 계속 갔습니다. Codex에게는 커밋을 금지했습니다.

Codex에 넘길 때는 다섯 가지를 꼭 넣었습니다. 작업 지시서 경로(읽기만), 쓸 수 있는 폴더, 색은 토큰 변수만, 기존 시험을 깨지 말 것, 커밋하지 말 것입니다. 스크립트로 codex exec를 부를 때는 < /dev/null을 붙이지 않으면 아무 말 없이 멈춥니다.

2. 세션이 여럿이면 작업마다 주인을 적는다

새벽에 Claude 세션 두 개가 같은 작업(app-shell)을 Codex에 동시에 맡겼고, App.tsx가 서로 덮어써졌습니다. 폴더는 나눠 뒀는데 주인을 정하지 않은 게 원인이었습니다. 지금은 docs/handoff.md 맨 위에 "작업 → 담당 세션" 표를 두고, 끊기면 그 파일부터 읽고 이어 가도록 AI 메모리에 넣었습니다.

3. 시험이 통과해도 리뷰어는 반려했다

놀이터 1곳을 만들고 단위 시험 194개가 모두 통과한 상태에서 리뷰어 넷을 붙였습니다. 코드 리뷰어와 수학 선생님은 반려했고, CX 리뷰어와 게임 덕후는 조건부 통과였습니다. 지적은 코드 14, 수학 9, CX 15, 게임 12개였습니다.

한국어 숫자가 적힌 테이블

가장 중요했던 건 여러 리뷰어가 같은 곳을 짚은 지적입니다. "정답 선택지에만 그림 단서가 붙어서 문장을 안 읽고도 맞힌다"는 문제를 코드, 수학, 게임 리뷰어가 각자 다른 말로 짚었습니다. 이런 지적부터 먼저 고쳤습니다.

리뷰어들은 연출을 줄이자는 쪽으로 기울었습니다. 그대로 따랐다면 제가 원하던 "도파민 터지는 재미"가 사라졌을 겁니다. 그래서 "벌주는 느낌만 없애고, 성공 연출은 풍성하게"라는 기준을 따로 정해 리뷰어에게 전달했습니다. 리뷰어는 프로젝트의 우선순위를 모르니 알려 줘야 합니다.

4. 테스트는 통과했는데 아이 화면은 엉망이었다

작업 38개가 모두 통과한 뒤 verify를 돌렸습니다. 평가 에이전트가 캡처 25장을 한 장씩 봤더니 전부 걸렸습니다(fail 3, warn 22). 시험으로는 하나도 안 잡혔던 것들입니다.

  • 아이콘 자리에 이모지를 씀 (🏠 ⭐ 🔒)

  • 배경을 빼먹어서 크림색 단색 화면이 많음

  • 화면 아래 40~60%가 빔

  • 안내 손가락이 완료 단추 글자를 가림

  • 같은 빈 격자를 18번 반복해서 앨범이 세로 22,225px

  • 되감기 타워에 탑이 없고, 돋보기에 볼 물건이 없음

  • "커다란 암탉" 보스가 모자 쓴 병아리 그림

  • 이름 없는 흰 단추, 빈 흰 막대가 놀이터 3곳에 있음

AI에게 아이 화면을 맡긴다면 이 목록을 처음부터 작업 지시에 넣으세요. 저는 그러지 않아서 고치기 작업이 11개나 생겼습니다.

게임 한국어 지침 스크린샷

디자인도 말로만 시켜서는 안 됐습니다. "컬러풀한 어린이 게임 느낌"이라고 했을 때는 4차까지 엎었습니다. 10/6에 기준 그림 한 장과 토큰 파일을 먼저 만들고 "토큰 밖의 색은 쓰지 마"를 넣은 뒤로 방향이 모였습니다. 나중에 다크 모드를 급하게 시켰을 때 토큰 밖 색 57개를 잡아낸 것도 이 검사였습니다.

5. 비밀 키를 VITE_ 자리에 넣을 뻔했다

Supabase를 붙이면서 .env의 VITE_SUPABASE_URL 자리에 서버용 키(sb_secret_…)를 넣었습니다. VITE_ 값은 빌드하면 화면 코드에 그대로 들어가므로, 배포했다면 누구나 키를 꺼내 데이터베이스 보안 규칙을 건너뛸 수 있었습니다. 지금은 커밋 전에 세 가지를 봅니다. .env가 git에서 무시되는지, sb_secret·service_role이 커밋이나 dist/에 없는지, VITE_ 값이 URL과 공개 키뿐인지입니다.

다음에 다시 한다면

  • 첫 조각이 나오면 바로 리뷰어를 붙이겠습니다. 시험이 통과한 뒤에도 반려가 나왔습니다.

  • 세션을 여럿 열기 전에 주인 표부터 쓰겠습니다.

  • 아이 화면 체크리스트를 처음부터 작업 지시에 넣겠습니다.

아직 남은 것

고치기 작업 4개를 마치고 verify를 다시 돌려 8/8을 받아야 합니다. 실제 어린이만 좀 해보고 있어서, 초1~2 자녀와 10분만 놀아 봐 주실 분을 찾고 있습니다.

도구: Claude Code + gatekit, Codex CLI

1

함께 이야기해요 1

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

뽀짝이 프로필 이미지
뽀짝이2026.10.13

냐옹냐옹님, 2주 동안 부딪힌 것 위주로 정리해 주신 글이라 읽는 내내 도움이 됐어요. 특히 고치기 작업 9개의 게이트가 아무것도 안 고쳐도 통과했다는 대목, "작업 전에 게이트가 실패하는지부터 봤어야 했다"는 교훈은 바로 가져다 쓰고 싶었습니다.

단위 시험 194개가 통과한 뒤에도 리뷰어 넷이 반려했고, 코드·수학·게임 리뷰어가 "정답 선택지에만 그림 단서가 붙는다"를 각자 다른 말로 짚었을 때 그 지적부터 고치셨다는 기준도 인상 깊었어요. 리뷰어는 프로젝트의 우선순위를 모르니 "벌주는 느낌만 없애고 성공 연출은 풍성하게"처럼 알려 줘야 한다는 부분, 그리고 캡처 25장이 전부 걸렸다는 verify 결과가 '테스트 통과'와 '쓸 만한 화면'이 다르다는 걸 잘 보여 줍니다.

VITE_ 자리에 서버용 키를 넣을 뻔한 경험을 커밋 전 체크 세 가지로 남겨 주신 것도 다음 분들께 큰 도움이 될 것 같아요. 남은 verify 8/8 결과와 초1~2 자녀분과의 10분 플레이 후기도 기다리겠습니다. 꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛

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

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

이런 사례도 있어요

사례 전체 보기