uctm 1.1.0 → 1.2.0

package/agents/en/xml-schema.md

@@ -1,109 +1,109 @@
-# Agent Communication XML Schema
-
-XML communication format definition for uc-taskmanager agents.
-
----
-
-## 1. Dispatch Format (Dispatcher → Receiver)
-
-```xml
-<dispatch to="{receiver}" work="{WORK_ID}" task="{TASK_ID}" execution-mode="{direct|pipeline|full}">
-  <context>
-    <project>{project name}</project>
-    <language>{lang_code}</language>
-    <plan-file>works/{WORK_ID}/PLAN.md</plan-file>
-  </context>
-  <task-spec>
-    <file>works/{WORK_ID}/TASK-XX.md</file>
-    <title>{title}</title>
-    <action>{implement|verify|commit|plan|route}</action>
-    <description>{optional}</description>
-  </task-spec>
-  <previous-results>
-    <result task="{TASK_ID}" status="{PASS|FAIL|SKIP}">{summary}</result>
-  </previous-results>
-  <cache-hint sections="{section1},{section2}"/>
-</dispatch>
-```
-
-| Attribute | Value |
-|-----------|-------|
-| `to` | builder, verifier, committer, planner, scheduler, router |
-| `task` | `TASK-NN` — WORK prefix must NOT be included |
-| `execution-mode` | direct / pipeline / full (defaults to full if omitted) |
-
----
-
-## 2. Task Result Format (Receiver → Dispatcher)
-
-```xml
-<task-result work="{WORK_ID}" task="{TASK_ID}" agent="{agent}" status="{PASS|FAIL}">
-  <summary>{1-2 line summary}</summary>
-  <files-changed>
-    <file action="{created|modified|deleted}" path="{path}">{description}</file>
-  </files-changed>
-  <verification>
-    <check name="{type}" status="{PASS|FAIL|N/A}">{output}</check>
-  </verification>
-  <notes>{notes}</notes>
-</task-result>
-```
-
----
-
-## 3. Dispatcher-Receiver Mapping
-
-| Dispatcher | Receiver | execution-mode | Description |
-|------------|----------|:--------------:|-------------|
-| Router | (self) | `direct` | No subagents. Router implements+commits+callbacks directly |
-| Router | Planner | `full` | Complex WORK planning |
-| Router | Scheduler | `full` | Planned WORK execution |
-| Router | Builder | `pipeline` | Single TASK implementation |
-| Router | Verifier | `pipeline` | Single TASK verification |
-| Router | Committer | `pipeline` | Single TASK commit |
-| Scheduler | Builder | `full` | N TASK implementation |
-| Scheduler | Verifier | `full` | N TASK verification |
-| Scheduler | Committer | `full` | N TASK commit |
-
----
-
-## 4. Context-Handoff Element
-
-```xml
-<context-handoff from="{agent}" detail-level="{FULL|SUMMARY|DROP}">
-  <what>{changes/verification details}</what>
-  <why>{decision rationale}</why>       <!-- FULL only -->
-  <caution>{caveats}</caution>          <!-- FULL only -->
-  <incomplete>{incomplete items}</incomplete>  <!-- FULL only -->
-</context-handoff>
-```
-
-| detail-level | Included Fields |
-|:---:|---|
-| `FULL` | what, why, caution, incomplete |
-| `SUMMARY` | what only (1-3 lines) |
-| `DROP` | Element omitted |
-
----
-
-## 5. Agent Behavior by execution-mode
-
-| Agent | direct | pipeline | full |
-|-------|--------|----------|------|
-| Router | implement+self-check+result.md+commit+callback directly | Create PLAN then dispatch B→V→C | Dispatch to Planner |
-| Planner | Not invoked | Not invoked | Create PLAN.md |
-| Scheduler | Not invoked | Not invoked | DAG management + [B→V→C]×N |
-| Builder | Not invoked | Normal execution | Normal execution |
-| Verifier | Not invoked | Normal execution | Normal execution |
-| Committer | Not invoked | result.md+commit+callback | result.md+commit+callback |
-
-Invariants (regardless of mode):
-
-| Item | direct | pipeline/full |
-|------|:---:|:---:|
-| `works/WORK-NN/` directory | Router | Router/Planner |
-| `PLAN.md` | Router | Router/Planner |
-| `TASK-XX.md` | Router | Router/Planner |
-| `TASK-XX_result.md` | Router | Committer |
-| COMMITTER DONE callback | Router | Committer |
-| `WORK-LIST.md` IN_PROGRESS | Router | Router |
+# Agent Communication XML Schema
+
+XML communication format definition for uc-taskmanager agents.
+
+---
+
+## 1. Dispatch Format (Dispatcher → Receiver)
+
+```xml
+<dispatch to="{receiver}" work="{WORK_ID}" task="{TASK_ID}" execution-mode="{direct|pipeline|full}">
+  <context>
+    <project>{project name}</project>
+    <language>{lang_code}</language>
+    <plan-file>works/{WORK_ID}/PLAN.md</plan-file>
+  </context>
+  <task-spec>
+    <file>works/{WORK_ID}/TASK-XX.md</file>
+    <title>{title}</title>
+    <action>{implement|verify|commit|plan|route}</action>
+    <description>{optional}</description>
+  </task-spec>
+  <previous-results>
+    <result task="{TASK_ID}" status="{PASS|FAIL|SKIP}">{summary}</result>
+  </previous-results>
+  <cache-hint sections="{section1},{section2}"/>
+</dispatch>
+```
+
+| Attribute | Value |
+|-----------|-------|
+| `to` | builder, verifier, committer, planner, scheduler, router |
+| `task` | `TASK-NN` — WORK prefix must NOT be included |
+| `execution-mode` | direct / pipeline / full (defaults to full if omitted) |
+
+---
+
+## 2. Task Result Format (Receiver → Dispatcher)
+
+```xml
+<task-result work="{WORK_ID}" task="{TASK_ID}" agent="{agent}" status="{PASS|FAIL}">
+  <summary>{1-2 line summary}</summary>
+  <files-changed>
+    <file action="{created|modified|deleted}" path="{path}">{description}</file>
+  </files-changed>
+  <verification>
+    <check name="{type}" status="{PASS|FAIL|N/A}">{output}</check>
+  </verification>
+  <notes>{notes}</notes>
+</task-result>
+```
+
+---
+
+## 3. Dispatcher-Receiver Mapping
+
+| Dispatcher | Receiver | execution-mode | Description |
+|------------|----------|:--------------:|-------------|
+| Router | (self) | `direct` | No subagents. Router implements+commits+callbacks directly |
+| Router | Planner | `full` | Complex WORK planning |
+| Router | Scheduler | `full` | Planned WORK execution |
+| Router | Builder | `pipeline` | Single TASK implementation |
+| Router | Verifier | `pipeline` | Single TASK verification |
+| Router | Committer | `pipeline` | Single TASK commit |
+| Scheduler | Builder | `full` | N TASK implementation |
+| Scheduler | Verifier | `full` | N TASK verification |
+| Scheduler | Committer | `full` | N TASK commit |
+
+---
+
+## 4. Context-Handoff Element
+
+```xml
+<context-handoff from="{agent}" detail-level="{FULL|SUMMARY|DROP}">
+  <what>{changes/verification details}</what>
+  <why>{decision rationale}</why>       <!-- FULL only -->
+  <caution>{caveats}</caution>          <!-- FULL only -->
+  <incomplete>{incomplete items}</incomplete>  <!-- FULL only -->
+</context-handoff>
+```
+
+| detail-level | Included Fields |
+|:---:|---|
+| `FULL` | what, why, caution, incomplete |
+| `SUMMARY` | what only (1-3 lines) |
+| `DROP` | Element omitted |
+
+---
+
+## 5. Agent Behavior by execution-mode
+
+| Agent | direct | pipeline | full |
+|-------|--------|----------|------|
+| Router | implement+self-check+result.md+commit+callback directly | Create PLAN then dispatch B→V→C | Dispatch to Planner |
+| Planner | Not invoked | Not invoked | Create PLAN.md |
+| Scheduler | Not invoked | Not invoked | DAG management + [B→V→C]×N |
+| Builder | Not invoked | Normal execution | Normal execution |
+| Verifier | Not invoked | Normal execution | Normal execution |
+| Committer | Not invoked | result.md+commit+callback | result.md+commit+callback |
+
+Invariants (regardless of mode):
+
+| Item | direct | pipeline/full |
+|------|:---:|:---:|
+| `works/WORK-NN/` directory | Router | Router/Planner |
+| `PLAN.md` | Router | Router/Planner |
+| `TASK-XX.md` | Router | Router/Planner |
+| `TASK-XX_result.md` | Router | Committer |
+| COMMITTER DONE callback | Router | Committer |
+| `WORK-LIST.md` IN_PROGRESS | Router | Router |

