@kood/claude-code 0.2.4 → 0.2.5

package/dist/index.js

@@ -404,7 +404,7 @@ var init = async (options) => {
 
 // src/index.ts
 var program = new Command();
-program.name("claude-code").description("Claude Code documentation installer for projects").version("0.2.4");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.2.5");
 program.option(
   "-t, --template <names>",
   "template names (comma-separated: tanstack-start,hono)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/commands/prd.md

@@ -0,0 +1,330 @@
+---
+description: PRD(Product Requirements Document) 생성. 기능/제품 정의 시 사용. ultrathink + sequential thinking 3-5 필수.
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash(ls:*, mkdir:*), Task, mcp__sequential-thinking__sequentialthinking
+argument-hint: <기능명 또는 제품명>
+---
+
+# PRD Generator
+
+AI-friendly PRD(Product Requirements Document)를 생성.
+
+## CRITICAL: 필수 요구사항
+
+| 요구사항 | 설명 |
+|----------|------|
+| **ARGUMENT 필수** | PRD 대상 없이 실행 시 되물음 |
+| **Ultrathink** | 깊은 사고로 요구사항 분석 |
+| **Sequential Thinking 3-5** | 복잡도에 따라 조정 |
+| **정보 수집 필수** | 사용자에게 필수 정보 질문 |
+
+## ARGUMENT 확인
+
+```
+$ARGUMENTS 없음 → 즉시 질문:
+"어떤 제품/기능의 PRD를 작성할까요?
+
+예시:
+- 신규 기능: '사용자 알림 시스템'
+- 제품: '관리자 대시보드'
+- 개선: '결제 프로세스 개선'"
+
+$ARGUMENTS 있음 → 다음 단계 진행
+```
+
+**PRD 대상**: $ARGUMENTS
+
+## 실행 흐름
+
+```
+1. ARGUMENT 확인 (없으면 되물음)
+2. Sequential Thinking으로 정보 수집 계획 (1단계)
+3. 필수 정보 순차 질문 (2-3단계)
+4. 선택 정보 확인 (4단계)
+5. PRD 문서 생성 (5단계)
+6. .claude/prd/[기능명].md 저장
+```
+
+## 정보 수집 (대화형)
+
+### 필수 질문 (순차 진행)
+
+**Q1. 개요**
+```
+[제품/기능명]에 대해 알려주세요:
+
+1. 무엇을 만드나요? (1-2문장)
+2. 왜 필요한가요? (배경/문제)
+```
+
+**Q2. 사용자**
+```
+누구를 위한 것인가요?
+
+1. 주 사용자 그룹
+2. 사용자가 겪는 문제점
+```
+
+**Q3. 기능**
+```
+어떤 기능이 필요한가요?
+
+1. 반드시 필요한 기능 (Must Have)
+2. 있으면 좋은 기능 (Nice to Have)
+3. 제외할 것 (Out of Scope)
+```
+
+**Q4. 성공 지표**
+```
+성공을 어떻게 측정하나요?
+
+예시:
+- 사용자 만족도 80% 이상
+- 처리 시간 50% 감소
+- 일일 활성 사용자 1000명
+```
+
+### 선택 질문 (해당 시만)
+
+```
+추가 정보가 있나요?
+
+- 기술 제약: 사용해야 하는 기술 스택
+- 일정: 목표 출시일
+- 참조 문서: 디자인/기획 문서
+- AI 사용: AI/ML 기능 포함 여부
+
+없으면 'N'을 입력하세요.
+```
+
+## Sequential Thinking 가이드
+
+```
+thought 1: PRD 범위 및 복잡도 판단
+thought 2: 핵심 요구사항 정리 (사용자 입력 기반)
+thought 3: 기능 상세화 및 우선순위 결정
+thought 4: 기술 요구사항 및 제약 정리
+thought 5: PRD 문서 구조화 및 작성
+```
+
+## PRD 템플릿
+
+**파일 위치:** `.claude/prd/[기능명].md`
+
+```markdown
+# PRD: [제품/기능명]
+
+**상태**: Draft
+**작성일**: [YYYY-MM-DD]
+**버전**: 1.0
+
+---
+
+## 1. 개요
+
+### 1.1 배경
+[왜 이 제품/기능이 필요한가?]
+
+### 1.2 목표
+[이 제품/기능이 달성하고자 하는 것]
+
+### 1.3 성공 지표
+| 지표 | 목표값 | 측정 방법 |
+|------|--------|----------|
+| [지표1] | [목표] | [방법] |
+
+---
+
+## 2. 사용자 정의
+
+### 2.1 목표 사용자
+| 페르소나 | 특성 | 주요 니즈 |
+|----------|------|----------|
+| [페르소나1] | [특성] | [니즈] |
+
+### 2.2 사용자 문제
+| 문제 | 빈도 | 심각도 |
+|------|------|--------|
+| [문제1] | High/Med/Low | High/Med/Low |
+
+### 2.3 사용자 스토리
+```
+As a [사용자],
+I want to [행동],
+So that [가치/결과].
+```
+
+---
+
+## 3. 기능 정의
+
+### 3.1 핵심 기능 (P0 - Must Have)
+| 기능 | 설명 | 수락 기준 |
+|------|------|----------|
+| [기능1] | [설명] | [기준] |
+
+### 3.2 부가 기능 (P1 - Nice to Have)
+| 기능 | 설명 | 수락 기준 |
+|------|------|----------|
+| [기능2] | [설명] | [기준] |
+
+### 3.3 범위 외 (Out of Scope)
+- [제외 항목1]
+
+---
+
+## 4. 상세 기능
+
+### 4.1 [기능명]
+
+**설명**: [기능 설명]
+
+**사용자 플로우**:
+1. 사용자가 [행동1]
+2. 시스템이 [응답1]
+
+**입력/출력**:
+| 입력 | 타입 | 필수 | 설명 |
+|------|------|------|------|
+| [입력1] | string | Y | [설명] |
+
+| 출력 | 타입 | 설명 |
+|------|------|------|
+| [출력1] | object | [설명] |
+
+**엣지 케이스**:
+| 케이스 | 처리 |
+|--------|------|
+| [케이스1] | [처리 방법] |
+
+---
+
+## 5. 기술 요구사항
+
+### 5.1 기술 스택
+| 영역 | 기술 | 버전 |
+|------|------|------|
+| Frontend | [기술] | [버전] |
+| Backend | [기술] | [버전] |
+
+### 5.2 비기능 요구사항
+| 항목 | 요구사항 |
+|------|----------|
+| 성능 | [예: 응답시간 < 500ms] |
+| 확장성 | [예: 동시접속 10K] |
+| 보안 | [예: HTTPS 필수] |
+
+### 5.3 AI 요구사항 (해당 시)
+| 항목 | 요구사항 |
+|------|----------|
+| 모델 | [사용 모델] |
+| 정확도 | [목표 정확도] |
+| 가드레일 | [안전장치] |
+
+---
+
+## 6. 일정
+
+| 마일스톤 | 목표일 | 산출물 |
+|----------|--------|--------|
+| MVP | [날짜] | [산출물] |
+| Beta | [날짜] | [산출물] |
+| GA | [날짜] | [산출물] |
+
+---
+
+## 7. 위험 및 의존성
+
+### 7.1 위험 요소
+| 위험 | 영향 | 대응 방안 |
+|------|------|----------|
+| [위험1] | High/Med/Low | [대응] |
+
+### 7.2 의존성
+| 항목 | 담당 | 상태 |
+|------|------|------|
+| [의존1] | [담당] | [상태] |
+
+---
+
+## 8. 오픈 이슈
+
+| # | 이슈 | 담당 | 상태 |
+|---|------|------|------|
+| 1 | [이슈1] | [담당] | Open |
+
+---
+
+## 부록
+
+### A. 용어 정의
+| 용어 | 정의 |
+|------|------|
+| [용어1] | [정의] |
+
+### B. 변경 이력
+| 버전 | 날짜 | 변경 내용 |
+|------|------|----------|
+| 1.0 | [날짜] | 초안 작성 |
+```
+
+## Claude Code 친화적 PRD 특징
+
+| 특징 | 설명 |
+|------|------|
+| **테이블 형식** | 정보 구조화로 빠른 파악 |
+| **명확한 입출력** | 기능별 입력/출력 명시 |
+| **우선순위** | P0/P1/P2로 구현 순서 명확 |
+| **엣지 케이스** | 예외 상황 사전 정의 |
+| **수락 기준** | 구현 완료 기준 명확화 |
+
+## 작성 규칙
+
+### DO
+- 구체적인 숫자와 지표 사용
+- 사용자 관점에서 기능 설명
+- 명확한 범위 정의 (In/Out of Scope)
+- 측정 가능한 성공 기준
+- 엣지 케이스 미리 정의
+
+### DON'T
+- 모호한 표현 ("빠른", "좋은")
+- 기술 구현 세부사항 과도 포함
+- 범위 없이 모든 것 포함
+- 검증 없는 가정
+
+## 예시 워크플로우
+
+```
+1. 사용자: /prd 사용자 알림 시스템
+
+2. Claude:
+   "사용자 알림 시스템 PRD를 작성하겠습니다.
+
+   Q1. 개요
+   1. 무엇을 만드나요?
+   2. 왜 필요한가요?"
+
+3. 사용자: "실시간 알림 기능. 사용자가 중요 이벤트를 놓침."
+
+4. Claude:
+   "Q2. 누구를 위한 것인가요?
+   1. 주 사용자 그룹
+   2. 겪는 문제점"
+
+5. 사용자: "모든 로그인 사용자. 이메일 확인 안 함."
+
+6. (계속 질문...)
+
+7. PRD 생성: .claude/prd/notification-system.md
+```
+
+## CRITICAL: 절대 금지
+
+| 금지 항목 |
+|----------|
+| ARGUMENT 없이 PRD 작성 시작 |
+| 정보 수집 없이 가정으로 작성 |
+| Sequential Thinking 3단계 미만 |
+| 성공 지표 없는 PRD |
+| 기능 우선순위 없는 PRD |
+| 엣지 케이스 고려 없는 기능 정의 |