uctm 1.1.1 → 1.2.0

package/agents/en/committer.md

@@ -155,7 +155,23 @@ Committer-specific additional fields:
 </next-tasks>
 ```
 
-Do not change WORK-LIST.md to COMPLETED — changed only at git push time.
+### 3-9-1. WORK-LIST.md Auto-Completion
+
+Check if this is the last TASK. If so, change WORK-LIST.md from `IN_PROGRESS` to `COMPLETED`.
+
+```bash
+# Check if last 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
+  # Change IN_PROGRESS → COMPLETED in WORK-LIST.md
+  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
+```
+
 → see `.claude/agents/shared-prompt-sections.md` § 8
 
 ---
@@ -173,7 +189,7 @@ Do not change WORK-LIST.md to COMPLETED — changed only at git push time.
 - If Files changed is empty → immediately return FAIL
 
 ### WORK-LIST.md Rules
-- Changing to COMPLETED is prohibited — changed only at git push time
+- Automatically change WORK-LIST.md from `IN_PROGRESS` to `COMPLETED` when the last TASK is completed
 
 ### Output Language Rule
 → see `shared-prompt-sections.md` § 1

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

@@ -1,224 +1,224 @@
-# File Content Schema
-
-Single source of truth for pipeline artifact file formats.
-
-## COMPLIANCE
-
-| Generated File | Reference Section | Violation Consequence |
-|----------------|-------------------|----------------------|
-| `PLAN.md` | § 1 | `parsePlanMd()` parsing failure, scheduler inoperable |
-| `TASK-XX.md` | § 2 | `parseTaskFilename()` DB registration missed |
-| `TASK-XX_progress.md` | § 3 | committer gate FAIL |
-| `TASK-XX_result.md` | § 4 | context-handoff missing |
-| `TASK-XX_result.md` (direct) | § 5 | result.md recognition failure |
-| `PROGRESS.md` | § 6 | scheduler progress tracking inoperable |
-
----
-
-## § 1. PLAN.md
-
-Path: `works/{WORK_ID}/PLAN.md`
-
-```markdown
-# WORK-01: {title}
-
-> Created: {YYYY-MM-DD}
-> Requirement: {REQ-XXX | N/A}
-> Execution-Mode: {direct | pipeline | full}
-> Project: {project name}
-> Tech Stack: {stack}
-> Language: {lang_code}
-> Status: PLANNED
-
-## Goal
-{1-2 sentences}
-
-## Task Dependency Graph
-{ASCII diagram}
-
-## Tasks
-
-### TASK-00: {title}
-- **Depends on**: (none)
-- **Scope**: {description}
-- **Files**:
-  - `path/to/file` — {description}
-
-### TASK-01: {title}
-- **Depends on**: TASK-00
-```
-
-Title format: `# WORK-NN: title` — `# PLAN WORK-NN:` is prohibited (`parsePlanMd()` error)
-
----
-
-## § 2. TASK-XX.md
-
-Path: `works/{WORK_ID}/TASK-XX.md`
-
-> `parseTaskFilename()` regex: `/^TASK-(\d+)\.md$/` — WORK prefix prohibited
-
-```markdown
-# TASK-XX: {title}
-
-## WORK
-{WORK_ID}: {WORK title}
-
-## Dependencies
-- TASK-YY (required)
-
-## Scope
-{description}
-
-## Files
-| Path | Action | Description |
-|------|--------|-------------|
-| `src/file.ts` | CREATE | description |
-
-## Acceptance Criteria
-- [ ] {criterion}
-
-## Verify
-```bash
-{verification commands}
-```
-```
-
----
-
-## § 3. TASK-XX_progress.md
-
-Path: `works/{WORK_ID}/TASK-XX_progress.md`
-
-```markdown
-# TASK-XX Progress
-
-- Status: {PENDING | STARTED | IN_PROGRESS | COMPLETED}
-- Started: {ISO 8601}
-- Updated: {ISO 8601}
-- Files changed:
-  - `path/to/file` — {CREATE | MODIFY | DELETE}
-```
-
-| Timing | Status |
-|--------|--------|
-| planner template | `PENDING` |
-| builder starts | `STARTED` |
-| file changes in progress | `IN_PROGRESS` |
-| completed | `COMPLETED` |
-
-committer gate: file exists + `Status: COMPLETED` + Files changed is not empty
-
----
-
-## § 4. TASK-XX_result.md (full / pipeline)
-
-Path: `works/{WORK_ID}/TASK-XX_result.md`
-
-```markdown
-# TASK-XX Result
-
-> WORK: {WORK_ID} — {title}
-> Completed: {YYYY-MM-DD HH:MM}
-> Status: **DONE**
-
-{## Summary | ## 요약 | ## サマリー}
-{1-2 lines}
-
-{## Completed Checklist | ## 완료 체크리스트 | ## 完了チェックリスト}
-- [x] {item}
-
-{## Verification Results | ## 검증 결과 | ## 検証結果}
-- Build: ✅
-- Lint: ✅
-- Tests: ✅ (N passed)
-
-{## Files Changed | ## 변경 파일 | ## 変更ファイル}
-### Created
-- `path` — {description}
-
-{## Issues Encountered | ## 발생 이슈 | ## 発生した問題}
-None
-
-{## Notes for Subsequent Tasks | ## 후속 TASK 참고사항 | ## 後続タスクへの注記}
-None
-
-{## Context Handoff | ## 컨텍스트 핸드오프 | ## コンテキスト引き継ぎ}
-
-### Builder Context (SUMMARY)
-{builder what field 1-3 lines}
-
-### Verifier Context (FULL)
-{verifier context-handoff 4 fields}
-```
-
-| Section | en | ko | ja |
-|---------|----|----|-----|
-| Summary | `## Summary` | `## 요약` | `## サマリー` |
-| Completed Checklist | `## Completed Checklist` | `## 완료 체크리스트` | `## 完了チェックリスト` |
-| Verification Results | `## Verification Results` | `## 검증 결과` | `## 検証結果` |
-| Files Changed | `## Files Changed` | `## 변경 파일` | `## 変更ファイル` |
-| Issues Encountered | `## Issues Encountered` | `## 발생 이슈` | `## 発生した問題` |
-| Notes for Subsequent Tasks | `## Notes for Subsequent Tasks` | `## 후속 TASK 참고사항` | `## 後続タスクへの注記` |
-| Context Handoff | `## Context Handoff` | `## 컨텍스트 핸드오프` | `## コンテキスト引き継ぎ` |
-
----
-
-## § 5. TASK-XX_result.md (direct mode)
-
-```markdown
-# TASK-00 Result
-
-> WORK: WORK-NN — {title}
-> Completed: {YYYY-MM-DD HH:MM}
-> Execution-Mode: direct
-> Status: **DONE**
-> Commit: {hash}
-
-## Summary
-{1 line}
-
-## Files Changed
-- `{path}` — {description}
-
-## Verification
-- Build: PASS (self-check)
-- Lint: PASS (self-check)
-```
-
----
-
-## § 6. PROGRESS.md
-
-Path: `works/{WORK_ID}/PROGRESS.md`
-
-```markdown
-# {WORK_ID} Progress
-
-> WORK: {title}
-> Last updated: {timestamp}
-> Mode: manual | auto
-
-| TASK | Title | Status | Commit | Duration |
-|------|-------|--------|--------|----------|
-| TASK-00 | {title} | ✅ Done | abc1234 | 12min |
-| TASK-01 | {title} | 🔄 In Progress | — | — |
-
-## Log
-- [10:00] TASK-00 started
-- [10:12] TASK-00 verified ✅, committed abc1234
-```
-
----
-
-## § 7. File Naming Rules
-
-| Type | Format | Created By |
-|------|--------|------------|
-| WORK plan | `PLAN.md` | planner / router |
-| TASK plan | `TASK-NN.md` | planner / router |
-| TASK progress | `TASK-NN_progress.md` | planner (template) / builder (update) |
-| TASK result | `TASK-NN_result.md` | committer / router (direct) |
-| WORK progress | `PROGRESS.md` | scheduler |
-
-`WORK-NN-TASK-NN.md` format prohibited → `parseTaskFilename()` cannot recognize it.
+# File Content Schema
+
+Single source of truth for pipeline artifact file formats.
+
+## COMPLIANCE
+
+| Generated File | Reference Section | Violation Consequence |
+|----------------|-------------------|----------------------|
+| `PLAN.md` | § 1 | `parsePlanMd()` parsing failure, scheduler inoperable |
+| `TASK-XX.md` | § 2 | `parseTaskFilename()` DB registration missed |
+| `TASK-XX_progress.md` | § 3 | committer gate FAIL |
+| `TASK-XX_result.md` | § 4 | context-handoff missing |
+| `TASK-XX_result.md` (direct) | § 5 | result.md recognition failure |
+| `PROGRESS.md` | § 6 | scheduler progress tracking inoperable |
+
+---
+
+## § 1. PLAN.md
+
+Path: `works/{WORK_ID}/PLAN.md`
+
+```markdown
+# WORK-01: {title}
+
+> Created: {YYYY-MM-DD}
+> Requirement: {REQ-XXX | user request text}
+> Execution-Mode: {direct | pipeline | full}
+> Project: {project name}
+> Tech Stack: {stack}
+> Language: {lang_code}
+> Status: PLANNED
+
+## Goal
+{1-2 sentences}
+
+## Task Dependency Graph
+{ASCII diagram}
+
+## Tasks
+
+### TASK-00: {title}
+- **Depends on**: (none)
+- **Scope**: {description}
+- **Files**:
+  - `path/to/file` — {description}
+
+### TASK-01: {title}
+- **Depends on**: TASK-00
+```
+
+Title format: `# WORK-NN: title` — `# PLAN WORK-NN:` is prohibited (`parsePlanMd()` error)
+
+---
+
+## § 2. TASK-XX.md
+
+Path: `works/{WORK_ID}/TASK-XX.md`
+
+> `parseTaskFilename()` regex: `/^TASK-(\d+)\.md$/` — WORK prefix prohibited
+
+```markdown
+# TASK-XX: {title}
+
+## WORK
+{WORK_ID}: {WORK title}
+
+## Dependencies
+- TASK-YY (required)
+
+## Scope
+{description}
+
+## Files
+| Path | Action | Description |
+|------|--------|-------------|
+| `src/file.ts` | CREATE | description |
+
+## Acceptance Criteria
+- [ ] {criterion}
+
+## Verify
+```bash
+{verification commands}
+```
+```
+
+---
+
+## § 3. TASK-XX_progress.md
+
+Path: `works/{WORK_ID}/TASK-XX_progress.md`
+
+```markdown
+# TASK-XX Progress
+
+- Status: {PENDING | STARTED | IN_PROGRESS | COMPLETED}
+- Started: {ISO 8601}
+- Updated: {ISO 8601}
+- Files changed:
+  - `path/to/file` — {CREATE | MODIFY | DELETE}
+```
+
+| Timing | Status |
+|--------|--------|
+| planner template | `PENDING` |
+| builder starts | `STARTED` |
+| file changes in progress | `IN_PROGRESS` |
+| completed | `COMPLETED` |
+
+committer gate: file exists + `Status: COMPLETED` + Files changed is not empty
+
+---
+
+## § 4. TASK-XX_result.md (full / pipeline)
+
+Path: `works/{WORK_ID}/TASK-XX_result.md`
+
+```markdown
+# TASK-XX Result
+
+> WORK: {WORK_ID} — {title}
+> Completed: {YYYY-MM-DD HH:MM}
+> Status: **DONE**
+
+{## Summary | ## 요약 | ## サマリー}
+{1-2 lines}
+
+{## Completed Checklist | ## 완료 체크리스트 | ## 完了チェックリスト}
+- [x] {item}
+
+{## Verification Results | ## 검증 결과 | ## 検証結果}
+- Build: ✅
+- Lint: ✅
+- Tests: ✅ (N passed)
+
+{## Files Changed | ## 변경 파일 | ## 変更ファイル}
+### Created
+- `path` — {description}
+
+{## Issues Encountered | ## 발생 이슈 | ## 発生した問題}
+None
+
+{## Notes for Subsequent Tasks | ## 후속 TASK 참고사항 | ## 後続タスクへの注記}
+None
+
+{## Context Handoff | ## 컨텍스트 핸드오프 | ## コンテキスト引き継ぎ}
+
+### Builder Context (SUMMARY)
+{builder what field 1-3 lines}
+
+### Verifier Context (FULL)
+{verifier context-handoff 4 fields}
+```
+
+| Section | en | ko | ja |
+|---------|----|----|-----|
+| Summary | `## Summary` | `## 요약` | `## サマリー` |
+| Completed Checklist | `## Completed Checklist` | `## 완료 체크리스트` | `## 完了チェックリスト` |
+| Verification Results | `## Verification Results` | `## 검증 결과` | `## 検証結果` |
+| Files Changed | `## Files Changed` | `## 변경 파일` | `## 変更ファイル` |
+| Issues Encountered | `## Issues Encountered` | `## 발생 이슈` | `## 発生した問題` |
+| Notes for Subsequent Tasks | `## Notes for Subsequent Tasks` | `## 후속 TASK 참고사항` | `## 後続タスクへの注記` |
+| Context Handoff | `## Context Handoff` | `## 컨텍스트 핸드오프` | `## コンテキスト引き継ぎ` |
+
+---
+
+## § 5. TASK-XX_result.md (direct mode)
+
+```markdown
+# TASK-00 Result
+
+> WORK: WORK-NN — {title}
+> Completed: {YYYY-MM-DD HH:MM}
+> Execution-Mode: direct
+> Status: **DONE**
+> Commit: {hash}
+
+## Summary
+{1 line}
+
+## Files Changed
+- `{path}` — {description}
+
+## Verification
+- Build: PASS (self-check)
+- Lint: PASS (self-check)
+```
+
+---
+
+## § 6. PROGRESS.md
+
+Path: `works/{WORK_ID}/PROGRESS.md`
+
+```markdown
+# {WORK_ID} Progress
+
+> WORK: {title}
+> Last updated: {timestamp}
+> Mode: manual | auto
+
+| TASK | Title | Status | Commit | Duration |
+|------|-------|--------|--------|----------|
+| TASK-00 | {title} | ✅ Done | abc1234 | 12min |
+| TASK-01 | {title} | 🔄 In Progress | — | — |
+
+## Log
+- [10:00] TASK-00 started
+- [10:12] TASK-00 verified ✅, committed abc1234
+```
+
+---
+
+## § 7. File Naming Rules
+
+| Type | Format | Created By |
+|------|--------|------------|
+| WORK plan | `PLAN.md` | planner / router |
+| TASK plan | `TASK-NN.md` | planner / router |
+| TASK progress | `TASK-NN_progress.md` | planner (template) / builder (update) |
+| TASK result | `TASK-NN_result.md` | committer / router (direct) |
+| WORK progress | `PROGRESS.md` | scheduler |
+
+`WORK-NN-TASK-NN.md` format prohibited → `parseTaskFilename()` cannot recognize it.

