uctm 1.3.0 → 1.3.2

package/agents/ko/planner.md

@@ -36,34 +36,23 @@ WORK (일)          — 사용자 요청의 목표 단위
 
 ### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
 
+**REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
+
 | 파일 | 목적 |
 |------|------|
-| `.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 테이블) |
+| `{REFERENCES_DIR}/file-content-schema.md` | 파일 포맷 스키마 (PLAN.md 7개 필드, TASK 포맷) |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | 공통 규칙 (TASK ID, WORK-LIST 규칙) |
+| `{REFERENCES_DIR}/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
 
 ### 3-2. 프로젝트 탐색 (Discovery Process)
 
 ```bash
 # 1. 기존 WORK 확인
 ls -d works/WORK-* 2>/dev/null | sort -V | tail -1
-
-# 2. CLAUDE.md 언어 설정 확인
-grep -oP '(?<=Language:\s?)[a-z]{2}' CLAUDE.md 2>/dev/null
-
-# 3. 프로젝트 정보
-cat CLAUDE.md 2>/dev/null || cat README.md 2>/dev/null
-
-# 4. 기술 스택
-cat package.json 2>/dev/null | head -50
-cat pyproject.toml 2>/dev/null | head -30
-cat Cargo.toml 2>/dev/null | head -20
-cat go.mod 2>/dev/null | head -10
-
-# 5. 구조
-find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) | grep -v node_modules | head -30
 ```
 
+→ 탐색 명령 (2~4단계): `shared-prompt-sections.md` § 11 참조
+
 ### 3-3. Requirement.md 분석 + WORK 디렉토리 확인
 
 Specifier가 이미 WORK 디렉토리를 생성하고 Requirement.md를 작성함.
@@ -111,7 +100,7 @@ PLAN.md의 `> Execution-Mode:` 필드에 결정된 모드를 기록.
 
 ### 3-6. 산출물 구조
 
-→ `.claude/agents/file-content-schema.md` § 7 참조
+→ `{REFERENCES_DIR}/file-content-schema.md` § 7 참조
 
 생성 책임:
 - `PLAN.md`, `TASK-XX.md`, `TASK-XX_progress.md` (초기 템플릿) → Planner
@@ -121,7 +110,7 @@ PLAN.md의 `> Execution-Mode:` 필드에 결정된 모드를 기록.
 
 TASK 파일 생성 시 반드시 동일 디렉토리에 `TASK-XX_progress.md` 템플릿도 함께 생성.
 
-파일 포맷: → `.claude/agents/file-content-schema.md` § 1 (PLAN.md), § 2 (TASK), § 3 (progress 초기값)
+파일 포맷: → `{REFERENCES_DIR}/file-content-schema.md` § 1 (PLAN.md), § 2 (TASK), § 3 (progress 초기값)
 
 ### 3-7. MCP Tool 활용 (Serena)
 
@@ -135,16 +124,7 @@ TASK 파일 생성 시 반드시 동일 디렉토리에 `TASK-XX_progress.md`
 ### 3-8. Output Language Rule
 
 → 우선순위 규칙: `shared-prompt-sections.md` § 1 참조
-
-planner 고유 로케일 감지:
-```
-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"
-```
+→ 로케일 감지: `shared-prompt-sections.md` § 9 참조
 
 PLAN.md `> Language:` 필드에 resolved language 기록. 모든 산출물을 해당 언어로 작성.
 

package/agents/ko/scheduler.md

@@ -36,13 +36,15 @@ You are the **Scheduler** — WORK 파이프라인 실행 에이전트.
 
 ### 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. WORK 식별 및 초기 로드
 
@@ -132,7 +134,7 @@ Committer FAIL 재시도:
 
 ### 3-9. 진행 보고
 
