§05 · 학습 챕터

04. Task lifecycle

작업 흐름 · 재진입

“로그인 기능 추가해줘” 같은 한 덩어리 작업이 하네스 안에서 어떻게 파일로 흘러가는지 단계별로 봅니다. 끝나면 status: done과 [VERIFICATION]이 남습니다.

정본: AGENTS.md Task Lifecycle · _templates/task-folder.md · orchestrator-rules.md §3대상: 바이브코더 · 초급 개발자 (기술 용어 + 한글 설명 병행)

챕터 이동chapter-nav

이전·다음 챕터로 이동합니다. 본문은 아래 학습 블록 카드에서 펼칩니다.

03. Folder 3 layers / _shared · _templates · tasks

홈

Harness MultiAgent 2.1

05 워커 · MCP · routes

01. Harness Orchestrator 02. Install · validate 03. Folder 3 layers 04. Task lifecycle 05. Workers · MCP 06. Approval · envelope 07. Four flavors 08. RUNBOOK 09. KNOT · wiki 10. KNOT · install 11. KNOT · bridge LAB · Phase · Run

전체 학습 블록 카드learn-blocks

학습 블록

Core flow

전체 그림

AGENTS.md Task Lifecycle · _templates/task-folder.md · orchestrator-rules.md §3 · 작업 접수 → 오케스트레이터 계획 → 워커 선택(routing.md)

문서 코드 본문현재 실습

학습 블록

Eight steps

lifecycle 8단계

AGENTS.md Task Lifecycle · _templates/task-folder.md · orchestrator-rules.md §3 · lifecycle 8단계

문서 코드 본문 실습

학습 블록

Re-entry protocol

재진입 프로토콜

AGENTS.md Task Lifecycle · _templates/task-folder.md · orchestrator-rules.md §3 · 채팅이 초기화되어도 괜찮습니다 (orchestrator-rules.md §3).

문서 코드 본문 실습

학습 블록

Log tags

log.md 태그

AGENTS.md Task Lifecycle · _templates/task-folder.md · orchestrator-rules.md §3 · [2026-06-10 14:31] [APPROVAL] user approved workers: codex (critique) — scope: API draft review

문서 코드 본문 실습

학습 블록

Reference task

참조 예시

AGENTS.md Task Lifecycle · _templates/task-folder.md · orchestrator-rules.md §3 · tasks/manual-core-flow-e2e/ — 매뉴얼 Core Flow 토폴로지를 파일로 증명한 reference task.

문서 코드 본문 실습

학습 블록

Common mistakes

자주 하는 실수

AGENTS.md Task Lifecycle · _templates/task-folder.md · orchestrator-rules.md §3 · 자주 하는 실수

문서 코드 본문 실습

학습 블록

Checklist

체크리스트

AGENTS.md Task Lifecycle · _templates/task-folder.md · orchestrator-rules.md §3 · 체크리스트

문서 코드 본문 실습

선택 블록 본문block-detail

Core flow

전체 그림

작업 접수 → 오케스트레이터 계획 → 워커 선택(routing.md)
→ 승인 게이트 → brief 작성 → 워커 호출 → result 저장
→ 통합·critique(선택) → Verification → [COMPLETE]

단계별 한글 설명

단계	무엇을 하나	남는 파일
1. 접수	목표·범위 정리	`task.md` (`status: pending`)
2. 계획	최소 워커 set 결정	`planned_workers` + routing 참고
3. 승인	누구를 부를지 사용자 확인	`workers_approved` + `log.md` `[APPROVAL]`
4. brief	워커별 지시 (짧게)	`workers/<w>/brief.md`
5. 호출	claude/codex/gemini 실행	`workers/<w>/result.md`
6. 검증	체크리스트 통과 여부	`log.md` `[VERIFICATION]`
7. 완료	작업 종료 표시	`task.md` `status: done` + `[COMPLETE]`

정본 발췌 (AGENTS.md)

1. Create tasks/<task-name>/task.md (status: pending)
2. Read _shared/routing.md — minimum worker set
3. Record orchestrator_host
4. Confirm target_repo (외부 repo 쓰기 시)
5. workers_approved before any worker call
6. brief.md — mode: implement | critique | analysis
7. Run worker → result.md
8. Verification → [VERIFICATION] → done