package/agents/ko/agent-flow.md

@@ -1,106 +1,106 @@
-# 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가 반환값을 받아 다음 에이전트를 호출한다.
+
+---
+
+## 실행 모드 결정
+
+```
+[] 태그 감지 → 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 | 전달 안 함 |

package/agents/ko/builder.md

@@ -35,11 +35,11 @@ You are the **Builder** — TASK 명세를 받아 실제 코드를 구현하고
 
 | 파일 | 목적 |
 |------|------|
-| `agents/file-content-schema.md` | 파일 포맷 스키마 |
-| `agents/shared-prompt-sections.md` | 공통 규칙 (TASK ID, PLAN.md 7개 필드, WORK-LIST) |
-| `agents/xml-schema.md` | XML 통신 포맷 |
-| `agents/context-policy.md` | 슬라이딩 윈도우 규칙 |
-| `agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
+| `.claude/agents/file-content-schema.md` | 파일 포맷 스키마 |
+| `.claude/agents/shared-prompt-sections.md` | 공통 규칙 (TASK ID, PLAN.md 7개 필드, WORK-LIST) |
+| `.claude/agents/xml-schema.md` | XML 통신 포맷 |
+| `.claude/agents/context-policy.md` | 슬라이딩 윈도우 규칙 |
+| `.claude/agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
 
 ### 3-2. XML Input 파싱
 

package/agents/ko/committer.md

@@ -35,11 +35,11 @@ You are the **Committer** — 검증 완료된 TASK의 result report를 생성
 
 | 파일 | 목적 |
 |------|------|
-| `agents/file-content-schema.md` | 파일 포맷 스키마 |
-| `agents/shared-prompt-sections.md` | 공통 규칙 |
-| `agents/xml-schema.md` | XML 통신 포맷 |
-| `agents/context-policy.md` | 슬라이딩 윈도우 규칙 |
-| `agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
+| `.claude/agents/file-content-schema.md` | 파일 포맷 스키마 |
+| `.claude/agents/shared-prompt-sections.md` | 공통 규칙 |
+| `.claude/agents/xml-schema.md` | XML 통신 포맷 |
+| `.claude/agents/context-policy.md` | 슬라이딩 윈도우 규칙 |
+| `.claude/agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
 
 ### 3-2. XML Input 파싱
 
@@ -66,7 +66,7 @@ Gate 실패 시:
 
 ### 3-4. Result Report 생성
 
-→ `agents/file-content-schema.md` § 4 참조 (포맷 + 언어별 섹션 헤더)
+→ `.claude/agents/file-content-schema.md` § 4 참조 (포맷 + 언어별 섹션 헤더)
 
 `works/{WORK_ID}/TASK-XX_result.md` 생성.
 - builder context-handoff `what` → "Builder Context" 섹션
@@ -155,8 +155,24 @@ committer 고유 추가 필드:
 </next-tasks>
 ```
 
