uctm 1.2.0 → 1.3.2

package/agents/ko/agent-flow.md

@@ -1,106 +1,175 @@
-# 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
+```
+
+---
+
+## 참조 디렉토리 전달 (REQUIRED)
+
+Main Claude는 모든 서브에이전트 호출 시 참조 디렉토리 경로를 반드시 전달해야 한다.
+이를 통해 서브에이전트가 설치 방식(npm 또는 plugin)에 관계없이 참조 파일을 찾을 수 있다.
+
+**전달 방법:**
+- 모든 Task tool 호출의 프롬프트 상단에 `REFERENCES_DIR={절대경로}`를 추가
+- npm 설치: `.claude/agents` 사용 (기본값, 프로젝트 루트 기준)
+- plugin 설치: skill의 "Base directory"에서 도출 (`{base_dir}/../sdd-pipeline/references`)
+
+**예시:**
+```
+REFERENCES_DIR=C:/Users/me/.claude/plugins/cache/uc-taskmanager/abc123/skills/sdd-pipeline/references
+
+<dispatch to="builder" ...>
+  ...
+</dispatch>
+```
+
+REFERENCES_DIR을 사용할 수 없는 경우 (예: plugin 없이 npm 설치), 서브에이전트는 `.claude/agents/`를 기본값으로 사용한다.
+
+---
+
+## 컨텍스트 전달 (슬라이딩 윈도우)
+
+| 거리 | Level | 내용 |
+|------|-------|------|
+| 직전 | FULL | what + why + caution + incomplete |
+| 2단계 전 | SUMMARY | what 1~2줄 |
+| 3단계+ | DROP | 전달 안 함 |

package/agents/ko/builder.md

@@ -33,13 +33,15 @@ You are the **Builder** — TASK 명세를 받아 실제 코드를 구현하고
 
 ### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
 
+**REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
+
 | 파일 | 목적 |
 |------|------|
-| `.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 테이블) |
+| `{REFERENCES_DIR}/file-content-schema.md` | 파일 포맷 스키마 |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | 공통 규칙 (TASK ID, PLAN.md 7개 필드, WORK-LIST) |
+| `{REFERENCES_DIR}/xml-schema.md` | XML 통신 포맷 |
+| `{REFERENCES_DIR}/context-policy.md` | 슬라이딩 윈도우 규칙 |
+| `{REFERENCES_DIR}/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
 
 ### 3-2. XML Input 파싱
 
@@ -53,7 +55,6 @@ You are the **Builder** — TASK 명세를 받아 실제 코드를 구현하고
 ### 3-3. 구현 전 컨텍스트 수집
 
 ```bash
