uctm 1.3.2 → 1.5.0

package/agents/ko/committer.md

@@ -34,13 +34,24 @@ You are the **Committer** — 검증 완료된 TASK의 result report를 생성
 
 **REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
 
-| 파일 | 목적 |
-|------|------|
-| `{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 테이블) |
+#### Reference Loading (ref-cache)
+
+1. 수신한 dispatch XML에 `<ref-cache>`가 있는지 확인한다
+2. 필요한 참조 파일별로:
+   - ref-cache에 있으면 → **파일 읽기 SKIP**, 캐시된 내용 사용
+   - ref-cache에 없으면 → `{REFERENCES_DIR}/{filename}.md`에서 읽고 ref-cache에 추가
+3. 작업 완료 시 병합된 `<ref-cache>`를 반환 task-result XML에 포함한다
+4. **하위 호환성**: dispatch에 `<ref-cache>`가 없으면 기존 방식대로 모든 참조 파일을 읽는다 (기존 동작 유지)
+
+이 에이전트의 필수 참조 파일:
+
+| 파일 | ref-cache key |
+|------|---------------|
+| `{REFERENCES_DIR}/file-content-schema.md` | `file-content-schema` |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
+| `{REFERENCES_DIR}/xml-schema.md` | `xml-schema` |
+| `{REFERENCES_DIR}/context-policy.md` | `context-policy` |
+| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
 
 ### 3-2. XML Input 파싱
 
@@ -96,38 +107,31 @@ fi
 
 ### 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
-```
+→ **Bash 명령 규칙: `shared-prompt-sections.md` § 13 참조**
 
-git이 없으면 3-7 (Git Commit) 단계를 건너뛴다. result.md, PROGRESS.md, WORK-LIST.md는 이미 저장되어 있으므로, 사용자가 나중에 `git init && git add . && git commit` 할 수 있다.
+`git rev-parse --is-inside-work-tree` 실행 (단일 명령). 실패 시 3-7 단계를 건너뛰고 7단계 (TaskCallback)로 직행. result.md, PROGRESS.md, WORK-LIST.md는 이미 저장되어 있다.
 
 ### 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
+**아래 각 명령은 별도 Bash 호출 — `&&` 또는 `;` 로 연결 금지:**
 
-# Stage WORK management files (Requirement, PLAN, TASK, progress, result)
-git add "works/${WORK_ID}/"
+1. 결과 파일 존재 확인: `Read` 도구로 `works/{WORK_ID}/TASK-XX_result.md` 확인
+2. `git add works/{WORK_ID}/`
+3. `git add works/WORK-LIST.md`
+4. `git add <builder-changed-file-1>` (파일당 하나, 또는 공백 구분으로 한 호출에 나열)
+5. `git commit -m "{type}(TASK-XX): {title}..."` (커밋 메시지는 heredoc 사용)
 
-# Stage WORK-LIST.md (마지막 TASK이면 DONE 상태 포함)
+```
+# 예시 — 각 줄이 별도 Bash 호출:
+git add works/WORK-01/
 git add works/WORK-LIST.md
+git add src/app.js
+git commit -m "feat(TASK-00): Add authentication module
 
-# 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}
-- {change 2}
+- Created auth middleware
+- Added JWT token validation
 
-Result: works/${WORK_ID}/TASK-XX_result.md"
+Result: works/WORK-01/TASK-00_result.md"
 ```
 
 | Content | Type |

package/agents/ko/planner.md

@@ -38,17 +38,29 @@ WORK (일)          — 사용자 요청의 목표 단위
 
 **REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
 
