앱인토스 풀스택 템플릿 프로젝트의 대화형 온보딩 가이드. 사용 가능한 모든 스킬(.claude/skills/), Robin SDK 예제(with-*, scenario-*), Claude Code 에코시스템 설치법(Superpowers, Ouroboros, OMC), CLAUDE.md/AGENTS.md 작성법을 동적으로 스캔하여 안내한다. 사용자가 궁금한 항목을 선택하면 해당 파일을 읽어 상세 설명을 제공한다. "어떤 스킬이 있어?", "뭐부터 해야 해?", "예제 보여줘", "도와줘", "가이드", "플러그인 설치", "CLAUDE.md 작성법", "robin 예제" 등의 요청에 트리거된다.
이 프로젝트의 모든 스킬, 예제, 에코시스템을 대화형으로 안내하는 가이드. 하드코딩된 목록이 아니라 실제 파일을 동적으로 스캔하므로, 프로젝트가 변해도 항상 최신 상태를 반영한다.
모든 응답은 한국어로 작성한다.
Step 1: 스캔 & 표시 → Step 2: 질문 → Step 3: 상세 설명 → Step 4: 반복/종료
(Glob + Read 헤더) (AskUserQuestion) (Read 전체 파일) (추가 질문 또는 끝)
런타임에 동적으로 카탈로그를 구성한다. 아래 카테고리 구분은 구조 가이드일 뿐, 실제 데이터는 반드시 파일 시스템에서 읽어온다.
1a. 스킬 스캔
Glob(".claude/skills/*/SKILL.md") 실행. 각 결과의 처음 15줄을 읽어
YAML frontmatter의 description을 추출한다. 아래 카테고리로 분류:
| 카테고리 | 이름 패턴 |
|---|---|
| 앱인토스 SDK | appintoss-* |
| Harness 워크플로우 | harness-* |
| Superpowers | superpower-*, using-superpowers |
| 웹 개발 | 그 외 전부 |
번호가 매겨진 표로 출력: | # | 스킬 | 명령어 | 설명 |
1b. Robin 예제 스캔
Glob("apps-in-toss-examples-robin/with-*/README.md") 와
Glob("apps-in-toss-examples-robin/scenario-*/README.md") 실행.
각 README의 3번째 줄 (> 설명 라인)을 읽어 한줄 요약을 추출한다.
두 개의 하위 표로 출력:
with-* — 단일 SDK 기능 예제scenario-* — 풀스택 (client + server) 시나리오 예제1c. 에코시스템 가이드 메뉴 표시
아래 짧은 메뉴를 출력한다 (상세 내용은 reference 파일에 있음):
에코시스템 가이드:
A. CLAUDE.md 작성 베스트 프랙티스
B. AGENTS.md 작성 베스트 프랙티스
C. 플러그인 설치법 (Superpowers / Ouroboros / OMC)
D. 에이전트 세트 (VoltAgent / Agency Agents)
AskUserQuestion으로 아래 옵션을 제시:
스킬 선택 시:
SKILL.md 전체를 읽는다Robin 예제 선택 시:
README.md를 읽는다Glob으로 예제 디렉토리의 파일 구조를 확인한다with-*(단일 기능, 클라이언트만)인지 scenario-*(풀스택, Express 서버 포함)인지 구분에코시스템 가이드 선택 시: 적절한 reference 파일을 읽어 내용을 안내:
상세 설명 후, AskUserQuestion으로 추가 질문이 있는지 묻는다:
사용자가 요청할 때만 로드되는 상세 가이드. 메인 스킬을 가볍게 유지하면서 필요 시 깊은 정보를 제공한다.
@apps-in-toss/web-framework SDK 2.0.1 기반이며, dynamic import + isSupported() 체크 패턴을 사용한다.