Initial commit

commands/plan.md

@@ -0,0 +1,134 @@
+## 계획 수립
+
+구현 전 계획 수립 모드를 시작해서 상세한 구현 전략을 수립합니다. 코드 구현 전에 구조화된 계획을 세움으로써 효율적인 개발을 지원합니다.
+
+### 사용법
+
+```bash
+# Claude 에게 Plan Mode 의뢰
+"[구현 내용] 구현 계획을 세워주세요"
+```
+
+### 기본 사용 예시
+
+```bash
+# 새 기능의 구현 계획
+"사용자 인증 기능 구현 계획을 세워주세요"
+
+# 시스템 설계 계획
+"마이크로서비스 분할 구현 계획을 세워주세요"
+
+# 리팩터링 계획
+"레거시 코드 리팩터링 계획을 세워주세요"
+```
+
+### Claude 와의 연동
+
+```bash
+# 복잡한 기능 구현
+"채팅 기능 구현 계획을 세워주세요. WebSocket, 실시간 알림, 기록 관리를 포함해서"
+
+# 데이터베이스 설계
+"쇼핑몰 데이터베이스 설계 계획을 세워주세요. 상품, 주문, 사용자 관리를 포함해서"
+
+# API 설계
+"GraphQL API 구현 계획을 세워주세요. 인증, 캐시, 레이트 제한을 포함해서"
+
+# 인프라 설계
+"Docker 화 구현 계획을 세워주세요. 개발 환경, 프로덕션 환경, CI/CD 를 포함해서"
+```
+
+### Plan Mode 의 특징
+
+**자동 시작**
+
+- 구현 작업을 감지하면 자동으로 Plan Mode 시작
+- "구현 계획을 세워주세요" 등의 키워드로 명시적 시작 가능
+
+**구조화된 명세서**
+
+- 요구사항 정의 (사용자 스토리·수용 기준)
+- 설계서 (아키텍처·데이터 설계·UI 설계)
+- 구현 계획 (작업 분해·진행 추적·품질 보증)
+- 위험 분석 및 대책
+
+**승인 프로세스**
+
+- `exit_plan_mode` 도구로 계획 제시
+- **중요**: 도구의 반환 값과 관계없이 반드시 사용자의 명시적 승인 대기
+- 승인 없는 구현 시작 금지
+- 계획의 수정·조정 가능
+- 승인 후에만 TodoWrite 로 작업 관리 시작
+
+### 상세 사용 예시
+
+```bash
+# 복잡한 시스템 구현
+"온라인 결제 시스템 구현 계획을 세워주세요. Stripe 연동, 보안, 오류 처리를 포함해서"
+
+# 프론트엔드 구현
+"React 대시보드 구현 계획을 세워주세요. 상태 관리, 컴포넌트 설계, 테스트를 포함해서"
+
+# 백엔드 구현
+"RESTful API 구현 계획을 세워주세요. 인증, 유효성 검사, 로그 기록을 포함해서"
+
+# DevOps 구현
+"CI/CD 파이프라인 구현 계획을 세워주세요. 테스트 자동화, 배포, 모니터링을 포함해서"
+```
+
+### 3 단계 워크플로
+
+#### Phase 1: Requirements (요구사항 정의)
+
+- **사용자 스토리**: 기능의 목적과 가치 명확화
+- **수용 기준**: 완료 조건과 품질 기준 정의
+- **제약·전제조건**: 기술적·시간적 제약 정리
+- **우선순위**: Must-have/Nice-to-have 분류
+
+#### Phase 2: Design (설계)
+
+- **아키텍처 설계**: 시스템 구성과 기술 선택
+- **데이터 설계**: 스키마, API 명세, 데이터 플로
+- **UI/UX 설계**: 화면 구성과 조작 플로
+- **위험 분석**: 잠재적 문제와 대책
+
+#### Phase 3: Implementation (구현)
+
+- **작업 분해**: 구현 가능한 단위로 세분화
+- **진행 추적**: TodoWrite 를 통한 상태 관리
+- **품질 보증**: 테스트 전략과 검증 방법
+- **승인 프로세스**: exit_plan_mode 로 계획 제시 및 명시적 승인 대기
+
+### 주의사항
+
+**적용 범위**
+
+- Plan Mode 는 복잡한 구현 작업에 최적
+- 단순한 수정이나 소규모 변경의 경우 일반적인 구현 방식 사용
+- 3 단계 이상의 작업이나 새 기능 개발에 권장
+
+**기술적 제약**
+
+- `exit_plan_mode` 도구의 반환 값은 신뢰하지 않음
+- 승인 프로세스는 사용자의 명시적 의사 표시로 판단
+- CLI 의 plan mode 와는 다른 기능
+
+**실행상 주의**
+
+- 승인 전 구현 시작 엄금
+- 계획 제시 후 반드시 사용자 응답 대기
+- 오류 시 대안 제시
+
+### 실행 예시
+
+```bash
+# 사용 예시
+"사용자 관리 시스템 구현 계획을 세워주세요"
+
+# 예상되는 동작
+# 1. Plan Mode 자동 시작
+# 2. 요구사항 분석 및 기술 선택
+# 3. 구현 단계 구조화
+# 4. exit_plan_mode 로 계획 제시
+# 5. 승인 후 구현 시작
+```