Task Manager Agent 활용 가이드

태스크 파일 관리 작업을 task-manager-agent에 위임하는 방법입니다.

핵심 원칙

태스크 파일 직접 수정 대신 task-manager-agent에 위임합니다.

상태 업데이트, 테스트 결과 기록, 아카이빙 등 모든 태스크 관리 작업을 위임합니다.

사용 시나리오

반드시 Task tool을 사용합니다. Bash 명령어로 실행하지 마세요.

1. 태스크 목록 조회

Task tool 호출:
  subagent_type: "task-manager-agent"
  run_in_background: true
  prompt: |
액션: list
필터: in_progress (선택적)

.claude/agents/task-manager-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘."

2. 태스크 상태 조회

Task tool 호출:
  subagent_type: "task-manager-agent"
  run_in_background: true
  prompt: |
액션: get
대상: TASK-001

.claude/agents/task-manager-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘."

3. 상태 업데이트

Task tool 호출:
  subagent_type: "task-manager-agent"
  run_in_background: true
  prompt: |
액션: update
대상: TASK-001
새 상태: pending_test

.claude/agents/task-manager-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘."

4. 테스트 결과 기록

Task tool 호출:
  subagent_type: "task-manager-agent"
  run_in_background: true
  prompt: |
액션: record_test
대상: TASK-001
테스트 결과:
  - 테스트 ID: TASK-001-T01
  - 결과: PASSED
  - 일시: 2024-01-15T14:30:00
  - 비고: 모든 케이스 통과

.claude/agents/task-manager-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘."

5. 내용 추가

Task tool 호출:
  subagent_type: "task-manager-agent"
  run_in_background: true
  prompt: |
액션: add_content
대상: TASK-001
섹션: 에이전트 결과
내용:
  ### coder_agent_result (Step 2)
  - 상태: COMPLETED
  - 수정 파일: [목록]

.claude/agents/task-manager-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘."

6. 아카이빙

Task tool 호출:
  subagent_type: "task-manager-agent"
  run_in_background: true
  prompt: |
액션: archive
대상: TASK-001

.claude/agents/task-manager-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘."

액션 목록

| 액션 | 설명 | 필수 파라미터 | |------|------|---------------| | list | 태스크 목록 조회 | (없음) | | get | 특정 태스크 조회 | task_id | | update | 상태 업데이트 | task_id, status | | add_content | 내용 추가 | task_id, section, content | | record_test | 테스트 결과 기록 | task_id, test_result | | archive | 아카이빙 | task_id |

결과 처리

성공

## task-manager-agent 결과
- 상태: COMPLETED
- 액션: update
- 대상: TASK-001
- 결과: 상태가 pending_test로 업데이트됨

실패

## task-manager-agent 결과
- 상태: FAILED
- 액션: archive
- 대상: TASK-001
- 에러: 테스트가 완료되지 않음 (pending_test 상태)

워크플로우 통합

일반 작업 흐름

Step 완료
    ↓
task-manager-agent (상태: in_progress → completed)
    ↓
모든 Step 완료
    ↓
task-manager-agent (상태: completed → pending_test)

/test-report 흐름

테스트 결과 수신
    ↓
task-manager-agent (record_test)
    ↓ [모든 테스트 PASSED]
task-manager-agent (archive)

주의사항

아카이브 조건: 모든 테스트가 PASSED일 때만 아카이브 가능
상태 흐름: pending → in_progress → completed → pending_test → archived
실패 처리: 아카이브 실패 시 에러 메시지 확인 후 조치