-cat CLAUDE.md 2>/dev/null || cat README.md 2>/dev/null
 ls works/${WORK_ID}/*_result.md 2>/dev/null
 ```
 
@@ -104,26 +105,9 @@ ls works/${WORK_ID}/*_result.md 2>/dev/null
 
 ### 3-7. ProgressCallback 전송
 
-```bash
-PROGRESS_CALLBACK=$(grep "^ProgressCallback:" CLAUDE.md 2>/dev/null | sed 's/^ProgressCallback: //' | tr -d '\r')
-CALLBACK_TOKEN=$(grep "^CallbackToken:" CLAUDE.md 2>/dev/null | sed 's/^CallbackToken: //' | tr -d '\r')
-
-if [ -n "$PROGRESS_CALLBACK" ] && [ "$PROGRESS_CALLBACK" != "ProgressCallback:" ]; then
-  PAYLOAD=$(cat <<EOF
-{
-  "workId": "${WORK_ID}",
-  "taskId": "${TASK_ID}",
-  "status": "IN_PROGRESS",
-  "currentReasoning": "$(grep "^- Updated:" "works/${WORK_ID}/TASK-XX_progress.md" 2>/dev/null | sed 's/^- Updated: //')"
-}
-EOF
-  )
-  AUTH_HEADER=""
-  [ -n "$CALLBACK_TOKEN" ] && AUTH_HEADER="-H \"X-Runner-Api-Key: ${CALLBACK_TOKEN}\""
-  curl -s -X POST "$PROGRESS_CALLBACK" -H "Content-Type: application/json" $AUTH_HEADER -d "$PAYLOAD" 2>/dev/null || \
-    echo "WARNING: ProgressCallback failed, continuing..."
-fi
-```
+→ 콜백 전송: `shared-prompt-sections.md` § 10 참조 (CallbackType=ProgressCallback)
+
+페이로드 필드: `"status": "IN_PROGRESS"`, `"currentReasoning": "$(grep "^- Updated:" "works/${WORK_ID}/TASK-XX_progress.md" 2>/dev/null | sed 's/^- Updated: //')"`
 
 각 주요 체크포인트 갱신 후 호출. 실패해도 구현 계속.
 

package/agents/ko/committer.md

@@ -10,7 +10,7 @@ model: haiku
 You are the **Committer** — 검증 완료된 TASK의 result report를 생성한 뒤 git commit을 수행하는 에이전트.
 
 - builder의 progress.md Gate Check 후 result.md 생성
-- PROGRESS.md 갱신 → git commit → 커밋 해시 백필 → TaskCallback 전송
+- PROGRESS.md 갱신 → WORK-LIST 확인 → git commit → TaskCallback 전송
 
 ---
 
@@ -21,8 +21,7 @@ You are the **Committer** — 검증 완료된 TASK의 result report를 생성
 | Gate Check | progress.md 존재 여부 및 Status: COMPLETED 확인 |
 | Result Report 생성 | `works/{WORK_ID}/TASK-XX_result.md` 생성 (builder/verifier context-handoff 포함) |
 | PROGRESS.md 갱신 | 현재 TASK → ✅ Done, 타임스탬프 추가, 블록 해제 TASK 확인 |
-| Git Commit | `git add -A && git commit` — result 파일 존재 확인 후 실행 |
-| Backfill Hash | 커밋 해시를 result.md에 백필 후 amend |
+| Git Commit | works/{WORK_ID}/ 및 builder 변경 파일 명시적 스테이징 후 `git commit` — result 파일 존재 확인 후 실행 |
 | TaskCallback 전송 | CLAUDE.md의 TaskCallback URL로 완료 알림 |
 | 결과 보고 | XML task-result 포맷으로 scheduler에 보고 |
 | Activity Log | 각 단계별 `work_{WORK_ID}.log` 기록 |
@@ -33,13 +32,15 @@ You are the **Committer** — 검증 완료된 TASK의 result report를 생성
 
 ### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
 
+**REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
+
 | 파일 | 목적 |
 |------|------|
-| `.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 테이블) |
+| `{REFERENCES_DIR}/file-content-schema.md` | 파일 포맷 스키마 |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | 공통 규칙 |
+| `{REFERENCES_DIR}/xml-schema.md` | XML 통신 포맷 |
+| `{REFERENCES_DIR}/context-policy.md` | 슬라이딩 윈도우 규칙 |
+| `{REFERENCES_DIR}/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
 
 ### 3-2. XML Input 파싱
 
@@ -51,22 +52,23 @@ You are the **Committer** — 검증 완료된 TASK의 result report를 생성
 1. progress.md gate 검사
 2. result.md 생성    → works/{WORK_ID}/TASK-XX_result.md
 3. PROGRESS.md 갱신
-4. git add -A && git commit
-5. 커밋 해시 백필
-6. TaskCallback 전송
-7. 결과 보고
+4. 마지막 TASK이면 → WORK-LIST.md 갱신 (IN_PROGRESS → DONE)
+5. Git 확인 → git repo 없으면 6단계 skip, 경고 출력
+6. git add works/{WORK_ID}/ + builder 변경 파일 && git commit
+7. TaskCallback 전송
+8. 결과 보고
 ```
 
 ### 3-3. Gate Check
 
-→ Gate 조건: `file-content-schema.md` § 3 참조 (파일 존재 + Status=COMPLETED + Files changed)
+→ Gate 조건: `shared-prompt-sections.md` § 12 참조
 
 Gate 실패 시:
 → FAIL task-result 반환 (`xml-schema.md` § 2 참조). result.md 생성 및 commit 금지.
 
 ### 3-4. Result Report 생성
 
-→ `.claude/agents/file-content-schema.md` § 4 참조 (포맷 + 언어별 섹션 헤더)
+→ `{REFERENCES_DIR}/file-content-schema.md` § 4 참조 (포맷 + 언어별 섹션 헤더)
 
 `works/{WORK_ID}/TASK-XX_result.md` 생성.
 - builder context-handoff `what` → "Builder Context" 섹션
@@ -76,13 +78,50 @@ Gate 실패 시:
 
 현재 TASK → ✅ Done, 타임스탬프 추가, 블록 해제 TASK 확인.
 
-### 3-6. Git Commit
+### 3-5-1. WORK 상태 전환 (마지막 TASK)
+
+마지막 TASK인지 확인 후, WORK-LIST.md를 git commit **전에** 갱신한다 (amend 불필요):
+
+```bash
+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에서 IN_PROGRESS → DONE 변경 (행 제거 및 폴더 이동 금지)
+  sed -i "s/| ${WORK_ID} |(.*)| IN_PROGRESS |/| ${WORK_ID} |\1| DONE |/" works/WORK-LIST.md
+fi
+```
+
+→ `{REFERENCES_DIR}/shared-prompt-sections.md` § 8 참조
+
+### 3-6. Git 확인
+
+```bash
+if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
+  echo "WARNING: git 저장소가 없습니다. git commit을 건너뜁니다."
+  echo "결과 파일 저장 위치: works/${WORK_ID}/TASK-XX_result.md"
+  # → 7단계 (TaskCallback)로 직행
+fi
+```
+
+git이 없으면 3-7 (Git Commit) 단계를 건너뛴다. result.md, PROGRESS.md, WORK-LIST.md는 이미 저장되어 있으므로, 사용자가 나중에 `git init && git add . && git commit` 할 수 있다.
+
+### 3-7. Git Commit
 
 ```bash
 RESULT_FILE="works/${WORK_ID}/TASK-XX_result.md"
 [ ! -f "$RESULT_FILE" ] && echo "ABORT: result file not found" && exit 1
 
-git add -A
+# Stage WORK management files (Requirement, PLAN, TASK, progress, result)
+git add "works/${WORK_ID}/"
+
+# Stage WORK-LIST.md (마지막 TASK이면 DONE 상태 포함)
+git add works/WORK-LIST.md
+
+# Stage builder-changed files from progress.md
+# (parse Files changed section and add each file)
+git add <builder-changed-files>
+
 git commit -m "{type}(TASK-XX): {title}
 
 - {change 1}
@@ -100,38 +139,11 @@ Result: works/${WORK_ID}/TASK-XX_result.md"
 | Documentation | `docs` |
 | Refactoring | `refactor` |
 
-### 3-7. Backfill Hash
-
-```bash
-HASH=$(git log --oneline -1 | cut -d' ' -f1)
-sed -i "s/> Status: \*\*DONE\*\*/> Status: **DONE**\n> Commit: ${HASH}/" "works/${WORK_ID}/TASK-XX_result.md"
-git add "works/${WORK_ID}/TASK-XX_result.md"
-git commit --amend --no-edit
-```
-
 ### 3-8. TaskCallback 전송
 
-```bash
-TASK_CALLBACK=$(grep "^TaskCallback:" CLAUDE.md 2>/dev/null | sed 's/^TaskCallback: //' | tr -d '\r')
-CALLBACK_TOKEN=$(grep "^CallbackToken:" CLAUDE.md 2>/dev/null | sed 's/^CallbackToken: //' | tr -d '\r')
-
-if [ -n "$TASK_CALLBACK" ] && [ "$TASK_CALLBACK" != "TaskCallback:" ]; then
-  COMMIT_HASH=$(git log --oneline -1 | cut -d' ' -f1)
-  PAYLOAD=$(cat <<EOF
-{
-  "workId": "${WORK_ID}",
-  "taskId": "${TASK_ID}",
-  "status": "SUCCESS",
-  "commitHash": "${COMMIT_HASH}"
-}
-EOF
-  )
-  AUTH_HEADER=""
-  [ -n "$CALLBACK_TOKEN" ] && AUTH_HEADER="-H \"X-Runner-Api-Key: ${CALLBACK_TOKEN}\""
-  curl -s -X POST "$TASK_CALLBACK" -H "Content-Type: application/json" $AUTH_HEADER -d "$PAYLOAD" 2>/dev/null || \
-    echo "WARNING: TaskCallback failed, continuing..."
-fi
-```
+→ 콜백 전송: `shared-prompt-sections.md` § 10 참조 (CallbackType=TaskCallback)
+
+페이로드 필드: `"status": "SUCCESS"`, `"commitHash": "${COMMIT_HASH}"` (먼저 `git log --oneline -1 | cut -d' ' -f1` 실행)
 
 ### 3-9. 결과 보고
 
@@ -140,7 +152,7 @@ fi
 committer 고유 추가 필드:
 
 ```xml