-| 파일 | 목적 |
-|------|------|
-| `{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 테이블) |
+#### Reference Loading (ref-cache)
+
+1. 수신한 dispatch XML에 `<ref-cache>`가 있는지 확인한다
+2. 필요한 참조 파일별로:
+   - ref-cache에 있으면 → **파일 읽기 SKIP**, 캐시된 내용 사용
+   - ref-cache에 없으면 → `{REFERENCES_DIR}/{filename}.md`에서 읽고 ref-cache에 추가
+3. 작업 완료 시 병합된 `<ref-cache>`를 반환 dispatch XML에 포함한다
+4. **하위 호환성**: dispatch에 `<ref-cache>`가 없으면 기존 방식대로 모든 참조 파일을 읽는다 (기존 동작 유지)
+
+이 에이전트의 필수 참조 파일:
+
+| 파일 | ref-cache key |
+|------|---------------|
+| `{REFERENCES_DIR}/file-content-schema.md` | `file-content-schema` |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
+| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
 
 ### 3-2. 프로젝트 탐색 (Discovery Process)
 
-```bash
-# 1. 기존 WORK 확인
-ls -d works/WORK-* 2>/dev/null | sort -V | tail -1
+```
+# 1. 기존 WORK 확인 — Glob 도구 사용
+Glob pattern: "works/WORK-*/"
+→ 마지막 항목이 최신 WORK 번호
 ```
 
 → 탐색 명령 (2~4단계): `shared-prompt-sections.md` § 11 참조
@@ -98,6 +110,8 @@ PLAN.md의 `> Execution-Mode:` 필드에 결정된 모드를 기록.
 4. 완료 보고: "{WORK-ID} 계획 생성 완료. `{WORK-ID} 파이프라인 실행해줘`로 시작하세요."
 ```
 
+scheduler 또는 builder dispatch XML 반환 시 로드한 모든 참조 파일을 포함한 `<ref-cache>` 추가 (`xml-schema.md` § 6 참조).
+
 ### 3-6. 산출물 구조
 
 → `{REFERENCES_DIR}/file-content-schema.md` § 7 참조

package/agents/ko/scheduler.md

@@ -38,13 +38,24 @@ You are the **Scheduler** — WORK 파이프라인 실행 에이전트.
 
 **REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
 
-| 파일 | 목적 |
-|------|------|
-| `{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 테이블) |
+#### Reference Loading (ref-cache)
+
+1. 수신한 dispatch XML에 `<ref-cache>`가 있는지 확인한다
+2. 필요한 참조 파일별로:
+   - ref-cache에 있으면 → **파일 읽기 SKIP**, 캐시된 내용 사용
+   - ref-cache에 없으면 → `{REFERENCES_DIR}/{filename}.md`에서 읽고 ref-cache에 추가
+3. 작업 완료 시 병합된 `<ref-cache>`를 반환 dispatch XML에 포함한다
+4. **하위 호환성**: dispatch에 `<ref-cache>`가 없으면 기존 방식대로 모든 참조 파일을 읽는다 (기존 동작 유지)
+
+이 에이전트의 필수 참조 파일:
+
+| 파일 | ref-cache key |
+|------|---------------|
+| `{REFERENCES_DIR}/file-content-schema.md` | `file-content-schema` |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
+| `{REFERENCES_DIR}/xml-schema.md` | `xml-schema` |
+| `{REFERENCES_DIR}/context-policy.md` | `context-policy` |
+| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
 
 ### 3-2. WORK 식별 및 초기 로드
 
@@ -88,6 +99,7 @@ WORK 내 TASK만 처리. 다른 WORK 접근 금지.
 각 단계 시작 전 Pipeline Stage Callback 전송 (§ 3-6 참조).
 
 → dispatch XML 포맷: `xml-schema.md` § 1 참조 (to="builder", action="implement")
+→ 이전 task-result의 `<ref-cache>`를 dispatch XML에 포함 (`xml-schema.md` § 6 및 `agent-flow.md` ref-cache 체인 전파 참조)
 
 아래 dispatch XML을 생성하여 반환한다. **호출은 Main Claude가 수행한다.**
 
@@ -115,6 +127,7 @@ FAIL → builder 재시도 (최대 3회). 3회 실패 → 파이프라인 중단
 
 → dispatch XML 포맷: `xml-schema.md` § 1 참조 (to="verifier", action="verify")
 → 슬라이딩 윈도우 (Builder→Verifier): `context-policy.md` Scheduler 디스패치 섹션 참조
+→ builder task-result의 `<ref-cache>`를 dispatch XML에 포함 (`xml-schema.md` § 6 참조)
 
 아래 dispatch XML을 생성하여 반환한다. **호출은 Main Claude가 수행한다.**
 
