everything-claude-code/docs/ko-KR/commands/plan.md

description

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