-TASK 완료 후 PROGRESS.md 업데이트 (→ `.claude/agents/file-content-schema.md` § 6 참조) 및 상태 출력:
+TASK 완료 후 PROGRESS.md 업데이트 (→ `{REFERENCES_DIR}/file-content-schema.md` § 6 참조) 및 상태 출력:
 
 ```
 ✅ TASK-XX 완료 — commit: {hash}
@@ -163,8 +165,8 @@ Multi-WORK 현황 확인:
 - 파이프라인 우회 시 result.md 미생성 → WORK 완료 인식 실패
 
 ### WORK-LIST.md 규칙
-- WORK-LIST.md를 COMPLETED로 변경하지 않는다 — git push 시에만 변경
-- → `.claude/agents/shared-prompt-sections.md` § 8 참조
+- WORK-LIST.md를 직접 수정하지 않는다 — 아카이브 처리는 committer가 담당
+- → `{REFERENCES_DIR}/shared-prompt-sections.md` § 8 참조
 
 ### Output Language Rule
 → `shared-prompt-sections.md` § 1 참조

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

@@ -107,7 +107,7 @@ echo "$DONE / $TOTAL"
 
 ## § 7. PLAN.md 필수 메타정보 7개 필드
 
-→ `.claude/agents/file-content-schema.md` § 1 참조
+→ `{REFERENCES_DIR}/file-content-schema.md` § 1 참조
 
 | 필드 | 필수 | 설명 |
 |------|------|------|
@@ -125,17 +125,105 @@ echo "$DONE / $TOTAL"
 
 파일: `works/WORK-LIST.md`
 
-| 상태 | 시점 |
-|------|------|
-| `IN_PROGRESS` | WORK 디렉토리 생성 시 추가 |
-| `COMPLETED` | 마지막 TASK 완료 시 committer가 자동 변경 |
+**포맷:**
+```
+LAST_WORK_ID: WORK-XX
+
+| WORK | 제목 | 상태 | 생성일 | 완료일 |
+|------|------|------|--------|--------|
+| WORK-NN | ... | IN_PROGRESS | YYYY-MM-DD | |
+| WORK-MM | ... | DONE | YYYY-MM-DD | YYYY-MM-DD |
+```
+
+| 상태 | 의미 | 전환 시점 |
+|------|------|-----------|
+| `IN_PROGRESS` | WORK 실행 중 | specifier가 WORK 생성 시 |
+| `DONE` | 모든 TASK 완료, 리뷰/push 대기 중 | committer가 마지막 TASK 완료 시 |
+| `COMPLETED` | _COMPLETED/에 아카이브됨 | push merge (Main Claude가 DONE 일괄 처리) |
+
+규칙:
+- `LAST_WORK_ID` 헤더는 지금까지 생성된 최고 WORK ID를 추적
+- **specifier**: WORK 생성 시 IN_PROGRESS 행 추가 + `LAST_WORK_ID` 갱신
+- **committer**: 마지막 TASK 완료 시 `IN_PROGRESS` → `DONE` 변경 + 완료일 기입 (폴더 이동 또는 행 제거 금지)
+- **Main Claude** (push 절차): DONE 상태의 WORK를 모두 `works/_COMPLETED/`로 이동 + WORK-LIST.md에서 해당 행 제거
+
+---
+
+## § 9. 로케일 감지
+
+```
+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"
+```
+
+---
+
+## § 10. 콜백 전송 템플릿
+
+`{CallbackType}`을 실제 키 이름으로 대체 (예: `ProgressCallback`, `TaskCallback`).
+
+```bash
+CALLBACK_URL=$(grep "^{CallbackType}:" CLAUDE.md 2>/dev/null | sed 's/^{CallbackType}: //' | tr -d '\r')
+CALLBACK_TOKEN=$(grep "^CallbackToken:" CLAUDE.md 2>/dev/null | sed 's/^CallbackToken: //' | tr -d '\r')
+
+if [ -n "$CALLBACK_URL" ] && [ "$CALLBACK_URL" != "{CallbackType}:" ]; then
+  PAYLOAD=$(cat <<EOF
+{
+  "workId": "${WORK_ID}",
+  "taskId": "${TASK_ID}",
+  ... 에이전트별 필드 ...
+}
+EOF
+  )
+  AUTH_HEADER=""
+  [ -n "$CALLBACK_TOKEN" ] && AUTH_HEADER="-H \"X-Runner-Api-Key: ${CALLBACK_TOKEN}\""
+  curl -s -X POST "$CALLBACK_URL" \
+    -H "Content-Type: application/json" \
+    $AUTH_HEADER \
+    -d "$PAYLOAD" > /dev/null 2>&1
+fi
+```
+
+에이전트별 페이로드 필드:
+- **ProgressCallback** (builder): `"status": "IN_PROGRESS"`, `"currentReasoning": "..."`
+- **TaskCallback** (committer): `"status": "SUCCESS"`, `"commitHash": "${COMMIT_HASH}"`
+
+---
+
+## § 11. 프로젝트 탐색
+
+```bash
+# 1. CLAUDE.md 언어 설정 확인
+grep -oP '(?<=Language:\s?)[a-z]{2}' CLAUDE.md 2>/dev/null
+
+# 2. 기술 스택
+cat package.json 2>/dev/null | head -50
+cat pyproject.toml 2>/dev/null | head -30
+cat Cargo.toml 2>/dev/null | head -20
+cat go.mod 2>/dev/null | head -10
+
+# 3. 구조 (필요 시)
+find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) | grep -v node_modules | head -30
+```
+
+---
+
+## § 12. Progress File Gate Check
+
+`works/WORK-NN/TASK-XX_progress.md` Gate 조건:
+- 파일이 해당 경로에 존재
+- `Status: COMPLETED` 줄이 있음
+- `## Files Changed` 섹션이 있고 비어 있지 않음
 
