uctm 1.5.1 → 1.5.2

package/.claude-plugin/plugin.json

@@ -9,6 +9,12 @@
     "./agents/verifier.md",
     "./agents/committer.md"
   ],
+  "skills": [
+    "./skills/init",
+    "./skills/work-pipeline",
+    "./skills/work-status",
+    "./skills/sdd-pipeline"
+  ],
   "description": "SDD WORK-PIPELINE Agent — Requirements analysis & development 6-agent full pipeline with DAG-based orchestration and sliding window context management",
   "author": {
     "name": "UCJung",

package/README.md

@@ -315,7 +315,7 @@ This ensures Claude automatically delegates `[]`-tagged requests to the specifie
 
 ## Installation
 
-### npm CLI — v1.5.0
+### npm CLI
 
 ```bash
 npm install -g uctm
@@ -338,7 +338,7 @@ uctm update --lang en
 ```bash
 git clone https://github.com/UCJung/uc-taskmanager-claude-agent.git /tmp/uc-tm
 mkdir -p .claude/agents
-cp /tmp/uc-tm/agents/en/*.md .claude/agents/   # or agents/ko/ for Korean
+cp /tmp/uc-tm/npm/agents/*.md .claude/agents/
 rm -rf /tmp/uc-tm
 git add .claude/agents/ && git commit -m "chore: add uc-taskmanager agents"
 ```
@@ -486,7 +486,7 @@ Six agents work together in a clean, isolated pipeline:
 ### Support Files (included in Plugin)
 
 In addition to the 6 pipeline agents, the plugin includes 6 support files that agents reference at startup.
-These are located in `plugin/skills/sdd-pipeline/references/` (synced from `agents/en/`):
+These are located in `plugin/skills/sdd-pipeline/references/` (synced from `develop/references/`):
 
 | File | Purpose |
 |------|---------|
@@ -550,7 +550,7 @@ The specifier maintains `works/WORK-LIST.md` as the master index:
 When you ask Claude to push (`"push this"`, `"git push"`), Claude handles the full sequence automatically:
 
 ```
-1. Agent sync — copy agents/ source to npm/agents/ and plugin/agents/
+1. Agent sync — copy develop/ source to npm/ and plugin/
 2. DONE WORK batch completion — remove DONE rows from WORK-LIST, move folders to _COMPLETED/
 3. Check README.md — update if changes are missing
 4. git push
@@ -993,24 +993,25 @@ Auto-detected from project files. No configuration needed.
 
 ```
 uc-taskmanager/
-├── agents/                  ← Agent source (edit here — authoritative)
-│   ├── en/                  ← English agent prompts (12 files)
+├── develop/                 ← Source of truth (edit here)
+│   ├── agents/              ← 6 agent prompts (language-agnostic)
 │   │   ├── specifier.md     ← [] tag detection + execution-mode routing
 │   │   ├── planner.md       ← WORK creation + TASK decomposition
 │   │   ├── scheduler.md     ← DAG management + pipeline orchestration
 │   │   ├── builder.md       ← Code implementation
 │   │   ├── verifier.md      ← Build/lint/test verification
-│   │   ├── committer.md     ← git commit + result.md
+│   │   └── committer.md     ← git commit + result.md
+│   ├── references/          ← 6 support files (shared across agents)
 │   │   ├── agent-flow.md    ← Pipeline orchestration rules
 │   │   ├── file-content-schema.md  ← File format definitions
 │   │   ├── shared-prompt-sections.md  ← Cacheable shared sections
 │   │   ├── context-policy.md    ← Sliding window context rules
 │   │   ├── work-activity-log.md ← Activity log format
 │   │   └── xml-schema.md    ← XML communication format
-│   └── ko/                  ← Korean agent prompts (12 files)
+│   ├── skills/              ← Skill definitions
+│   └── hooks/               ← Hook scripts
 ├── npm/                     ← npm package (published as `uctm`)
-│   ├── agents/              ← Synced from agents/en/ (+ ko/ subfolder)
-│   │   └── ko/              ← Synced from agents/ko/
+│   ├── agents/              ← Synced from develop/agents/ + develop/references/
 │   ├── bin/cli.mjs          ← CLI entry point (uctm init/update)
 │   ├── lib/                 ← CLI implementation (constants.mjs, init.mjs, update.mjs)
 │   ├── .agent/              ← Default router config bundled with npm
@@ -1018,12 +1019,13 @@ uc-taskmanager/
 │   ├── package.json         ← npm package config
 │   ├── .npmignore
 │   └── LICENSE
-├── plugin/                  ← Claude Plugin (local testing)
-│   ├── agents/              ← Synced from agents/en/ (6 core agents)
-│   ├── skills/              ← Plugin skills (reference docs)
+├── plugin/                  ← Claude Plugin (Marketplace)
+│   ├── agents/              ← Synced from develop/agents/
+│   ├── references/          ← Synced from develop/references/
+│   ├── skills/              ← Plugin skills
 │   │   ├── sdd-pipeline/
 │   │   │   ├── SKILL.md     ← Skill manifest
-│   │   │   └── references/  ← Synced from agents/en/ (6 support files)
+│   │   │   └── references/  ← Synced from develop/references/
 │   │   ├── work-pipeline/
 │   │   │   └── SKILL.md
 │   │   ├── work-status/

package/agents/builder.md

@@ -22,10 +22,9 @@ You are the **Builder** — the implementation agent that receives a TASK specif
 | Code Exploration | Use Serena MCP first for minimal-scope reads |
 | Implementation | Create/modify/delete files → follow project conventions |
 | Self-Check | Verify build + lint pass; fix and re-run on failure |
-| Progress Recording | Update TASK-XX_progress.md in real-time (STARTED → IN_PROGRESS → COMPLETED) |
-| ProgressCallback | Send external callback at each checkpoint |
 | Result Return | Return task-result XML (including context-handoff) |
-| Activity Log | Record each stage in `work_{WORK_ID}.log` |
+| Callback (CE7) | Send START/DONE events to server (REQ-ID required) |
+| Activity Log | Record start/end to `work_{WORK_ID}.log` |
 
 ---
 
@@ -33,26 +32,18 @@ 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`.
+**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/references`.
 
-#### Reference Loading (ref-cache)
+#### Reference Loading
 
-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)
+Read the following from `{REFERENCES_DIR}/`: `file-content-schema.md`, `shared-prompt-sections.md`, `xml-schema.md`, `context-policy.md`, `work-activity-log.md`
 
-Required reference files for this agent:
+### 3-1-1. Callback START + Activity Log START
 
-| 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` |
+→ see `shared-prompt-sections.md` § 10
+
+- Activity Log: append `[timestamp] BUILDER_START — TASK-XX` to `work_{WORK_ID}.log`
+- Callback: Read `works/{WORK_ID}/TASK-NN.md` content, then send CE7 `{"stage":"BUILDER","event":"START","workId":"...","taskId":"...","docs":{"taskContent":"<actual TASK-NN.md content>"}}` (only if CALLBACK_URL available). Must include the **actual file content**, not a reference.
 
 ### 3-2. XML Input Parsing
 
@@ -65,8 +56,8 @@ Required reference files for this agent:
 
 ### 3-3. Pre-Implementation Context Collection
 
-```bash
-ls works/${WORK_ID}/*_result.md 2>/dev/null
+```
+Use Glob tool: pattern "works/${WORK_ID}/*_result.md"
 ```
 
 **Serena Code Exploration Priority:**
@@ -99,34 +90,12 @@ ls works/${WORK_ID}/*_result.md 2>/dev/null
 - If build/lint scripts do not exist, treat that check as **N/A** (do not attempt to fix).
 - On build/lint failure, attempt to fix before reporting. **Maximum 2 retries**.
 - If still failing on 3rd attempt → return task-result XML with `status="FAIL"` and exit. No infinite loops.
+- After self-check passes, update TASK file Acceptance Criteria checkboxes (`[ ]` → `[x]`) for completed items.
 
-### 3-6. Progress Checkpoint Recording
-
-Update `works/{WORK_ID}/TASK-XX_progress.md` in real-time:
-
-- Immediately after starting → `Status: STARTED`
-- During file changes → `Status: IN_PROGRESS` (add Files changed list)
-- After completion → `Status: COMPLETED`
-
-**Resumption on Retry:**
-
-1. Read existing progress.md → identify completed files
-2. Resume from last checkpoint
-3. Update progress.md (Status = COMPLETED)
-
-### 3-7. ProgressCallback Transmission
-
-→ 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.
-
-### 3-8. Context-Handoff Output Return
+### 3-6. Context-Handoff Output Return
 
 → task-result XML base structure: see `xml-schema.md` § 2
-→ context-handoff element: see `xml-schema.md` § 4
-→ ref-cache element: see `xml-schema.md` § 6
+→ context-handoff element: see `xml-schema.md` § 3
 
 Builder-specific additional fields:
 
@@ -136,15 +105,16 @@ Builder-specific additional fields:
   <check name="lint" status="PASS" />
 </self-check>
 <notes>{items for verifier to check}</notes>
-<ref-cache>
-  <!-- Include all reference files loaded during this execution (from disk or received ref-cache) -->
-  <ref key="shared-prompt-sections">{content}</ref>
-  <ref key="xml-schema">{content}</ref>
-  <!-- ... other keys loaded ... -->
-</ref-cache>
 ```
 
-### 3-9. Retry Protocol
+### 3-9. Callback DONE + Activity Log DONE
+
+→ see `shared-prompt-sections.md` § 10
+
+- Activity Log: append `[timestamp] BUILDER_DONE — TASK-XX` to `work_{WORK_ID}.log`
+- Callback: send CE7 `{"stage":"BUILDER","event":"DONE","workId":"...","taskId":"..."}` (only if CALLBACK_URL available)
+
+### 3-10. Retry Protocol
 
 1. Read failure details
 2. Fix only the affected part
@@ -155,17 +125,16 @@ Builder-specific additional fields:
 
 ## 4. Constraints and Prohibitions
 
+### Output Rules
+- Return **only** the task-result XML. Do NOT add summary text, explanations, or descriptions before or after the XML.
+- Keep the return as concise as possible to minimize output time.
+
 ### Implementation Prohibitions
 - NEVER skip self-check
 - NEVER modify tests to make them pass
 - NEVER change task scope
 - NEVER overwrite files without reading first
-- ALWAYS return XML task-result format
 
 ### Output Language Rule
 → see `shared-prompt-sections.md` § 1
-
-Builder-specific rules:
-- Code comments: resolved language (overridable via `CommentLanguage:` in CLAUDE.md)
-- If existing code has comments in a specific language, follow that language
-- File names, paths, commands → always English
+- Code comments: follow existing language; overridable via `CommentLanguage:` in CLAUDE.md

package/agents/committer.md

@@ -9,8 +9,8 @@ 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 → WORK-LIST check → git commit → send TaskCallback
+- Generate result.md from builder's work
+- WORK-LIST check → git commit
 
 ---
 
@@ -18,13 +18,12 @@ You are the **Committer** — the agent that generates the result report for a v
 
 | Duty | Description |
 |------|-------------|
-| 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 |
+| Last TASK Check | Check if current TASK is the last one → update WORK-LIST.md |
 | 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` |
+| Callback (CE7) | Send START/DONE events + TASK-NN_result.md to server (REQ-ID required) |
+| Activity Log | Record start/end to `work_{WORK_ID}.log` |
 
 ---
 
@@ -32,26 +31,18 @@ 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`.
+**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/references`.
 
-#### Reference Loading (ref-cache)
+#### Reference Loading
 
-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)
+Read the following from `{REFERENCES_DIR}/`: `file-content-schema.md`, `shared-prompt-sections.md`, `xml-schema.md`, `context-policy.md`, `work-activity-log.md`
 
-Required reference files for this agent:
+### 3-1-1. Callback START + Activity Log START
 
-| 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` |
+→ see `shared-prompt-sections.md` § 10
+
+- Activity Log: append `[timestamp] COMMITTER_START — TASK-XX` to `work_{WORK_ID}.log`
+- Callback: send CE7 `{"stage":"COMMITTER","event":"START","workId":"...","taskId":"..."}` (only if CALLBACK_URL available)
 
 ### 3-2. XML Input Parsing
 
@@ -60,24 +51,14 @@ Required reference files for this agent:
 Execution order:
 
 ```
-1. progress.md gate check
-2. Create result.md    → works/{WORK_ID}/TASK-XX_result.md
-3. Update PROGRESS.md
-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
+1. Create result.md    → works/{WORK_ID}/TASK-XX_result.md
+2. If last TASK → update WORK-LIST.md (IN_PROGRESS → DONE)
+3. Git check → if no git repo, skip step 4, output warning
+4. git add works/{WORK_ID}/ + builder-changed files && git commit
+5. Report result
 ```
 
-### 3-3. Gate Check
-
-→ 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
+### 3-3. Result Report Generation
 
 → see `{REFERENCES_DIR}/file-content-schema.md` § 4 (format + language-specific section headers)
 
@@ -85,33 +66,26 @@ Create `works/{WORK_ID}/TASK-XX_result.md`.
 - builder context-handoff `what` → "Builder Context" section
 - verifier context-handoff 4 fields → "Verifier Context" section
 
-### 3-5. PROGRESS.md Update
+### 3-4. WORK Status Update (Last TASK)
 
-Current TASK → ✅ Done, add timestamp, check unblocked TASKs.
+Check if this is the last TASK by reading activity log. If so, update WORK-LIST.md **before** 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
+```
+Read PLAN.md → count total TASKs
+Read work_${WORK_ID}.log → count lines matching "COMMITTER_DONE"
+If COMMITTER_DONE count + 1 (current) >= total TASKs:
+  Change IN_PROGRESS → DONE in WORK-LIST.md (do NOT remove row or move folder)
 ```
 
 → see `{REFERENCES_DIR}/shared-prompt-sections.md` § 8
 
-### 3-6. Git Check
+### 3-5. Git Check
 
 → **Bash command rules: see `shared-prompt-sections.md` § 13**
 
-Run `git rev-parse --is-inside-work-tree` (single command). If it fails, skip steps 3-7 and jump to step 7 (TaskCallback). The result.md, PROGRESS.md, and WORK-LIST.md are already saved.
+Run `git rev-parse --is-inside-work-tree` (single command). If it fails, skip git commit and jump to result report. The result.md and WORK-LIST.md are already saved.
 
-### 3-7. Git Commit
+### 3-6. Git Commit
 
 **Each command below is a separate Bash call — do NOT chain with `&&` or `;`:**
 
@@ -143,16 +117,9 @@ Result: works/WORK-01/TASK-00_result.md"
 | Documentation | `docs` |
 | Refactoring | `refactor` |
 
-### 3-8. TaskCallback Transmission
-
-→ 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
+### 3-7. Result Report
 
 → task-result XML base structure: see `xml-schema.md` § 2
-→ ref-cache element: see `xml-schema.md` § 6
 
 Committer-specific additional fields:
 
@@ -170,20 +137,25 @@ Committer-specific additional fields:
 <next-tasks>
   <task id="TASK-YY" status="READY">{title}</task>
 </next-tasks>
-<ref-cache>
-  <!-- Include all reference files loaded during this execution (from disk or received ref-cache) -->
-  <ref key="shared-prompt-sections">{content}</ref>
-  <ref key="xml-schema">{content}</ref>
-  <!-- ... other keys loaded ... -->
-</ref-cache>
 ```
 
 → see `{REFERENCES_DIR}/shared-prompt-sections.md` § 8
 
+### 3-8. Callback DONE + Activity Log DONE
+
+→ see `shared-prompt-sections.md` § 10
+
+- Activity Log: append `[timestamp] COMMITTER_DONE — TASK-XX` to `work_{WORK_ID}.log`
+- Callback: Read `works/{WORK_ID}/TASK-NN_result.md` content, then send CE7 `{"stage":"COMMITTER","event":"DONE","workId":"...","taskId":"...","docs":{"resultContent":"<actual file content>"}}` (only if CALLBACK_URL available). Must include the **actual file content**, not a reference.
+
 ---
 
 ## 4. Constraints and Prohibitions
 
+### Output Rules
+- Return **only** the task-result XML. Do NOT add summary text, explanations, or descriptions before or after the XML.
+- Keep the return as concise as possible to minimize output time.
+
 ### Execution Order Constraints
 - ALWAYS create result report BEFORE git commit
 - NEVER commit without result file
@@ -191,7 +163,6 @@ Committer-specific additional fields:
 - 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
 - If Status is not COMPLETED → immediately return FAIL
 - If Files changed is empty → immediately return FAIL
 
@@ -200,9 +171,6 @@ Committer-specific additional fields:
 
 ### Output Language Rule
 → see `shared-prompt-sections.md` § 1
-
-Committer-specific rules:
-- Section headers (##) are also written in the resolved language (see § 4 language mapping)
 - Git commit type prefix (`feat`, `fix`, etc.) → always English
 
 ### Report Format

package/agents/planner.md

@@ -1,6 +1,6 @@
 ---
 name: planner
-description: Agent that analyzes projects to create WORK (unit of work) and decompose sub-TASKs. Must be used for requests like "plan this", "decompose TASKs", "build XXX", "add XXX feature". Reads CLAUDE.md, README, and source code to create WORK and derive sub-TASKs.
+description: Agent that analyzes projects to create WORK (unit of work) and decompose sub-TASKs. Reads CLAUDE.md, README, and source code to create WORK and derive sub-TASKs.
 tools: Read, Glob, Grep, Bash, mcp__serena__*, mcp__sequential-thinking__sequentialthinking
 model: opus
 ---
@@ -26,9 +26,10 @@ WORK (unit of work)    — Goal unit of the user's request
 | Project Exploration | Analyze CLAUDE.md, README, package.json, directory structure, codebase |
 | Execution-Mode Determination | Determine pipeline/full based on TASK count |
 | TASK Decomposition | Decompose WORK goal into TASK list in dependency DAG form |
-| File Generation | Create PLAN.md, TASK-XX.md, TASK-XX_progress.md under `works/{WORK-ID}/` |
+| File Generation | Create PLAN.md, TASK-XX.md under `works/{WORK-ID}/` |
 | User Approval | Present plan and receive approval; generate files after approval |
-| Activity Log | Record each stage in `work_{WORK_ID}.log` |
+| Callback (CE7) | Send START/DONE events + PLAN.md to server (REQ-ID required) |
+| Activity Log | Record start/end to `work_{WORK_ID}.log` |
 
 ---
 
@@ -36,24 +37,18 @@ 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`.
+**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/references`.
 
-#### Reference Loading (ref-cache)
+#### Reference Loading
 
-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)
+Read the following from `{REFERENCES_DIR}/`: `file-content-schema.md`, `shared-prompt-sections.md`, `work-activity-log.md`
 
-Required reference files for this agent:
+### 3-1-1. Callback START + Activity Log START
 
-| 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` |
+→ see `shared-prompt-sections.md` § 10
+
+- Activity Log: append `[timestamp] PLANNER_START` to `work_{WORK_ID}.log`
+- Callback: send CE7 `{"stage":"PLANNER","event":"START","workId":"..."}` (only if CALLBACK_URL available)
 
 ### 3-2. Project Exploration (Discovery Process)
 
@@ -70,10 +65,10 @@ Glob pattern: "works/WORK-*/"
 Specifier has already created the WORK directory and written Requirement.md.
 Check the WORK ID from the dispatch XML's `work` attribute, and read Requirement.md from that directory.
 
-```bash
+```
 # Check WORK ID from dispatch XML
 WORK_ID="WORK-NN"  # work attribute from dispatch XML
-cat "works/${WORK_ID}/Requirement.md"
+Use Read tool: "works/${WORK_ID}/Requirement.md"
 ```
 
 ### 3-4. TASK Decomposition
@@ -110,21 +105,17 @@ 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
 
 Creation responsibilities:
-- `PLAN.md`, `TASK-XX.md`, `TASK-XX_progress.md` (initial template) → Planner
-- `PROGRESS.md` → Scheduler
-- `TASK-XX_progress.md` (updates) → Builder
+- `PLAN.md`, `TASK-XX.md` → Planner
 - `TASK-XX_result.md` → Committer
+- `work_WORK-NN.log` → All agents (append)
 
-When creating TASK files, always create `TASK-XX_progress.md` template in the same directory.
-
-File formats: → `{REFERENCES_DIR}/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-7. MCP Tool Usage (Serena)
 
@@ -136,21 +127,29 @@ File formats: → `{REFERENCES_DIR}/file-content-schema.md` § 1 (PLAN.md), § 2
 | 4 | `mcp__serena__search_for_pattern` | Pattern location |
 
 ### 3-8. Output Language Rule
-
-→ Priority rules: see `shared-prompt-sections.md` § 1
-→ Locale detection: see `shared-prompt-sections.md` § 9
-
-Record resolved language in PLAN.md `> Language:` field. Write all outputs in that language.
+→ see `shared-prompt-sections.md` § 1, § 9
+- Record resolved language in PLAN.md `> Language:` field
 
 ### 3-9. Requirement Recording
 
 Record Requirement.md path in PLAN.md `> Requirement:` field:
 - `> Requirement: works/WORK-NN/Requirement.md`
 
+### 3-10. Callback DONE + Activity Log DONE
+
+→ see `shared-prompt-sections.md` § 10
+
+- Activity Log: append `[timestamp] PLANNER_DONE` to `work_{WORK_ID}.log`
+- Callback: Read `works/{WORK_ID}/PLAN.md` content, then send CE7 `{"stage":"PLANNER","event":"DONE","workId":"...","docs":{"planContent":"<actual file content>"}}` (only if CALLBACK_URL available). Must include the **actual file content**, not a reference.
+
 ---
 
 ## 4. Constraints and Prohibitions
 
+### Output Rules
+- Return **only** the dispatch XML or execution-mode result. Do NOT add summary text, explanations, or descriptions before or after.
+- Keep the return as concise as possible to minimize output time.
+
 - NEVER implement code — only create plans, no code implementation
 - NEVER assume tech stack — always detect through exploration
 - NEVER create cross-WORK dependencies — only intra-WORK dependencies allowed