Menu
미니앱 기본 틀(React + Vite + granite)을 세팅하고, PRD 에 맞춰 라우팅/서버 데이터/TDS 를 자동 판단해 설치합니다.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
앱인토스 콘솔 등록에 필요한 초기 이미지(로고/가로형 썸네일)/텍스트 리소스를 점검하고, 이미지 자동 생성 옵션 제공. 세로형 스크린샷은 implement 이후 /ait-screenshots 가 담당
앱인토스 미니앱 전체 출시 플로우를 8단계(기획→리소스→스캐폴딩→TDS→구현→스크린샷→검수→빌드)로 순차 실행
앱의 .meta-dashboard.json을 PRD와 소스코드 분석으로 자동 생성합니다.
typecheck→lint→ait build 순서로 빌드하고 .ait 번들 용량 검증 및 콘솔 업로드 절차 안내
Claude 스킬·에이전트가 정상 동작할 수 있는 환경인지 점검. 시스템·MCP·에셋 도구·환경변수를 한 번에 확인하고 실패 항목에 대한 해결 가이드를 제공.
앱인토스 검수 체크리스트 기반 코드 리뷰. light(핵심만)/full(전수검사) 모드 지원
| name | ait-scaffold |
| description | 미니앱 기본 틀(React + Vite + granite)을 세팅하고, PRD 에 맞춰 라우팅/서버 데이터/TDS 를 자동 판단해 설치합니다. |
| argument-hint | <app-name> |
| mode | automated |
| step | 3 |
| label | 프로젝트 틀 만들기 |
| produces | 최소 앱 구조 + 선택한 추가 기능 |
| requires | ["ait-plan"] |
| inputs | [{"key":"displayName","type":"text","required":false},{"key":"primaryColor","type":"color","required":false},{"key":"appType","type":"select","values":["partner","game"],"required":false}] |
| outputs | [{"key":"project","type":"directory","path":"apps/<appName>/"}] |
| idempotencyKey | ait-scaffold |
미니앱이 일단 켜지는 최소 구성을 세팅하고, 기획서(PRD) 에서 필요하다고 판단된 추가 기능들을 하나씩 확인받아 덧붙입니다.
예전에는 pnpm new-app 한 번에 React Router · TanStack Query · TDS 가 전부 박혀 나왔습니다.
하지만 실제로는 화면이 하나뿐인 단순 앱, 게임 앱(TDS 불필요), 로컬 데이터만 쓰는 앱도 많습니다.
꼭 필요한 것만 넣어야 번들 크기 · 이해할 코드량이 줄어들어요.
apps/<app-name>/ 이 이미 존재하고 package.json 이 stub(barreleye:stub: true) 이 아니면, step 1 은 스킵하고 바로 step 2 로 넘어간다. pnpm new-app <app-name> 으로 앱 폴더를 먼저 만든 뒤 진입한 경우 이 경로를 탄다.
앱 폴더가 없거나 stub 상태면:
pnpm new-app <app-name>
pnpm install
이 단계만으로 들어가는 패키지:
react, react-dom@apps-in-toss/web-framework (granite 필수)대시보드 inputs(displayName, primaryColor, appType) 가 전달됐으면 그 값으로 apps/<app-name>/granite.config.ts 를 수정한다. 누락된 값은 PRD 에서 추론하고, 그래도 애매하면 안전한 기본값(displayName = 영문 appName 의 공백 분해, primaryColor = #3182F6, appType = partner)을 사용한 뒤 완료 보고에 "선택: X (이유: ...)" 로 명시한다.
app.console.prdPath 또는 docs/prd/*.md 를 읽어, 아래 규칙으로 질문 없이 스스로 결정한다. 결정과 근거는 완료 보고에 한 줄씩 남겨 사용자가 사후에 추가/제거할 수 있게 한다.
| 기능 | 설치 규칙 | 설치 스킬 |
|---|---|---|
| 화면 이동 (React Router) | PRD 에 "홈/상세/결과" 같은 2개 이상 화면이 등장하면 설치. 애매하면 설치 안 함. | /ait-add-routing |
| 서버 데이터 (TanStack Query) | PRD 에 "API", "서버에서 가져와서", "외부 데이터" 문구가 있으면 설치. 로컬 저장으로 충분해 보이면 설치 안 함. | /ait-add-query |
| 토스 스타일 UI (TDS) | 비게임(partner) 앱이면 항상 설치 (앱인토스 정책상 필수). 게임(game)은 스킵. | /ait-tds-setup |
PRD 가 없거나 비어있으면: 라우팅·쿼리는 스킵, TDS 는 appType 규칙대로. 이유를 완료 보고에 명시.
위 규칙으로 "설치" 로 판정된 스킬을 순서대로 실행한다. 각 스킬은 독립적으로 idempotent 해야 하며, 이미 붙어있으면 건너뛴다. 설치 중 에러가 나면 해당 스킬만 스킵하고 사유를 보고에 남긴 뒤 다음으로 진행 — 멈추지 않는다.
pnpm --filter @barreleye/<app-name> typecheck
typecheck 가 통과하는지, granite.config.ts · package.json 이 의도한 값으로 쓰였는지 확인.
dev 서버는 띄우지 않는다 — automated 모드는 장시간 실행 프로세스를 기다리지 못한다.
사용자가 직접 pnpm --filter @barreleye/<app-name> dev 로 확인한다.
apps/<app-name>/ 최소 앱 구조위 검증까지 끝나면 짧은 완료 보고 한 번만 출력하고 세션을 마무리한다.
형식:
✅ 스캐폴딩 완료: apps/<app-name>/
설치된 기능: <선택한 기능 리스트>
typecheck OK
규칙: 완료 보고 1회 후 종료.