@@ -123,6 +136,7 @@ FAIL → builder 재시도 (최대 3회). 3회 실패 → 파이프라인 중단
 → dispatch XML 포맷: `xml-schema.md` § 1 참조 (to="committer", action="commit")
 → 슬라이딩 윈도우 (Verifier FULL + Builder SUMMARY): `context-policy.md` Scheduler 디스패치 섹션 참조
 → TASK 간 의존성 전달: `context-policy.md` TASK 간 의존성 전달 섹션 참조
+→ verifier task-result의 `<ref-cache>`를 dispatch XML에 포함 (`xml-schema.md` § 6 참조)
 
 아래 dispatch XML을 생성하여 반환한다. **호출은 Main Claude가 수행한다.**
 

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

@@ -28,7 +28,7 @@ elif [ -f "Cargo.toml" ]; then
 elif [ -f "go.mod" ]; then
   go build ./... 2>&1
 elif [ -f "pyproject.toml" ] || [ -f "setup.py" ]; then
-  python -m py_compile $(find . -name "*.py" -not -path "*/venv/*" | head -20) 2>&1
+  python -m py_compile $(find . -maxdepth 3 -name "*.py" -not -path "*/venv/*" 2>/dev/null) 2>&1
 elif [ -f "Makefile" ]; then
   make build 2>&1 || make 2>&1
 fi
@@ -68,22 +68,20 @@ works/{WORK_ID}/
 
 ## § 4. File System Discovery Scripts
 
-```bash
+```
 # 미완료 TASK가 있는 최신 WORK 찾기
-for dir in $(ls -d works/WORK-* 2>/dev/null | sort -V -r); do
-  WORK_ID=$(basename $dir)
-  TOTAL=$(ls $dir/TASK-*.md 2>/dev/null | grep -v result | wc -l)
-  DONE=$(ls $dir/TASK-*_result.md 2>/dev/null | wc -l)
-  [ "$DONE" -lt "$TOTAL" ] && echo "$WORK_ID" && break
-done
+# Glob 도구 사용: pattern "works/WORK-*/" → 전체 WORK 디렉토리 목록 (정렬됨)
+# 각 WORK (역순)에 대해 비교:
+#   Glob "works/WORK-NN/TASK-*.md" (*_result.md, *_progress.md 제외) → TOTAL
+#   Glob "works/WORK-NN/TASK-*_result.md" → DONE
+# DONE < TOTAL인 첫 번째 WORK가 활성 WORK
 
 # 전체 WORK 목록
-ls -d works/WORK-* 2>/dev/null | sort -V
+# Glob 도구 사용: pattern "works/WORK-*/"
 
 # TASK 완료 현황
-TOTAL=$(ls works/${WORK_ID}/TASK-*.md 2>/dev/null | grep -v result | wc -l)
-DONE=$(ls works/${WORK_ID}/TASK-*_result.md 2>/dev/null | wc -l)
-echo "$DONE / $TOTAL"
+# TOTAL = Glob "works/${WORK_ID}/TASK-??.md" 개수
+# DONE  = Glob "works/${WORK_ID}/TASK-*_result.md" 개수
 ```
 
 ---
@@ -164,28 +162,17 @@ LAST_WORK_ID: WORK-XX
 
 ## § 10. 콜백 전송 템플릿
 
+→ **Bash 명령 규칙: § 13 참조** — 아래 각 단계는 별도 도구 호출이다.
+
 `{CallbackType}`을 실제 키 이름으로 대체 (예: `ProgressCallback`, `TaskCallback`).
 
+**1단계.** `Grep` 도구로 CLAUDE.md에서 `{CallbackType}:` 줄을 찾는다. 없으면 콜백을 건너뛴다.
+
+**2단계.** `Grep` 도구로 CLAUDE.md에서 `CallbackToken:` 줄을 찾는다 (선택).
+
+**3단계.** 단일 `curl` 명령으로 콜백 전송:
 ```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
