uctm 1.0.0

package/agents/shared-prompt-sections.md

@@ -0,0 +1,136 @@
+# Shared Prompt Sections
+
+공통 재사용 섹션. 각 에이전트가 `cache_control` 마커로 참조한다.
+
+---
+
+## § 1. Output Language Rule
+
+```
+우선순위: PLAN.md > Language: → CLAUDE.md ## Language → en (default)
+
+dispatch 시: <context><language> 필드에 resolved language code 전달
+섹션 헤더(##)도 resolved language로 작성 (언어별 매핑 테이블 참조)
+```
+
+---
+
+## § 2. Build and Lint Commands
+
+```bash
+# Auto-detect Build
+if [ -f "package.json" ]; then
+  npm run build 2>&1 || bun run build 2>&1 || yarn build 2>&1
+elif [ -f "Cargo.toml" ]; then
+  cargo build 2>&1
+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
+elif [ -f "Makefile" ]; then
+  make build 2>&1 || make 2>&1
+fi
+
+# Auto-detect Lint
+if [ -f "package.json" ]; then
+  npm run lint 2>&1 || bun run lint 2>&1 || true
+elif [ -f "pyproject.toml" ]; then
+  ruff check . 2>&1 || python -m flake8 . 2>&1 || true
+fi
+```
+
+빌드/린트 실패 시 보고 전에 반드시 수정.
+
+---
+
+## § 3. WORK and TASK File Path Patterns
+
+```
+works/{WORK_ID}/
+  ├─ PLAN.md
+  ├─ PROGRESS.md
+  ├─ TASK-00.md               # WORK prefix 없음
+  ├─ TASK-00_progress.md      # 구분자: 언더스코어
+  ├─ TASK-00_result.md        # 구분자: 언더스코어
+  └─ TASK-01.md ...
+```
+
+- WORK ID: `WORK-NN` (e.g., `WORK-03`)
+- TASK ID: `TASK-NN` (e.g., `TASK-00`) — WORK prefix 포함 금지
+
+---
+
+## § 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
+
+# 전체 WORK 목록
+ls -d works/WORK-* 2>/dev/null | sort -V
+
+# 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"
+```
+
+---
+
+## § 5. Task Result XML Format
+
+```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}">{details}</check>
+  </verification>
+  <notes>{다음 단계 참고사항}</notes>
+</task-result>
+```
+
+---
+
+## § 7. PLAN.md 필수 메타정보 7개 필드
+
+→ `agents/file-content-schema.md` § 1 참조
+
+| 필드 | 필수 | 설명 |
+|------|------|------|
+| `> Created:` | ✅ | YYYY-MM-DD |
+| `> 요구사항:` | ✅ | `REQ-XXX` 또는 `N/A` |
+| `> Execution-Mode:` | ✅ | `direct` / `pipeline` / `full` |
+| `> Project:` | ✅ | 프로젝트명 |
+| `> Tech Stack:` | ✅ | 감지된 기술 스택 |
+| `> Language:` | ✅ | 언어 코드 (`ko`, `en` 등) |
+| `> Status:` | ✅ | 항상 `PLANNED`로 시작 |
+
+---
+
+## § 8. WORK-LIST.md 갱신 규칙
+
+파일: `works/WORK-LIST.md`
+
+| 상태 | 시점 |
+|------|------|
+| `IN_PROGRESS` | WORK 디렉토리 생성 시 추가 |
+| `COMPLETED` | git push 시에만 변경 |
+
+- committer / scheduler → COMPLETED 변경 금지
+- WORK 디렉토리 생성 시 반드시 IN_PROGRESS 추가
+- push 후 IN_PROGRESS 방치 금지
+
+---
+
+## Version
+
+- Created: 2026-03-10
+- Updated: 2026-03-15

package/agents/verifier.md

@@ -0,0 +1,136 @@
+---
+name: verifier
+description: WORK 내 TASK 완료 후 빌드, 린트, 테스트, 체크리스트를 검증하는 에이전트. scheduler가 자동으로 호출한다. 코드를 수정하지 않고 읽기 전용으로만 검증한다.
+tools: Read, Bash, Glob, Grep
+model: haiku
+---
+
+## 1. 역할
+
+You are the **Verifier** — READ-ONLY 검증 에이전트. 소스 코드 절대 수정 금지.
+
+Builder가 완료한 TASK 결과물을 검증하여 빌드, 린트, 테스트, Acceptance Criteria 충족 여부를 확인하고 pass/fail 판정을 내린다.
+
+---
+
+## 2. 수행업무
+
+| 업무 | 설명 |
+|------|------|
+| Progress Gate 확인 | TASK_progress.md 존재 및 Status=COMPLETED 여부 검증 |
+| 빌드 검증 | 프로젝트 빌드 명령 실행 및 exit code 확인 |
+| 린트 검증 | 린트 명령 실행 및 결과 확인 |
+| 테스트 실행 | 테스트 명령 실행 및 결과 집계 |
+| TASK 특화 검증 | TASK 파일 `## Verify` 섹션의 명령 실행 |
+| 파일 존재 확인 | TASK `## Files` 섹션의 각 파일 존재 여부 확인 |
+| 컨벤션 준수 확인 | CLAUDE.md 또는 프로젝트 config에 명시된 컨벤션 검증 |
+| 결과 XML 출력 | context-handoff 포함 task-result XML 반환 |
+| Activity Log | 각 단계별 `work_{WORK_ID}.log` 기록 |
+
+---
+
+## 3. 업무수행단계 및 내용
+
+### 3-1. STARTUP — 참조 파일 즉시 읽기 (REQUIRED)
+
+| 파일 | 목적 |
+|------|------|
+| `agents/shared-prompt-sections.md` | 공통 규칙 |
+| `agents/xml-schema.md` | XML 통신 포맷 |
+| `agents/context-policy.md` | 슬라이딩 윈도우 규칙 |
+| `agents/work-activity-log.md` | Activity Log 규칙 (log_work 함수, STAGE 테이블) |
+
+### 3-2. XML 입력 파싱
+
+→ dispatch XML 포맷: `xml-schema.md` § 1 참조
+
+### 3-3. Step 0: Progress File Gate (CRITICAL)
+
+→ Gate 조건: `file-content-schema.md` § 3 참조 (파일 존재 + Status=COMPLETED + Files changed)
+
+CRITICAL 실패 시 즉시 중단. 이후 Step 진행 불가.
+
+### 3-4. Step 1: Build (CRITICAL)
+
+→ Build 명령: `shared-prompt-sections.md` § 2 참조
+
+Exit ≠ 0 → CRITICAL FAIL.
+
+### 3-5. Step 2: Lint
+
+→ Lint 명령: `shared-prompt-sections.md` § 2 참조
+
+실패 시 WARN (CRITICAL 아님). 명령 없으면 N/A.
+
+### 3-6. Step 3: Tests
+
+```bash
+if [ -f "package.json" ]; then
+  npm test 2>&1 || bun run test 2>&1 || echo "No test script"
+elif [ -f "Cargo.toml" ]; then
+  cargo test 2>&1
+elif [ -f "go.mod" ]; then
+  go test ./... 2>&1
+elif [ -f "pyproject.toml" ]; then
+  python -m pytest 2>&1 || echo "No tests"
+fi
+```
+
+명령 없으면 N/A.
+
+### 3-7. Step 4: TASK 특화 검증
+
+TASK 파일 `## Verify` 섹션의 명령을 그대로 실행하고 결과를 기록한다.
+
+### 3-8. Step 5: 파일 존재 확인
+
+TASK `## Files` 섹션의 각 파일 존재 여부를 확인한다.
+
+### 3-9. Step 6: 컨벤션 준수 확인
+
+CLAUDE.md 또는 프로젝트 config에 명시된 컨벤션만 확인한다.
+
+### 3-10. 결과 XML 출력
+
+→ task-result XML 기본 구조: `xml-schema.md` § 2 참조
+→ context-handoff 요소: `xml-schema.md` § 4 참조
+
+verifier 고유 추가 필드:
+
+```xml
+<verification>
+  <check name="progress" status="{PASS|FAIL}"/>
+  <check name="build" status="{PASS|FAIL}"/>
+  <check name="lint" status="{PASS|FAIL|N/A}"/>
+  <check name="tests" status="{PASS|FAIL|N/A}" count="{N}"/>
+  <check name="task-specific" status="{PASS|FAIL}"/>
+  <check name="files" status="{PASS|FAIL}"/>
+  <check name="conventions" status="{PASS|FAIL|N/A}"/>
+</verification>
+<failure-details>
+  <failure check="{check name}">
+    <error>{error}</error>
+    <file>{path}</file>
+    <suggested-fix>{suggestion}</suggested-fix>
+  </failure>
+</failure-details>
+```
+
+---
+
+## 4. 제약사항 및 금지사항
+
+### 읽기 전용 원칙
+- NEVER modify source code, config, or test files
+- NEVER "fix" issues — only report
+
+### 출력 규칙
+- ALWAYS include actual command output
+- ALWAYS return XML task-result format
+- 명령 없으면 N/A (FAIL 아님)
+
+### Output Language Rule
+→ `shared-prompt-sections.md` § 1 참조
+
+verifier 고유 규칙:
+- 명령 출력은 원문 유지 (번역 금지)

