본문으로 건너뛰기

비개발자가 토스 미니앱 검수를 한 번에 통과한 방법: 검수 에이전트 따로 두기

은쌤T

2026.10.20

비개발자가 토스 미니앱 검수를 한 번에 통과한 방법: 검수 에이전트 따로 두기 본문 이미지

소개

다른 컴퓨터에서 만들다 만 토스 미니앱 '본전기록'을 Claude Code로 이어받아 하루 안에 콘솔 제출까지 마쳤어요. 앱을 만드는 에이전트와 정책을 검수하는 에이전트를 따로 둔 덕분에 첫 검토 요청이 반려 없이 승인됐고, 그날 저녁에는 광고 업데이트까지 내부 검수를 통과했어요.

바쁘시면 이것만 읽어도 돼요

  • 도구와 목표: Claude Code로 토스 미니앱을 이어 만들고, 콘솔 제출과 광고 업데이트까지 하기

  • 핵심 방법: 만드는 에이전트(toss-builder)와 검수하는 에이전트(toss-reviewer)를 나누고, 검수가 통과하기 전에는 제출하지 않기

  • 인상적인 순간: 만드는 쪽은 광고 자리가 "활성"이라고 보고했어요. 그런데 검수 쪽이 콘솔을 직접 조회해 보니 아직 "등록중"이었어요

  • 교훈: AI의 "다 됐어요"는 다른 AI나 실제 화면으로 한 번 더 확인해야 해요

이런 분들께 도움돼요

  • 토스 미니앱(앱인토스)을 처음 만들어 보는 비개발자

  • 검수에서 반려될까 봐 제출 버튼 앞에서 망설이는 분

  • AI가 고쳤다고 했는데 막상 보면 덜 고쳐져 있던 경험이 있는 분

문제 상황

'본전기록'은 물건을 쓴 날을 기록하면 "1회 사용 비용"을 보여 주는 앱이에요. 10만 원짜리 운동화를 50번 신었다면 한 번에 2천 원인 셈이죠. 쓸수록 이 금액이 내려가요. 기록은 서버 없이 휴대폰 안에만 저장돼요.

이 앱은 맥북에어에서 만들기 시작했어요. 그래서 남은 건 압축 파일 하나뿐이었고, 캐릭터도 로고도 콘솔 등록도 없었어요.

앞서 토스 미니앱 세 개를 내 보면서 알게 된 게 있어요. 반려 사유는 대개 내가 모르는 규칙에서 나와요. 확대 막기, 탭바 모양, 글자 크기 설정 같은 것들이에요. AI에게 "규칙 지켜서 만들어 줘"라고 하면 만드는 데 집중하느라 놓치는 게 생겨요. 그리고 고친 AI가 스스로 "다 고쳤어요"라고 보고하는 구조로는 그걸 잡기 어려웠어요.

이어받을 때 처음 보낸 요청이에요.

(압축 파일 경로) 맥북에어에서 만들던 토스미니앱이야. 이어서 작업하자.
(파일 구조 붙여넣기)
받은 자료도 넣어줄께.

진행 방법

사용한 도구

  • Claude Code — 전체 진행. 메인 대화가 두 에이전트를 이어 줘요

  • toss-builder 에이전트 — 앱을 만들고 고쳐요. 순서는 지난 세 앱에서 정리한 플레이북을 따라요

  • toss-reviewer 에이전트 — 토스 정책 기준표로 PASS / HOLD / FAIL 판정만 내려요. 코드는 고치지 않아요

  • 앱인토스 콘솔 MCP — 번들 업로드, 테스트 링크, 광고 자리 조회

  • Claude in Chrome — 콘솔 웹 제출 화면 입력

  • codex-image — 다람쥐 캐릭터와 로고

  • 모델: Claude Opus

에피소드 1. 캐릭터와 이름은 고르기만 했어요

캐릭터, 그림 스타일, 대표 칸, 브랜드 색은 AI가 추천안을 먼저 놓고 저에게 고르게 했어요. 다람쥐와 소프트 3D 스타일을 골랐어요. 12칸 시트에서 1번 칸을 대표 캐릭터로 정했어요.

브랜드 색은 원래 #3182F6이었어요. AI가 이 색이 토스 기본 파랑과 똑같다고 짚어 줘서 숲초록 #1F7A5C로 바꿨어요. 앱 이름, 부제, 카테고리, 콘솔 확약 5개도 같은 방식으로 정했어요. 홈 화면에 있던 영문 머리말 "LESS COST, MORE LIFE"는 한글 "쓸수록 가벼워지는 가격"으로 바꿨어요.

