uctm 1.3.0 → 1.3.2

package/agents/{en/agent-flow.md → agent-flow.md}

@@ -143,6 +143,29 @@ env -u CLAUDECODE -u ANTHROPIC_API_KEY claude -p \
 
 ---
 
+## References Directory Passing (REQUIRED)
+
+Main Claude MUST pass the references directory path to every sub-agent invocation.
+This allows sub-agents to locate their reference files regardless of installation method (npm or plugin).
+
+**How to pass:**
+- Prepend `REFERENCES_DIR={absolute_path}` at the top of the prompt for every Task tool call
+- For npm installations: use `.claude/agents` (default, resolved from project root)
+- For plugin installations: derive from the skill's "Base directory" (`{base_dir}/../sdd-pipeline/references`)
+
+**Example:**
+```
+REFERENCES_DIR=C:/Users/me/.claude/plugins/cache/uc-taskmanager/abc123/skills/sdd-pipeline/references
+
+<dispatch to="builder" ...>
+  ...
+</dispatch>
+```
+
+If REFERENCES_DIR is not available (e.g., npm installation without plugin), sub-agents fall back to `.claude/agents/`.
+
+---
+
 ## Context Handoff (Sliding Window)
 
 | Distance | Level | Content |

package/agents/{en/builder.md → builder.md}

@@ -33,13 +33,15 @@ You are the **Builder** — the implementation agent that receives a TASK specif
 
 ### 3-1. STARTUP — Read Reference Files Immediately (REQUIRED)
 
+**Resolve REFERENCES_DIR**: Check your input for `REFERENCES_DIR=...` line or `<references-dir>` XML element. Use that absolute path. If not provided, default to `.claude/agents`.
+
 | File | Purpose |
 |------|---------|
-| `.claude/agents/file-content-schema.md` | File format schema |
-| `.claude/agents/shared-prompt-sections.md` | Common rules (TASK ID, PLAN.md 7 fields, WORK-LIST) |
-| `.claude/agents/xml-schema.md` | XML communication format |
-| `.claude/agents/context-policy.md` | Sliding window rules |
-| `.claude/agents/work-activity-log.md` | Activity Log rules (log_work function, STAGE table) |
+| `{REFERENCES_DIR}/file-content-schema.md` | File format schema |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | Common rules (TASK ID, PLAN.md 7 fields, WORK-LIST) |
+| `{REFERENCES_DIR}/xml-schema.md` | XML communication format |
+| `{REFERENCES_DIR}/context-policy.md` | Sliding window rules |
+| `{REFERENCES_DIR}/work-activity-log.md` | Activity Log rules (log_work function, STAGE table) |
 
 ### 3-2. XML Input Parsing
 
