계획 수립

언제 쓰나

새로운 기능을 구현하기 전에 요구 사항을 명확히 하고 잠재적 위험을 파악하며 상세한 구현 계획을 수립하고 싶을 때

---
description: 요구사항을 재정의하고, 위험을 평가하며, 단계별 구현 계획을 수립합니다. 어떤 코드도 건드리기 전에 사용자 확인을 기다립니다.
---

# Plan 명령

이 명령은 코드를 작성하기 전에 포괄적인 구현 계획을 수립합니다.

기본적으로 인라인으로 실행됩니다. 기본적으로 Task 도구나 서브 에이전트를 호출하지 않습니다. 이는 에이전트 파일 없이 명령을 제공하는 플러그인 설치에서 `/plan`을 사용할 수 있도록 합니다.

## 이 명령의 기능

1.  **요구사항 재정의** - 구축해야 할 내용을 명확히 합니다.
2.  **위험 식별** - 잠재적인 문제와 차단 요소를 파악합니다.
3.  **단계별 계획 수립** - 구현을 단계별로 나눕니다.
4.  **확인 대기** - 진행하기 전에 반드시 사용자 승인을 받아야 합니다.

## 사용 시점

다음 경우에 `/plan`을 사용하세요:
- 새 기능 개발을 시작할 때
- 중요한 아키텍처 변경을 할 때
- 복잡한 리팩토링 작업을 할 때
- 여러 파일/컴포넌트에 영향을 미칠 때
- 요구사항이 불분명하거나 모호할 때

## 작동 방식

어시스턴트는 다음을 수행합니다:

1.  **요청을 분석**하고 요구사항을 명확한 용어로 재정의합니다.
2.  구체적이고 실행 가능한 단계로 **단계별로 나눕니다**.
3.  컴포넌트 간의 **의존성을 식별**합니다.
4.  **위험과 잠재적인 차단 요소를 평가**합니다.
5.  **복잡도를 추정**합니다 (높음/중간/낮음).
6.  **계획을 제시**하고 명시적인 확인을 기다립니다.

## 사용 예시

```
User: /plan I need to add real-time notifications when markets resolve

Assistant:
# Implementation Plan: Real-Time Market Resolution Notifications

## Requirements Restatement
- Send notifications to users when markets they're watching resolve
- Support multiple notification channels (in-app, email, webhook)
- Ensure notifications are delivered reliably
- Include market outcome and user's position result

## Implementation Phases

### Phase 1: Database Schema
- Add notifications table with columns: id, user_id, market_id, type, status, created_at
- Add user_notification_preferences table for channel preferences
- Create indexes on user_id and market_id for performance

### Phase 2: Notification Service
- Create notification service in lib/notifications.ts
- Implement notification queue using BullMQ/Redis
- Add retry logic for failed deliveries
- Create notification templates

### Phase 3: Integration Points
- Hook into market resolution logic (when status changes to "resolved")
- Query all users with positions in market
- Enqueue notifications for each user

### Phase 4: Frontend Components
- Create NotificationBell component in header
- Add NotificationList modal
- Implement real-time updates via Supabase subscriptions
- Add notification preferences page

## Dependencies
- Redis (for queue)
- Email service (SendGrid/Resend)
- Supabase real-time subscriptions

## Risks
- HIGH: Email deliverability (SPF/DKIM required)
- MEDIUM: Performance with 1000+ users per market
- MEDIUM: Notification spam if markets resolve frequently
- LOW: Real-time subscription overhead

## Estimated Complexity: MEDIUM
- Backend: 4-6 hours
- Frontend: 3-4 hours
- Testing: 2-3 hours
- Total: 9-13 hours

**WAITING FOR CONFIRMATION**: Proceed with this plan? (yes/no/modify)
```

## 중요 사항

**중요**: 이 명령은

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-143/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 새로운 기능을 구현하기 전에 요구 사항을 명확히 하고 잠재적 위험을 파악하며 상세한 구현 계획을 수립하고 싶을 때

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.