uctm 1.2.0 → 1.3.0

package/agents/ko/agent-flow.md

@@ -1,106 +1,152 @@
-# Agent Flow — Main Claude 오케스트레이션 가이드
-
-> **모든 에이전트 호출은 Main Claude가 수행한다.**
-> 서브에이전트는 작업 완료 후 결과(dispatch XML 또는 task-result XML)만 반환한다.
-> Main Claude가 반환값을 받아 다음 에이전트를 호출한다.
-
----
-
-## 실행 모드 결정
-
-```
-[] 태그 감지 → router 호출
-    │
-    router 반환값(execution-mode) 확인
-    │
-    ├─ direct   → router가 직접 처리 완료 (추가 호출 없음)
-    ├─ pipeline → § pipeline 절차 실행
-    └─ full     → § full 절차 실행
-```
-
----
-
-## direct 모드
-
-router가 단독으로 처리 완료. Main Claude 추가 호출 없음.
-
----
-
-## pipeline 모드
-
-```
-1. router 호출 → PLAN.md + TASK-00.md 생성 + builder dispatch XML 반환
-2. builder 호출 (dispatch XML을 prompt로)
-3. verifier 호출 (builder 결과를 prompt로)
-4. committer 호출 (verifier 결과를 prompt로)
-```
-
----
-
-## full 모드
-
-```
-1. router 호출 → WORK 디렉토리 생성 + planner dispatch XML 반환
-2. planner 호출 (dispatch XML을 prompt로) → PLAN.md + TASK 파일 생성
-3. scheduler 호출 → DAG 분석 + READY TASK + builder dispatch XML 반환
-4. builder 호출 (dispatch XML을 prompt로) → 구현
-5. verifier 호출 (builder 결과를 prompt로) → 검증
-6. committer 호출 (verifier 결과를 prompt로) → commit
-7. 미완료 TASK 있으면 3번으로 돌아감
-```
-
-병렬 실행: scheduler가 복수의 READY TASK를 반환하면 builder를 동시에 호출한다.
-
----
-
-## 에이전트 역할 요약
-
-| 에이전트 | 반환값 | 호출 주체 |
-|---------|-------|---------|
-| router | execution-mode + dispatch XML | Main Claude |
-| planner | PLAN.md/TASK 파일 생성 완료 보고 | Main Claude |
-| scheduler | READY TASK + dispatch XML | Main Claude |
-| builder | task-result XML (context-handoff 포함) | Main Claude |
-| verifier | task-result XML | Main Claude |
-| committer | task-result XML + commit hash | Main Claude |
-
----
-
-## Bash CLI 실행 (서버 자동화)
-
-대화 세션 없이 파이프라인을 독립 실행하는 방법. `claude -p`가 Main Claude 역할을 수행한다.
-
-```bash
-env -u CLAUDECODE -u ANTHROPIC_API_KEY claude -p \
-  "[WORK 시작] {작업 내용}" \
-  --dangerously-skip-permissions \
-  --output-format stream-json \
-  --verbose \
-  2>&1 | tee /tmp/pipeline.log
-```
-
-| 옵션 | 목적 |
-|------|------|
-| `env -u CLAUDECODE` | 중첩 실행 차단 우회 |
-| `env -u ANTHROPIC_API_KEY` | API 키 대신 구독 인증(Max) 사용 |
-| `--dangerously-skip-permissions` | 무인 실행 시 권한 프롬프트 스킵 |
-| `--output-format stream-json --verbose` | 실시간 모니터링용 스트리밍 |
-
-중단된 파이프라인 재개:
-```bash
-env -u CLAUDECODE -u ANTHROPIC_API_KEY claude -p \
-  "WORK-XX 파이프라인을 이어서 실행하라." \
-  --dangerously-skip-permissions
-```
-
-검증 결과 (WORK-24): `claude -p` → Task tool 9회 호출 → router/planner/scheduler/builder/verifier/committer 전체 자동 완주 확인됨.
-
----
-
-## 컨텍스트 전달 (슬라이딩 윈도우)
-
-| 거리 | Level | 내용 |
-|------|-------|------|
-| 직전 | FULL | what + why + caution + incomplete |
-| 2단계 전 | SUMMARY | what 1~2줄 |
-| 3단계+ | DROP | 전달 안 함 |
+# Agent Flow — Main Claude 오케스트레이션 가이드
+
+> **모든 에이전트 호출은 Main Claude가 수행한다.**
+> 서브에이전트는 작업 완료 후 결과(dispatch XML 또는 task-result XML)만 반환한다.
+> Main Claude가 반환값을 받아 다음 에이전트를 호출한다.
+
+---
+
+## 파이프라인 흐름
+
+```
+[] 태그 감지 → specifier 호출
+    │
+    specifier 반환값 확인
+    │
+    ├─ 겸임 (direct) → specifier가 Requirement.md + PLAN.md + TASK-00 생성
+    │                   → builder dispatch XML 반환
+    │                   → § direct 절차 실행
+    │
+    └─ 위임 (pipeline/full) → specifier가 Requirement.md만 생성
+                               → planner dispatch XML 반환
+                               → § planner-driven 절차 실행
+```
+
+---
+
+## direct 모드 (Specifier 겸임)
+
+```
+1. specifier 호출 → Requirement.md + PLAN.md + TASK-00 생성 + builder dispatch XML 반환
+2. [승인 1회] 사용자 검토 (요구사항 + 설계 통합)
+3. builder 호출 (dispatch XML을 prompt로) — self-check 포함
+4. committer 호출 (builder 결과를 prompt로)
+```
+
+> Verifier 생략: Builder가 self-check(build/lint)를 수행하므로 단일 TASK에서 별도 검증 불필요.
+
+---
+
+## pipeline 모드 (Planner 별도 호출)
+
+```
+1. specifier 호출 → Requirement.md 생성 + planner dispatch XML 반환
+2. [기획 승인] 사용자 검토 (Requirement.md)
+3. planner 호출 (dispatch XML을 prompt로) → PLAN.md + TASK-NN 생성 + execution-mode 결정
+4. [개발 승인] 사용자 검토 (PLAN.md + TASK 목록)
+5. builder 호출 (TASK별 dispatch XML을 prompt로)
+6. verifier 호출 (builder 결과를 prompt로)
+7. committer 호출 (verifier 결과를 prompt로)
+```
+
+---
+
+## full 모드 (Scheduler 포함)
+
+```
+1. specifier 호출 → Requirement.md 생성 + planner dispatch XML 반환
+2. [기획 승인] 사용자 검토 (Requirement.md)
+3. planner 호출 → PLAN.md + TASK 분해 + execution-mode: full 결정
+4. [개발 승인] 사용자 검토 (PLAN.md + TASK 목록)
+5. scheduler 호출 → DAG 분석 + READY TASK + builder dispatch XML 반환
+6. builder 호출 (dispatch XML을 prompt로) → 구현
+7. verifier 호출 (builder 결과를 prompt로) → 검증
+8. committer 호출 (verifier 결과를 prompt로) → commit
+9. 미완료 TASK 있으면 5번으로 돌아감
+```
+
+병렬 실행: scheduler가 복수의 READY TASK를 반환하면 builder를 동시에 호출한다.
+
+---
+
+## 기존 WORK 재개
+
+이미 PLAN.md + TASK가 존재하는 WORK의 파이프라인 재개:
+
+```
+1. scheduler 호출 → READY TASK 확인 + builder dispatch XML 반환
+2. builder → verifier → committer 순서대로 실행
+3. 미완료 TASK 있으면 1번으로 돌아감
+```
+
+---
+
+## 에이전트 역할 요약
+
+| 에이전트 | 반환값 | 호출 주체 |
+|---------|-------|---------|
+| specifier | Requirement.md + (겸임 시) PLAN.md/TASK + dispatch XML | Main Claude |
+| planner | PLAN.md/TASK 파일 생성 완료 + execution-mode | Main Claude |
+| scheduler | READY TASK + dispatch XML | Main Claude |
+| builder | task-result XML (context-handoff 포함) | Main Claude |
+| verifier | task-result XML | Main Claude |
+| committer | task-result XML + commit hash | Main Claude |
+
+---
+
+## 모드별 서브에이전트 호출 횟수
+
+| 모드 | Specifier | Planner | Scheduler | Builder | Verifier | Committer | 합계 |
+|------|:---------:|:-------:|:---------:|:-------:|:--------:|:---------:|:----:|
+| direct | O (겸임) | X | X | O | X | O | **3회** |
+| pipeline | O | O | X | O | O | O | **5회** |
+| full | O | O | O | O | O | O | **6회** |
+
+---
+
+## 승인 게이트
+
+| 모드 | 승인 횟수 | 시점 |
+|------|:---------:|------|
+| direct | 1회 | Specifier 완료 후 (요구사항 + 설계 통합) |
+| pipeline/full | 2회 | 기획 승인 (Requirement.md) → 개발 승인 (PLAN.md) |
+| 자동 승인 | 0회 | "자동으로 진행" 명시 시 |
+
+---
+
+## Bash CLI 실행 (서버 자동화)
+
+대화 세션 없이 파이프라인을 독립 실행하는 방법. `claude -p`가 Main Claude 역할을 수행한다.
+
+```bash
+env -u CLAUDECODE -u ANTHROPIC_API_KEY claude -p \
+  "[WORK 시작] {작업 내용}" \
+  --dangerously-skip-permissions \
+  --output-format stream-json \
+  --verbose \
+  2>&1 | tee /tmp/pipeline.log
+```
+
+| 옵션 | 목적 |
+|------|------|
+| `env -u CLAUDECODE` | 중첩 실행 차단 우회 |
+| `env -u ANTHROPIC_API_KEY` | API 키 대신 구독 인증(Max) 사용 |
+| `--dangerously-skip-permissions` | 무인 실행 시 권한 프롬프트 스킵 |
+| `--output-format stream-json --verbose` | 실시간 모니터링용 스트리밍 |
+
+중단된 파이프라인 재개:
+```bash
+env -u CLAUDECODE -u ANTHROPIC_API_KEY claude -p \
+  "WORK-XX 파이프라인을 이어서 실행하라." \
+  --dangerously-skip-permissions
+```
+
+---
+
+## 컨텍스트 전달 (슬라이딩 윈도우)
+
+| 거리 | Level | 내용 |
+|------|-------|------|
+| 직전 | FULL | what + why + caution + incomplete |
+| 2단계 전 | SUMMARY | what 1~2줄 |
+| 3단계+ | DROP | 전달 안 함 |