검색 키워드에서 "절약"을 뺀 것도 검수 에이전트의 의견이었어요. 앱 안에서는 "실제 절약액은 아니에요"라고 밝히는데, 키워드는 절약을 약속하는 것처럼 보일 수 있다는 이유였어요.

왼쪽 위 아이콘 다람쥐로 바꾸고 커밋해줘

에피소드 2. 첫 검수는 FAIL, 그다음 세 번은 PASS

규칙은 프로젝트 설정 파일(CLAUDE.md)에 적어 두었어요. 만드는 에이전트가 단계 끝에 "검수 필요"를 남기면, 저에게 넘기기 전에 메인 대화가 검수 에이전트를 먼저 불러요.

출시 전 검수(G2)의 기준은 52개 항목이에요. 첫 판정은 FAIL, 필수 위반 3개였어요.

  • 손가락으로 화면 확대가 돼요

  • 탭바가 토스식 떠 있는 모양이 아니에요

  • 코드 검사 도구(lint)가 없어요

셋 다 저는 몰랐던 규칙이에요. 고친 뒤 2차에 PASS를 받았어요.

그 사이 제 휴대폰에서도 문제가 나왔어요. 이건 제가 직접 보고 알렸어요.

기록관리 작은 글씨들이 너무 흐려. 잘 보이지 않아. 이것도 고쳐야 해. 기록파일 내려받기는 눌러도 아무 변화가 없는데?
큰 글자로 폰 설정을 바꾸어도 앱의 글씨크기는 바뀌지 않는데?

흐린 글씨는 만드는 에이전트가 "앱 전체에서 고쳤다"고 보고했어요. 그런데 검수 에이전트가 보니 회색을 정하는 변수 하나가 빠져 있었어요. 다음 번들에서 마저 고쳤어요. 큰 글자 문제는 휴대폰 글자 크기를 따르는 설정이 꺼져 있었고, 글자 크기 대부분이 고정값이었던 게 원인이었어요.

이렇게 고칠 때마다 검수를 다시 받았어요. 2·3·4차 모두 PASS였어요.

에피소드 3. 제출 화면은 크롬으로 채우고, 버튼은 내가

첫 제출은 MCP로 할 수 없고 콘솔 웹에서 해야 해요. 그래서 이렇게 물었어요.

다른 두 앱은 어사이드 브라우저에서 직접 올렸거든? 그것도 여기서 시킬 수 있어?

크롬을 연결하자 AI가 앱 정보, 로고, 스크린샷 3장, 키워드 7개, 주요 기능 3개를 채웠어요. 확약 체크박스와 제출 버튼은 제가 눌렀어요. 제가 "검수 올려"라고 말하기 전에는 AI가 검토 요청 버튼을 누르지 않게 규칙으로 막아 두었어요.

첫 시도는 입력 확인에서 걸렸어요. 주요 기능 이름 "오늘 썼어요"가 "명사·명사형으로 끝나야 합니다"라는 규칙에 맞지 않았어요. "오늘 사용 기록"으로 바꾸자 접수됐고, 첫 검토는 반려 없이 승인됐어요.

에피소드 4. "활성이에요"라던 광고 자리

승인이 나자마자 광고를 붙이기로 했어요.

바로 승인이 났네. 광고 붙이자.

광고는 사용 리포트 화면 맨 아래 배너 하나만 넣기로 했어요. 전면광고는 넣지 않았어요. 만드는 에이전트는 광고 자리를 만들고 "활성"이라고 보고했어요.

업데이트 검수(G3)에서 검수 에이전트가 콘솔을 직접 조회했어요. 결과는 "등록중"이었고, 광고 ID도 아직 발급 전이었어요. 광고 자리는 만든 뒤 구글 시스템에 반영되기까지 2시간쯤 걸린대요. 그대로 믿었다면 광고가 안 나오는 업데이트를 검수에 올렸을 거예요.

판정은 HOLD였어요. 2시간 뒤 다시 조회하니 "활성"이었고, 광고 ID도 코드에 넣은 값과 같았어요. 그제야 G3 PASS가 나왔어요.

그 2시간 동안 휴대폰으로 본 문제를 같이 고쳤어요.

  • 최근 7일 그래프가 칸 밖으로 나갔어요

  • 글자를 작게 바꿔도 작아지지 않았어요

  • 글자를 아주 크게 하면 표가 옆으로 밀렸어요

고친 번들에서 막대 옆 "일" 글자에 막대 색이 묻는 새 문제가 생겼어요. 이것도 검수 에이전트가 잡았어요.