-WORK-LIST.md를 COMPLETED로 변경하지 않는다 — git push 시에만 변경.
-→ `agents/shared-prompt-sections.md` § 8 참조
+### 3-9-1. WORK-LIST.md 자동 완료 처리
+
+마지막 TASK인지 확인 후, 마지막 TASK이면 WORK-LIST.md를 `IN_PROGRESS` → `COMPLETED`로 변경한다.
+
+```bash
+# 마지막 TASK 확인
+TOTAL=$(ls works/${WORK_ID}/TASK-*.md 2>/dev/null | grep -cv '_result\|_progress')
+DONE=$(ls works/${WORK_ID}/TASK-*_result.md 2>/dev/null | wc -l)
+
+if [ "$DONE" -ge "$TOTAL" ]; then
+  # WORK-LIST.md에서 해당 WORK의 IN_PROGRESS → COMPLETED 변경
+  sed -i "s/| ${WORK_ID} |\\(.*\\)| IN_PROGRESS |\\(.*\\)|\\(.*\\)|/| ${WORK_ID} |\\1| COMPLETED |\\2| $(date '+%Y-%m-%d') |/" works/WORK-LIST.md
+  git add works/WORK-LIST.md
+  git commit --amend --no-edit
+fi
+```
+
+→ `.claude/agents/shared-prompt-sections.md` § 8 참조
 
 ---
 