package/agents/ko/file-content-schema.md

@@ -15,6 +15,31 @@
 
 ---
 
+## § 0. Requirement.md
+
+경로: `works/{WORK_ID}/Requirement.md`
+
+```markdown
+# Requirement — WORK-NN
+
+## Original Request
+> 사용자가 입력한 그대로
+
+## Functional Requirements (기능 요구사항)
+- FR-01: ...
+- FR-02: ...
+
+## Non-Functional Requirements (비기능 요구사항)
+- NFR-01: ...
+
+## Acceptance Criteria
+- [ ] 검증 가능한 기준들
+```
+
+생성 주체: Specifier (모든 요청에 필수)
+
+---
+
 ## § 1. PLAN.md
 
 경로: `works/{WORK_ID}/PLAN.md`
@@ -215,10 +240,11 @@ None
 
 | 종류 | 형식 | 생성 주체 |
 |------|------|----------|
-| WORK 계획 | `PLAN.md` | planner / router |
-| TASK 계획 | `TASK-NN.md` | planner / router |
-| TASK 진행 | `TASK-NN_progress.md` | planner(템플릿) / builder(갱신) |
-| TASK 결과 | `TASK-NN_result.md` | committer / router(direct) |
+| 요구사항 | `Requirement.md` | specifier |
+| WORK 계획 | `PLAN.md` | planner / specifier |
+| TASK 계획 | `TASK-NN.md` | planner / specifier |
+| TASK 진행 | `TASK-NN_progress.md` | planner / specifier(템플릿) / builder(갱신) |
+| TASK 결과 | `TASK-NN_result.md` | committer |
 | WORK 진행 | `PROGRESS.md` | scheduler |
 
 `WORK-NN-TASK-NN.md` 형식 금지 → `parseTaskFilename()` 인식 불가.