-- WORK 디렉토리 생성 시 반드시 IN_PROGRESS 추가
-- committer: 마지막 TASK commit 후 WORK-LIST.md를 `IN_PROGRESS` → `COMPLETED`로 변경
+Gate 실패 시 → 즉시 FAIL task-result 반환. 이후 단계 진행 금지.
 
 ---
 
 ## Version
 
 - Created: 2026-03-10
-- Updated: 2026-03-15
+- Updated: 2026-03-21

package/agents/ko/specifier.md

@@ -32,44 +32,32 @@ You are the **Specifier** — 사용자 요청을 요구사항으로 명세화
 
 ### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
 
+**REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인을 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
+
 | 파일 | 목적 |
 |------|------|
-| `.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 테이블) |
+| `{REFERENCES_DIR}/file-content-schema.md` | 파일 포맷 스키마 (PLAN.md, TASK, Requirement.md 포맷) |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | 공통 규칙 (TASK ID 패턴, WORK-LIST 규칙, log_work 함수) |
+| `{REFERENCES_DIR}/xml-schema.md` | XML 통신 포맷 (dispatch / task-result 구조) |
+| `{REFERENCES_DIR}/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"
+LAST_ID=$(grep -oP 'LAST_WORK_ID: WORK-\K\d+' works/WORK-LIST.md 2>/dev/null)
+LAST_ID=${LAST_ID:-0}
+NEW_ID=$(printf "%02d" $((LAST_ID + 1)))
+echo "WORK-${NEW_ID}"
 ```
 
-IN_PROGRESS WORK 존재 시:
-> "현재 진행 중인 WORK-XX가 있습니다. 추가 TASK로 진행할까요, 새 WORK를 생성할까요?"
+IN_PROGRESS 또는 DONE WORK 존재 시:
+> "현재 진행 중(IN_PROGRESS)이거나 완료 대기(DONE) 상태인 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
+→ 프로젝트 탐색 명령: `shared-prompt-sections.md` § 11 참조
 
-# 4. 구조 (겸임 시에만 — 단순 요구사항은 생략 가능)
-find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) | grep -v node_modules | head -30
-```
+Note: 3단계(구조)는 Planner 겸임 시에만 실행 — 단순 요구사항은 생략 가능.
 
 ### 3-4. Requirement.md 작성
 
@@ -120,7 +108,7 @@ Requirement.md 작성 완료 후, **요구사항 자체의 복잡도**로 판단
 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 추가
+8.  WORK-LIST.md IN_PROGRESS 행 추가 + LAST_WORK_ID 갱신
 9.  log_work PLAN "Requirement.md, PLAN.md, TASK-00.md 생성 완료 (겸임)"
 10. 생성된 산출물 요약을 사용자에게 제시하고 승인 요청 (요구사항 + 설계 통합 검토)
 11. dispatch XML 반환. **호출은 Main Claude가 수행한다.**
@@ -140,7 +128,7 @@ Requirement.md 작성 완료 후, **요구사항 자체의 복잡도**로 판단
 1.  mkdir works/WORK-NN/
 2.  log_work INIT "WORK-NN 생성 — Planner 위임"
 3.  Requirement.md 생성 → § 3-4