같은 게이트를 세 번 돌아도 PASS가 안 나오면 멈추고 저에게 남은 항목을 보여 주라는 규칙도 있어요. 실제로 네 번째에 멈췄어요. 남은 건 광고 자리 등록 대기 하나뿐이어서 "이대로 진행해"라고 답했어요.

사용한 프롬프트 전문

두 에이전트를 잇는 규칙이에요. 프로젝트 폴더의 CLAUDE.md에 넣어 두었어요.

## 두 에이전트로 진행한다

- `toss-builder` — 만든다. 순서는 `docs/MINIAPP-PLAYBOOK.md`
- `toss-reviewer` — 정책을 검수한다. 기준은 `docs/toss-policy/REVIEW-CRITERIA.md`. 코드는 고치지 않는다

메인 세션이 둘을 잇는다(에이전트끼리는 서로 부를 수 없다):

1. 미니앱 제작·다음 단계 요청 → `toss-builder`를 부른다.
2. builder 보고의 마지막 줄이 `🔍 검수 필요: toss-reviewer G<n> — <경로>`이면 **은쌤에게 넘기기 전에** 바로 `toss-reviewer`를 그 게이트·경로로 부른다.
3. reviewer가 FAIL/HOLD면 `↩︎ toss-builder 수정 필요` 항목을 builder에게 SendMessage로 넘겨 고치게 하고, 다시 2번. 같은 게이트를 3번 돌아도 PASS가 안 되면 멈추고 은쌤에게 남은 항목을 보여 준다.
4. PASS면 은쌤에게 보고: 판정 · 보고서 링크 · 은쌤이 실기기에서 볼 것 · 은쌤 결정 필요 항목.
5. builder가 "은쌤 결정 필요"를 남기면 AskUserQuestion으로 물어(추천 먼저) 답을 builder에게 SendMessage로 전한다.

## 은쌤만 하는 것

- 검수 요청은 은쌤이 "검수 올려"라고 말한 뒤 `/토스배포` 스킬로. **G2/G3 PASS 전에는 검수 요청을 권하지 않는다.**
- 최초 제출·약관 동의·출시하기·핵심 지표 설정은 콘솔 웹에서 은쌤이 한다.
- 반려를 받으면 사유 원문을 `docs/toss-policy/REVIEW-CRITERIA.md` 맨 아래 반려 기록 표에 한 줄 추가한다.

결과와 배운 점

확인된 결과

  • 첫 제출: 압축 파일만 있던 앱이 같은 날 콘솔 첫 검토 요청까지 갔고, 반려 없이 승인됐어요. (근거: 커밋 기록, 콘솔 라이브 버전 20261019-5)

  • 출시 전 검수(G2): 1차 FAIL(필수 위반 3)에서 2·3·4차 PASS(52항목 중 통과 37, 위반 0)가 됐어요. (근거: 검수 보고서 4개)

  • 광고 업데이트 검수(G3): HOLD 4번 뒤 PASS(통과 22, 위반 0)가 나왔어요. (근거: 검수 보고서 5개)

  • 광고 자리: "활성"이라는 잘못된 보고를 검수 에이전트가 "등록중"으로 바로잡았고, 2시간 뒤 실제로 활성이 된 걸 확인했어요. (근거: 콘솔 조회 결과)

  • 업데이트 번들: 광고 업데이트 번들(-10)은 G3 PASS 상태예요. 아직 토스에 검수를 올리지는 않았어요.

시행착오

출시 노트 초안에 "휴대폰 글자 크기를 바꾸고 돌아오면 앱 글자도 함께 바뀌어요"라는 문장이 들어갔어요. 검수 에이전트는 이 문장을 "사실인지 확인되지 않음"으로 보류했어요. 그리고 확인 방법을 적어 줬어요. 앱을 닫지 않은 채 글자 크기를 바꾸고 돌아왔을 때 바로 바뀌는지 보라는 거였어요.

그런데 저는 테스트 중에 이렇게 답했어요. 이 말이 그대로 전달돼서 보류가 풀렸어요.

글씨 크기는 바꾸는대로 잘 반영되고 있어.

나중에 검수 에이전트가 적어 준 방법대로 다시 해 보니 달랐어요.

지금은 폰에서 글자크기를 바꾼다고 바로바로 반영되지는 않는 것 같은데. 이건 토스 출시되고 반영되는지 확인해야 하는건 아니야?
닫았다 다시 여니까 바뀌어. 추천 문장으로 바꿔줘.

