---

name: task-planning description: 인수 테스트를 기반으로 남은 작업을 분석하고 다음 작업을 계획합니다. "작업 계획", "다음 작업", "할 일 확인", "남은 작업" 등의 요청 시 활성화됩니다.

작업 계획 스킬

개요

이 스킬은 문서를 분석하여 남은 작업을 파악하고, 인수 테스트를 기반으로 적절한 크기의 작업을 선정합니다. 모든 작업 분할과 우선순위 결정은 인수 테스트를 기준으로 이루어집니다.

사전 조건

• docs/user-stories/ 디렉토리에 사용자 스토리가 존재해야 합니다.
• docs/traceability-matrix.md 파일이 존재해야 합니다.
• 사용자 스토리에 인수 테스트(AT)가 정의되어 있어야 합니다.

산출물

실행 절차

1단계: 문서 분석

다음 문서들을 분석합니다:

1. 사용자 스토리 (docs/user-stories/US-*.md)

   • 모든 인수 테스트(AT) 목록 추출
   • 각 인수 테스트의 ID 확인

2. 추적성 매트릭스 (docs/traceability-matrix.md)

   • 구현 완료된 인수 테스트 확인
   • 역방향 추적으로 구현된 코드 확인

3. 기존 테스트 코드 (tests/acceptance/)

   • 실제 구현된 테스트 파일 확인
   • 통과/실패 상태 확인

2단계: 남은 작업 판단

Copy전체 인수 테스트 목록
─────────────────────
│ US-001-AT-1 ✓ 완료
│ US-001-AT-2 ✓ 완료
│ US-002-AT-1 ○ 미완료  ← 다음 작업 후보
│ US-002-AT-2 ○ 미완료
│ US-003-AT-1 ○ 미완료
─────────────────────

작업 완료 판단 기준

인수 테스트가 "완료"로 판단되려면:

1. 테스트 코드가 존재하고 (@trace 어노테이션으로 연결)
2. 테스트가 통과하며
3. 추적성 매트릭스에 역방향 추적이 기록됨

모든 작업 완료 시

Copy## 작업 완료 안내

축하합니다! 모든 인수 테스트가 완료되었습니다.

### 완료된 항목
- US-001: {스토리 제목}
  - AT-1: ✓ 완료
  - AT-2: ✓ 완료
- US-002: {스토리 제목}
  - AT-1: ✓ 완료

### 다음 단계 제안
1. 회고 미팅 진행
2. 추가 요구사항 수집
3. 다음 스프린트 계획

3단계: 작업 분할 및 선정

분할 원칙

1. 인수 테스트 단위 분할

   • 하나의 작업은 1~3개의 인수 테스트를 포함
   • 관련된 인수 테스트는 함께 묶음

2. 테스트 작성 시간 고려

   • 각 인수 테스트당 테스트 코드 작성 시간 포함
   • 단위 테스트 + 인수 테스트 = 총 테스트 시간

3. 의존성 고려

   • 선행 작업이 필요한 경우 먼저 완료

작업 크기 기준

Copy작업 크기 = 구현 시간 + 테스트 작성 시간

소형 (S): 인수 테스트 1개 + 단위 테스트 2-3개
중형 (M): 인수 테스트 2개 + 단위 테스트 4-6개
대형 (L): 인수 테스트 3개 + 단위 테스트 7개 이상

우선순위 결정

Copy1순위: 다른 작업의 선행 조건이 되는 인수 테스트
2순위: 핵심 사용자 흐름에 해당하는 인수 테스트
3순위: 사용자 스토리 우선순위가 높은 항목
4순위: 구현 복잡도가 낮은 항목 (빠른 성과)

4단계: 작업 계획서 작성

docs/tasks/TASK-{번호}-{제목}.md 파일을 생성합니다:

Copy# TASK-{번호}: {작업 제목}

## 메타데이터
- **작성일**: YYYY-MM-DD
- **예상 크기**: S | M | L
- **상태**: 대기중 | 진행중 | 완료
- **담당**: {담당자 또는 AI}

