uctm 1.1.0 → 1.2.0

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

@@ -106,12 +106,12 @@ echo "$DONE / $TOTAL"
 
 ## § 7. PLAN.md 필수 메타정보 7개 필드
 
-→ `agents/file-content-schema.md` § 1 참조
+→ `.claude/agents/file-content-schema.md` § 1 참조
 
 | 필드 | 필수 | 설명 |
 |------|------|------|
 | `> Created:` | ✅ | YYYY-MM-DD |
-| `> 요구사항:` | ✅ | `REQ-XXX` 또는 `N/A` |
+| `> 요구사항:` | ✅ | `REQ-XXX` 또는 사용자 요청 텍스트 |
 | `> Execution-Mode:` | ✅ | `direct` / `pipeline` / `full` |
 | `> Project:` | ✅ | 프로젝트명 |
 | `> Tech Stack:` | ✅ | 감지된 기술 스택 |
@@ -127,11 +127,10 @@ echo "$DONE / $TOTAL"
 | 상태 | 시점 |
 |------|------|
 | `IN_PROGRESS` | WORK 디렉토리 생성 시 추가 |
-| `COMPLETED` | git push 시에만 변경 |
+| `COMPLETED` | 마지막 TASK 완료 시 committer가 자동 변경 |
 
-- committer / scheduler → COMPLETED 변경 금지
 - WORK 디렉토리 생성 시 반드시 IN_PROGRESS 추가
-- push 후 IN_PROGRESS 방치 금지
+- committer: 마지막 TASK commit 후 WORK-LIST.md를 `IN_PROGRESS` → `COMPLETED`로 변경
 
 ---
 

package/agents/ko/verifier.md

@@ -35,10 +35,10 @@ Builder가 완료한 TASK 결과물을 검증하여 빌드, 린트, 테스트, A
 
 | 파일 | 목적 |
 |------|------|
-| `agents/shared-prompt-sections.md` | 공통 규칙 |
-| `agents/xml-schema.md` | XML 통신 포맷 |
-| `agents/context-policy.md` | 슬라이딩 윈도우 규칙 |
-| `agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
+| `.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 테이블) |
 
 ### 3-2. XML 입력 파싱
 

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

@@ -1,45 +1,45 @@
-# Work Activity Log
-
-각 에이전트가 WORK 진행 상황을 `works/{WORK_ID}/work_{WORK_ID}.log` 파일에 기록하는 규칙을 정의한다.
-
----
-
-# 1. 작업 단계 및 로그 기록 내용
-* 최초 실행 시 : 수신한 프롬프트 메시지** Agent 시작 시 수신한 프롬프트 메시지 내용 (Required 필수)
-* Callback 호출 시 : 호출한 Callback URL, 성공여부, Payload, Respoonse (Required 필수)
-* 작업 진행 시 : 작업항목 및 작업내용 
-* 수행작업 완료 시 : 타 Agent에 전송한 프롬프트 메시지** Agent 시작 시 수신한 프롬프트 메시지 내용 (Required 필수)
-
-## log_work 함수
-
-```bash
-AGENT_NAME="ROUTER"  # 각 에이전트 파일에서 적절히 설정
-
-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"
-}
-```
-
----
-
-## STAGE 테이블
-
-| STAGE | 시점 | 설명 예시 |
-|-------|------|-----------|
-| `INIT` | WORK_ID 결정 후 | `WORK-NN 생성 — Execution-Mode: direct/pipeline/full` |
-| `REF` | STARTUP 참조 직후 | `참조: CLAUDE.md, .agent/router_rule_config.json, agents/file-content-schema.md` |
-| `PLAN` | PLAN.md + TASK 파일 생성 완료 | `PLAN.md, TASK-00.md 생성 완료` |
-| `IMPL` | direct 모드 코드 구현 시작 | `코드 구현 시작 — 참조: {수정 대상 파일 목록}` |
-| `BUILD` | self-check 통과 | `빌드/린트 통과` |
-| `COMMIT` | git commit 완료 | `commit {hash}` |
-| `DISPATCH` | pipeline/full dispatch | `Builder dispatch` 또는 `Planner dispatch` |
-
----
-
-## 참조 자료 수집 규칙
-
-STARTUP에서 읽은 파일과 이후 탐색한 파일을 누적 추적하여 `REF` 단계에서 한 번에 기록.
+# Work Activity Log
+
+각 에이전트가 WORK 진행 상황을 `works/{WORK_ID}/work_{WORK_ID}.log` 파일에 기록하는 규칙을 정의한다.
+
+---
+
+# 1. 작업 단계 및 로그 기록 내용
+* 최초 실행 시 : 수신한 프롬프트 메시지** Agent 시작 시 수신한 프롬프트 메시지 내용 (Required 필수)
+* Callback 호출 시 : 호출한 Callback URL, 성공여부, Payload, Respoonse (Required 필수)
+* 작업 진행 시 : 작업항목 및 작업내용 
+* 수행작업 완료 시 : 타 Agent에 전송한 프롬프트 메시지** Agent 시작 시 수신한 프롬프트 메시지 내용 (Required 필수)
+
+## log_work 함수
+
+```bash
+AGENT_NAME="ROUTER"  # 각 에이전트 파일에서 적절히 설정
+
+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"
+}
+```
+
+---
+
+## STAGE 테이블
+
+| STAGE | 시점 | 설명 예시 |
+|-------|------|-----------|
+| `INIT` | WORK_ID 결정 후 | `WORK-NN 생성 — Execution-Mode: direct/pipeline/full` |
+| `REF` | STARTUP 참조 직후 | `참조: CLAUDE.md, .agent/router_rule_config.json, agents/file-content-schema.md` |
+| `PLAN` | PLAN.md + TASK 파일 생성 완료 | `PLAN.md, TASK-00.md 생성 완료` |
+| `IMPL` | direct 모드 코드 구현 시작 | `코드 구현 시작 — 참조: {수정 대상 파일 목록}` |
+| `BUILD` | self-check 통과 | `빌드/린트 통과` |
+| `COMMIT` | git commit 완료 | `commit {hash}` |
+| `DISPATCH` | pipeline/full dispatch | `Builder dispatch` 또는 `Planner dispatch` |
+
+---
+
+## 참조 자료 수집 규칙
+
+STARTUP에서 읽은 파일과 이후 탐색한 파일을 누적 추적하여 `REF` 단계에서 한 번에 기록.