package/agents/ko/planner.md

@@ -9,7 +9,7 @@ model: opus
 
 You are the **Planner** — WORK 생성 및 TASK 분해 에이전트.
 
-사용자 요청을 분석하여 WORK(일) 단위를 정의하고, 이를 달성하기 위한 TASK(작업) 목록을 의존성 DAG 형태로 분해한다.
+Specifier가 생성한 Requirement.md를 기반으로 WORK의 설계와 TASK 분해를 수행하고, execution-mode를 결정한다.
 
 ```
 WORK (일)          — 사용자 요청의 목표 단위
@@ -22,8 +22,9 @@ WORK (일)          — 사용자 요청의 목표 단위
 
 | 업무 | 설명 |
 |------|------|
-| WORK ID 결정 | 파일시스템 스캔으로 다음 WORK 번호 산출 |
-| 프로젝트 탐색 | CLAUDE.md, README, package.json, 디렉토리 구조 파악 |
+| Requirement.md 분석 | Specifier가 생성한 요구사항 문서 기반으로 설계 |
+| 프로젝트 탐색 | CLAUDE.md, README, package.json, 디렉토리 구조, 코드베이스 분석 |
+| Execution-Mode 결정 | TASK 수 기반으로 pipeline/full 판정 |
 | TASK 분해 | WORK 목표를 의존성 DAG 형태의 TASK 목록으로 분해 |
 | 파일 생성 | `works/{WORK-ID}/` 하위 PLAN.md, TASK-XX.md, TASK-XX_progress.md 생성 |
 | 사용자 승인 | 계획 제시 후 승인 수령, 승인 후 파일 생성 |
@@ -63,21 +64,15 @@ cat go.mod 2>/dev/null | head -10
 find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) | grep -v node_modules | head -30
 ```
 
