AI용 분할본 · 지도 0단계(규칙) · 이 페이지 전에 읽을 페이지: 없음 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)

핵심 규칙 — AI 는 어느 페이지에서든 이것을 지킨다

  1. 사용자가 결정 질문(PART 0 지침 1)에 답하고 승인하기 전에는 코드를 한 줄도 쓰지 않는다.
  2. HRUM API 키는 서버 환경변수 HRUM_API_KEY 에만 둔다. 미니앱 코드·.env·채팅·커밋·로그에 쓰지 않고, 키 값을 사용자에게 달라고 하지 않는다. 미니앱은 내 서버만 부른다.
  3. 책 코드 파일은 다시 쓰지 않는다 — node scripts/get-book-code.mjs 가 책 그대로 만든다(처음에는 부록 A-2 의 curl 한 줄). 분할본의 코드 자리는 「경로」 한 줄이다 — 받은 파일을 cat 으로 읽는다.
  4. 앱인토스 내용은 각 장 끝 출처의 공식 문서가 우선이다. 다르면 문서를 따르고 사용자에게 알린다.
  5. 확인은 명령 출력으로 증명한다. 콘솔 화면(앱인토스·HRUM)은 사용자가 누르고, AI 는 대신 가입·로그인하지 않는다. 진행은 PROGRESS.md 에 적는다.
  6. AI 는 지도(https://console.hrum.ai/tossEbook/ — 같은 지도가 tossEbook/ai.html 에도 있다)의 단계 순서대로 그 단계의 페이지만 읽는다. 전체본 tossEbook.html 은 사람용이다.

PART 0 — 이 책의 사용법 (꼭 읽고 시작)

이 책은 HRUM(흐름) API 하나로 토스 앱 안에서 열리는 미니앱을 만드는 실행형 전자책입니다. 예시 앱은 생년월일을 넣으면 그날의 흐름·행운 색·좋은 시간을 보여 주는 「오늘의 운세」입니다. 미니앱 화면(번들)은 앱인토스 콘솔에 올리고, HRUM API 키를 가진 작은 서버는 RIDM Apps 에 올립니다.

먼저 알아 두세요: HRUM(흐름)과 RIDM Apps 는 플로트 주식회사가 운영하는 서비스이고, 토스(비바리퍼블리카)와 제휴하지 않은 독립 서비스입니다. 앱인토스 콘솔 가입·앱 등록·검수·출시는 여러분이 앱인토스 정책에 따라 직접 진행하며, 이 책은 검수 통과를 보장하지 않습니다. 앱인토스에 관한 내용은 공식 개발자센터 문서를 요약한 것이고, 문서와 이 책이 다르면 문서가 맞습니다.

0-1. 누가 무엇을 하나

여러분이 직접AI 코딩 도구가
앱인토스 콘솔 가입·워크스페이스·앱 등록(PART 2)
HRUM 콘솔 가입·이메일 인증·API 키 발급(PART 2)
RIDM Apps 환경변수 칸에 키 넣기(PART 5)
번들 업로드·토스 앱 QR 테스트·검수 요청·출시하기 버튼(PART 6~7)		결정 질문 정리, 책 코드 받기, 테스트 실행, 번들 만들기, 배포 뒤 확인 명령 실행, 체크리스트 점검, PROGRESS.md 기록

가입·약관 동의·본인 확인·비밀값 입력은 사람만 합니다. AI 가 대신 가입하거나 콘솔에 로그인하지 않습니다.

0-2. [AI 시작 지침]

  1. 먼저 묻는다, 한 번에. 아래 결정 질문을 추천값과 함께 한 번에 묻고, 사용자가 승인하기 전에는 코드를 한 줄도 쓰지 않는다. ① 앱인토스 appName(콘솔에 등록할 값과 똑같아야 하고, 등록 뒤에는 바꿀 수 없다 — 추천: 짧은 영문 소문자와 하이픈, 예 my-today) ② 미니앱 이름(국문, 토스 앱에 보이는 이름) ③ RIDM Apps 앱 이름(서버 주소 <이름>.ridm.ai 가 된다) ④ 태어난 시각 입력(추천: 받되 「몰라요」 허용 — 책 코드 그대로).
  2. 책 코드는 다시 쓰지 않는다. 「[완전 코드] 경로」 블록은 node scripts/get-book-code.mjs 로 원문 그대로 받는다(처음에는 부록 A 의 curl 한 줄). 고쳐도 되는 파일은 miniapp/apps-in-toss.config.ts(appName), miniapp/index.html(문구), miniapp/src/style.css(모양), miniapp/.env.example 뿐이다. AI용 분할본의 코드 자리는 「경로」 한 줄이다 — 받은 파일을 cat 으로 읽는다.
  3. HRUM API 키는 서버 환경변수 HRUM_API_KEY 에만 있다. 미니앱 코드·.env·채팅·커밋·로그·PROGRESS.md 에 쓰지 않는다. 미니앱은 api.hrum.ai 를 직접 부르지 않는다 — 미니앱 빌드의 check-bundle 이 그런 번들을 막는다.
  4. 앱인토스 내용은 공식 문서가 우선이다. 각 장 끝 출처의 문서와 이 책이 다르면 문서를 따르고, 무엇이 달랐는지 사용자에게 알린다.
  5. 확인은 명령 출력으로 한다. 「됐다」고 말하기 전에 지도에 적힌 증거 명령을 실행해 출력을 그대로 보인다. 진행 상황은 프로젝트 폴더의 PROGRESS.md 에 적고, 이어서 할 때는 PROGRESS.md 의 다음 단계부터 간다.
  6. 콘솔은 사용자가 누른다. 앱인토스 콘솔·HRUM 콘솔 화면에서 할 일은 순서대로 안내하고, 사용자가 화면에 무엇이 보이는지 말해 주면 다음으로 간다. 짐작하지 않는다.
  7. 홍보 문구 규칙을 지킨다. 미니앱 안팎의 문구에 「토스 공식」「공식 파트너」「제휴」「입점」 같은 표현과 토스 로고를 쓰지 않는다(PART 7-5).

0-3. 이 책으로 만드는 것과 만들지 않는 것

출처

앱인토스 내용은 2026-10-28 에 앱인토스 개발자센터 문서를 직접 읽고 요약했고, 2026-10-30 에 문서와 다시 대조했습니다. 정책·화면은 바뀔 수 있으니 시작 전에 원문을 다시 확인하세요.

AI용 분할본 · 지도 0단계(규칙) · 이 페이지 전에 읽을 페이지: 없음 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)