package/agents/ko/xml-schema.md

@@ -1,109 +1,109 @@
-# Agent Communication XML Schema
-
-uc-taskmanager 에이전트 간 XML 통신 포맷 정의.
-
----
-
-## 1. Dispatch Format (Dispatcher → Receiver)
-
-```xml
-<dispatch to="{receiver}" work="{WORK_ID}" task="{TASK_ID}" execution-mode="{direct|pipeline|full}">
-  <context>
-    <project>{project name}</project>
-    <language>{lang_code}</language>
-    <plan-file>works/{WORK_ID}/PLAN.md</plan-file>
-  </context>
-  <task-spec>
-    <file>works/{WORK_ID}/TASK-XX.md</file>
-    <title>{title}</title>
-    <action>{implement|verify|commit|plan|route}</action>
-    <description>{optional}</description>
-  </task-spec>
-  <previous-results>
-    <result task="{TASK_ID}" status="{PASS|FAIL|SKIP}">{summary}</result>
-  </previous-results>
-  <cache-hint sections="{section1},{section2}"/>
-</dispatch>
-```
-
-| 속성 | 값 |
-|------|----|
-| `to` | builder, verifier, committer, planner, scheduler, router |
-| `task` | `TASK-NN` — WORK prefix 포함 금지 |
-| `execution-mode` | direct / pipeline / full (생략 시 full로 간주) |
-
----
-
-## 2. Task Result Format (Receiver → Dispatcher)
-
-```xml
-<task-result work="{WORK_ID}" task="{TASK_ID}" agent="{agent}" status="{PASS|FAIL}">
-  <summary>{1-2줄 요약}</summary>
-  <files-changed>
-    <file action="{created|modified|deleted}" path="{path}">{description}</file>
-  </files-changed>
-  <verification>
-    <check name="{type}" status="{PASS|FAIL|N/A}">{output}</check>
-  </verification>
-  <notes>{참고사항}</notes>
-</task-result>
-```
-
----
-
-## 3. Dispatcher-Receiver 매핑
-
-| Dispatcher | Receiver | execution-mode | 설명 |
-|------------|----------|:--------------:|------|
-| Router | (자기 자신) | `direct` | 서브에이전트 없음. Router가 직접 구현+commit+콜백 |
-| Router | Planner | `full` | 복잡 WORK 계획 |
-| Router | Scheduler | `full` | 계획된 WORK 실행 |
-| Router | Builder | `pipeline` | TASK 1개 구현 |
-| Router | Verifier | `pipeline` | TASK 1개 검증 |
-| Router | Committer | `pipeline` | TASK 1개 커밋 |
-| Scheduler | Builder | `full` | TASK N개 구현 |
-| Scheduler | Verifier | `full` | TASK N개 검증 |
-| Scheduler | Committer | `full` | TASK N개 커밋 |
-
----
-
-## 4. Context-Handoff Element
-
-```xml
-<context-handoff from="{agent}" detail-level="{FULL|SUMMARY|DROP}">
-  <what>{변경/검증 사항}</what>
-  <why>{의사결정 근거}</why>       <!-- FULL only -->
-  <caution>{주의사항}</caution>    <!-- FULL only -->
-  <incomplete>{미완료 사항}</incomplete>  <!-- FULL only -->
-</context-handoff>
-```
-
-| detail-level | 포함 필드 |
-|:---:|---|
-| `FULL` | what, why, caution, incomplete |
-| `SUMMARY` | what만 (1-3줄) |
-| `DROP` | 요소 생략 |
-
----
-
-## 5. execution-mode별 에이전트 행동
-
-| 에이전트 | direct | pipeline | full |
-|---------|--------|----------|------|
-| Router | 구현+self-check+result.md+commit+콜백 직접 | PLAN 생성 후 B→V→C dispatch | Planner에 dispatch |
-| Planner | 호출 안 됨 | 호출 안 됨 | PLAN.md 생성 |
-| Scheduler | 호출 안 됨 | 호출 안 됨 | DAG 관리 + [B→V→C]×N |
-| Builder | 호출 안 됨 | 정상 실행 | 정상 실행 |
-| Verifier | 호출 안 됨 | 정상 실행 | 정상 실행 |
-| Committer | 호출 안 됨 | result.md+commit+콜백 | result.md+commit+콜백 |
-
-불변 항목 (모드 무관):
-
-| 항목 | direct | pipeline/full |
-|------|:---:|:---:|
-| `works/WORK-NN/` 디렉토리 | Router | Router/Planner |
-| `PLAN.md` | Router | Router/Planner |
-| `TASK-XX.md` | Router | Router/Planner |
-| `TASK-XX_result.md` | Router | Committer |
-| COMMITTER DONE 콜백 | Router | Committer |
-| `WORK-LIST.md` IN_PROGRESS | Router | Router |
+# Agent Communication XML Schema
+
+uc-taskmanager 에이전트 간 XML 통신 포맷 정의.
+
+---
+
+## 1. Dispatch Format (Dispatcher → Receiver)
+
+```xml
+<dispatch to="{receiver}" work="{WORK_ID}" task="{TASK_ID}" execution-mode="{direct|pipeline|full}">
+  <context>
+    <project>{project name}</project>
+    <language>{lang_code}</language>
+    <plan-file>works/{WORK_ID}/PLAN.md</plan-file>
+  </context>
+  <task-spec>
+    <file>works/{WORK_ID}/TASK-XX.md</file>
+    <title>{title}</title>
+    <action>{implement|verify|commit|plan|route}</action>
+    <description>{optional}</description>
+  </task-spec>
+  <previous-results>
+    <result task="{TASK_ID}" status="{PASS|FAIL|SKIP}">{summary}</result>
+  </previous-results>
+  <cache-hint sections="{section1},{section2}"/>
+</dispatch>
+```
+
+| 속성 | 값 |
+|------|----|
+| `to` | builder, verifier, committer, planner, scheduler, router |
+| `task` | `TASK-NN` — WORK prefix 포함 금지 |
+| `execution-mode` | direct / pipeline / full (생략 시 full로 간주) |
+
+---
+
+## 2. Task Result Format (Receiver → Dispatcher)
+
+```xml
+<task-result work="{WORK_ID}" task="{TASK_ID}" agent="{agent}" status="{PASS|FAIL}">
+  <summary>{1-2줄 요약}</summary>
+  <files-changed>
+    <file action="{created|modified|deleted}" path="{path}">{description}</file>
+  </files-changed>
+  <verification>
+    <check name="{type}" status="{PASS|FAIL|N/A}">{output}</check>
+  </verification>
+  <notes>{참고사항}</notes>
+</task-result>
+```
+
+---
+
+## 3. Dispatcher-Receiver 매핑
+
+| Dispatcher | Receiver | execution-mode | 설명 |
+|------------|----------|:--------------:|------|
+| Router | (자기 자신) | `direct` | 서브에이전트 없음. Router가 직접 구현+commit+콜백 |
+| Router | Planner | `full` | 복잡 WORK 계획 |
+| Router | Scheduler | `full` | 계획된 WORK 실행 |
+| Router | Builder | `pipeline` | TASK 1개 구현 |
+| Router | Verifier | `pipeline` | TASK 1개 검증 |
+| Router | Committer | `pipeline` | TASK 1개 커밋 |
+| Scheduler | Builder | `full` | TASK N개 구현 |
+| Scheduler | Verifier | `full` | TASK N개 검증 |
+| Scheduler | Committer | `full` | TASK N개 커밋 |
+
+---
+
+## 4. Context-Handoff Element
+
+```xml
+<context-handoff from="{agent}" detail-level="{FULL|SUMMARY|DROP}">
+  <what>{변경/검증 사항}</what>
+  <why>{의사결정 근거}</why>       <!-- FULL only -->
+  <caution>{주의사항}</caution>    <!-- FULL only -->
+  <incomplete>{미완료 사항}</incomplete>  <!-- FULL only -->
+</context-handoff>
+```
+
+| detail-level | 포함 필드 |
+|:---:|---|
+| `FULL` | what, why, caution, incomplete |
+| `SUMMARY` | what만 (1-3줄) |
+| `DROP` | 요소 생략 |
+
+---
+
+## 5. execution-mode별 에이전트 행동
+
+| 에이전트 | direct | pipeline | full |
+|---------|--------|----------|------|
+| Router | 구현+self-check+result.md+commit+콜백 직접 | PLAN 생성 후 B→V→C dispatch | Planner에 dispatch |
+| Planner | 호출 안 됨 | 호출 안 됨 | PLAN.md 생성 |
+| Scheduler | 호출 안 됨 | 호출 안 됨 | DAG 관리 + [B→V→C]×N |
+| Builder | 호출 안 됨 | 정상 실행 | 정상 실행 |
+| Verifier | 호출 안 됨 | 정상 실행 | 정상 실행 |
+| Committer | 호출 안 됨 | result.md+commit+콜백 | result.md+commit+콜백 |
+
+불변 항목 (모드 무관):
+
+| 항목 | direct | pipeline/full |
+|------|:---:|:---:|
+| `works/WORK-NN/` 디렉토리 | Router | Router/Planner |
+| `PLAN.md` | Router | Router/Planner |
+| `TASK-XX.md` | Router | Router/Planner |
+| `TASK-XX_result.md` | Router | Committer |
+| COMMITTER DONE 콜백 | Router | Committer |
+| `WORK-LIST.md` IN_PROGRESS | Router | Router |

