rupy1014
2e6c5b7924
- Update all appkit slash commands to use local docs/ directory - Add .gitignore to exclude docs/ folder - Update example files 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
285 lines
5.3 KiB
Markdown
285 lines
5.3 KiB
Markdown
---
|
|
description: 아이디어 스케치 - 막연한 아이디어를 서비스 컨셉으로 구체화
|
|
---
|
|
|
|
## User Input
|
|
|
|
```text
|
|
$ARGUMENTS
|
|
```
|
|
|
|
User input **must** be considered (if not empty).
|
|
|
|
## Overview
|
|
|
|
`/appkit.new` 뒤에 오는 텍스트가 앱 설명입니다.
|
|
|
|
**논리적 사고 5단계 워크플로우**:
|
|
|
|
```
|
|
1. /appkit.new → 아이디어 스케치 (어떤 서비스인지?) ← YOU ARE HERE
|
|
2. /appkit.mvp → MVP 범위 정하기 + 랜딩페이지
|
|
3. /appkit.ui → 화면설계서 (라우터, 화면, 컴포넌트)
|
|
4. /appkit.policy → 정책설계서 (비즈니스 규칙)
|
|
5. /appkit.visualize → 목업 생성 (HTML 프로토타입)
|
|
```
|
|
|
|
**출력 디렉토리**: `docs/`
|
|
|
|
---
|
|
|
|
## Execution Flow
|
|
|
|
### 1. 아이디어 스케치 (고객 중심 대화)
|
|
|
|
**Input**: 사용자의 자연어 앱 설명
|
|
|
|
**Step 1: 고객 문제 파악**
|
|
1. **무슨 문제를 해결하나?**
|
|
- 현재 고객이 겪는 불편함
|
|
- 기존 솔루션의 한계
|
|
|
|
2. **누가 이 문제를 겪나?**
|
|
- 주요 타겟 고객군
|
|
- 그들의 특성과 행동 패턴
|
|
|
|
**Step 2: 서비스 컨셉 제시**
|
|
|
|
```markdown
|
|
## 서비스 컨셉
|
|
|
|
**서비스명**: [추론한 이름 또는 사용자 입력]
|
|
|
|
### 핵심 문제와 해결책
|
|
|
|
**고객이 겪는 문제**:
|
|
- [구체적인 문제 1]
|
|
- [구체적인 문제 2]
|
|
|
|
**우리의 해결책**:
|
|
- [해결책 1]
|
|
- [해결책 2]
|
|
|
|
### 타겟 고객
|
|
|
|
**Primary (핵심 고객)**:
|
|
- [타겟 설명]
|
|
|
|
**Secondary (보조 고객)**:
|
|
- [보조 타겟 설명]
|
|
|
|
### 핵심 가치 (왜 써야 하나?)
|
|
|
|
1. **[가치1]**: [설명]
|
|
2. **[가치2]**: [설명]
|
|
3. **[가치3]**: [설명]
|
|
|
|
### 주요 기능 (고객 가치 중심)
|
|
|
|
1. **001-[feature]**: [설명]
|
|
2. **002-[feature]**: [설명]
|
|
3. **003-[feature]**: [설명]
|
|
|
|
### 수익 모델
|
|
|
|
- [수익원 1]
|
|
- [수익원 2]
|
|
|
|
---
|
|
|
|
이렇게 이해한 것이 맞나요? 수정하거나 추가하고 싶은 내용이 있나요?
|
|
```
|
|
|
|
**Step 3: 사용자 피드백 수신**
|
|
|
|
- "좋아", "Yes", "진행해" → Step 4로 이동
|
|
- 수정 요청 → 내용 업데이트 후 Step 2로
|
|
- 추가 기능 요청 → 기능 목록 추가 후 Step 2로
|
|
|
|
**Step 4: 최종 확인**
|
|
|
|
사용자가 확정하면:
|
|
|
|
```
|
|
✅ 서비스 컨셉 확정!
|
|
|
|
파일 생성 중...
|
|
```
|
|
|
|
---
|
|
|
|
### 2. 파일 생성 (사용자 확인 후에만)
|
|
|
|
**디렉토리 생성**:
|
|
- `docs/`
|
|
- `docs/specs/`
|
|
- 각 기능별 서브디렉토리 (`001-user/`, `002-venue/`, ...)
|
|
|
|
---
|
|
|
|
### 3. 서비스 컨셉 문서 생성
|
|
|
|
**File**: `docs/concept.md`
|
|
|
|
**Content**:
|
|
|
|
```markdown
|
|
# [서비스명] 서비스 컨셉
|
|
|
|
## 서비스 본질
|
|
[한 문장으로 서비스 정의]
|
|
|
|
## 해결하는 문제
|
|
- [문제 1]
|
|
- [문제 2]
|
|
|
|
## 타겟 고객
|
|
|
|
### Primary Persona
|
|
- [페르소나 설명]
|
|
|
|
### Secondary Personas
|
|
- [보조 페르소나들]
|
|
|
|
## 핵심 가치 제안
|
|
1. **[가치1]**: [설명]
|
|
2. **[가치2]**: [설명]
|
|
3. **[가치3]**: [설명]
|
|
|
|
## 주요 기능 (고객 가치 중심)
|
|
- **001-[feature]**: [설명]
|
|
- **002-[feature]**: [설명]
|
|
- **003-[feature]**: [설명]
|
|
|
|
## 비즈니스 모델
|
|
- [수익원 설명]
|
|
```
|
|
|
|
---
|
|
|
|
### 4. 개별 Spec 초안 생성
|
|
|
|
각 기능 디렉토리에 `spec.md` 파일 생성:
|
|
|
|
**File**: `docs/specs/001-[feature]/spec.md`
|
|
|
|
```markdown
|
|
# Spec: 001-[feature]
|
|
|
|
## Feature Name
|
|
[기능명]
|
|
|
|
## User Value (고객 가치)
|
|
- [가치 1]
|
|
- [가치 2]
|
|
|
|
## Target User (누가 쓸까?)
|
|
- Primary: [타겟]
|
|
- Use case: [사용 시나리오]
|
|
|
|
## User Journey & Screen Flow
|
|
|
|
### 1. [화면명]
|
|
- **UI Elements**: [UI 요소들]
|
|
- **CTA**: [주요 버튼/액션]
|
|
- **Next**: [다음 화면]
|
|
|
|
## Business Rules
|
|
- [규칙 1]
|
|
- [규칙 2]
|
|
|
|
## Edge Cases
|
|
- [예외 상황 1]
|
|
- [예외 상황 2]
|
|
|
|
## Dependencies
|
|
- [의존성]
|
|
|
|
---
|
|
|
|
💡 **더 구체화하려면**: `/appkit.ui`, `/appkit.policy` 실행
|
|
```
|
|
|
|
---
|
|
|
|
### 5. 완료 리포트
|
|
|
|
```
|
|
✅ 서비스 컨셉 정의 완료!
|
|
|
|
📁 생성된 파일:
|
|
- docs/concept.md
|
|
- docs/specs/001-[feature]/spec.md
|
|
- docs/specs/002-[feature]/spec.md
|
|
- ...
|
|
|
|
📝 다음 단계:
|
|
|
|
**Step 2 - MVP 범위 + 랜딩페이지 (/appkit.mvp)**
|
|
/appkit.mvp
|
|
|
|
**Step 3 - 화면설계서 (/appkit.ui)**
|
|
/appkit.ui
|
|
|
|
**Step 4 - 정책설계서 (/appkit.policy)**
|
|
/appkit.policy
|
|
|
|
**Step 5 - HTML 목업 (/appkit.visualize)**
|
|
/appkit.visualize all
|
|
|
|
📍 현재 위치: Step 1/5 완료
|
|
```
|
|
|
|
---
|
|
|
|
## Important Notes
|
|
|
|
### 필수 요구사항
|
|
|
|
1. **인터랙티브 프로세스 필수**:
|
|
- 즉시 파일 생성 금지
|
|
- Step 2에서 항상 요약 제시
|
|
- 사용자 확인 후에만 파일 생성
|
|
|
|
2. **사용자 피드백 처리**:
|
|
- "좋아", "Yes", "진행해" → 파일 생성 진행
|
|
- 수정 요청 → 업데이트 후 재제시
|
|
- 불확실하면 추가 질문
|
|
|
|
3. **확인 전 반복**:
|
|
- 사용자 만족할 때까지 Step 2-3 반복
|
|
|
|
### 분석 가이드라인
|
|
|
|
1. **자연어 분석**:
|
|
- 사용자 입력 신중히 분석
|
|
- 도메인과 비즈니스 모델 추론
|
|
- 합리적인 주요 기능 도출 (5-8개)
|
|
|
|
2. **번호 체계**:
|
|
- 3자리 숫자 사용 (001, 002, 003, ...)
|
|
- 논리적 순서로 정렬
|
|
|
|
3. **기능명**:
|
|
- 짧고 명확하게
|
|
- 소문자 영어와 하이픈 사용
|
|
|
|
---
|
|
|
|
## Example Flow
|
|
|
|
```
|
|
User: /appkit.new 테니스 코트 예약 앱
|
|
|
|
Claude: [Step 2 요약 제시]
|
|
|
|
User: 레슨 예약도 추가해줘
|
|
|
|
Claude: [업데이트된 요약 제시]
|
|
|
|
User: 좋아!
|
|
|
|
Claude: ✅ 확정! 파일 생성 중...
|
|
[파일 생성 실행]
|
|
```
|