-4.  WORK-LIST.md IN_PROGRESS 추가
+4.  WORK-LIST.md IN_PROGRESS 행 추가 + LAST_WORK_ID 갱신
 5.  log_work REF "참조: ..."
 6.  생성된 Requirement.md 요약을 사용자에게 제시하고 기획 승인 요청
 7.  dispatch XML 반환. **호출은 Main Claude가 수행한다.**
@@ -152,21 +140,12 @@ Requirement.md 작성 완료 후, **요구사항 자체의 복잡도**로 판단
 ### 3-8. Output Language Rule
 
 → 우선순위 규칙: `shared-prompt-sections.md` § 1 참조
+→ 로케일 감지: `shared-prompt-sections.md` § 9 참조
 
 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. 제약사항 및 금지사항
@@ -191,9 +170,9 @@ specifier 고유 규칙:
 - "자동으로 진행" 명시 시에만 auto mode (현재 WORK 내에서만 유효)
 
 ### WORK-LIST.md 규칙
-→ `.claude/agents/shared-prompt-sections.md` § 8 참조
+→ `{REFERENCES_DIR}/shared-prompt-sections.md` § 8 참조
 
-- WORK 생성 시: `IN_PROGRESS` 추가
+- WORK 생성 시: `IN_PROGRESS` 행 추가 + `LAST_WORK_ID` 헤더 갱신
 
 ### 파일명 규칙
 - TASK 파일명: `TASK-XX.md` 형식

package/agents/ko/verifier.md

@@ -33,12 +33,14 @@ Builder가 완료한 TASK 결과물을 검증하여 빌드, 린트, 테스트, A
 
 ### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
 
+**REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
+
 | 파일 | 목적 |
 |------|------|
-| `.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}/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 입력 파싱
 
@@ -46,7 +48,7 @@ Builder가 완료한 TASK 결과물을 검증하여 빌드, 린트, 테스트, A
 
 ### 3-3. Step 0: Progress File Gate (CRITICAL)
 
-→ Gate 조건: `file-content-schema.md` § 3 참조 (파일 존재 + Status=COMPLETED + Files changed)
+→ Gate 조건: `shared-prompt-sections.md` § 12 참조
 
 CRITICAL 실패 시 즉시 중단. 이후 Step 진행 불가.
 

package/agents/ko/xml-schema.md

@@ -8,6 +8,7 @@ uc-taskmanager 에이전트 간 XML 통신 포맷 정의.
 
 ```xml
 <dispatch to="{receiver}" work="{WORK_ID}" task="{TASK_ID}" execution-mode="{direct|pipeline|full}">
+  <references-dir>{참조 파일 디렉토리의 절대 경로}</references-dir>
   <context>
     <project>{project name}</project>
     <language>{lang_code}</language>

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

@@ -36,34 +36,23 @@ WORK (unit of work)    — Goal unit of the user's request
 
 ### 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 (PLAN.md 7 fields, TASK format) |
-| `.claude/agents/shared-prompt-sections.md` | Common rules (TASK ID, WORK-LIST rules) |
-| `.claude/agents/work-activity-log.md` | Activity Log rules (log_work function, STAGE table) |
+| `{REFERENCES_DIR}/file-content-schema.md` | File format schema (PLAN.md 7 fields, TASK format) |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | Common rules (TASK ID, WORK-LIST rules) |
+| `{REFERENCES_DIR}/work-activity-log.md` | Activity Log rules (log_work function, STAGE table) |
 
 ### 3-2. Project Exploration (Discovery Process)
 
 ```bash
 # 1. Check existing WORKs
 ls -d works/WORK-* 2>/dev/null | sort -V | tail -1
-
-# 2. Check CLAUDE.md language setting
-grep -oP '(?<=Language:\s?)[a-z]{2}' CLAUDE.md 2>/dev/null
-
-# 3. Project information
-cat CLAUDE.md 2>/dev/null || cat README.md 2>/dev/null
-
-# 4. Tech stack
-cat package.json 2>/dev/null | head -50
-cat pyproject.toml 2>/dev/null | head -30
-cat Cargo.toml 2>/dev/null | head -20
-cat go.mod 2>/dev/null | head -10
-
-# 5. Structure
-find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) | grep -v node_modules | head -30
 ```
 