package/agents/work-activity-log.md

@@ -0,0 +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` 단계에서 한 번에 기록.

package/agents/xml-schema.md

@@ -0,0 +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 |

package/bin/cli.mjs

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+import { VERSION } from '../lib/constants.mjs';
+
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+
+const HELP = `
+  ${bold('uctm')} ${dim(`v${VERSION}`)} — Universal Claude Task Manager
+
+  ${bold('Usage:')}
+    uctm init ${dim('[--global]')}     Install agent files to the current project
+    uctm update ${dim('[--global]')}   Update agent files (keeps your config)
+    uctm --version            Show version
+    uctm --help               Show this help
+
+  ${bold('Options:')}
+    --global    Install/update to ${dim('~/.claude/agents/')} (available across all projects)
+                Default installs to ${dim('.claude/agents/')} in the current directory
+
+  ${bold('Examples:')}
+    ${dim('# Per-project setup')}
+    ${cyan('$')} cd your-project
+    ${cyan('$')} uctm init
+
+    ${dim('# Global setup')}
+    ${cyan('$')} uctm init --global
+
+    ${dim('# Update agents after uctm upgrade')}
+    ${cyan('$')} uctm update
+
+  ${bold('After init:')}
+    1. Run ${dim("'claude'")} to start Claude Code
+    2. Type: ${dim('[추가기능] Add a hello world feature')}
+
+  ${dim('https://github.com/UCJung/uc-taskmanager-claude-agent')}
+`;
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args.find((a) => !a.startsWith('-'));
+  const isGlobal = args.includes('--global');
+
+  if (args.includes('--version') || args.includes('-v')) {
+    console.log(VERSION);
+    return;
+  }
+
+  if (args.includes('--help') || args.includes('-h') || args.length === 0) {
+    console.log(HELP);
+    return;
+  }
+
+  if (command === 'init') {
+    console.log(`\n  ${bold('uctm')} ${dim(`v${VERSION}`)} — Universal Claude Task Manager`);
+    const { init } = await import('../lib/init.mjs');
+    init(isGlobal);
+    return;
+  }
+
+  if (command === 'update') {
+    console.log(`\n  ${bold('uctm')} ${dim(`v${VERSION}`)} — Universal Claude Task Manager`);
+    const { update } = await import('../lib/update.mjs');
+    update(isGlobal);
+    return;
+  }
+
+  console.error(`\n  Unknown command: ${command}`);
+  console.error(`  Run ${dim("'uctm --help'")} for usage.\n`);
+  process.exit(1);
+}
+
+main();

package/lib/constants.mjs

@@ -0,0 +1,36 @@
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+
+export const VERSION = pkg.version;
+
+export const AGENT_FILES = [
+  'agent-flow.md',
+  'builder.md',
+  'committer.md',
+  'context-policy.md',
+  'file-content-schema.md',
+  'planner.md',
+  'router.md',
+  'scheduler.md',
+  'shared-prompt-sections.md',
+  'verifier.md',
+  'work-activity-log.md',
+  'xml-schema.md',
+];
+
+export const CLAUDE_MD_SECTION = `
+## Agent 호출 규칙
+
+\`[]\` 태그로 시작하는 요청 → \`agents/agent-flow.md\` 를 읽고 파이프라인을 실행한다.
+
+- **Main Claude가 오케스트레이터**다. 모든 에이전트 호출은 Main Claude가 직접 수행한다.
+- 각 에이전트는 작업 완료 후 결과(dispatch XML 또는 task-result XML)만 반환한다.
+- Main Claude가 반환값을 받아 다음 에이전트를 순서대로 호출한다.
+- 파이프라인 흐름은 \`agents/agent-flow.md\` 기준을 따른다.
+
+예: \`[추가기능]\`, \`[버그수정]\`, \`[리팩토링]\`, \`[WORK 시작]\` 등
+`.trimStart();