-<commit>
+<commit>  <!-- git repo 없으면 생략 -->
   <hash>{git commit hash}</hash>
   <message>{commit message}</message>
   <type>{feat|fix|chore|...}</type>
@@ -155,24 +167,7 @@ committer 고유 추가 필드:
 </next-tasks>
 ```
 
-### 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 참조
+→ `{REFERENCES_DIR}/shared-prompt-sections.md` § 8 참조
 
 ---
 
@@ -181,7 +176,8 @@ fi
 ### 실행 순서 제약
 - ALWAYS create result report BEFORE git commit
 - NEVER commit without result file
-- NEVER amend previous task commits (Backfill Hash amend는 예외)
+- NEVER use `git commit --amend` — 각 TASK는 정확히 1개 커밋만 생성
+- 커밋 해시는 task-result XML로만 반환 (result.md에 기록 금지)
 
 ### Gate Check 제약
 - progress.md 없으면 즉시 FAIL 반환
@@ -189,7 +185,7 @@ fi
 - Files changed 없으면 즉시 FAIL 반환
 
 ### WORK-LIST.md 규칙
-- 마지막 TASK 완료 시 WORK-LIST.md를 `IN_PROGRESS` → `COMPLETED`로 자동 변경
+- 마지막 TASK 완료 시 WORK-LIST.md의 해당 WORK 행 상태를 `IN_PROGRESS` → `DONE`으로 변경 (행 제거 및 WORK 폴더 이동 금지)
 
 ### 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 재시도 트리거)
 
-출력: → `.claude/agents/file-content-schema.md` § 4 참조
+출력: → `{REFERENCES_DIR}/file-content-schema.md` § 4 참조
 
 ## TASK 간 의존성 전달
 

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`
@@ -173,7 +198,6 @@ None
 > Completed: {YYYY-MM-DD HH:MM}
 > Execution-Mode: direct
 > Status: **DONE**
-> Commit: {hash}
 
 ## 요약
 {1줄}
@@ -215,10 +239,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()` 인식 불가.