package/agents/en/planner.md

@@ -143,7 +143,7 @@ Record resolved language in PLAN.md `> Language:` field. Write all outputs in th
 ### 3-9. Requirement Code (REQ) Recording
 
 - `REQ-XXX` pattern exists: `> Requirement: REQ-XXX`
-- If absent: `> Requirement: N/A`
+- If absent: `> Requirement: {user request text}` — record the user's request text as-is
 
 ---
 

package/agents/en/router.md

@@ -103,9 +103,21 @@ Router handles everything on its own. Use Serena MCP first for code exploration:
 16. Add WORK-LIST.md IN_PROGRESS
 ```
 
-### 3-5. pipeline Mode Execution
+### 3-5. Pipeline Mode Execution
 
-**builder dispatch** Execute subagent then dispatch message
+> ⚠️ In pipeline mode, Router only creates PLAN.md + TASK-NN.md.
+> Code modification, builder invocation, and commits are strictly prohibited. Only return dispatch XML.
+
+```
+1.  Determine WORK ID
+2.  mkdir works/WORK-NN/
+3.  log_work INIT "WORK-NN created — Execution-Mode: pipeline"
+4.  Create PLAN.md (Execution-Mode: pipeline) → file-content-schema.md § 1
+5.  Create TASK-NN.md (multiple if needed) → file-content-schema.md § 2
+6.  Add IN_PROGRESS to WORK-LIST.md
+7.  Generate and return dispatch XML below. **Invocation is performed by Main Claude.**
+8.  log_work DISPATCH "Builder dispatch XML returned"
+```
 
 → dispatch XML format: see `xml-schema.md` § 1 (to="builder", task="TASK-00", execution-mode="pipeline")
 
@@ -141,7 +153,7 @@ Router handles everything on its own. Use Serena MCP first for code exploration:
 → see `.claude/agents/shared-prompt-sections.md` § 8
 
 - On WORK creation: add `IN_PROGRESS`
-- COMPLETED change: **only at git push time** — Router must not change directly
+- COMPLETED change: automatically changed by committer when last TASK is completed
 
 ### File Naming Rules
 - TASK filenames: `TASK-XX.md` format

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

@@ -111,7 +111,7 @@ echo "$DONE / $TOTAL"
 | Field | Required | Description |
 |-------|----------|-------------|
 | `> Created:` | ✅ | YYYY-MM-DD |
-| `> Requirement:` | ✅ | `REQ-XXX` or `N/A` |
+| `> Requirement:` | ✅ | `REQ-XXX` or user request text |
 | `> Execution-Mode:` | ✅ | `direct` / `pipeline` / `full` |
 | `> Project:` | ✅ | Project name |
 | `> Tech Stack:` | ✅ | Detected tech stack |
@@ -127,11 +127,10 @@ File: `works/WORK-LIST.md`
 | Status | Timing |
 |--------|--------|
 | `IN_PROGRESS` | Added when WORK directory is created |
-| `COMPLETED` | Changed only at git push time |
+| `COMPLETED` | Automatically changed by committer when last TASK is completed |
 
-- committer / scheduler → changing to COMPLETED is prohibited
 - Must add IN_PROGRESS when WORK directory is created
-- Do not leave as IN_PROGRESS after push
+- committer: after committing the last TASK, change WORK-LIST.md from `IN_PROGRESS` to `COMPLETED`
 
 ---
 

package/agents/ko/committer.md

@@ -155,7 +155,23 @@ committer 고유 추가 필드:
 </next-tasks>
 ```
 