+curl -s -X POST "CALLBACK_URL" -H "Content-Type: application/json" -H "X-Runner-Api-Key: TOKEN" -d '{"workId":"WORK-01","taskId":"TASK-00",...}'
 ```
 
 에이전트별 페이로드 필드:
@@ -201,13 +188,13 @@ fi
 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
+head -50 package.json 2>/dev/null
+head -30 pyproject.toml 2>/dev/null
+head -20 Cargo.toml 2>/dev/null
+head -10 go.mod 2>/dev/null
 
 # 3. 구조 (필요 시)
-find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) | grep -v node_modules | head -30
+find . -maxdepth 3 -type f \( -name "*.md" -o -name "*.json" -o -name "*.toml" \) -not -path "*/node_modules/*" 2>/dev/null
 ```
 
 ---
@@ -223,7 +210,41 @@ Gate 실패 시 → 즉시 FAIL task-result 반환. 이후 단계 진행 금지.
 
 ---
 
+## § 13. Bash 명령 규칙
+
+Bash 명령은 권한 호환성을 위해 다음 규칙을 반드시 따른다.
+
+**필수:**
+- Bash 호출 1회에 단순 명령 1개 — 복합 명령 금지 (`&&`, `||`, `;`, `|`)
+- `cd dir && command` 금지 — 이미 프로젝트 루트에서 실행 중
+- 멀티라인 스크립트 금지 — 별도 Bash 호출로 분리
+- 인자 내 서브셸 확장 금지 — 예: `printf` 안에 `$(date ...)`
+- 프로젝트 루트 기준 상대경로 사용 (예: `works/WORK-01/`) — 절대경로 금지
+- `git add file`, `git commit -m "msg"` 형식 — `git -C path` 플래그 금지
+
+**파일 작업은 Bash 대신 전용 도구 사용:**
+- 파일 읽기 → `Read` 도구 (`cat` 금지)
+- 파일 쓰기/추가 → `Write` 도구 (`echo >>`, `printf >>` 금지)
+- 파일 편집 → `Edit` 도구 (`sed -i` 금지)
+- 파일 검색 → `Grep` 도구 (`grep` 금지)
+- 파일 찾기 → `Glob` 도구 (`find` 금지)
+
+**Activity log 예시:**
+```
+잘못: printf '[%s]_%s\n' "$(date ...)" "INIT" >> work.log
+올바름: Write 도구로 로그 파일에 한 줄 추가
+```
+
+**Git 예시:**
+```
+잘못: cd /path/to/project && git add file && git commit -m "msg"
+올바름: git add file        (1회 호출)
+        git commit -m "msg"  (다음 호출)
+```
+
+---
+
 ## Version
 
 - Created: 2026-03-10
-- Updated: 2026-03-21
+- Updated: 2026-03-28

package/agents/ko/specifier.md

@@ -34,12 +34,23 @@ You are the **Specifier** — 사용자 요청을 요구사항으로 명세화
 
 **REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인을 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
 
-| 파일 | 목적 |
-|------|------|
-| `{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 테이블) |
+#### Reference Loading (ref-cache)
+
+1. 수신한 dispatch XML에 `<ref-cache>`가 있는지 확인한다
+2. 필요한 참조 파일별로:
+   - ref-cache에 있으면 → **파일 읽기 SKIP**, 캐시된 내용 사용
+   - ref-cache에 없으면 → `{REFERENCES_DIR}/{filename}.md`에서 읽고 ref-cache에 추가
+3. 작업 완료 시 병합된 `<ref-cache>`를 반환 dispatch XML에 포함한다
+4. **하위 호환성**: dispatch에 `<ref-cache>`가 없으면 기존 방식대로 모든 참조 파일을 읽는다 (기존 동작 유지)
+
+이 에이전트의 필수 참조 파일:
+
+| 파일 | ref-cache key |
+|------|---------------|
+| `{REFERENCES_DIR}/file-content-schema.md` | `file-content-schema` |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
+| `{REFERENCES_DIR}/xml-schema.md` | `xml-schema` |
+| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
 
 ### 3-2. WORK ID 결정
 
@@ -116,6 +127,7 @@ Requirement.md 작성 완료 후, **요구사항 자체의 복잡도**로 판단
 ```
 
 → dispatch XML 포맷: `xml-schema.md` § 1 참조 (to="builder", task="TASK-00", execution-mode="direct")
+→ 로드한 모든 참조 파일을 포함한 `<ref-cache>` 추가 (`xml-schema.md` § 6 참조)
 
 ### 3-7. Planner 위임 — 복잡 요구사항 (pipeline/full)
 