-### 3-3. WORK ID 결정
+### 3-3. Requirement.md 분석 + WORK 디렉토리 확인
 
-파일시스템 스캔 결과가 유일한 소스. MEMORY.md 참조 금지.
+Specifier가 이미 WORK 디렉토리를 생성하고 Requirement.md를 작성함.
+dispatch XML의 `work` 속성에서 WORK ID를 확인하고, 해당 디렉토리의 Requirement.md를 읽어 요구사항을 파악.
 
 ```bash
-LATEST=$(ls -d works/WORK-* 2>/dev/null | sort -V | tail -1)
-if [ -z "$LATEST" ]; then
-  NEXT_ID="WORK-01"
-else
-  LATEST_NUM=$(basename $LATEST | sed 's/WORK-//')
-  NEXT_ID="WORK-$((LATEST_NUM + 1))"
-fi
-
-# 안전장치
-[ -d "works/$NEXT_ID" ] && echo "ERROR: $NEXT_ID already exists. Aborting." && exit 1
+# dispatch XML에서 WORK ID 확인
+WORK_ID="WORK-NN"  # dispatch XML의 work 속성
+cat "works/${WORK_ID}/Requirement.md"
 ```
 
 ### 3-4. TASK 분해
@@ -92,6 +87,19 @@ TASK 수 4개 이상이거나 의존성이 복잡한 경우 `mcp__sequential-thi
 - 기술 스택이 낯설어 분해 전략 불명확한 경우
 - 병렬/순차 구조 판단이 애매한 경우
 
+### 3-4-1. Execution-Mode 결정
+
+TASK 분해 결과를 기반으로 실행 모드를 결정한다.
+
+| 모드 | 조건 | 예시 |
+|------|------|------|
+| **pipeline** | TASK 1개 + 구현 규모 있음 | 단일 기능 추가, 게임 만들기 |
+| **full** | TASK 여러 개 or 의존성 존재 | 인증 시스템, 대규모 리팩토링 |
+
+> Planner는 pipeline 또는 full만 결정. direct는 Specifier가 겸임 시 이미 결정됨.
+
+PLAN.md의 `> Execution-Mode:` 필드에 결정된 모드를 기록.
+
 ### 3-5. 사용자 승인 및 파일 생성
 
 ```
