doc-tasks

요구사항을 실행 가능한 작업으로 분해

목적

1. 작업 분해: 큰 요구사항을 작은 단위로 분할
2. 의존성 관리: 작업 간 선후 관계 명확화
3. 추정 지원: 난이도와 복잡도 평가
4. 추적 가능성: PRD ↔ 작업 간 연결고리 유지

태스크 문서 구조

tasks/
├── {feature}-tasks.md        # 태스크 목록
└── {feature}-tasks-detail/   # 상세 태스크 (선택)
    ├── TASK-001.md
    └── TASK-002.md

실행 프로세스

Phase 1: 소스 분석

flowchart TD
    P1Start["Phase 1: 소스 분석"] --> Step1["1. PRD 문서 확인"]
    Step1 --> Step1a["tasks/{feature}-prd.md<br/>로드"]
    Step1a --> Step1b["기능 요구사항 추출"]

    Step1b --> Step2["2. 기존 코드베이스 분석"]
    Step2 --> Step2a["관련 파일 탐색"]
    Step2a --> Step2b["변경 필요 범위 파악"]

    Step2b --> Step3["3. 기술 스택 확인"]
    Step3 --> Step3a["사용 기술 파악"]
    Step3a --> Step3b["제약 조건 확인"]

    style P1Start fill:#e1f5ff,stroke:#333,stroke-width:3px
    style Step1 fill:#fff4e1,stroke:#333,stroke-width:2px
    style Step2 fill:#e1ffe1,stroke:#333,stroke-width:2px
    style Step3 fill:#ffe1f5,stroke:#333,stroke-width:2px

Phase 2: 작업 분해

flowchart TD
    P2Start["Phase 2: 작업 분해"] --> Step1["1. 기능별 작업 도출"]
    Step1 --> Step1a["PRD의 각 기능<br/>요구사항 → 작업"]
    Step1a --> Step1b["F-001 → TASK-001,<br/>TASK-002, ..."]

    Step1b --> Step2["2. 인프라/설정 작업 추가"]
    Step2 --> Step2a["DB 마이그레이션"]
    Step2a --> Step2b["환경 설정"]
    Step2b --> Step2c["의존성 추가"]

    Step2c --> Step3["3. 테스트 작업 추가"]
    Step3 --> Step3a["단위 테스트"]
    Step3a --> Step3b["통합 테스트"]
    Step3b --> Step3c["E2E 테스트"]

    Step3c --> Step4["4. 문서화 작업 추가"]
    Step4 --> Step4a["API 문서"]
    Step4a --> Step4b["사용자 가이드"]

    style P2Start fill:#e1f5ff,stroke:#333,stroke-width:3px
    style Step1 fill:#fff4e1,stroke:#333,stroke-width:2px
    style Step2 fill:#e1ffe1,stroke:#333,stroke-width:2px
    style Step3 fill:#ffe1f5,stroke:#333,stroke-width:2px
    style Step4 fill:#f5e1ff,stroke:#333,stroke-width:2px

Phase 3: 순서화 및 추정

flowchart TD
    P3Start["Phase 3: 순서화 및 추정"] --> Step1["1. 의존성 분석"]
    Step1 --> Step1a["선행 작업 파악"]
    Step1a --> Step1b["병렬 가능 작업 식별"]

    Step1b --> Step2["2. 난이도 추정"]
    Step2 --> Step2a["S (Small): 1-2시간"]
    Step2a --> Step2b["M (Medium): 반나절"]
    Step2b --> Step2c["L (Large): 1일"]
    Step2c --> Step2d["XL (Extra Large): 2일+"]

    Step2d --> Step3["3. 우선순위 배정"]
    Step3 --> Step3a["Critical Path 식별"]
    Step3a --> Step3b["리스크 기반 순서"]

    style P3Start fill:#e1f5ff,stroke:#333,stroke-width:3px
    style Step1 fill:#fff4e1,stroke:#333,stroke-width:2px
    style Step2 fill:#e1ffe1,stroke:#333,stroke-width:2px
    style Step3 fill:#ffe1f5,stroke:#333,stroke-width:2px

Phase 4: 문서 생성

flowchart TD
    P4Start["Phase 4: 문서 생성"] --> Step1["1. 태스크 목록<br/>문서 생성"]
    Step1 --> Step2["2. 선택적 상세<br/>문서 생성"]
    Step2 --> Step3["3. TodoWrite 연동<br/>(선택)"]

    style P4Start fill:#e1f5ff,stroke:#333,stroke-width:3px
    style Step1 fill:#fff4e1,stroke:#333,stroke-width:2px
    style Step2 fill:#e1ffe1,stroke:#333,stroke-width:2px
    style Step3 fill:#ffe1f5,stroke:#333,stroke-width:2px

태스크 목록 템플릿

# Tasks: {기능명}

> PRD: tasks/{feature}-prd.md
> 생성일: {날짜}
> 총 작업 수: {N}개

---

## 요약

| 항목 | 수량 |
|------|------|
| 총 작업 | {N} |
| 구현 작업 | {X} |
| 테스트 작업 | {Y} |
| 문서 작업 | {Z} |

### 난이도 분포
| 난이도 | 수량 | 예상 시간 |
|--------|------|----------|
| S | {n} | {n*2}h |
| M | {n} | {n*4}h |
| L | {n} | {n*8}h |
| XL | {n} | {n*16}h+ |

---

## 의존성 그래프

