Plan Manager

Usage / 사용법

/plan              # Summary / plan.md 현황 요약
/plan create       # Create new plan.md / 새 plan.md 생성
/plan add          # Add Phase/tasks / Phase/태스크 추가
/plan edit         # Edit a Phase / 특정 Phase 수정

$ARGUMENTS

Project Detection / 프로젝트 감지 규칙

1. CWD-based - Uses current working directory as project root / 현재 작업 디렉토리를 프로젝트 루트로 사용
2. Git root detection -

   git rev-parse --show-toplevel

   / Git root로 프로젝트 루트 확인
3. Project name - Git root folder name / git root 폴더명 사용

Document folder search order / 문서 폴더 탐색 순서:

1. .claude-docs/

2. .claude/docs/

3. docs/

4. CWD (project root / 프로젝트 루트)

Command: (default) - Summary / 현황 요약

Steps / 수행 단계:

1. Search for plan.md (see search order) / plan.md 파일 탐색
2. Read and analyze file / 파일 읽기 및 분석
3. Parse Phase/task structure / Phase/태스크 구조 파싱
4. Output summary / 현황 출력

Output format / 출력 형식:

📋 plan.md Summary / 현황

📍 Location / 위치: .claude-docs/plan.md
📅 Last Modified / 최종 수정: 2026-02-03

📊 Structure / 구조:
- Phase 1: MVP (5 tasks / 5개 태스크)
- Phase 2: Core Features (5 tasks / 5개 태스크)
- Phase 3: Monetization (4 tasks / 4개 태스크)

Total: 14 tasks / 총 14개 태스크

If no file found / 파일 없는 경우:

📋 No plan.md found / plan.md 없음

💡 Create one with / 생성하려면:
   /plan create [description / 요청]
Example / 예: /plan create Tarot app, 5 phases

Command: create

Syntax / 구문:

/plan create [description / 요청]

Steps / 수행 단계:

1. Analyze request (app type, features, Phase count) / 요청 분석 (앱 종류, 기능, Phase 수)
2. Generate standard plan.md template / 표준 plan.md 템플릿 생성:
   • Project overview / 앱 개요
   • Phase checklists with IDs / Phase별 체크리스트 (ID 포함)
3. Save plan.md to document folder / 문서 폴더에 plan.md 저장
   • Create

     .claude-docs/

     if no document folder exists / 폴더 없으면

     .claude-docs/

     생성

Output format / 출력 형식:

✅ Created / plan.md 생성 완료

📋 Structure / 구조:
- Phase 1: MVP (5 tasks / 5개 태스크)
- Phase 2: Core Features (4 tasks / 4개 태스크)
- Phase 3: Polish (3 tasks / 3개 태스크)

Total: 12 tasks created / 총 12개 태스크 생성
📍 Saved / 저장: .claude-docs/plan.md

💡 Next step / 다음 단계: /task generate

Command: add

Syntax / 구문:

/plan add [description / 요청]

Examples / 예시:

/plan add Add i18n to Phase 2
/plan add Create Phase 5: Performance optimization
/plan add Add payment feature          # Auto-placed in appropriate Phase
/plan add Phase 2에 다국어 지원 기능 추가
/plan add 결제 기능 추가                # 적절한 Phase에 자동 배치

Steps / 수행 단계:

1. Read and analyze existing plan.md / 기존 plan.md 분석
2. Determine placement / 배치 결정:
   • Phase specified: add to that Phase / Phase 지정 시: 해당 Phase에 추가
   • No Phase specified: auto-place / Phase 미지정 시: 적절한 Phase에 자동 배치
   • New Phase requested: create section / 새 Phase 요청 시: 새 Phase 섹션 생성
3. Auto-assign IDs (continuing from existing) / ID 자동 부여 (기존 ID 이어서)
4. Update plan.md / plan.md 업데이트

Output format / 출력 형식:

✅ Updated / plan.md 업데이트

➕ Added tasks / 추가된 태스크:
- 2.6 i18n support
- 2.7 Language selection UI
- 2.8 Translation data management

📍 Phase 2: Core Features
   5 → 8 tasks / 5개 → 8개 태스크

💡 Next step / 다음 단계: /task sync

Command: edit

Syntax / 구문:

/plan edit Phase N
/plan edit [Phase name]

Steps / 수행 단계:

1. Identify target Phase / 대상 Phase 식별
2. Display Phase contents / 해당 Phase 내용 표시
3. AskUserQuestion for edit request / 수정 요청 입력 받기
4. Apply edits and save / 수정 적용 후 저장

Output format / 출력 형식:

📝 Editing / 편집: Phase 2: Core Features

Current tasks / 현재 태스크:
- [ ] 2.1 Three card spread
- [ ] 2.2 Fan card selection UI
- [ ] 2.3 Particle effects
- [ ] 2.4 Ad integration
- [ ] 2.5 Reading history

Enter your edit request... / 수정 요청을 입력하세요...

✅ Edited / 수정 완료

➖ Removed / 삭제: 2.3 Particle effects
➕ Added / 추가: 2.6 Sound effects
✏️ Modified / 수정: 2.1 Three card spread → Three/one card spread

plan.md Template / 생성 템플릿

# {Project Name}

**Created:** YYYY-MM-DD
**Last Updated:** YYYY-MM-DD

## Project Overview

{Brief description}

---

## Development Plan

### Phase 1: {Phase Name}