## 관련 인수 테스트

이 작업에서 구현할 인수 테스트:

| ID | 제목 | 사용자 스토리 |
|----|------|--------------|
| US-{번호}-AT-{번호} | {인수 테스트 제목} | US-{번호} |

## 인수 조건 상세

### US-{번호}-AT-{번호}: {인수 테스트 제목}

**Given** (전제조건):
{전제조건 상세}

**When** (행동):
{사용자 행동 상세}

**Then** (결과):
{예상 결과 상세}

## 구현 계획

### 1. 테스트 작성 (TDD)

#### 인수 테스트

파일: tests/acceptance/test_{기능}.{확장자}

• 테스트 케이스: {테스트 설명}
• @trace US-{번호}-AT-{번호}

Copy
#### 단위 테스트

파일: tests/unit/test_{모듈}.{확장자}

• 테스트 케이스 1: {설명}
• 테스트 케이스 2: {설명}

Copy
### 2. 구현

파일: src/{경로}/{파일명}.{확장자}

• 함수/클래스: {이름}
• @trace US-{번호}-AT-{번호}
• @spec SPEC-{번호}-FR-{번호}

Copy
### 3. 리팩토링 (필요시)

- {리팩토링 계획}

## 완료 조건

- [ ] 인수 테스트 코드 작성
- [ ] 단위 테스트 코드 작성
- [ ] 구현 코드 작성
- [ ] 모든 테스트 통과
- [ ] CI 파이프라인 통과
- [ ] 추적성 매트릭스 업데이트
- [ ] 코드 리뷰 (해당시)

## 의존성

### 선행 작업
- {필요한 선행 작업 또는 "없음"}

### 후속 작업
- {이 작업 완료 후 가능해지는 작업}

## 참고사항
- {추가 정보}

5단계: 진행 현황 업데이트

docs/tasks/PROGRESS.md 파일을 생성하거나 업데이트합니다:

Copy# 프로젝트 진행 현황

## 최종 업데이트
- **일시**: YYYY-MM-DD HH:MM
- **전체 진행률**: {완료 AT 수}/{전체 AT 수} ({퍼센트}%)

## 사용자 스토리별 현황

### US-001: {스토리 제목}
- **상태**: 완료 | 진행중 | 대기중
- **진행률**: {완료 AT}/{전체 AT}

| 인수 테스트 | 상태 | 작업 |
|------------|------|------|
| AT-1 | ✓ 완료 | TASK-001 |
| AT-2 | ○ 진행중 | TASK-002 |
| AT-3 | - 대기중 | - |

### US-002: {스토리 제목}
...

## 현재 진행 중인 작업

| 작업 ID | 제목 | 관련 AT | 상태 |
|---------|------|---------|------|
| TASK-002 | {제목} | US-001-AT-2 | 진행중 |

## 다음 예정 작업

| 우선순위 | 작업 ID | 제목 | 관련 AT |
|----------|---------|------|---------|
| 1 | TASK-003 | {제목} | US-002-AT-1 |
| 2 | TASK-004 | {제목} | US-002-AT-2 |

## 완료된 작업 이력

| 작업 ID | 제목 | 완료일 | 관련 AT |
|---------|------|--------|---------|
| TASK-001 | {제목} | YYYY-MM-DD | US-001-AT-1 |

작업 상태 전이

Copy대기중 ──▶ 진행중 ──▶ 완료
   │         │
   │         ▼
   │      차단됨 ──▶ 진행중
   │
   ▼
  취소됨

다음 단계

작업 계획이 완료되면:

• implementation 스킬을 사용하여 작업 계획서에 따라 구현을 진행합니다.

품질 체크리스트

• 모든 미완료 인수 테스트가 식별되었는가?
• 작업이 인수 테스트 단위로 분할되었는가?
• 테스트 작성 시간이 작업 크기에 포함되었는가?
• 의존성이 올바르게 파악되었는가?
• 진행 현황이 업데이트되었는가?