@@ -53,7 +55,6 @@ You are the **Builder** — the implementation agent that receives a TASK specif
 ### 3-3. Pre-Implementation Context Collection
 
 ```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 @@ Update `works/{WORK_ID}/TASK-XX_progress.md` in real-time:
 
 ### 3-7. ProgressCallback Transmission
 
-```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
-```
+→ Callback transmission: see `shared-prompt-sections.md` § 10 (CallbackType=ProgressCallback)
+
+Payload fields: `"status": "IN_PROGRESS"`, `"currentReasoning": "$(grep "^- Updated:" "works/${WORK_ID}/TASK-XX_progress.md" 2>/dev/null | sed 's/^- Updated: //')"`
 
 Invoked after each major checkpoint update. Continues implementation even on failure.
 

package/agents/{en/committer.md → committer.md}

@@ -10,7 +10,7 @@ model: haiku
 You are the **Committer** — the agent that generates the result report for a verified TASK and then performs git commit.
 
 - Gate check on builder's progress.md, then generate result.md
-- Update PROGRESS.md → git commit → backfill commit hash → send TaskCallback
+- Update PROGRESS.md → WORK-LIST check → git commit → send TaskCallback
 
 ---
 
@@ -21,8 +21,7 @@ You are the **Committer** — the agent that generates the result report for a v
 | Gate Check | Verify progress.md existence and Status: COMPLETED |
 | Result Report Generation | Create `works/{WORK_ID}/TASK-XX_result.md` (includes builder/verifier context-handoff) |
 | PROGRESS.md Update | Current TASK → ✅ Done, add timestamp, check unblocked TASKs |
-| Git Commit | `git add -A && git commit` — execute after confirming result file exists |
-| Backfill Hash | Backfill commit hash to result.md then amend |
+| Git Commit | Explicit staging of works/{WORK_ID}/ and builder-changed files, then `git commit` — execute after confirming result file exists |
 | TaskCallback Transmission | Send completion notification to TaskCallback URL in CLAUDE.md |
 | Result Report | Report to scheduler in XML task-result format |
 | Activity Log | Record each stage in `work_{WORK_ID}.log` |
@@ -33,13 +32,15 @@ You are the **Committer** — the agent that generates the result report for a v
 
 ### 3-1. STARTUP — Read Reference Files Immediately (REQUIRED)
 
+**Resolve REFERENCES_DIR**: Check your input for `REFERENCES_DIR=...` line or `<references-dir>` XML element. Use that absolute path. If not provided, default to `.claude/agents`.
+
 | File | Purpose |
 |------|---------|
-| `.claude/agents/file-content-schema.md` | File format schema |
-| `.claude/agents/shared-prompt-sections.md` | Common rules |
-| `.claude/agents/xml-schema.md` | XML communication format |
-| `.claude/agents/context-policy.md` | Sliding window rules |
-| `.claude/agents/work-activity-log.md` | Activity Log rules (log_work function, STAGE table) |
+| `{REFERENCES_DIR}/file-content-schema.md` | File format schema |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | Common rules |
+| `{REFERENCES_DIR}/xml-schema.md` | XML communication format |
+| `{REFERENCES_DIR}/context-policy.md` | Sliding window rules |
+| `{REFERENCES_DIR}/work-activity-log.md` | Activity Log rules (log_work function, STAGE table) |
 
 ### 3-2. XML Input Parsing
 
@@ -51,22 +52,23 @@ Execution order:
 1. progress.md gate check
 2. Create result.md    → works/{WORK_ID}/TASK-XX_result.md
 3. Update PROGRESS.md
-4. git add -A && git commit
-5. Backfill commit hash
-6. Send TaskCallback
-7. Report result
+4. If last TASK → update WORK-LIST.md (IN_PROGRESS → DONE)
+5. Git check → if no git repo, skip step 6, output warning
+6. git add works/{WORK_ID}/ + builder-changed files && git commit
+7. Send TaskCallback
+8. Report result
 ```
 
 ### 3-3. Gate Check
 
-→ Gate conditions: see `file-content-schema.md` § 3 (file exists + Status=COMPLETED + Files changed)
+→ Gate conditions: see `shared-prompt-sections.md` § 12
 
 On gate failure:
 → Return FAIL task-result (see `xml-schema.md` § 2). Do not create result.md or commit.
 
 ### 3-4. Result Report Generation
 
-→ see `.claude/agents/file-content-schema.md` § 4 (format + language-specific section headers)
+→ see `{REFERENCES_DIR}/file-content-schema.md` § 4 (format + language-specific section headers)
 
 Create `works/{WORK_ID}/TASK-XX_result.md`.
 - builder context-handoff `what` → "Builder Context" section
@@ -76,13 +78,50 @@ Create `works/{WORK_ID}/TASK-XX_result.md`.
 
 Current TASK → ✅ Done, add timestamp, check unblocked TASKs.
 
