Tasks & Runs

**Task(Work)**는 SprintX에서 AI 에이전트에게 위임하는 최소 실행 단위입니다. Task가 실행되면 **Run(Execution)**이 생성되고, 완료되면 Review로 이어집니다.

태스크 개요

Task는 Goal 아래에 속하며 다음 4가지 상태를 거칩니다.

backlog → doing → review → done
                    ↑
              (반려 시 되돌아옴)

상태	의미
backlog	계획됨, 아직 실행 전
doing	에이전트가 실행 중
review	실행 완료, 사용자 검토 대기
done	승인 완료

태스크 생성

Task는 스프린트 보드(/projects/[id]/sprints/[sprintId])에서 생성합니다.

입력 항목:

필드	필수	설명
제목	O	Task 내용을 한 줄로 요약
설명	X	상세 설명, 에이전트 실행 컨텍스트로 활용
에이전트	X	AI 담당자 지정 (미지정 시 추천 사용)
라벨	X	분류 태그 (DB에 영속화)

보드 상단의 Quick Create 입력으로 제목만 빠르게 생성할 수도 있습니다.

에이전트 배정

Task 내용을 분석해 맞는 에이전트를 추천해 줍니다.

에이전트	주 적합 유형
Claude Code	UX/카피/프론트엔드 구현, 넓은 종합 분석
Codex	코드 구현, 리팩터링, 테스트 보강
Gemini	문서/리서치/요약
OpenCode	검증/QA/로컬 자동화 보조

추천 결과는 자동 적용되거나 검토 필요로 표시됩니다. 언제든지 수동으로 변경할 수 있습니다.

Run 실행

에이전트가 배정된 Task에서 실행을 시작하면 Task Run이 생성됩니다.

Run 상태:

상태	의미
queued	실행 요청 수락, 시작 대기
running	에이전트 실행 중
blocked_needs_input	에이전트가 입력을 요청하여 대기 중
completed	실행 완료, Task → review 전환
failed	실행 실패 (재실행 가능)
cancelled	명시적 취소

실행 중 에이전트가 추가 정보를 요청하면 Question Card가 생성되고 Task 상태가 blocked_needs_input으로 전환됩니다. Home의 Needs Attention 또는 Inbox에서 답변할 수 있습니다.

실행 결과 확인

Task 상세 화면 (/tasks/[id])

Task 상세 화면은 3단 레이아웃으로 실행 정보를 보여줍니다.

• 상단: 현재 상태 배지, 다음 액션 버튼
• 중간: 최신 Run 요약, 실시간 실행 상태, AI 추천 카드, Review Packet 링크
• 하단(접힘): 전체 실행 이력 타임라인, 원본 로그

전체 실행 이력 (/runs)

/runs 페이지에서 모든 프로젝트의 Run 이력을 조회할 수 있습니다.

필터 옵션: 상태 / 프로젝트 / 에이전트 / 날짜 범위

Run 항목: Task 이름 링크, 실행 상태 배지, 시작/종료 시간, 실행 소요 시간, Retry 이력

재실행 (Retry)

Run이 failed 상태가 되면 재실행을 시도할 수 있습니다. 재실행은 기존 Run을 수정하지 않고 새 Run을 생성합니다. 최대 3회 자동 재실행 후 소유자 확인이 필요합니다.

사이클 전체 흐름은 사이클 개념 가이드를 참고하세요.