planlisted

# Plan - 작업 분해 Spec을 구현 가능한 작은 작업 단위로 분해하는 스킬입니다. ## 사용법 ``` /plan # 현재 컨텍스트에서 작업 분해 ``` /dev에서 Phase 2로 자동 호출될 수도 있습니다. ## pharos 프로토콜 ```bash source "$HOME/.claude/skills/_shared/pharos-helpers.sh" # 시작 pw set-status phase "PLAN" --icon "🗺️" --color "#8B5CF6" pw set-progress 0.0 --label "Plan: 시작" # 기존 도메인 지식 로드 — 과거 삽질을 피하기 위해 반드시 읽기 fm_get # 이 프로젝트의 축적된 교훈 (워크스페이스 횡단) pharos global-memo-get 2>/dev/null # 범용 교훈 wm_get # 이번 dev cycle의 spec 결과 (같은 워크스페이스) # → 태스크 분해 시 교훈에서 언급된 제약/주의사항을 반영 # 레이아웃: 코드 탐색용 pane 추가 pw split right # 진행: 탐색/분해 시 progress 갱신 # 완료 wm_append "### Plan 완료 ✅ #### Tasks - [ ] Task 1: ... ---" pw set-progress 1.0 --label "Plan: 완료" pw notify --title "Plan 완료" --body "[n]개 태스크" # history 기록 (전역 축적) pw history add --type phase --phase plan --summary "PLAN 완료: [n]개 태스크" # 각 태스크마다: pw history add --type task --phase plan --summary "[태스크 설명]" --tags task:1,[관련 decision 태그] ``` ## 프로세스 ### 1. 코드베이스 탐색 기존 코드를 탐색하여 영향 범위를 파악합니다. ```bash pw set-progress 0.2 --label "Plan: 코드 탐색" ``` - 관련 파일/모듈 식별 - 기존 패턴과 컨벤션 파악 - 변경 영향이 미치는 범위 추정 - **단일 길목/단일 소스 가정 금지 — 전수 grep**: "X는 이 함수/테이블/필드 한 곳만 거친다" 또는 "이 값은 여기서만 온다"는 전제를 세우기 **전에**, 그 대상을 바꾸는·읽는·거치는 **모든 경로**를 grep으로 확인한다. (예: `Foo.update` 직접 호출, raw SQL `UPDATE foo`, `bulkCreate`/`ON DUPLICATE`, 스케줄러, 다른 서비스/레포지토리). 단일 길목이 아니면 후킹·표시·추적 전제가 통째로 틀어진다. ### 2. 태스크 분해 Spec을 작업 단위로 분해합니다. 각 작업은: - **하나의 관심사**만 다룸 - **독립적으로 테스트 가능** - *