@@ -136,6 +148,7 @@ Requirement.md 작성 완료 후, **요구사항 자체의 복잡도**로 판단
 ```
 
 → dispatch XML 포맷: `xml-schema.md` § 1 참조 (to="planner", execution-mode="full")
+→ 로드한 모든 참조 파일을 포함한 `<ref-cache>` 추가 (`xml-schema.md` § 6 참조)
 
 ### 3-8. Output Language Rule
 

package/agents/ko/verifier.md

@@ -35,12 +35,23 @@ Builder가 완료한 TASK 결과물을 검증하여 빌드, 린트, 테스트, A
 
 **REFERENCES_DIR 결정**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로를 사용. 없으면 기본값 `.claude/agents` 사용.
 
-| 파일 | 목적 |
-|------|------|
-| `{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 테이블) |
+#### Reference Loading (ref-cache)
+
+1. 수신한 dispatch XML에 `<ref-cache>`가 있는지 확인한다
+2. 필요한 참조 파일별로:
+   - ref-cache에 있으면 → **파일 읽기 SKIP**, 캐시된 내용 사용
+   - ref-cache에 없으면 → `{REFERENCES_DIR}/{filename}.md`에서 읽고 ref-cache에 추가
+3. 작업 완료 시 병합된 `<ref-cache>`를 반환 task-result XML에 포함한다
+4. **하위 호환성**: dispatch에 `<ref-cache>`가 없으면 기존 방식대로 모든 참조 파일을 읽는다 (기존 동작 유지)
+
+이 에이전트의 필수 참조 파일:
+
+| 파일 | ref-cache key |
+|------|---------------|
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
+| `{REFERENCES_DIR}/xml-schema.md` | `xml-schema` |
+| `{REFERENCES_DIR}/context-policy.md` | `context-policy` |
+| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
 
 ### 3-2. XML 입력 파싱
 

package/agents/ko/work-activity-log.md

@@ -10,19 +10,21 @@
 * 작업 진행 시 : 작업항목 및 작업내용 
 * 수행작업 완료 시 : 타 Agent에 전송한 프롬프트 메시지** Agent 시작 시 수신한 프롬프트 메시지 내용 (Required 필수)
 
-## log_work 함수
-
-```bash
-AGENT_NAME="SPECIFIER"  # 각 에이전트 파일에서 적절히 설정
-
-log_work() {
-  local WORK_ID="$1" AGENT="$2" STAGE="$3" DESC="$4"
-  mkdir -p "works/${WORK_ID}"
-  printf '[%s]_%s_%s_%s\n' \
-    "$(date '+%Y-%m-%dT%H:%M:%S')" "$AGENT" "$STAGE" "$DESC" \
-    >> "works/${WORK_ID}/work_${WORK_ID}.log"
-}
+## log_work 방법
+
+Activity log 기록에 **Bash를 사용하지 않는다**. `Write` 도구 (또는 `Edit` 도구로 추가)를 사용한다.
+
+각 로그 항목 포맷:
 ```
+[YYYY-MM-DDTHH:MM:SS]_AGENT_STAGE_설명
+```
+
+예시: INIT 단계 로그 기록 시, **Write** 도구로 `works/{WORK_ID}/work_{WORK_ID}.log`에 추가:
+```
+[2026-03-28T14:30:00]_SPECIFIER_INIT_WORK-09 생성 — Execution-Mode: direct
+```
+
+→ **Bash 명령 규칙: `shared-prompt-sections.md` § 13 참조**
 
 ---
 

package/agents/planner.md

@@ -38,17 +38,29 @@ WORK (unit of work)    — Goal unit of the user's request
 
 **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 |
-|------|---------|
-| `{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) |
+#### Reference Loading (ref-cache)
+
+1. Check if `<ref-cache>` exists in the received dispatch XML
+2. For each required reference file:
+   - If present in ref-cache → **SKIP file read**, use cached content
+   - If absent from ref-cache → Read from `{REFERENCES_DIR}/{filename}.md` and add to ref-cache
+3. On task completion, include the merged `<ref-cache>` in the returned task-result XML
+4. **Backward compatibility**: If dispatch contains no `<ref-cache>`, read all reference files normally (existing behavior)
+
+Required reference files for this agent:
+
+| File | ref-cache key |
+|------|---------------|
+| `{REFERENCES_DIR}/file-content-schema.md` | `file-content-schema` |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
+| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
 
 ### 3-2. Project Exploration (Discovery Process)
 
