plan-task

Plan-Task 스킬

사용법

/plan-task W-001                    # 기존 Work ID로 재개
/plan-task 로그인 기능 추가          # 새 요청 (Work 자동 생성)
/plan-task fix the auth bug         # 새 요청 (description 형식)

Phase Gate

이 스킬은 brainstorming 이후에 실행되어야 합니다.

docs/specs/에 관련 스펙 파일이 없으면:

• 새 기능이라면 → 먼저 brainstorming 스킬을 invoke하세요
• 버그 수정/소규모 작업이라면 → 계속 진행 가능 (단, 이 사실을 명시)

---

Work 파일과 Task 시스템을 통합하여 구조화된 Planning을 진행합니다.

---

Step 0: Work ID 확보 [건너뛰기 금지]

체크리스트 초기화 [최우선]

Step 0 진입 즉시, Work ID 확보 전에 스킬 자체 진행을 추적할 Tasks를 생성합니다:

1. ToolSearch("select:TaskCreate,TaskUpdate,TaskList") 실행

Task 도구가 없으면 멈추지 말고 대체 경로로 간다 — ToolSearch가 Task 계열을 반환하지 않는 호스트/세션이 있다(F-038). 그때는 ./scripts/checklist.sh 기반 durable checklist로 추적한다. 규율 SSOT: skills/references/task-tools-fallback.md.

1. 다음 Tasks 생성 (이미 [Planning] Task 있으면 스킵):

TaskCreate: [Planning] Work ID 확보 및 초기화
TaskCreate: [Planning] 요구사항 명확화
TaskCreate: [Planning] 구현 계획 수립
TaskCreate: [Planning] Planning 완료 처리

의존성 설정: 각 Task는 이전 Task가 완료되어야 시작 가능 (addBlockedBy).

Work ID가 제공된 경우 (예: /plan-task W-043)

1. docs/works/idea/ 디렉토리에서 해당 Work 폴더 탐색
2. W-XXX-{slug}/W-XXX-{slug}.md 파일 읽기
3. progress.md로 현재 진행 상황 확인 — 중단된 지점부터 재개
4. frontmatter status, current_phase 확인

Work ID가 없는 경우 (새 요청)

docs/works/ 폴더가 존재하면:

1. work.sh new로 Work 파일 생성:

   ./scripts/work.sh new "<요청 제목>"
   

   → docs/works/idea/W-XXX-{slug}/ 폴더와 파일 자동 생성 → 출력된 Work ID(예: W-001)를 이후 단계에서 사용

docs/works/ 폴더 자체가 없으면 → Fallback으로 이동

Work ID 확보 완료 후에만 Step 1로 진행.

---

Step 1: Task 시스템 초기화 [건너뛰기 금지]

1. ToolSearch("select:TaskCreate,TaskUpdate,TaskList") — 스키마 fetch (deferred tool이므로 필수)

2. TaskList 실행 → 이미 생성된 동일 Work Task 있으면 이 Step 스킵 (중복 방지)

3. Task 없으면 아래 두 Tasks 생성:

   T1: [W-XXX][Planning] 요구사항 명확화
   T2: [W-XXX][Planning] 구현 계획 수립   ← blockedBy T1
   

   TaskCreate 시 모든 Task에 metadata 포함:

   { "work_id": "W-XXX", "phase": "planning" }
   

   T2 생성 직후 TaskUpdate(T2, addBlockedBy=[T1]) 설정.