plan

plan skill

목적

/ait:plan은 아이디어가 없는 상태에서도 시작할 수 있는 기획 station이다. 사용자가 서 있는 지점에 따라 세 구간을 이어서 진행한다:

1. 아이데이션 — 아이디어가 막연할 때 발산 → 실현성 필터 → 후보 1개로 수렴
2. PRD 디스커션 — 미니앱용 경량 PRD 9섹션을 대화로 채워 PRD.md로 남김
3. 매핑 — 그 PRD에서 출시까지 필요한 세 가지를 뽑는다:
   • SDK 도메인 — 어떤 @apps-in-toss/web-framework API 그룹이 필요한가
   • 권한(permissions) — 그 도메인들이 런타임에 사용자에게 요청하는 권한
   • 약관(terms) — 등록·배포 시 콘솔이 게이트하는 워크스페이스 약관

요구사항이 이미 또렷하면 1·2를 건너뛰고 3만 해도 된다(아래 "입력"의 모드 판정).

전제: 미니앱은 토스 앱 WebView에서 도는 웹(React DOM) 앱이지 React Native 앱이 아니다 — 계획·아키텍처를 웹 스택 기준으로 세우고 RN/네이티브 화면 경로를 전제하지 않는다. 이 전제와 검수 존재가 아이데이션의 실현성 필터를 이룬다.

이 skill은 harness의 첫 station이다(station 7 "plan"은 개발 순서상 마지막에 추가됐지만, 흐름상으로는 scaffold 앞에 온다). 빈 디렉토리에서 /ait:new로 프로젝트를 만들기 전에, 무엇을 쓰게 될지 미리 지도를 그려서 나중에 register/deploy에서 약관 게이트에 막혀 되돌아오는 일을 줄인다.

이 skill은 기획만 한다. CLI를 호출하지 않고, 아무것도 등록하지 않으며, 프로젝트를 만들지 않는다. 쓰는 파일은 PRD.md 하나뿐이다(아래 "산출물"). hand-off는 /ait:new다.

도메인·권한·약관 이름을 지어내지 않는다. 확신이 없으면 docs MCP (searchDocumentation/getPage)로 문서를 조회하거나 사용자에게 되묻는다. 산출하는 계획·안내에 과장·홍보성 문구는 넣지 않는다.

입력

$ARGUMENTS를 읽고 모드를 먼저 판정한다. 모드가 실행 순서의 진입점을 정한다.

모드	판정 기준	진입
A. 아이데이션	인자 없음, 또는 "뭘 만들지 모르겠다"류	1단계부터
B. PRD	아이디어 한 줄은 있으나 화면·범위가 안 잡힘	3단계부터
C. 매핑	기능이 문장으로 나열될 만큼 또렷하거나 PRD.md가 이미 있음	5단계부터

• 모드 C의 <요구사항> 예:

  • "사용자 위치 기반으로 주변 매장을 보여주고, 로그인하면 즐겨찾기를 저장한다"
  • "디지털 아이템을 인앱 결제로 판매하는 게임"

• 인자 없이 호출되면 모드를 한 줄로 확인한다:

  만들고 싶은 미니앱이 정해져 있나요?
    - 아직 막연하다 → 아이디어를 같이 좁혀갑니다
    - 한 줄로는 있다 → PRD를 같이 채웁니다
    - 기능이 정해져 있다 → 그대로 알려주시면 SDK 도메인·권한·약관으로 정리합니다
  

모드 C에서도 도메인·약관 분기를 가르는 모호함이 있으면(결제가 토스페이 체크아웃인지 인앱 디지털 재화(IAP)인지, 로그인이 필요한지) 그 부분만 짧게 되묻는다. 과도한 인터뷰는 하지 않는다.

산출물

• PRD.md — 모드 A·B를 탄 경우 현재 디렉토리에 쓴다. 형식은 references/prd-template.md의 9섹션 고정. 이미 파일이 있으면 덮어쓰지 않고 이어서 갱신할지 묻는다. 모드 C(요구사항이 이미 또렷함)에서는 사용자가 요청할 때만 쓴다.
• 계획 블록 — 대화 출력. SDK 도메인·권한·약관 + 다음 station seam(8단계).

/ait:plan은 scaffold 전에 도는 station이라 PRD.md는 보통 프로젝트 디렉토리가 생기기 전 위치에 놓인다. /ait:new <app-name> 후 <app-name>/으로 옮겨 두면 이후 station에서 참조하기 쉽다 — 옮기는 것은 사용자 몫이고 이 skill이 파일을 이동시키지 않는다.