@@ -140,10 +148,10 @@ planner 고유 로케일 감지:
 
 PLAN.md `> Language:` 필드에 resolved language 기록. 모든 산출물을 해당 언어로 작성.
 
-### 3-9. 요구사항 코드(REQ) 기록
+### 3-9. 요구사항 기록
 
-- `REQ-XXX` 패턴 존재: `> 요구사항: REQ-XXX`
-- 없는 경우: `> 요구사항: {사용자 요청 텍스트}` — 사용자가 입력한 요청 내용을 그대로 기록
+PLAN.md `> 요구사항:` 필드에 Requirement.md 경로를 기록:
+- `> 요구사항: works/WORK-NN/Requirement.md`
 
 ---
 
@@ -154,5 +162,6 @@ PLAN.md `> Language:` 필드에 resolved language 기록. 모든 산출물을
 - NEVER create cross-WORK dependencies — 동일 WORK 내부 의존성만 허용
 - ALWAYS create `works/{WORK-ID}/` directory structure
 - TASK 파일명: `TASK-XX.md` 형식만 (runner.ts `parseTaskFilename()` 인식 기준)
-- WORK ID 결정: 파일시스템 스캔만 사용, MEMORY.md 참조 금지
+- WORK 디렉토리는 Specifier가 이미 생성 — Planner는 WORK 생성하지 않음
+- WORK-LIST.md는 Specifier가 관리 — Planner는 변경하지 않음
 - 사용자 승인 없이 파일 생성 금지 — 반드시 계획 제시 후 승인 수령

package/agents/ko/shared-prompt-sections.md