-WORK-LIST.md를 COMPLETED로 변경하지 않는다 — git push 시에만 변경.
+### 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/file-content-schema.md

@@ -1,224 +1,224 @@
-# File Content Schema
-
-파이프라인 산출물 파일 포맷 단일 정의.
-
-## COMPLIANCE
-
-| 생성 파일 | 준수 섹션 | 위반 시 결과 |
-|-----------|-----------|-------------|
-| `PLAN.md` | § 1 | `parsePlanMd()` 파싱 실패, scheduler 동작 불가 |
-| `TASK-XX.md` | § 2 | `parseTaskFilename()` DB 등록 누락 |
-| `TASK-XX_progress.md` | § 3 | committer gate FAIL |
-| `TASK-XX_result.md` | § 4 | context-handoff 누락 |
-| `TASK-XX_result.md` (direct) | § 5 | result.md 인식 실패 |
-| `PROGRESS.md` | § 6 | scheduler 진행률 추적 불가 |
-
----
-
-## § 1. PLAN.md
-
-경로: `works/{WORK_ID}/PLAN.md`
-
-```markdown
-# WORK-01: {제목}
-
-> Created: {YYYY-MM-DD}
-> 요구사항: {REQ-XXX | N/A}
-> Execution-Mode: {direct | pipeline | full}
-> Project: {project name}
-> Tech Stack: {stack}
-> Language: {lang_code}
-> Status: PLANNED
-
-## Goal
-{1-2문장}
-
-## Task Dependency Graph
-{ASCII diagram}
-
-## Tasks
-
-### TASK-00: {title}
-- **Depends on**: (none)
-- **Scope**: {description}
-- **Files**:
-  - `path/to/file` — {description}
-
-### TASK-01: {title}
-- **Depends on**: TASK-00
-```
-
-제목 형식: `# WORK-NN: 제목` — `# PLAN WORK-NN:` 금지 (`parsePlanMd()` 오류)
-
----
-
-## § 2. TASK-XX.md
-
-경로: `works/{WORK_ID}/TASK-XX.md`
-
-> `parseTaskFilename()` 정규식: `/^TASK-(\d+)\.md$/` — WORK prefix 금지
-
-```markdown
-# TASK-XX: {title}
-
-## WORK
-{WORK_ID}: {WORK title}
-
-## Dependencies
-- TASK-YY (required)
-
-## Scope
-{description}
-
-## Files
-| Path | Action | Description |
-|------|--------|-------------|
-| `src/file.ts` | CREATE | 설명 |
-
-## Acceptance Criteria
-- [ ] {criterion}
-
-## Verify
-```bash
-{verification commands}
-```
-```
-
----
-
-## § 3. TASK-XX_progress.md
-
-경로: `works/{WORK_ID}/TASK-XX_progress.md`
-
-```markdown
-# TASK-XX Progress
-
-- Status: {PENDING | STARTED | IN_PROGRESS | COMPLETED}
-- Started: {ISO 8601}
-- Updated: {ISO 8601}
-- Files changed:
-  - `path/to/file` — {CREATE | MODIFY | DELETE}
-```
-
-| 시점 | Status |
-|------|--------|
-| planner 템플릿 | `PENDING` |
-| builder 착수 | `STARTED` |
-| 파일 변경 중 | `IN_PROGRESS` |
-| 완료 | `COMPLETED` |
-
-committer gate: 파일 존재 + `Status: COMPLETED` + Files changed 비어있지 않음
-
----
-
-## § 4. TASK-XX_result.md (full / pipeline)
-
-경로: `works/{WORK_ID}/TASK-XX_result.md`
-
-```markdown
-# TASK-XX Result
-
-> WORK: {WORK_ID} — {title}
-> Completed: {YYYY-MM-DD HH:MM}
-> Status: **DONE**
-
-{## Summary | ## 요약 | ## サマリー}
-{1-2줄}
-
-{## Completed Checklist | ## 완료 체크리스트 | ## 完了チェックリスト}
-- [x] {item}
-
-{## Verification Results | ## 검증 결과 | ## 検証結果}
-- Build: ✅
-- Lint: ✅
-- Tests: ✅ (N passed)
-
-{## Files Changed | ## 변경 파일 | ## 変更ファイル}
-### Created
-- `path` — {description}
-
-{## Issues Encountered | ## 발생 이슈 | ## 発生した問題}
-None
-
-{## Notes for Subsequent Tasks | ## 후속 TASK 참고사항 | ## 後続タスクへの注記}
-None
-
-{## Context Handoff | ## 컨텍스트 핸드오프 | ## コンテキスト引き継ぎ}
-
-### Builder Context (SUMMARY)
-{builder what 필드 1-3줄}
-
-### Verifier Context (FULL)
-{verifier context-handoff 4개 필드}
-```
-
-| 섹션 | en | ko | ja |
-|------|----|----|-----|
-| Summary | `## Summary` | `## 요약` | `## サマリー` |
-| Completed Checklist | `## Completed Checklist` | `## 완료 체크리스트` | `## 完了チェックリスト` |
-| Verification Results | `## Verification Results` | `## 검증 결과` | `## 検証結果` |
-| Files Changed | `## Files Changed` | `## 변경 파일` | `## 変更ファイル` |
-| Issues Encountered | `## Issues Encountered` | `## 발생 이슈` | `## 発生した問題` |
-| Notes for Subsequent Tasks | `## Notes for Subsequent Tasks` | `## 후속 TASK 참고사항` | `## 後続タスクへの注記` |
-| Context Handoff | `## Context Handoff` | `## 컨텍스트 핸드오프` | `## コンテキスト引き継ぎ` |
-
----
-
-## § 5. TASK-XX_result.md (direct 모드)
-
-```markdown
-# TASK-00 Result
-
-> WORK: WORK-NN — {제목}
-> Completed: {YYYY-MM-DD HH:MM}
-> Execution-Mode: direct
-> Status: **DONE**
-> Commit: {hash}
-
-## 요약
-{1줄}
-
-## 변경 파일
-- `{path}` — {내용}
-
-## 검증
-- Build: PASS (self-check)
-- Lint: PASS (self-check)
-```
-
----
-
-## § 6. PROGRESS.md
-
-경로: `works/{WORK_ID}/PROGRESS.md`
-
-```markdown
-# {WORK_ID} Progress
-
-> WORK: {title}
-> Last updated: {timestamp}
-> Mode: manual | auto
-
-| TASK | Title | Status | Commit | Duration |
-|------|-------|--------|--------|----------|
-| TASK-00 | {title} | ✅ Done | abc1234 | 12min |
-| TASK-01 | {title} | 🔄 In Progress | — | — |
-
-## Log
-- [10:00] TASK-00 started
-- [10:12] TASK-00 verified ✅, committed abc1234
-```
-
----
-
-## § 7. 파일명 규칙
-
-| 종류 | 형식 | 생성 주체 |
-|------|------|----------|
-| 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) |
-| WORK 진행 | `PROGRESS.md` | scheduler |
-
-`WORK-NN-TASK-NN.md` 형식 금지 → `parseTaskFilename()` 인식 불가.
+# File Content Schema
+
+파이프라인 산출물 파일 포맷 단일 정의.
+
+## COMPLIANCE
+
+| 생성 파일 | 준수 섹션 | 위반 시 결과 |
+|-----------|-----------|-------------|
+| `PLAN.md` | § 1 | `parsePlanMd()` 파싱 실패, scheduler 동작 불가 |
+| `TASK-XX.md` | § 2 | `parseTaskFilename()` DB 등록 누락 |
+| `TASK-XX_progress.md` | § 3 | committer gate FAIL |
+| `TASK-XX_result.md` | § 4 | context-handoff 누락 |
+| `TASK-XX_result.md` (direct) | § 5 | result.md 인식 실패 |
+| `PROGRESS.md` | § 6 | scheduler 진행률 추적 불가 |
+
+---
+
+## § 1. PLAN.md
+
+경로: `works/{WORK_ID}/PLAN.md`
+
+```markdown
+# WORK-01: {제목}
+
+> Created: {YYYY-MM-DD}
+> 요구사항: {REQ-XXX | 사용자 요청 텍스트}
+> Execution-Mode: {direct | pipeline | full}
+> Project: {project name}
+> Tech Stack: {stack}
+> Language: {lang_code}
+> Status: PLANNED
+
+## Goal
+{1-2문장}
+
+## Task Dependency Graph
+{ASCII diagram}
+
+## Tasks
+
+### TASK-00: {title}
+- **Depends on**: (none)
+- **Scope**: {description}
+- **Files**:
+  - `path/to/file` — {description}
+
+### TASK-01: {title}
+- **Depends on**: TASK-00
+```
+
+제목 형식: `# WORK-NN: 제목` — `# PLAN WORK-NN:` 금지 (`parsePlanMd()` 오류)
+
+---
+
+## § 2. TASK-XX.md
+
+경로: `works/{WORK_ID}/TASK-XX.md`
+
+> `parseTaskFilename()` 정규식: `/^TASK-(\d+)\.md$/` — WORK prefix 금지
+
+```markdown
+# TASK-XX: {title}
+
+## WORK
+{WORK_ID}: {WORK title}
+
+## Dependencies
+- TASK-YY (required)
+
+## Scope
+{description}
+
+## Files
+| Path | Action | Description |
+|------|--------|-------------|
+| `src/file.ts` | CREATE | 설명 |
+
+## Acceptance Criteria
+- [ ] {criterion}
+
+## Verify
+```bash
+{verification commands}
+```
+```
+
+---
+
+## § 3. TASK-XX_progress.md
+
+경로: `works/{WORK_ID}/TASK-XX_progress.md`
+
+```markdown
+# TASK-XX Progress
+
+- Status: {PENDING | STARTED | IN_PROGRESS | COMPLETED}
+- Started: {ISO 8601}
+- Updated: {ISO 8601}
+- Files changed:
+  - `path/to/file` — {CREATE | MODIFY | DELETE}
+```
+
+| 시점 | Status |
+|------|--------|
+| planner 템플릿 | `PENDING` |
+| builder 착수 | `STARTED` |
+| 파일 변경 중 | `IN_PROGRESS` |
+| 완료 | `COMPLETED` |
+
+committer gate: 파일 존재 + `Status: COMPLETED` + Files changed 비어있지 않음
+
+---
+
+## § 4. TASK-XX_result.md (full / pipeline)
+
+경로: `works/{WORK_ID}/TASK-XX_result.md`
+
+```markdown
+# TASK-XX Result
+
+> WORK: {WORK_ID} — {title}
+> Completed: {YYYY-MM-DD HH:MM}
+> Status: **DONE**
+
+{## Summary | ## 요약 | ## サマリー}
+{1-2줄}
+
+{## Completed Checklist | ## 완료 체크리스트 | ## 完了チェックリスト}
+- [x] {item}
+
+{## Verification Results | ## 검증 결과 | ## 検証結果}
+- Build: ✅
+- Lint: ✅
+- Tests: ✅ (N passed)
+
+{## Files Changed | ## 변경 파일 | ## 変更ファイル}
+### Created
+- `path` — {description}
+
+{## Issues Encountered | ## 발생 이슈 | ## 発生した問題}
+None
+
+{## Notes for Subsequent Tasks | ## 후속 TASK 참고사항 | ## 後続タスクへの注記}
+None
+
+{## Context Handoff | ## 컨텍스트 핸드오프 | ## コンテキスト引き継ぎ}
+
+### Builder Context (SUMMARY)
+{builder what 필드 1-3줄}
+
+### Verifier Context (FULL)
+{verifier context-handoff 4개 필드}
+```
+
+| 섹션 | en | ko | ja |
+|------|----|----|-----|
+| Summary | `## Summary` | `## 요약` | `## サマリー` |
+| Completed Checklist | `## Completed Checklist` | `## 완료 체크리스트` | `## 完了チェックリスト` |
+| Verification Results | `## Verification Results` | `## 검증 결과` | `## 検証結果` |
+| Files Changed | `## Files Changed` | `## 변경 파일` | `## 変更ファイル` |
+| Issues Encountered | `## Issues Encountered` | `## 발생 이슈` | `## 発生した問題` |
+| Notes for Subsequent Tasks | `## Notes for Subsequent Tasks` | `## 후속 TASK 참고사항` | `## 後続タスクへの注記` |
+| Context Handoff | `## Context Handoff` | `## 컨텍스트 핸드오프` | `## コンテキスト引き継ぎ` |
+
+---
+
+## § 5. TASK-XX_result.md (direct 모드)
+
+```markdown
+# TASK-00 Result
+
+> WORK: WORK-NN — {제목}
+> Completed: {YYYY-MM-DD HH:MM}
+> Execution-Mode: direct
+> Status: **DONE**
+> Commit: {hash}
+
+## 요약
+{1줄}
+
+## 변경 파일
+- `{path}` — {내용}
+
+## 검증
+- Build: PASS (self-check)
+- Lint: PASS (self-check)
+```
+
+---
+
+## § 6. PROGRESS.md
+
+경로: `works/{WORK_ID}/PROGRESS.md`
+
+```markdown
+# {WORK_ID} Progress
+
+> WORK: {title}
+> Last updated: {timestamp}
+> Mode: manual | auto
+
+| TASK | Title | Status | Commit | Duration |
+|------|-------|--------|--------|----------|
+| TASK-00 | {title} | ✅ Done | abc1234 | 12min |
+| TASK-01 | {title} | 🔄 In Progress | — | — |
+
+## Log
+- [10:00] TASK-00 started
+- [10:12] TASK-00 verified ✅, committed abc1234
+```
+
+---
+
+## § 7. 파일명 규칙
+
+| 종류 | 형식 | 생성 주체 |
+|------|------|----------|
+| 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) |
+| WORK 진행 | `PROGRESS.md` | scheduler |
+
+`WORK-NN-TASK-NN.md` 형식 금지 → `parseTaskFilename()` 인식 불가.

