mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-03-30 21:53:28 +08:00
3e9c207c25
Add missing example sessions, code blocks, and detailed sections to 14 command files that were previously summarized versions.
114 lines
3.9 KiB
Markdown
114 lines
3.9 KiB
Markdown
---
|
|
description: 요구사항을 재확인하고, 위험을 평가하며, 단계별 구현 계획을 작성합니다. 코드를 건드리기 전에 사용자 확인을 기다립니다.
|
|
---
|
|
|
|
# Plan 커맨드
|
|
|
|
이 커맨드는 **planner** 에이전트를 호출하여 코드를 작성하기 전에 포괄적인 구현 계획을 만듭니다.
|
|
|
|
## 이 커맨드가 하는 일
|
|
|
|
1. **요구사항 재확인** - 무엇을 만들어야 하는지 명확히 합니다
|
|
2. **위험 식별** - 잠재적 이슈와 차단 요소를 도출합니다
|
|
3. **단계별 계획 작성** - 구현을 단계별로 분해합니다
|
|
4. **확인 대기** - 진행하기 전에 반드시 사용자 승인을 받아야 합니다
|
|
|
|
## 사용 시점
|
|
|
|
`/plan`을 사용해야 할 때:
|
|
- 새 기능을 시작할 때
|
|
- 중요한 아키텍처 변경을 할 때
|
|
- 복잡한 리팩토링 작업을 할 때
|
|
- 여러 파일/컴포넌트에 영향을 미칠 때
|
|
- 요구사항이 불명확하거나 모호할 때
|
|
|
|
## 작동 방식
|
|
|
|
planner 에이전트가 수행하는 작업:
|
|
|
|
1. 요청을 **분석**하고 요구사항을 명확한 용어로 재확인합니다
|
|
2. 구체적이고 실행 가능한 단계로 **분해**합니다
|
|
3. 컴포넌트 간 **의존성을 식별**합니다
|
|
4. **위험을 평가**하고 잠재적 차단 요소를 파악합니다
|
|
5. **복잡도를 추정**합니다 (High/Medium/Low)
|
|
6. 계획을 **제시**하고 명시적 확인을 **대기**합니다
|
|
|
|
## 사용 예시
|
|
|
|
```
|
|
User: /plan 마켓이 해결될 때 실시간 알림을 추가해야 합니다
|
|
|
|
Agent (planner):
|
|
# 구현 계획: 실시간 마켓 해결 알림
|
|
|
|
## 요구사항 재확인
|
|
- 사용자가 주시 중인 마켓이 해결될 때 알림 전송
|
|
- 다중 알림 채널 지원 (인앱, 이메일, webhook)
|
|
- 알림이 안정적으로 전달되도록 보장
|
|
- 마켓 결과와 사용자의 포지션 결과 포함
|
|
|
|
## 구현 단계
|
|
|
|
### 1단계: 데이터베이스 스키마
|
|
- id, user_id, market_id, type, status, created_at 컬럼을 가진 notifications 테이블 추가
|
|
- 채널 설정을 위한 user_notification_preferences 테이블 추가
|
|
- 성능을 위해 user_id와 market_id에 인덱스 생성
|
|
|
|
### 2단계: 알림 서비스
|
|
- lib/notifications.ts에 알림 서비스 생성
|
|
- BullMQ/Redis를 사용한 알림 큐 구현
|
|
- 전송 실패 시 재시도 로직 추가
|
|
- 알림 템플릿 생성
|
|
|
|
### 3단계: 연동 포인트
|
|
- 마켓 해결 로직에 연결 (status가 "resolved"로 변경될 때)
|
|
- 해당 마켓에 포지션을 가진 모든 사용자 조회
|
|
- 각 사용자에 대한 알림 큐에 추가
|
|
|
|
### 4단계: 프론트엔드 컴포넌트
|
|
- 헤더에 NotificationBell 컴포넌트 생성
|
|
- NotificationList 모달 추가
|
|
- Supabase subscriptions를 통한 실시간 업데이트 구현
|
|
- 알림 설정 페이지 추가
|
|
|
|
## 의존성
|
|
- Redis (큐용)
|
|
- 이메일 서비스 (SendGrid/Resend)
|
|
- Supabase 실시간 subscriptions
|
|
|
|
## 위험
|
|
- HIGH: 이메일 전달률 (SPF/DKIM 필요)
|
|
- MEDIUM: 마켓당 1000명 이상의 사용자 시 성능
|
|
- MEDIUM: 마켓이 자주 해결될 경우 알림 스팸
|
|
- LOW: 실시간 subscription 오버헤드
|
|
|
|
## 예상 복잡도: MEDIUM
|
|
- 백엔드: 4-6시간
|
|
- 프론트엔드: 3-4시간
|
|
- 테스트: 2-3시간
|
|
- 합계: 9-13시간
|
|
|
|
**확인 대기 중**: 이 계획으로 진행할까요? (yes/no/modify)
|
|
```
|
|
|
|
## 중요 참고 사항
|
|
|
|
**핵심**: planner 에이전트는 "yes"나 "proceed" 같은 긍정적 응답으로 명시적으로 계획을 확인하기 전까지 코드를 **절대 작성하지 않습니다.**
|
|
|
|
변경을 원하면 다음과 같이 응답하세요:
|
|
- "modify: [변경 사항]"
|
|
- "different approach: [대안]"
|
|
- "skip phase 2 and do phase 3 first"
|
|
|
|
## 다른 커맨드와의 연계
|
|
|
|
계획 수립 후:
|
|
- `/tdd`를 사용하여 테스트 주도 개발로 구현
|
|
- 빌드 에러 발생 시 `/build-fix` 사용
|
|
- 완성된 구현을 `/code-review`로 리뷰
|
|
|
|
## 관련 에이전트
|
|
|
|
이 커맨드는 다음 위치의 `planner` 에이전트를 호출합니다:
|
|
`~/.claude/agents/planner.md`
|