- [ ] 1.1 {Task}
- [ ] 1.2 {Task}
- [ ] 1.3 {Task}

### Phase 2: {Phase Name}

- [ ] 2.1 {Task}
- [ ] 2.2 {Task}

[...]

Plan File Search Order / plan 파일 탐색 순서

1. .claude-docs/plan.md

2. .claude/docs/plan.md

3. docs/plan.md

4. PLAN.md

5. plan.md

Plan Generator Rules / plan-generator 규칙

create

add

edit

create

add

edit

Common Rules / 공통 규칙

1. ID system / ID 체계: All tasks get

   N.M

   format ID / 모든 태스크에

   N.M

   형식 ID 부여
   • N: Phase number (1, 2, 3...) / Phase 번호
   • M: Task sequence within Phase (1, 2, 3...) / Phase 내 태스크 순번
   • Example / 예: 1.1, 1.2, 2.1, 2.2...
2. Checklist format / 체크리스트 형식: Standard markdown

   - [ ]

   / 표준 마크다운 사용
   markdown

   - [ ] 1.1 Task description
   - [ ] 1.2 Task description

3. Phase heading / Phase 헤딩:

   ### Phase N:

   format /

   ### Phase N:

   형식 유지
   markdown

   ### Phase 1: MVP
   ### Phase 2: Core Features

4. Date management / 날짜 관리:

   • **Created:**

     - Set on initial creation / 최초 생성 시 설정

   • **Last Updated:**

     - Update on every modification / 수정마다 갱신

create: Generate New plan.md / 새 plan.md 생성

1. Analyze request / 요청 분석:
   • Identify app/service type / 앱/서비스 종류 파악
   • Extract requested features / 요청된 기능 추출
   • Determine Phase count (default 3~5 if not specified) / Phase 수 확인
2. Generate plan.md / plan.md 생성:
   • Write project overview / 프로젝트 개요 작성
   • Compose Phase-based tasks / Phase별 태스크 구성
   • Arrange in logical order (MVP → Core → Advanced) / 논리적 순서 배치
3. Save file / 파일 저장:
   • Save to document folder / 문서 폴더에 저장
   • Create

     .claude-docs/

     if no folder exists / 폴더 없으면 생성

add: Add Tasks/Phases / 태스크/Phase 추가

1. Analyze existing plan.md / 기존 plan.md 분석:
   • Understand current Phase structure / 현재 Phase 구조 파악
   • Find last task ID / 마지막 태스크 ID 확인
2. Determine placement / 배치 결정:
   • Phase specified: add to that Phase / Phase 지정 시: 해당 Phase에 추가
   • No Phase specified: choose most appropriate Phase / Phase 미지정 시: 적절한 Phase 선택
   • New Phase requested: create new Phase section / 새 Phase 요청 시: 새 섹션 생성
3. Assign IDs / ID 부여:
   • Continue numbering from existing / 기존 ID 이어서 번호 부여
   • Example: if Phase 2 has up to 2.5, new tasks start at 2.6
4. Update plan.md / plan.md 업데이트:
   • Insert tasks at appropriate position / 적절한 위치에 태스크 추가
   • Update Last Updated date / 최종 수정일 갱신

edit: Modify Phase / Phase 수정

1. Identify target Phase / 대상 Phase 식별:
   • Find by "Phase N" or Phase name / "Phase N" 또는 Phase명으로 찾기
2. Display current state / 현재 상태 표시
3. Get edit request / 수정 요청 받기:
   • Use AskUserQuestion tool / AskUserQuestion 도구 사용
4. Apply edits / 수정 적용:
   • Delete: remove specified tasks / 삭제: 해당 태스크 제거
   • Add: assign new IDs / 추가: 새 ID로 태스크 추가
   • Modify: change task text / 수정: 태스크 텍스트 변경

Phase Structure Guidelines / Phase 구성 가이드라인

• Phase 1: Basic UI + core features
• Phase 2: Data storage + additional screens
• Phase 3: Notifications + settings
• Phase 4: Ads + IAP
• Phase 5: i18n + optimization

• Phase 1: Landing + core features
• Phase 2: Auth + dashboard
• Phase 3: Notifications + analytics
• Phase 4: Payments + subscriptions
• Phase 5: SEO + performance

Important Notes / 주의사항

1. Preserve existing IDs - Never change existing task IDs / 기존 태스크 ID 변경 불가
2. Maintain order - Tasks in logical sequence / 태스크는 논리적 순서로 배치
3. Specific tasks - "Implement login screen" not "Implement screen" / 구체적으로 작성
4. Appropriate size - Each task completable in 1~4 hours / 적절한 크기로 분할
5. Consider dependencies - Order tasks by prerequisites / 선행 태스크 고려

Command Reference / 명령어 정리

/plan

/plan create

/plan add

/plan edit

Integration with

/task

/

/task

스킬과 연계

/plan create "My App"       → plan.md created / 생성
        ↓
/task generate              → task.md created / 생성
        ↓
[Development / 개발 진행]
        ↓
/plan add "New feature"     → plan.md updated / 태스크 추가
        ↓
/task sync                  → task.md synced / 동기화 (completed status preserved / 완료 상태 유지)

Related Skills

• /plan

  - Plan document management (plan.md) / 기획서 관리

• /task

  - Task tracking and progress (task.md) / 태스크 추적

• /fix

  - Bug/improvement backlog (backlog.md) / 백로그 관리

npx skills add wintree86/plan-task-fix