plan-tasklisted
Install: claude install-skill This-HW/hiway-kit
# Plan-Task 스킬
## 사용법
```
/plan-task 로그인 기능 추가 # 새 요청
/plan-task fix the auth bug # 새 요청 (description 형식)
/plan-task docs/plans/2026-09-28-login-lockout # 기존 계획 재개 (디렉토리 또는 그 plan.md)
```
## Phase Gate
`brainstorming`(설계 승인)은 **설계가 필요한 Large 새 기능**에만 선행한다 — 크기 기준은
`skills/plan-task/references/elicitation.md` §6 이 소유한다. 그런 작업인데 `docs/specs/`에 관련
스펙이 없으면 먼저 `brainstorming` 을 invoke 한다. 버그 수정·Small·Medium 은 바로 진행한다(건너뛴
사실만 한 줄 적는다).
---
요구사항을 명확히 하고 구현 계획을 세운다. Medium/Large 면 결과를 **계획 파일**에 남긴다 —
규약(위치·frontmatter·절 순서) SSOT: `skills/plan-task/references/plan-format.md`.
**영속 상태는 `plan.md`(와 실행 단계의 checklist)다.** 호스트 태스크 도구는 진행 추적에만
쓴다 — 세션 스코프이거나(Claude Code) 아예 없는(Codex 등) 하네스가 있어서 세션을 넘지 못한다.
---
## Step 0: 진입 [건너뛰기 금지]
1. 호스트 태스크 도구가 있으면 로드한다(Claude Code: `ToolSearch("select:TaskCreate,TaskUpdate,TaskList")`).
> **Task 도구가 없으면 멈추지 말고 대체 경로로 간다** — `skills/plan-task/references/task-tools-fallback.md`
> §B 가 소유한다. `[Planning]` 단계의 대체는 **대화창 진행표 + `plan.md`** 다 — checklist 에는
> 걸지 않는다(걸 `verify` 명령이 없다).
이미 `[Planning]` Task 가 있으면 생성을 건너뛴다. 없으면(도구가 있을 때만):
```
T1: [Planning] 요구사�� 명확화
T2: [Planning] 구현 계획 수립 ← blockedBy T1
```
2. **기존 계획 경로가 주어졌으면** 그 `plan.md` 를 읽고 `status` 와 비어 있는 절을 보고
중단된 지점부터 재개한다. `status: done` 이면 재개하지 않고 사용자에게 알린다.
3. **새 요청이면** 아직 파일을 만들지 않는다 — 규모 판정(Step 1-1) 후에 만든다.
---
## Step 1: T1 — 요구사항 명확화
낯선 저장소라면 [프로젝트 탐색](references/project-discovery.md)으로 실제 진입점과 검증 명