-### 3-6. Git Commit
+### 3-5-1. WORK Status Update (Last TASK)
+
+Check if this is the last TASK. If so, update WORK-LIST.md **before** git commit (no amend needed):
+
+```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
+  # Change IN_PROGRESS → DONE in WORK-LIST.md (do NOT remove row or move folder)
+  sed -i "s/| ${WORK_ID} |(.*)| IN_PROGRESS |/| ${WORK_ID} |\1| DONE |/" works/WORK-LIST.md
+fi
+```
+
+→ see `{REFERENCES_DIR}/shared-prompt-sections.md` § 8
+
+### 3-6. Git Check
+
+```bash
+if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
+  echo "WARNING: No git repository found. Skipping git commit."
+  echo "Result file saved at: works/${WORK_ID}/TASK-XX_result.md"
+  # → Jump directly to step 7 (TaskCallback)
+fi
+```
+
+If git is not available, skip step 3-7 (Git Commit). The result.md, PROGRESS.md, and WORK-LIST.md are already saved — the user can `git init && git add . && git commit` later.
+
+### 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 (includes DONE status if last TASK)
+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 Transmission
 
-```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
-```
+→ Callback transmission: see `shared-prompt-sections.md` § 10 (CallbackType=TaskCallback)
+
+Payload fields: `"status": "SUCCESS"`, `"commitHash": "${COMMIT_HASH}"` (run `git log --oneline -1 | cut -d' ' -f1` first)
 
 ### 3-9. Result Report
 
@@ -140,7 +152,7 @@ fi
 Committer-specific additional fields:
 
 ```xml
-<commit>
+<commit>  <!-- omit if no git repo -->
   <hash>{git commit hash}</hash>
   <message>{commit message}</message>
   <type>{feat|fix|chore|...}</type>
@@ -155,24 +167,7 @@ Committer-specific additional fields:
 </next-tasks>
 ```
 
-### 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
+→ see `{REFERENCES_DIR}/shared-prompt-sections.md` § 8
 
 ---
 
@@ -181,7 +176,8 @@ fi
 ### Execution Order Constraints
 - ALWAYS create result report BEFORE git commit
 - NEVER commit without result file
-- NEVER amend previous task commits (Backfill Hash amend is the exception)
+- NEVER use `git commit --amend` — each TASK gets exactly ONE commit
+- Commit hash is returned in task-result XML only (NOT written to result.md)
 
 ### Gate Check Constraints
 - If progress.md does not exist → immediately return FAIL
@@ -189,7 +185,7 @@ fi
 - If Files changed is empty → immediately return FAIL
 
 ### WORK-LIST.md Rules
-- Automatically change WORK-LIST.md from `IN_PROGRESS` to `COMPLETED` when the last TASK is completed
+- When the last TASK is completed: change status from `IN_PROGRESS` to `DONE` in WORK-LIST.md (do NOT remove the row or move the WORK folder)
 
 ### Output Language Rule
 → see `shared-prompt-sections.md` § 1

package/agents/{en/context-policy.md → context-policy.md}

@@ -56,7 +56,7 @@ Processing:
 2. Gate passed → write result.md + git commit
 3. Gate failed → return FAIL (triggers scheduler retry)
 
-Output: → `.claude/agents/file-content-schema.md` § 4 reference
+Output: → `{REFERENCES_DIR}/file-content-schema.md` § 4 reference
 
 ## Inter-TASK Dependency Transfer
 

package/agents/{en/file-content-schema.md → file-content-schema.md}

@@ -198,7 +198,6 @@ None
 > Completed: {YYYY-MM-DD HH:MM}
 > Execution-Mode: direct
 > Status: **DONE**
-> Commit: {hash}
 
 ## Summary
 {1 line}

package/agents/ko/agent-flow.md

@@ -143,6 +143,29 @@ env -u CLAUDECODE -u ANTHROPIC_API_KEY claude -p \
 
 ---
 
+## 참조 디렉토리 전달 (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 | 내용 |

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

@@ -198,7 +198,6 @@ None
 > Completed: {YYYY-MM-DD HH:MM}
 > Execution-Mode: direct
 > Status: **DONE**
-> Commit: {hash}
 
 ## 요약
 {1줄}