```mermaid
graph TD
    TASK-001[DB 스키마] --> TASK-002[모델 구현]
    TASK-002 --> TASK-003[API 엔드포인트]
    TASK-002 --> TASK-004[비즈니스 로직]
    TASK-003 --> TASK-005[통합 테스트]
    TASK-004 --> TASK-005

작업 목록

Phase 1: 기반 작업

TASK-001: [작업명]

TASK-002: [작업명]

Phase 2: 핵심 구현

TASK-003: [작업명]

...

Phase 3: 테스트 및 검증

TASK-T001: [테스트 작업명]

Phase 4: 문서화

TASK-D001: [문서 작업명]

...

실행 순서 (권장)

Week 1:
├── Day 1-2: TASK-001 (기반)
├── Day 3-4: TASK-002 (모델)
└── Day 5: TASK-003 (API 시작)

Week 2:
├── Day 1-2: TASK-003 완료, TASK-004
├── Day 3: TASK-T001 (테스트)
└── Day 4-5: TASK-005, TASK-D001

변경 이력

---

## 사용 예시

### 예시 1: PRD에서 태스크 생성

User: /doc-tasks tasks/user-dashboard-prd.md

Claude: PRD 문서를 분석합니다.

발견된 기능 요구사항

• F-001: 데이터 위젯 표시
• F-002: 필터링 기능
• F-003: 데이터 내보내기
• F-004: 실시간 업데이트

작업 분해 시작

[AskUserQuestion 호출] question: "위젯 구현 방식을 선택해주세요" header: "위젯" options:

• "기존 컴포넌트 활용 (Recommended)" - 재사용 가능
• "새 컴포넌트 개발" - 맞춤 구현 필요

User: 기존 컴포넌트 활용

Claude: 작업 목록을 생성합니다.

총 12개 작업 도출:

• 구현: 8개
• 테스트: 3개
• 문서: 1개

파일: tasks/user-dashboard-tasks.md

검토 후 조정할 사항을 알려주세요.

### 예시 2: 기능명으로 태스크 생성

User: /doc-tasks 결제 시스템

Claude: 관련 PRD를 찾습니다...

발견: tasks/payment-system-prd.md

이 PRD를 기반으로 태스크를 생성할까요?

User: 네

Claude: (PRD 분석 후 작업 분해)

### 예시 3: 태스크를 TodoWrite로 연동

User: /doc-tasks 인증 모듈 --todo

Claude: 태스크 목록을 생성하고 TodoWrite에 등록합니다.

생성된 작업

1. TASK-001: JWT 유틸리티 함수 (M)
2. TASK-002: 인증 미들웨어 (L)
3. TASK-003: 로그인 API (M)
4. TASK-T001: 인증 단위 테스트 (S)

[TodoWrite 호출]

• JWT 유틸리티 함수
• 인증 미들웨어
• 로그인 API
• 인증 단위 테스트

Todo 목록에 등록되었습니다. 실행을 시작할까요? (/3-step-workflow 연계)

---

## 작업 분해 원칙

### 1. SMART 원칙

```mermaid
flowchart TD
    SMART["SMART 원칙"] --> S["Specific<br/>구체적인 산출물 명시"]
    SMART --> M["Measurable<br/>완료 조건 명확"]
    SMART --> A["Achievable<br/>1일 이내 완료 가능"]
    SMART --> R["Relevant<br/>PRD 요구사항과 연결"]
    SMART --> T["Time-bound<br/>예상 시간 추정"]

    style SMART fill:#e1f5ff,stroke:#333,stroke-width:3px
    style S fill:#fff4e1,stroke:#333,stroke-width:2px
    style M fill:#e1ffe1,stroke:#333,stroke-width:2px
    style A fill:#ffe1f5,stroke:#333,stroke-width:2px
    style R fill:#f5e1ff,stroke:#333,stroke-width:2px
    style T fill:#e1f5ff,stroke:#333,stroke-width:2px

2. 분해 기준

flowchart TD
    Criteria["분해 기준"] --> C1["1. 단일 책임<br/>하나의 작업 = 하나의 목적"]
    Criteria --> C2["2. 독립성<br/>가능한 병렬 실행 가능하게"]
    Criteria --> C3["3. 검증 가능<br/>완료 여부 명확히 판단 가능"]
    Criteria --> C4["4. 크기 제한<br/>XL(2일+) 작업은 더 분해 고려"]

    style Criteria fill:#e1f5ff,stroke:#333,stroke-width:3px
    style C1 fill:#fff4e1,stroke:#333,stroke-width:2px
    style C2 fill:#e1ffe1,stroke:#333,stroke-width:2px
    style C3 fill:#ffe1f5,stroke:#333,stroke-width:2px
    style C4 fill:#f5e1ff,stroke:#333,stroke-width:2px

3. 의존성 최소화

flowchart TD
    Dependency["의존성 최소화"] --> D1["1. 순환 의존성 금지"]
    Dependency --> D2["2. 의존성 깊이<br/>3단계 이하 권장"]
    Dependency --> D3["3. 병목 작업<br/>식별 및 분산"]

    style Dependency fill:#e1f5ff,stroke:#333,stroke-width:3px
    style D1 fill:#fff4e1,stroke:#333,stroke-width:2px
    style D2 fill:#e1ffe1,stroke:#333,stroke-width:2px
    style D3 fill:#ffe1f5,stroke:#333,stroke-width:2px

난이도 가이드

관련 스킬

옵션

--todo

--detail

--mermaid

--estimate

주의사항

1. PRD 없이 사용 주의: 요구사항 불명확 시 잘못된 분해 위험
2. 과도한 분해 지양: 너무 작은 작업은 관리 오버헤드 증가
3. 추정은 참고용: 난이도/시간 추정은 상황에 따라 달라질 수 있음
4. 지속적 업데이트: 실행 중 발견된 작업 추가 반영

Changelog