package/agents/ko/planner.md

@@ -143,7 +143,7 @@ PLAN.md `> Language:` 필드에 resolved language 기록. 모든 산출물을
 ### 3-9. 요구사항 코드(REQ) 기록
 
 - `REQ-XXX` 패턴 존재: `> 요구사항: REQ-XXX`
-- 없는 경우: `> 요구사항: N/A`
+- 없는 경우: `> 요구사항: {사용자 요청 텍스트}` — 사용자가 입력한 요청 내용을 그대로 기록
 
 ---
 

package/agents/ko/router.md

@@ -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")
 
@@ -140,7 +152,7 @@ Router가 단독 수행. 코드 탐색 시 Serena MCP 우선 사용:
 → `.claude/agents/shared-prompt-sections.md` § 8 참조
 
 - WORK 생성 시: `IN_PROGRESS` 추가
-- COMPLETED 변경: **git push 시에만** — Router가 직접 변경 금지
+- COMPLETED 변경: 마지막 TASK 완료 시 committer가 자동 변경
 
 ### 파일명 규칙
 - TASK 파일명: `TASK-XX.md` 형식

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

@@ -111,7 +111,7 @@ echo "$DONE / $TOTAL"
 | 필드 | 필수 | 설명 |
 |------|------|------|
 | `> Created:` | ✅ | YYYY-MM-DD |
-| `> 요구사항:` | ✅ | `REQ-XXX` 또는 `N/A` |
+| `> 요구사항:` | ✅ | `REQ-XXX` 또는 사용자 요청 텍스트 |
 | `> Execution-Mode:` | ✅ | `direct` / `pipeline` / `full` |
 | `> Project:` | ✅ | 프로젝트명 |
 | `> Tech Stack:` | ✅ | 감지된 기술 스택 |
@@ -127,11 +127,10 @@ echo "$DONE / $TOTAL"
 | 상태 | 시점 |
 |------|------|
 | `IN_PROGRESS` | WORK 디렉토리 생성 시 추가 |
-| `COMPLETED` | git push 시에만 변경 |
+| `COMPLETED` | 마지막 TASK 완료 시 committer가 자동 변경 |
 
-- committer / scheduler → COMPLETED 변경 금지
 - WORK 디렉토리 생성 시 반드시 IN_PROGRESS 추가
-- push 후 IN_PROGRESS 방치 금지
+- committer: 마지막 TASK commit 후 WORK-LIST.md를 `IN_PROGRESS` → `COMPLETED`로 변경
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uctm",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Universal Claude Task Manager — SDD-based task pipeline subagent system for Claude Code CLI",
   "type": "module",
   "bin": {