@@ -173,7 +189,7 @@ WORK-LIST.md를 COMPLETED로 변경하지 않는다 — git push 시에만 변
 - Files changed 없으면 즉시 FAIL 반환
 
 ### WORK-LIST.md 규칙
-- COMPLETED 변경 금지 — git push 시에만 변경
+- 마지막 TASK 완료 시 WORK-LIST.md를 `IN_PROGRESS` → `COMPLETED`로 자동 변경
 
 ### Output Language Rule
 → `shared-prompt-sections.md` § 1 참조

package/agents/ko/context-policy.md

@@ -56,7 +56,7 @@
 2. Gate 통과 → result.md 작성 + git commit
 3. Gate 실패 → FAIL 반환 (scheduler 재시도 트리거)
 
-출력: → `agents/file-content-schema.md` § 4 참조
+출력: → `.claude/agents/file-content-schema.md` § 4 참조
 
 ## TASK 간 의존성 전달
 

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

@@ -23,7 +23,7 @@
 # WORK-01: {제목}
 
 > Created: {YYYY-MM-DD}
-> 요구사항: {REQ-XXX | N/A}
+> 요구사항: {REQ-XXX | 사용자 요청 텍스트}
 > Execution-Mode: {direct | pipeline | full}
 > Project: {project name}
 > Tech Stack: {stack}

package/agents/ko/planner.md

@@ -37,9 +37,9 @@ WORK (일)          — 사용자 요청의 목표 단위
 
 | 파일 | 목적 |
 |------|------|
-| `agents/file-content-schema.md` | 파일 포맷 스키마 (PLAN.md 7개 필드, TASK 포맷) |
-| `agents/shared-prompt-sections.md` | 공통 규칙 (TASK ID, WORK-LIST 규칙) |
-| `agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
+| `.claude/agents/file-content-schema.md` | 파일 포맷 스키마 (PLAN.md 7개 필드, TASK 포맷) |
+| `.claude/agents/shared-prompt-sections.md` | 공통 규칙 (TASK ID, WORK-LIST 규칙) |
+| `.claude/agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
 
 ### 3-2. 프로젝트 탐색 (Discovery Process)
 
@@ -103,7 +103,7 @@ TASK 수 4개 이상이거나 의존성이 복잡한 경우 `mcp__sequential-thi
 
 ### 3-6. 산출물 구조
 
-→ `agents/file-content-schema.md` § 7 참조
+→ `.claude/agents/file-content-schema.md` § 7 참조
 
 생성 책임:
 - `PLAN.md`, `TASK-XX.md`, `TASK-XX_progress.md` (초기 템플릿) → Planner
@@ -113,7 +113,7 @@ TASK 수 4개 이상이거나 의존성이 복잡한 경우 `mcp__sequential-thi
 
 TASK 파일 생성 시 반드시 동일 디렉토리에 `TASK-XX_progress.md` 템플릿도 함께 생성.
 
-파일 포맷: → `agents/file-content-schema.md` § 1 (PLAN.md), § 2 (TASK), § 3 (progress 초기값)
+파일 포맷: → `.claude/agents/file-content-schema.md` § 1 (PLAN.md), § 2 (TASK), § 3 (progress 초기값)
 
 ### 3-7. MCP Tool 활용 (Serena)
 
@@ -143,7 +143,7 @@ PLAN.md `> Language:` 필드에 resolved language 기록. 모든 산출물을
 ### 3-9. 요구사항 코드(REQ) 기록
 
 - `REQ-XXX` 패턴 존재: `> 요구사항: REQ-XXX`
-- 없는 경우: `> 요구사항: N/A`
+- 없는 경우: `> 요구사항: {사용자 요청 텍스트}` — 사용자가 입력한 요청 내용을 그대로 기록
 
 ---
 

package/agents/ko/router.md

@@ -34,10 +34,10 @@ You are the **Router** — 사용자 요청을 분석하여 실행 전략을 결
 
 | 파일 | 목적 |
 |------|------|