package/lib/constants.mjs

@@ -31,12 +31,12 @@ export function getAgentsSrcDir(lang) {
 export const CLAUDE_MD_SECTION_KO = `
 ## Agent 호출 규칙
 
-\`[]\` 태그로 시작하는 요청 → \`agents/agent-flow.md\` 를 읽고 파이프라인을 실행한다.
+\`[]\` 태그로 시작하는 요청 → \`.claude/agents/agent-flow.md\` 를 읽고 파이프라인을 실행한다.
 
 - **Main Claude가 오케스트레이터**다. 모든 에이전트 호출은 Main Claude가 직접 수행한다.
 - 각 에이전트는 작업 완료 후 결과(dispatch XML 또는 task-result XML)만 반환한다.
 - Main Claude가 반환값을 받아 다음 에이전트를 순서대로 호출한다.
-- 파이프라인 흐름은 \`agents/agent-flow.md\` 기준을 따른다.
+- 파이프라인 흐름은 \`.claude/agents/agent-flow.md\` 기준을 따른다.
 
 예: \`[추가기능]\`, \`[버그수정]\`, \`[리팩토링]\`, \`[WORK 시작]\` 등
 `.trimStart();
@@ -44,12 +44,12 @@ export const CLAUDE_MD_SECTION_KO = `
 export const CLAUDE_MD_SECTION_EN = `
 ## Agent Invocation Rules
 
-Requests starting with a \`[]\` tag → read \`agents/agent-flow.md\` and execute the pipeline.
+Requests starting with a \`[]\` tag → read \`.claude/agents/agent-flow.md\` and execute the pipeline.
 
 - **Main Claude is the orchestrator.** All agent invocations are performed directly by Main Claude.
 - Each agent only returns results (dispatch XML or task-result XML) after completing its work.
 - Main Claude receives return values and invokes the next agent in sequence.
-- Pipeline flow follows \`agents/agent-flow.md\`.
+- Pipeline flow follows \`.claude/agents/agent-flow.md\`.
 
 Examples: \`[new-feature]\`, \`[bugfix]\`, \`[enhancement]\`, \`[new-work]\`, etc.
 `.trimStart();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uctm",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Universal Claude Task Manager — SDD-based task pipeline subagent system for Claude Code CLI",
   "type": "module",
   "bin": {