┌─────────────────────────────────────────────────────────┐
│                    Execute Mode                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │ 자동 실행: spawn → 결과 수신 → 다음 작업        │    │
│  └─────────────────────────────────────────────────┘    │
└────────────────────┬────────────────────────────────────┘
                     │ [입력 필요 감지]
                     ▼
┌─────────────────────────────────────────────────────────┐
│                     Plan Mode                            │
│  ┌─────────────────────────────────────────────────┐    │
│  │ 1. 상황 정리 및 옵션 제시                        │    │
│  │ 2. AskUserQuestion 또는 계획 작성                │    │
│  │ 3. 사용자 응답/승인 대기                         │    │
│  └─────────────────────────────────────────────────┘    │
└────────────────────┬────────────────────────────────────┘
                     │ [사용자 응답 수신]
                     ▼
┌─────────────────────────────────────────────────────────┐
│                    Execute Mode                          │
│  사용자 결정 반영하여 작업 재개                          │
└─────────────────────────────────────────────────────────┘

Task tool #1:
  subagent_type: "codebase-search-agent"
  run_in_background: true
  prompt: "프로젝트 코드에서 관련 코드를 찾아주세요..."

Task tool #2:
  subagent_type: "reference-agent"
  run_in_background: true
  prompt: "레퍼런스/예제 코드를 찾아주세요..."

Task tool #3: (필요시)
  subagent_type: "web-search-agent"
  run_in_background: true
  prompt: "외부 정보를 검색해주세요..."

Task tool #4: (config.json에 등록된 경우)
  subagent_type: "{custom_agent}"
  run_in_background: true
  prompt: "..."

FOR each Step in task.steps:
  IF step.status == 'completed': CONTINUE

  1. coder-agent 백그라운드 spawn → Step 작업
  2. 결과 수신 후 USER_INPUT_REQUIRED 확인
  3. builder-agent 백그라운드 spawn → 빌드/테스트

  IF 빌드 실패:
    - LESSONS_LEARNED.md 업데이트
    - 재시도 (최대 3회)
    - 3회 실패 시 사용자 보고

  IF 빌드 성공:
    - commit-agent spawn → [TASK-ID] 형식 커밋
    - test-case-agent spawn → 테스트 케이스 생성
    - step.status = 'completed'
    - 결과 기록

  Step 완료 보고

모든 Step 완료
    ↓
Task 상태: pending_test
    ↓
사용자에게 안내:
"테스트를 실행하고 결과를 보고해주세요:
/test-report TASK-001-T01 {결과}"

/test-report 성공 수신
    ↓
task-manager-agent → 결과 기록
    ↓
archive-task.py hook → 파일 이동
    ↓
완료 보고

## {agent-name} 결과
- 상태: PENDING_INPUT
- USER_INPUT_REQUIRED:
  - type: "choice" | "confirm" | "plan"
  - reason: "{입력이 필요한 이유}"
  - options: ["{선택지1}", "{선택지2}", ...] (choice인 경우)
  - context: "{추가 컨텍스트}"

Sub Agent 결과 수신
  ↓
USER_INPUT_REQUIRED 플래그 확인
  ↓
[있음] → input_type 확인
         ├─ "choice"   → AskUserQuestion (선택지 제시)
         ├─ "confirm"  → AskUserQuestion (예/아니오)
         └─ "plan"     → EnterPlanMode (상세 계획 필요)
  ↓
[없음] → Execute Mode 유지 → 다음 작업 진행

coder-agent 결과:
  - 상태: PENDING_INPUT
  - USER_INPUT_REQUIRED:
    - type: "choice"
    - reason: "인증 방식 선택 필요"
    - options: ["JWT", "Session", "OAuth2"]
    - context: "현재 프로젝트에 인증 시스템 없음"

/orchestrate 행동:
  → AskUserQuestion 호출
  → 선택지: JWT, Session, OAuth2
  → 사용자 선택 수신
  → coder-agent에 결과 전달하여 작업 재개

사용자 요청: "성능 최적화해줘"

/orchestrate 판단:
  → 범위가 모호함 (DB? API? 프론트?)
  → AskUserQuestion 호출
  → 질문: "어떤 영역을 최적화할까요?"
  → 선택지: ["데이터베이스 쿼리", "API 응답 속도", "프론트엔드 렌더링", "전체"]

## User Interactions

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

### [2024-01-15 11:00] 입력 요청 #2
- 요청 출처: /orchestrate (직접)
- 유형: confirm
- 질문: "기존 인증 코드를 삭제할까요?"
- **사용자 응답**: 예
- 처리 결과: 삭제 진행

task 파일에 {agent_name}_result 섹션이 존재하면 해당 에이전트 spawn 하지 않음