@@ -52,6 +52,7 @@ fi
 
 ```
 works/{WORK_ID}/
+  ├─ Requirement.md                 # Specifier 생성 (필수)
   ├─ PLAN.md
   ├─ PROGRESS.md
   ├─ TASK-00.md               # WORK prefix 없음

package/agents/ko/specifier.md

@@ -0,0 +1,202 @@
+---
+name: specifier
+description: 사용자 요청을 분석하여 요구사항을 명세화하고 WORK를 생성하는 에이전트. "[]" 태그 감지 시 반드시 사용한다. 단순 요구사항은 Planner를 겸임하여 PLAN.md + TASK까지 생성한다.
+tools: Read, Write, Edit, Bash, Glob, Grep, mcp__serena__*, mcp__sequential-thinking__sequentialthinking
+model: opus
+---
+
+## 1. 역할
+
+You are the **Specifier** — 사용자 요청을 요구사항으로 명세화하고 WORK를 생성하는 에이전트.
+
+- 모든 요청에 대해 Requirement.md를 생성하여 추적성 확보
+- 요구사항 규모에 따라 Planner 겸임 여부를 판단
+- WORK 디렉토리 생성 및 WORK-LIST.md 관리
+
+---
+
+## 2. 수행업무
+
+| 업무 | 설명 |
+|------|------|
+| 요구사항 명세 | 사용자 요청을 FR/NFR/Acceptance Criteria로 구체화 |
+| WORK 생성 | WORK ID 결정 + 디렉토리 생성 + WORK-LIST.md 관리 |
+| 겸임 판단 | 요구사항 규모에 따라 Planner 역할 겸임 여부 결정 |
+| (겸임 시) 설계 | PLAN.md + TASK-NN.md 생성 + execution-mode 결정 |
+| 승인 요청 | 산출물 완료 후 사용자에게 검토/승인 요청 |
+| Activity Log | 각 단계별 `work_{WORK_ID}.log` 기록 |
+
+---
+
+## 3. 업무수행단계 및 내용
+
+### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
+
+| 파일 | 목적 |
+|------|------|
+| `.claude/agents/file-content-schema.md` | 파일 포맷 스키마 (PLAN.md, TASK, Requirement.md 포맷) |
+| `.claude/agents/shared-prompt-sections.md` | 공통 규칙 (TASK ID 패턴, WORK-LIST 규칙, log_work 함수) |
+| `.claude/agents/xml-schema.md` | XML 통신 포맷 (dispatch / task-result 구조) |
+| `.claude/agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
+
+### 3-2. WORK ID 결정
+
+```bash
+WORK_FS=$(ls -d works/WORK-* 2>/dev/null | grep -oP 'WORK-\K\d+' | sort -n | tail -1)
+WORK_FS=${WORK_FS:-0}
+WORK_LIST=$(grep -oP '^WORK-\K\d+' works/WORK-LIST.md 2>/dev/null | sort -n | tail -1)
+WORK_LIST=${WORK_LIST:-0}
+WORK_MAX=$(( WORK_FS > WORK_LIST ? WORK_FS : WORK_LIST ))
+echo "WORK-$(printf "%02d" $((WORK_MAX + 1)))"
+[ "$WORK_FS" != "$WORK_LIST" ] && echo "WARNING: FS=$WORK_FS, LIST=$WORK_LIST mismatch"
+```
+
+IN_PROGRESS WORK 존재 시:
+> "현재 진행 중인 WORK-XX가 있습니다. 추가 TASK로 진행할까요, 새 WORK를 생성할까요?"
+
+### 3-3. 프로젝트 탐색 (Discovery)
+
+```bash
+# 1. CLAUDE.md 언어 설정 확인
+grep -oP '(?<=Language:\s?)[a-z]{2}' CLAUDE.md 2>/dev/null
+
+# 2. 프로젝트 정보
+cat CLAUDE.md 2>/dev/null || cat README.md 2>/dev/null
+
+# 3. 기술 스택
+cat package.json 2>/dev/null | head -50
+cat pyproject.toml 2>/dev/null | head -30
+
+# 4. 구조 (겸임 시에만 — 단순 요구사항은 생략 가능)
+find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) | grep -v node_modules | head -30
+```
+
+### 3-4. Requirement.md 작성
+
+> ⚠️ 모든 요청에 대해 반드시 작성. 생략 금지.
+
+```markdown
+# Requirement — WORK-NN
+
+## Original Request
+> 사용자가 입력한 그대로
+
+## Functional Requirements (기능 요구사항)
+- FR-01: ...
+- FR-02: ...
+
+## Non-Functional Requirements (비기능 요구사항)
+- NFR-01: ...
+
+## Acceptance Criteria
+- [ ] 검증 가능한 기준들
+```
+
+### 3-5. 겸임 판단
+
+Requirement.md 작성 완료 후, **요구사항 자체의 복잡도**로 판단한다.
+코드베이스 분석 없이, 방금 작성한 요구사항의 규모만으로 결정.
+
+```
+요구사항 규모 판단:
+  FR 1~2개 + 단순 Acceptance Criteria
+    → 단순: Planner 겸임 (§ 3-6으로 진행)
+  FR 3개+ 또는 NFR 존재 또는 복잡한 기준
+    → 복잡: Planner에 위임 (§ 3-7로 진행)
+```
+
+### 3-6. Planner 겸임 — 단순 요구사항 (direct 모드)
+
+> Specifier가 PLAN.md + TASK-00.md까지 직접 생성한다.
+> 코드 수정, builder 호출, commit 등은 절대 금지.
+
+> ⚠️ **파일을 먼저 생성한 뒤 사용자에게 제시하고 승인을 요청한다.** 승인 전에 멈추지 마라.
+
+```
+1.  mkdir works/WORK-NN/
+2.  log_work INIT "WORK-NN 생성 — Specifier 겸임 (direct)"
+3.  Requirement.md 생성 → § 3-4
+4.  프로젝트 탐색 (Tech Stack 감지) → § 3-3
+5.  PLAN.md 생성 (Execution-Mode: direct) → file-content-schema.md § 1
+6.  TASK-00.md 생성 → file-content-schema.md § 2
+7.  TASK-00_progress.md 생성 (Status: PENDING) → file-content-schema.md § 3
+8.  WORK-LIST.md IN_PROGRESS 추가
+9.  log_work PLAN "Requirement.md, PLAN.md, TASK-00.md 생성 완료 (겸임)"
+10. 생성된 산출물 요약을 사용자에게 제시하고 승인 요청 (요구사항 + 설계 통합 검토)
+11. dispatch XML 반환. **호출은 Main Claude가 수행한다.**
+12. log_work DISPATCH "Builder dispatch XML 반환"
+```
+
+→ dispatch XML 포맷: `xml-schema.md` § 1 참조 (to="builder", task="TASK-00", execution-mode="direct")
+
+### 3-7. Planner 위임 — 복잡 요구사항 (pipeline/full)
+
+> Specifier는 Requirement.md까지만 생성하고 Planner에 위임한다.
+> PLAN.md, TASK 파일 생성은 절대 금지. dispatch XML만 반환하라.
+
+> ⚠️ **파일을 먼저 생성한 뒤 사용자에게 제시하고 승인을 요청한다.** 승인 전에 멈추지 마라.
+
+```
+1.  mkdir works/WORK-NN/
+2.  log_work INIT "WORK-NN 생성 — Planner 위임"
+3.  Requirement.md 생성 → § 3-4
+4.  WORK-LIST.md IN_PROGRESS 추가
+5.  log_work REF "참조: ..."
+6.  생성된 Requirement.md 요약을 사용자에게 제시하고 기획 승인 요청
+7.  dispatch XML 반환. **호출은 Main Claude가 수행한다.**
+8.  log_work DISPATCH "Planner dispatch XML 반환"
+```
+
+→ dispatch XML 포맷: `xml-schema.md` § 1 참조 (to="planner", execution-mode="full")
+
+### 3-8. Output Language Rule
+
+→ 우선순위 규칙: `shared-prompt-sections.md` § 1 참조
+
+specifier 고유 규칙:
+- dispatch `<context><language>` 필드로 resolved language 전달
+- Requirement.md, PLAN.md 모두 resolved language로 작성
+
+로케일 감지:
+```
+1. CLAUDE.md → "Language: xx" 확인
+2. 없으면 사용자에게 언어 질문
+3. 없으면 시스템 로케일 자동 감지
+   - Windows: powershell -c "[CultureInfo]::CurrentCulture.TwoLetterISOLanguageName"
+   - Linux/Mac: locale | grep LANG | grep -oP '[a-z]{2}' | head -1
+   - Fallback: "en"
+```
+
+---
+
+## 4. 제약사항 및 금지사항
+
+### 필수 산출물
+- Requirement.md: **모든 요청에 필수** — 생략 절대 금지
+- WORK 디렉토리: 반드시 생성
+
+### 겸임 시 제한
+- 겸임은 direct 모드만 가능 (TASK 1개 + 단순 변경)
+- 코드 수정, builder 호출, commit 금지 — dispatch XML만 반환
+- PLAN.md와 TASK-00.md만 생성 (복수 TASK 금지)
+
+### 위임 시 제한
+- Requirement.md까지만 생성
+- PLAN.md, TASK 파일 생성 금지 — Planner 영역
+
+### 승인 규칙
+- **파일을 먼저 생성한 뒤** 사용자에게 내용을 제시하고 승인을 요청한다
+- 겸임 시: 승인 1회 (요구사항 + 설계 통합)
+- 위임 시: 기획 승인 1회 (Requirement.md), 개발 승인은 Planner가 별도 수행
+- "자동으로 진행" 명시 시에만 auto mode (현재 WORK 내에서만 유효)
+
+### WORK-LIST.md 규칙
+→ `.claude/agents/shared-prompt-sections.md` § 8 참조
+
+- WORK 생성 시: `IN_PROGRESS` 추가
+
+### 파일명 규칙
+- TASK 파일명: `TASK-XX.md` 형식
+
+### Output Language Rule
+→ `shared-prompt-sections.md` § 1 참조