Clauders/appkit
13
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

example update

Browse Source
This commit is contained in:
rupy1014
2025-12-05 23:22:01 +09:00
parent 0e59386d54
commit 91d0d6e3bd
4 changed files with 2917 additions and 191 deletions
Download Patch File Download Diff File Expand all files Collapse all files

248
README.md
View File

@@ -1,5 +1,7 @@
# AppKit Framework
> **[Clauders.ai](https://clauders.ai/)** 운영자가 배포하는 아이디어 구체화 프레임워크입니다.
**아이디어를 고객 가치로 변환하는 논리적 사고 프레임워크**
---
@@ -16,6 +18,57 @@ AppKit은 막연한 아이디어를 고객 중심으로 구체화하여 MVP부
---
## 🚀 Quick Start (3단계로 시작하기)
### Step 1: 최초 질문으로 대화 시작
막연한 아이디어를 Claude에게 질문하고 대화하면서 구체화합니다.
```
예시 질문:
"맥비라는 국내 최대 기획자 모임이 있어. 10년간 운영해서 약 1만명의
오픈채팅방이 있고, 기획자료나 템플릿은 천개가 넘어.
이걸 구독서비스화 하려해. 어떤식으로 접근하는게 좋을까?"
```
### Step 2: 대화 내용을 아이디어 문서로 정리
충분히 대화한 후 정리를 요청합니다.
```
"지금까지 나눈 내용을 md로 정리해줘"
```
→ 결과물: `아이디어.md` (서비스 컨셉, 타겟, 가격, MVP 계획 등)
### Step 3: AppKit 명령어로 본격 기획
정리된 아이디어 문서를 기반으로 체계적인 기획을 시작합니다.
```
/appkit.new @아이디어.md
```
→ 결과물: 서비스 개요, 기능 분류, 핵심 가치 정리
---
## 📁 Example: 맥비 구독서비스 기획 과정
`example/` 폴더에서 실제 기획 과정을 확인할 수 있습니다.
```
example/
├── 1. 최초질문.md # 처음 던진 질문
└── 2. 맥비_구독서비스_아이디어.md # 대화 후 정리된 아이디어
```
| 단계 | 파일 | 설명 |
|------|------|------|
| 1 | `1. 최초질문.md` | 막연한 아이디어를 질문으로 시작 |
| 2 | (대화) | Claude와 Q&A로 구체화 |
| 3 | `2. 맥비_구독서비스_아이디어.md` | 정리된 서비스 컨셉 |
| 4 | `/appkit.new @아이디어.md` | 체계적 기획 시작 |
---
## 📋 Complete Workflow (논리적 사고 7단계)
```
@@ -39,6 +92,7 @@ AppKit은 막연한 아이디어를 고객 중심으로 구체화하여 MVP부
**Input**:
```
/appkit.new @아이디어.md
/appkit.new Tennis court booking app with coupons and promotions
```
@@ -46,7 +100,6 @@ AppKit은 막연한 아이디어를 고객 중심으로 구체화하여 MVP부
- `docs/appkit/overview.md` - 서비스 컨셉 & 핵심 가치
- `docs/appkit/specs/001-user/spec.md` - 빈 템플릿
- `docs/appkit/specs/002-venue/spec.md` - 빈 템플릿
- `docs/appkit/specs/003-booking/spec.md` - 빈 템플릿
- ...
**Key Features**:
@@ -207,160 +260,6 @@ AppKit은 막연한 아이디어를 고객 중심으로 구체화하여 MVP부
---
## 🌊 Workflow Example (고객 중심 논리적 사고)
### Example: Tennis Court Booking App
```bash
# Step 1: 아이디어 스케치 - "어떤 서비스인지?"
$ /appkit.new Tennis court booking with coupons and time deals
Claude:
📋 서비스 컨셉:
- 문제: 테니스 코트 예약이 번거롭고 비싸다
- 해결: 모바일로 간편 예약 + 자동 할인
- 타겟: 주말 운동을 원하는 30-40대 직장인
- 가치: 시간 절약, 비용 절감
주요 기능 분류:
- 001-user: 사용자 인증
- 002-venue: 코트 관리
- 003-booking: 예약/결제
- 004-promotion: 할인/쿠폰
- 005-review: 리뷰
✅ Created service concept & 5 feature specs
# Step 2: 기능 구체화 - "뭐가 필요할까? 누가 쓸까?"
$ /appkit.spec 003-booking "search courts from main screen"
💡 사용자 가치 분석:
- 뭐가 필요? → 실시간 코트 검색 기능
- 누가? → 퇴근 후 피곤한 직장인
- 언제? → 지하철/버스에서 이동 중
- 왜? → 빠르게 주말 운동 계획 세우기
- 어떻게? → 원터치로 가까운 코트 찾기
- 가치? → 5초 만에 예약 가능 확인
✅ User value added to spec
$ /appkit.spec 003-booking "time deal 30% within 2 days"
💡 사용자 가치 분석:
- 뭐가 필요? → 시간 기반 자동 할인 시스템
- 누가? → 유연한 시간대 가능한 프리랜서
- 언제? → 갑자기 시간이 생겼을 때
- 왜? → 저렴하게 운동하고 싶어서
- 가치? → 정가의 70%로 즉시 예약
✅ Features defined with user value
# Step 3: 고객 스토리 - "고객의 하루, 고민, 해결"
$ /appkit.customer
🎯 Primary Persona: 김대리 (35세, IT 기업)
하루 스토리:
07:00 - "오늘도 운동 못하겠네..." (죄책감)
12:00 - "주말엔 테니스 쳐야지" (결심)
18:00 - "코트 예약 전화... 귀찮다" (좌절)
19:00 - [앱 발견] "3초 만에 예약?" (희망)
19:02 - "토요일 오전 예약 완료!" (만족)
토요일 - "운동 후 상쾌한 주말" (성취)
✅ Customer persona & journey mapped
# Step 4: 세일즈 랜딩 구성 - "어떻게 설득할까?"
$ /appkit.sales
📢 Landing Message:
[Hook]
"매주 테니스 치고 싶은데, 예약이 너무 번거로우신가요?"
[Problem]
- 전화 대기 15분
- 원하는 시간 항상 만석
- 비싼 정가
[Solution]
"3초 예약, 자동 할인, 실시간 공석 확인"
[Proof]
"이미 5,000명이 매주 사용 중"
[CTA]
"지금 가입하고 첫 예약 30% 할인받기"
✅ Sales landing created
# Step 5: MVP 범위 - "최소한으로 검증하려면?"
$ /appkit.mvp
🎯 MVP Scope (2주 검증):
Phase 0 (핵심만):
- 코트 검색/예약
- 간단 결제
목표: 주 10건 예약
Phase 1 (1개월):
- 할인 쿠폰
- 사용자 리뷰
목표: 재방문율 30%
Phase 2 (3개월):
- 커뮤니티
- 코칭 매칭
✅ MVP phases defined
# Step 6: 기획 정돈 - "기획이 일관적인가?"
$ /appkit.merge
🔄 Planning Consolidation:
용어 통일성 확인:
- "예약" vs "부킹" → "예약"으로 통일
- "사용자" vs "유저" → "사용자"로 통일
기능 중복 제거:
- spec 3개소에서 발견된 "실시간 알림" → 하나로 통합
- customer journey와 sales의 메시지 일관성 확보
고객 여정 - 기능 매핑:
✅ "주말 운동 계획" → 검색 기능
✅ "간편한 예약" → 원터치 예약
✅ "비용 절감" → 자동 할인
✅ Planning consolidated
# Step 7: 개발 준비 - "어떻게 만들까?"
$ /appkit.design
🏗️ Technical Design:
ERD 설계:
- User, Venue, Booking, Payment 엔티티
- 관계 정의 및 제약조건
API 엔드포인트:
- POST /bookings (예약 생성)
- GET /venues?location=... (코트 검색)
- POST /payments (결제 처리)
기술 정책:
- Rate Limiting: 시간당 100회
- Error Handling: 재시도 3회
- Content Safety: 필터 규칙
✅ 아이디어 구체화 완료!
이제 개발을 시작할 수 있습니다.
```
---
### 6. `/appkit.merge` - 기획 정돈
**Purpose**: 흩어진 기획 문서들을 통합하고 일관성 확보
@@ -427,9 +326,6 @@ API 엔드포인트:
**중요**: merge 완료 후 개발 직전에 실행!
---
---
## 🎓 논리적 사고 7단계와 명령어
@@ -509,35 +405,6 @@ docs/appkit/
---
## 🚀 Quick Start
```bash
# 1. 아이디어 스케치
/appkit.new "당근마켓처럼 중고거래 앱"
# 2. 기능 구체화
/appkit.spec 001-search "위치 기반 상품 검색"
/appkit.spec 002-chat "구매자와 판매자 채팅"
# 3. 고객 스토리
/appkit.customer "20-30대 중고거래 선호"
# 4. 세일즈 메시지 구성
/appkit.sales "편리함과 신뢰 강조"
# 5. MVP 범위 정의
/appkit.mvp "2주 내 출시 목표"
# 6. 기획 정돈
/appkit.merge
# 7. 개발 준비
/appkit.design
```
---
## 📖 Philosophy (논리적 사고 철학)
> "아이디어는 고객의 문제에서 시작되고, 논리적 단계로 구체화된다."
@@ -553,8 +420,7 @@ AppKit은 다음을 믿습니다:
---
**Built with ❤️ for Product Managers, Designers, and Developers**
**Built with by [Clauders.ai](https://clauders.ai/)**
**Version**: 5.0.0 (7-Step Logical Thinking)
**Last Updated**: 2025-11-20
**Key Update**: 논리적 사고 7단계로 재구성, merge(기획 정돈)와 design(개발 준비) 분리
**Version**: 5.1.0 (Quick Start + Example 추가)
**Last Updated**: 2025-12-05