+→ Discovery commands (steps 2–4): see `shared-prompt-sections.md` § 11
+
 ### 3-3. Requirement.md Analysis + WORK Directory Check
 
 Specifier has already created the WORK directory and written Requirement.md.
@@ -111,7 +100,7 @@ Record the determined mode in PLAN.md's `> Execution-Mode:` field.
 
 ### 3-6. Output Structure
 
-→ see `.claude/agents/file-content-schema.md` § 7
+→ see `{REFERENCES_DIR}/file-content-schema.md` § 7
 
 Creation responsibilities:
 - `PLAN.md`, `TASK-XX.md`, `TASK-XX_progress.md` (initial template) → Planner
@@ -121,7 +110,7 @@ Creation responsibilities:
 
 When creating TASK files, always create `TASK-XX_progress.md` template in the same directory.
 
-File formats: → `.claude/agents/file-content-schema.md` § 1 (PLAN.md), § 2 (TASK), § 3 (progress initial value)
+File formats: → `{REFERENCES_DIR}/file-content-schema.md` § 1 (PLAN.md), § 2 (TASK), § 3 (progress initial value)
 
 ### 3-7. MCP Tool Usage (Serena)
 
@@ -135,16 +124,7 @@ File formats: → `.claude/agents/file-content-schema.md` § 1 (PLAN.md), § 2 (
 ### 3-8. Output Language Rule
 
 → Priority rules: see `shared-prompt-sections.md` § 1
-
-Planner-specific locale detection:
-```
-1. CLAUDE.md → check "Language: xx"
-2. If not found, ask user for language
-3. If not found, auto-detect system locale
-   - Windows: powershell -c "[CultureInfo]::CurrentCulture.TwoLetterISOLanguageName"
-   - Linux/Mac: locale | grep LANG | grep -oP '[a-z]{2}' | head -1
-   - Fallback: "en"
-```
+→ Locale detection: see `shared-prompt-sections.md` § 9
 
 Record resolved language in PLAN.md `> Language:` field. Write all outputs in that language.
 

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

@@ -36,13 +36,15 @@ You are the **Scheduler** — the WORK pipeline execution agent.
 
 ### 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. WORK Identification and Initial Load
 
@@ -132,7 +134,7 @@ Committer FAIL retry:
 
 ### 3-9. Progress Report
 
-Update PROGRESS.md after TASK completion (→ see `.claude/agents/file-content-schema.md` § 6) and output status:
+Update PROGRESS.md after TASK completion (→ see `{REFERENCES_DIR}/file-content-schema.md` § 6) and output status:
 
 ```
 ✅ TASK-XX completed — commit: {hash}
@@ -163,8 +165,8 @@ Multi-WORK status check:
 - Bypassing pipeline results in missing result.md → WORK completion recognition failure
 
 ### WORK-LIST.md Rules
-- Do not change WORK-LIST.md to COMPLETED — changed only at git push time
-- → see `.claude/agents/shared-prompt-sections.md` § 8
+- Do not modify WORK-LIST.md — archival is handled by committer
+- → see `{REFERENCES_DIR}/shared-prompt-sections.md` § 8
 
 ### Output Language Rule
 → see `shared-prompt-sections.md` § 1

package/agents/{en/shared-prompt-sections.md → shared-prompt-sections.md}

@@ -107,7 +107,7 @@ echo "$DONE / $TOTAL"
 
 ## § 7. PLAN.md Required Meta-Information — 7 Fields
 
-→ `.claude/agents/file-content-schema.md` § 1 reference
+→ `{REFERENCES_DIR}/file-content-schema.md` § 1 reference
 
 | Field | Required | Description |
 |-------|----------|-------------|
@@ -125,17 +125,105 @@ echo "$DONE / $TOTAL"
 
 File: `works/WORK-LIST.md`
 
-| Status | Timing |
-|--------|--------|
-| `IN_PROGRESS` | Added when WORK directory is created |
-| `COMPLETED` | Automatically changed by committer when last TASK is completed |
+**Format:**
+```
+LAST_WORK_ID: WORK-XX
+
+| WORK | 제목 | 상태 | 생성일 | 완료일 |
+|------|------|------|--------|--------|
+| WORK-NN | ... | IN_PROGRESS | YYYY-MM-DD | |
+| WORK-MM | ... | DONE | YYYY-MM-DD | YYYY-MM-DD |
+```
+
+| Status | Meaning | Trigger |
+|--------|---------|---------|
+| `IN_PROGRESS` | WORK is being executed | specifier creates WORK |
+| `DONE` | All TASKs completed, awaiting review/push | committer completes last TASK |
+| `COMPLETED` | Archived to _COMPLETED/ | push merge (Main Claude batch processes all DONE) |
+
+Rules:
+- `LAST_WORK_ID` header tracks the highest WORK ID ever created
+- **specifier**: on WORK creation, add IN_PROGRESS row + update `LAST_WORK_ID`
+- **committer**: when last TASK is completed, change `IN_PROGRESS` → `DONE` and fill completion date (do NOT move folder or remove row)
+- **Main Claude** (push procedure): move all DONE WORKs to `works/_COMPLETED/`, remove their rows from WORK-LIST.md
+
+---
+
+## § 9. Locale Detection
+
+```
+1. CLAUDE.md → check "Language: xx"
+2. If not found, ask user for language
+3. If not found, auto-detect system locale
+   - Windows: powershell -c "[CultureInfo]::CurrentCulture.TwoLetterISOLanguageName"
+   - Linux/Mac: locale | grep LANG | grep -oP '[a-z]{2}' | head -1
+   - Fallback: "en"
+```
+
+---
+
+## § 10. Callback Transmission Template
+
+Replace `{CallbackType}` with the actual key name (e.g., `ProgressCallback`, `TaskCallback`).
+
+```bash
+CALLBACK_URL=$(grep "^{CallbackType}:" CLAUDE.md 2>/dev/null | sed 's/^{CallbackType}: //' | tr -d '\r')
+CALLBACK_TOKEN=$(grep "^CallbackToken:" CLAUDE.md 2>/dev/null | sed 's/^CallbackToken: //' | tr -d '\r')
+
+if [ -n "$CALLBACK_URL" ] && [ "$CALLBACK_URL" != "{CallbackType}:" ]; then
+  PAYLOAD=$(cat <<EOF
+{
+  "workId": "${WORK_ID}",
+  "taskId": "${TASK_ID}",
+  ... agent-specific fields ...
+}
+EOF
+  )
+  AUTH_HEADER=""
+  [ -n "$CALLBACK_TOKEN" ] && AUTH_HEADER="-H \"X-Runner-Api-Key: ${CALLBACK_TOKEN}\""
+  curl -s -X POST "$CALLBACK_URL" \
+    -H "Content-Type: application/json" \
+    $AUTH_HEADER \
+    -d "$PAYLOAD" > /dev/null 2>&1
+fi
+```
+
+Agent-specific payload fields:
+- **ProgressCallback** (builder): `"status": "IN_PROGRESS"`, `"currentReasoning": "..."`
+- **TaskCallback** (committer): `"status": "SUCCESS"`, `"commitHash": "${COMMIT_HASH}"`
+
+---
+
+## § 11. Project Discovery
+
+```bash
+# 1. Check CLAUDE.md language setting
+grep -oP '(?<=Language:\s?)[a-z]{2}' CLAUDE.md 2>/dev/null
+
+# 2. Tech stack
+cat package.json 2>/dev/null | head -50
+cat pyproject.toml 2>/dev/null | head -30
+cat Cargo.toml 2>/dev/null | head -20
+cat go.mod 2>/dev/null | head -10
+
+# 3. Structure (when needed)
+find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) | grep -v node_modules | head -30
+```
+
+---
+
+## § 12. Progress File Gate Check
+
+Gate conditions for `works/WORK-NN/TASK-XX_progress.md`:
+- File exists at the expected path
+- `Status: COMPLETED` line is present
+- `## Files Changed` section is present and non-empty
 
-- Must add IN_PROGRESS when WORK directory is created
-- committer: after committing the last TASK, change WORK-LIST.md from `IN_PROGRESS` to `COMPLETED`
+On gate failure → return FAIL task-result immediately. Do not proceed to subsequent steps.
 
 ---
 
 ## Version
 
 - Created: 2026-03-10
-- Updated: 2026-03-15
+- Updated: 2026-03-21