القائمة
미니앱 기본 틀(React + Vite + granite)을 세팅하고, PRD 에 맞춰 라우팅/서버 데이터/TDS 를 자동 판단해 설치합니다.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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회 후 종료.
앱인토스 콘솔 등록에 필요한 초기 이미지(로고/가로형 썸네일)/텍스트 리소스를 점검하고, 이미지 자동 생성 옵션 제공. 세로형 스크린샷은 implement 이후 /ait-screenshots 가 담당
앱인토스 미니앱 전체 출시 플로우를 8단계(기획→리소스→스캐폴딩→TDS→구현→스크린샷→검수→빌드)로 순차 실행
앱의 .meta-dashboard.json을 PRD와 소스코드 분석으로 자동 생성합니다.
typecheck→lint→ait build 순서로 빌드하고 .ait 번들 용량 검증 및 콘솔 업로드 절차 안내
Claude 스킬·에이전트가 정상 동작할 수 있는 환경인지 점검. 시스템·MCP·에셋 도구·환경변수를 한 번에 확인하고 실패 항목에 대한 해결 가이드를 제공.
앱인토스 검수 체크리스트 기반 코드 리뷰. light(핵심만)/full(전수검사) 모드 지원