planlisted

작업을 머릿속이 아닌 **파일로** 가져와서 사용자 합의 후 단계별로 추적한다. /brainstorm이 "무엇을 / 왜"라면, /plan은 "어떻게 / 어떤 순서로". planner 에이전트가 분석을 수행하고 이 스킬은 artifact 라이프사이클을 관리한다. ## 사용 시점 **필수**: - HARD-GATE 6+ 파일 변경 (`rules/git.md` 참조) - 작업이 단일 세션을 넘길 가능성 (여러 날 / 여러 PR) - 의존성이 있는 단계가 2개 이상 **스킵 가능**: - HARD-GATE 1~5 파일 (인라인 설계로 충분) - 단일 패턴 반복 작업 (예: 같은 변경을 여러 파일에 일괄 적용) ## 호출 형태 ```bash /plan "<주제>" # 신규 plan 생성 (사용자 입력 → planner 분석 → 파일 저장) /plan from-brainstorm <spec-file> # brainstorm 결과를 입력으로 plan 생성 /plan status # 진행 중 plan 목록 + 단계별 상태 /plan status <plan-id> # 특정 plan 상세 /plan complete <plan-id>:<step-id> # 단계 완료 처리 /plan revise <plan-id> # plan 수정 (이탈 사유 기록) ``` ## 절차 ### 1. 입력 수집 세 가지 입력 경로: **(A) brainstorm spec 파일** — `/plan from-brainstorm <file>` - `## 의도 / ## 제약 / ## 추천 + 근거 / ## 다음 단계` 헤더 파싱 - Goal = 의도, Out of Scope = 제약, Approach = 추천, 단계 분해 시드 = 다음 단계 **(B) 사용자 자연어 입력** — `/plan "<주제>"` - 의도 4문항이 모호하면 brainstorm 먼저 권장 - 명확하면 직접 진행 **(C) 기존 plan 수정** — `/plan revise <id>` - 진행 중 발견된 변화 반영 (이탈 사유 + 수정 내용 기록) ### 2. planner 에이전트 호출 (분석) ``` Agent 호출: subagent_type: "general-purpose" (planner.md 프롬프트 사용) prompt: 너는 planner 에이전트다. .claude/agents/planner.md의 작업 절차를 따라 다음 입력을 분석하라: [Goal | Constraints | Approach] 출력 (Karpathy §5 context budget, F-A10): - 전체 응답 2000자 이내, 표/리스트 우선, 추측 0 - 영향 파일 목록 (최대 20개) - bite-sized 태스크 분해 (각 2~5분 단위, 최대 12개) - 의존성 / 순서 - 리스크 / 엣지 케