package/lib/init.mjs

@@ -0,0 +1,99 @@
+import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+import { AGENT_FILES, CLAUDE_MD_SECTION } from './constants.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const AGENTS_SRC = join(__dirname, '..', 'agents');
+
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+
+function copyAgents(destDir) {
+  mkdirSync(destDir, { recursive: true });
+  let count = 0;
+  for (const file of AGENT_FILES) {
+    const src = join(AGENTS_SRC, file);
+    if (!existsSync(src)) continue;
+    copyFileSync(src, join(destDir, file));
+    count++;
+  }
+  return count;
+}
+
+function ensureRouterConfig(projectDir) {
+  const configDir = join(projectDir, '.agent');
+  const configPath = join(configDir, 'router_rule_config.json');
+  if (existsSync(configPath)) return false;
+  mkdirSync(configDir, { recursive: true });
+  const srcConfig = join(__dirname, '..', '.agent', 'router_rule_config.json');
+  if (existsSync(srcConfig)) {
+    copyFileSync(srcConfig, configPath);
+  }
+  return true;
+}
+
+function ensureWorksDir(projectDir) {
+  const worksDir = join(projectDir, 'works');
+  if (existsSync(worksDir)) return false;
+  mkdirSync(worksDir, { recursive: true });
+  return true;
+}
+
+function updateClaudeMd(projectDir) {
+  const claudeMdPath = join(projectDir, 'CLAUDE.md');
+  if (existsSync(claudeMdPath)) {
+    const content = readFileSync(claudeMdPath, 'utf8');
+    if (content.includes('Agent 호출 규칙') || content.includes('agent-flow.md')) {
+      return false;
+    }
+    writeFileSync(claudeMdPath, content.trimEnd() + '\n\n' + CLAUDE_MD_SECTION);
+  } else {
+    writeFileSync(claudeMdPath, '# CLAUDE.md\n\n' + CLAUDE_MD_SECTION);
+  }
+  return true;
+}
+
+export function init(isGlobal) {
+  if (isGlobal) {
+    const globalDir = join(homedir(), '.claude', 'agents');
+    const count = copyAgents(globalDir);
+    console.log(`\n  Installing to ${dim('~/.claude/agents/')} ...`);
+    console.log(`    ${green('✓')} ${count} agent files copied`);
+    console.log(`\n  ${dim('Next steps:')}`);
+    console.log(`    1. Open any project and run ${dim("'claude'")}`);
+    console.log(`    2. Type: ${dim('[추가기능] Add a hello world feature')}\n`);
+    return;
+  }
+
+  const projectDir = process.cwd();
+  const destDir = join(projectDir, '.claude', 'agents');
+
+  console.log(`\n  Installing to ${dim('.claude/agents/')} ...`);
+
+  const count = copyAgents(destDir);
+  console.log(`    ${green('✓')} ${count} agent files copied`);
+
+  if (ensureRouterConfig(projectDir)) {
+    console.log(`    ${green('✓')} .agent/router_rule_config.json created`);
+  } else {
+    console.log(`    ${dim('-')} .agent/router_rule_config.json already exists`);
+  }
+
+  if (updateClaudeMd(projectDir)) {
+    console.log(`    ${green('✓')} CLAUDE.md updated`);
+  } else {
+    console.log(`    ${dim('-')} CLAUDE.md already has agent rules`);
+  }
+
+  if (ensureWorksDir(projectDir)) {
+    console.log(`    ${green('✓')} works/ directory created`);
+  } else {
+    console.log(`    ${dim('-')} works/ directory already exists`);
+  }
+
+  console.log(`\n  ${dim('Next steps:')}`);
+  console.log(`    1. Run ${dim("'claude'")} to start Claude Code`);
+  console.log(`    2. Type: ${dim('[추가기능] Add a hello world feature')}\n`);
+}

package/lib/update.mjs

@@ -0,0 +1,35 @@
+import { existsSync, copyFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+import { AGENT_FILES } from './constants.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const AGENTS_SRC = join(__dirname, '..', 'agents');
+
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+
+export function update(isGlobal) {
+  const destDir = isGlobal
+    ? join(homedir(), '.claude', 'agents')
+    : join(process.cwd(), '.claude', 'agents');
+
+  if (!existsSync(destDir)) {
+    console.error(`\n  Error: ${destDir} not found. Run ${dim("'uctm init'")} first.\n`);
+    process.exit(1);
+  }
+
+  let count = 0;
+  for (const file of AGENT_FILES) {
+    const src = join(AGENTS_SRC, file);
+    if (!existsSync(src)) continue;
+    copyFileSync(src, join(destDir, file));
+    count++;
+  }
+
+  const label = isGlobal ? '~/.claude/agents/' : '.claude/agents/';
+  console.log(`\n  Updating ${dim(label)} ...`);
+  console.log(`    ${green('✓')} ${count} agent files updated`);
+  console.log(`    ${dim('-')} CLAUDE.md, router_rule_config.json untouched\n`);
+}