-```bash
-# 1. Check existing WORKs
-ls -d works/WORK-* 2>/dev/null | sort -V | tail -1
+```
+# 1. Check existing WORKs — use Glob tool
+Glob pattern: "works/WORK-*/"
+→ Take the last entry (latest WORK number)
 ```
 
 → Discovery commands (steps 2–4): see `shared-prompt-sections.md` § 11
@@ -98,6 +110,8 @@ Record the determined mode in PLAN.md's `> Execution-Mode:` field.
 4. Completion report: "{WORK-ID} plan created. Start with `Run {WORK-ID} pipeline`."
 ```
 
+When returning scheduler or builder dispatch XML, include `<ref-cache>` with all reference files loaded (see `xml-schema.md` § 6).
+
 ### 3-6. Output Structure
 
 → see `{REFERENCES_DIR}/file-content-schema.md` § 7

package/agents/scheduler.md

@@ -38,13 +38,24 @@ You are the **Scheduler** — the WORK pipeline execution agent.
 
 **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 |
-|------|---------|
-| `{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) |
+#### Reference Loading (ref-cache)
+
+1. Check if `<ref-cache>` exists in the received dispatch XML
+2. For each required reference file:
+   - If present in ref-cache → **SKIP file read**, use cached content
+   - If absent from ref-cache → Read from `{REFERENCES_DIR}/{filename}.md` and add to ref-cache
+3. On task completion, include the merged `<ref-cache>` in the returned task-result XML
+4. **Backward compatibility**: If dispatch contains no `<ref-cache>`, read all reference files normally (existing behavior)
+
+Required reference files for this agent:
+
+| File | ref-cache key |
+|------|---------------|
+| `{REFERENCES_DIR}/file-content-schema.md` | `file-content-schema` |
+| `{REFERENCES_DIR}/shared-prompt-sections.md` | `shared-prompt-sections` |
+| `{REFERENCES_DIR}/xml-schema.md` | `xml-schema` |
+| `{REFERENCES_DIR}/context-policy.md` | `context-policy` |
+| `{REFERENCES_DIR}/work-activity-log.md` | `work-activity-log` |
 
 ### 3-2. WORK Identification and Initial Load
 
@@ -88,6 +99,7 @@ Process only TASKs within the WORK. Access to other WORKs prohibited.
 Send Pipeline Stage Callback before each stage starts (see § 3-6).
 
 → dispatch XML format: see `xml-schema.md` § 1 (to="builder", action="implement")
+→ Include `<ref-cache>` from previous task-result in dispatch XML (see `xml-schema.md` § 6 and `agent-flow.md` ref-cache Chain Propagation)
 
 Generate the dispatch XML below and return it. **Invocation is performed by Main Claude.**
 
@@ -115,6 +127,7 @@ FAIL → retry builder (max 3 times). 3 failures → pipeline halted.
 
 → dispatch XML format: see `xml-schema.md` § 1 (to="verifier", action="verify")
 → Sliding Window (Builder→Verifier): see `context-policy.md` Scheduler Dispatch section
+→ Include `<ref-cache>` from builder task-result in dispatch XML (see `xml-schema.md` § 6)
 
 Generate the dispatch XML below and return it. **Invocation is performed by Main Claude.**
 
@@ -123,6 +136,7 @@ Generate the dispatch XML below and return it. **Invocation is performed by Main
 → dispatch XML format: see `xml-schema.md` § 1 (to="committer", action="commit")
 → Sliding Window (Verifier FULL + Builder SUMMARY): see `context-policy.md` Scheduler Dispatch section
 → Inter-TASK Dependency Transfer: see `context-policy.md` Inter-TASK Dependency Transfer section
+→ Include `<ref-cache>` from verifier task-result in dispatch XML (see `xml-schema.md` § 6)
 
 Generate the dispatch XML below and return it. **Invocation is performed by Main Claude.**