토스 앱은 미니앱이 열려 있는 동안 글자 크기 정보를 새로 주지 않는 것 같아요. 닫았다 다시 열어야 반영됐어요. 그래서 출시 노트는 "휴대폰 글자 크기 설정에 맞춰 앱 글자도 커지고 작아져요"로 고쳤어요. '돌아오면 바로'라는 뜻을 뺐어요.

검수 에이전트는 코드만 보고도 의심할 수 있었어요. 하지만 끝내 확인하는 건 휴대폰을 든 제 몫이었어요. 확인을 꼼꼼히 하지 않으면 검수 에이전트가 있어도 틀린 문장이 통과돼요.

꿀팁

  1. 만드는 AI와 검수하는 AI를 나누세요. 검수 쪽은 코드를 못 고치게 하고 판정만 내리게 해요. 그래야 "고쳤어요"라는 말을 그대로 믿지 않고 직접 확인해요.

  2. "다 됐다"는 바깥에서 한 번 더 확인하게 하세요. 콘솔 상태, 실제 번들 안의 문구처럼 바깥 결과를 직접 조회하게 하면 거짓 "활성"이 걸러져요.

  3. 결정은 추천안을 먼저 받으세요. 이름, 색, 광고 위치를 고르기만 하면 돼서 비개발자도 덜 지쳐요.

  4. 휴대폰 확인은 검수 에이전트가 적어 준 방법 그대로 하세요. "열어 둔 채로 바꿔 보기"와 "닫았다 열어 보기"는 결과가 달라요. 이번 일 뒤로 두 가지를 나눠 묻도록 플레이북에 넣었어요.

이렇게 하면 안 돼요

  1. AI가 "앱 전체에서 고쳤어요"라고 하면 거기서 끝내지 마세요. 이번에도 한 곳이 남아 있었어요.

  2. 휴대폰으로 확인하지 않은 동작을 출시 노트에 약속하지 마세요.

  3. 광고 자리를 만든 직후에 검수를 올리지 마세요. 2시간쯤은 "등록중"이에요.

다른 업무에 적용한다면

"만드는 쪽 + 기준표로 판정만 하는 쪽"은 앱이 아닌 일에도 쓸 수 있을 것 같아요. 예를 들면 강의 자료를 만들고 저작권·표기 기준으로 검수하는 일, 카드뉴스를 만들고 브랜드 기준으로 검수하는 일이에요. 아직 해 보지는 않았어요.

도움이 필요한 부분

다른 분들은 토스 미니앱 검수 기준을 어떻게 모으고 계신지 궁금해요. 개발자센터 문서 말고 실제 반려 사례가 있다면 기준표에 더하고 싶어요.

앞으로의 계획

광고 업데이트 번들을 토스 검수에 올릴 거예요. 승인되면 사용 리포트 맨 아래에 실제 광고가 나와요.

4

함께 이야기해요 4

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

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

은쌤T님, "다 됐어요"라는 만드는 쪽 보고와 달리 검수 에이전트가 콘솔을 직접 조회해 보니 광고 자리가 아직 "등록중"이었다는 장면이 인상 깊어요. 회색 변수 하나가 빠져 있던 것도 검수가 다시 잡았고요. 만드는 쪽과 판정하는 쪽을 나누고, "검수 올려"라고 말하기 전엔 제출 버튼을 못 누르게 막아 둔 규칙까지, 따라 해보고 싶은 구조예요.

첫 검수 FAIL(필수 위반 3개)에서 2~4차 PASS까지 가는 과정이 기록돼 있어서 더 믿음이 가요. 고롱고롱… 이런 글 보면 기분 좋아져요 ✨

백경_BK 프로필 이미지
백경_BK2026.10.22

아니 은쌔엠!! 너무 멋있어요.
벌써 3번째 출시까지 하시고,, ㅎㅎ 다음에는 저 대신해서 스터디 운영하셔도 되겠는데용!

시행착오들을 숨기지 않고 다 오픈해주셔서 너무 감사드려요!
저도 보면서 이럴 수 있구나 하고 배우게 됩니다 ㅎㅎ

체크check 프로필 이미지
체크check2026.10.22

저는 토스 미니앱 관련 가이드 문서를 로컬에 따로 저장해놓고 원본 링크랑 같이 확인하도록 했어요. (도움받고 싶은 부분에 대한 의견)

oneshot 프로필 이미지
oneshot2026.10.26

결과물을 신뢰하지 않고 반드시 검수를 한다는 것이 인상적이네요. 인사이트 얻어갑니다.

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

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

이런 사례도 있어요

사례 전체 보기