Task Management 가이드

태스크 파일을 관리하고 상태를 추적하는 방법입니다.

태스크 파일 구조

위치

• 활성 태스크: ./tasks/TASK-{ID}.md
• 아카이브: ./tasks/archive/TASK-{ID}.md

기본 형식

# TASK-{ID}: {제목}

## 상태
- 현재: {status}
- 생성일: {created_at}
- 마지막 업데이트: {updated_at}

## 요청 내용
{사용자 요청 원문}

## Steps
### Step 1: {제목} [S/M/L]
- 설명: {상세 설명}
- 상태: pending | in_progress | completed
- 관련 파일: {파일 목록}

## 에이전트 결과
### codebase_search_result
{결과}

## 테스트 결과
### [TASK-ID-T01] {테스트명}
- 결과: PASSED | FAILED
- 일시: {timestamp}

## User Interactions
{사용자 입력 기록}

태스크 상태

조회 작업

목록 조회

# 모든 활성 태스크
ls ./tasks/TASK-*.md

# 상태별 필터링 (Grep 사용)
grep -l "현재: pending" ./tasks/TASK-*.md
grep -l "현재: in_progress" ./tasks/TASK-*.md
grep -l "현재: pending_test" ./tasks/TASK-*.md

ID별 조회

Read: ./tasks/TASK-001.md

상태 업데이트

Edit 도구 사용

old_string: "- 현재: in_progress"
new_string: "- 현재: completed"

타임스탬프 포함

- 현재: completed
- 마지막 업데이트: 2024-01-15T10:30:00

테스트 결과 기록

새 테스트 결과 추가

Task 파일의 ## 테스트 결과 섹션에 추가:

## 테스트 결과

### [TASK-001-T01] 사용자 인증 테스트
- 결과: PASSED
- 일시: 2024-01-15T14:30:00
- 테스터: {user}
- 비고: 모든 케이스 통과

### [TASK-001-T02] 권한 검증 테스트
- 결과: FAILED
- 일시: 2024-01-15T14:45:00
- 에러: 관리자 권한 검증 실패
- 로그: ./logs/test-error-001.txt

테스트 상태 집계

## 테스트 요약
- 총 테스트: 5개
- 통과: 4개
- 실패: 1개
- 마지막 실행: 2024-01-15T14:45:00

아카이빙

아카이브 조건

모든 조건 충족 시에만 아카이브:

1. 모든 Step: completed
2. 모든 테스트: PASSED (또는 테스트 없음)

아카이브 실행

# archive-task.py hook 사용
python3 .claude/hooks/archive-task.py TASK-001

# 미리보기
python3 .claude/hooks/archive-task.py TASK-001 --dry-run

아카이브 동작

1. ./tasks/TASK-001.md → ./tasks/archive/TASK-001.md
2. ./Test/[TASK-001-*].md → ./Test/Archive/
3. 상태를 archived로 변경

내용 추가

에이전트 결과 추가

## 에이전트 결과

### coder_agent_result (Step 1)
- 상태: COMPLETED
- 수정 파일: src/auth/login.ts, src/middleware/auth.ts
- 변경 내용: JWT 인증 구현
- 타임스탬프: 2024-01-15T10:30:00

사용자 코멘트 추가

## User Interactions

### [2024-01-15 10:30] 입력 요청 #1
- 요청 출처: coder-agent (Step 2)
- 유형: choice
- 질문: "인증 방식 선택"
- 선택지: ["JWT", "Session"]
- **사용자 응답**: JWT

에러 처리

파일 없음

Task 파일을 찾을 수 없습니다: TASK-999
→ 올바른 TASK-ID 확인 필요

아카이브 실패

테스트가 완료되지 않았습니다.
→ pending_test 상태 유지
→ /test-report로 테스트 결과 보고 필요