-| `agents/file-content-schema.md` | 파일 포맷 스키마 (PLAN.md 7개 필드, TASK 포맷, result.md 포맷) |
-| `agents/shared-prompt-sections.md` | 공통 규칙 (TASK ID 패턴, WORK-LIST 규칙, log_work 함수) |
-| `agents/xml-schema.md` | XML 통신 포맷 (dispatch / task-result 구조) |
-| `agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블, 참조 자료 수집) |
+| `.claude/agents/file-content-schema.md` | 파일 포맷 스키마 (PLAN.md 7개 필드, TASK 포맷, result.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. Execution-Mode 결정
 
@@ -104,7 +104,19 @@ Router가 단독 수행. 코드 탐색 시 Serena MCP 우선 사용:
 ```
 ### 3-5. pipeline 모드 일때 실행
 
-**builder 디스패치** subagent 실행 후 메시지 디스패치
+> ⚠️ pipeline 모드에서 Router는 PLAN.md + TASK-NN.md 생성까지만 수행한다.
+> 코드 수정, builder 호출, commit 등은 절대 금지. dispatch XML만 반환하라.
+
+```
+1.  WORK ID 결정
+2.  mkdir works/WORK-NN/
+3.  log_work INIT "WORK-NN 생성 — Execution-Mode: pipeline"
+4.  PLAN.md 생성 (Execution-Mode: pipeline) → file-content-schema.md § 1
+5.  TASK-NN.md 생성 (필요 시 복수) → file-content-schema.md § 2
+6.  WORK-LIST.md IN_PROGRESS 추가
+7.  아래 dispatch XML을 생성하여 반환한다. **호출은 Main Claude가 수행한다.**
+8.  log_work DISPATCH "Builder dispatch XML 반환"
+```
 
 → dispatch XML 포맷: `xml-schema.md` § 1 참조 (to="builder", task="TASK-00", execution-mode="pipeline")
 
@@ -137,10 +149,10 @@ Router가 단독 수행. 코드 탐색 시 Serena MCP 우선 사용:
 - "자동으로 진행" 명시 시에만 auto mode (현재 WORK 내에서만 유효)
 
 ### WORK-LIST.md 규칙
-→ `agents/shared-prompt-sections.md` § 8 참조
+→ `.claude/agents/shared-prompt-sections.md` § 8 참조
 
 - WORK 생성 시: `IN_PROGRESS` 추가
-- COMPLETED 변경: **git push 시에만** — Router가 직접 변경 금지
+- COMPLETED 변경: 마지막 TASK 완료 시 committer가 자동 변경
 
 ### 파일명 규칙
 - TASK 파일명: `TASK-XX.md` 형식

package/agents/ko/scheduler.md

@@ -38,11 +38,11 @@ You are the **Scheduler** — WORK 파이프라인 실행 에이전트.
 
 | 파일 | 목적 |
 |------|------|
-| `agents/file-content-schema.md` | 파일 포맷 스키마 |
-| `agents/shared-prompt-sections.md` | 공통 규칙 |
-| `agents/xml-schema.md` | XML 통신 포맷 |
-| `agents/context-policy.md` | 슬라이딩 윈도우 규칙 |
-| `agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
+| `.claude/agents/file-content-schema.md` | 파일 포맷 스키마 |
+| `.claude/agents/shared-prompt-sections.md` | 공통 규칙 |
+| `.claude/agents/xml-schema.md` | XML 통신 포맷 |
+| `.claude/agents/context-policy.md` | 슬라이딩 윈도우 규칙 |
+| `.claude/agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
 
 ### 3-2. WORK 식별 및 초기 로드
 
@@ -132,7 +132,7 @@ Committer FAIL 재시도:
 
 ### 3-9. 진행 보고
 
-TASK 완료 후 PROGRESS.md 업데이트 (→ `agents/file-content-schema.md` § 6 참조) 및 상태 출력:
+TASK 완료 후 PROGRESS.md 업데이트 (→ `.claude/agents/file-content-schema.md` § 6 참조) 및 상태 출력:
 
 ```
 ✅ TASK-XX 완료 — commit: {hash}
@@ -164,7 +164,7 @@ Multi-WORK 현황 확인:
 
 ### WORK-LIST.md 규칙
 - WORK-LIST.md를 COMPLETED로 변경하지 않는다 — git push 시에만 변경
-- → `agents/shared-prompt-sections.md` § 8 참조
+- → `.claude/agents/shared-prompt-sections.md` § 8 참조
 
 ### Output Language Rule
 → `shared-prompt-sections.md` § 1 참조