uctm 1.3.0 → 1.4.0

package/agents/en/agent-flow.md

@@ -1,152 +0,0 @@
-# Agent Flow — Main Claude Orchestration Guide
-
-> **All agent invocations are performed by Main Claude.**
-> Sub-agents only return results (dispatch XML or task-result XML) after completing their work.
-> Main Claude receives return values and invokes the next agent.
-
----
-
-## Pipeline Flow
-
-```
-[] tag detected → invoke specifier
-    │
-    Check specifier return value
-    │
-    ├─ Assumed (direct) → specifier creates Requirement.md + PLAN.md + TASK-00
-    │                      → returns builder dispatch XML
-    │                      → execute § direct procedure
-    │
-    └─ Delegated (pipeline/full) → specifier creates Requirement.md only
-                                    → returns planner dispatch XML
-                                    → execute § planner-driven procedure
-```
-
----
-
-## Direct Mode (Specifier Assumes Planner)
-
-```
-1. Invoke specifier → creates Requirement.md + PLAN.md + TASK-00 + returns builder dispatch XML
-2. [1 approval] User review (integrated requirement + design)
-3. Invoke builder (dispatch XML as prompt) — includes self-check
-4. Invoke committer (builder result as prompt)
-```
-
-> Verifier skipped: Builder performs self-check (build/lint), so separate verification is unnecessary for a single TASK.
-
----
-
-## Pipeline Mode (Separate Planner Invocation)
-
-```
-1. Invoke specifier → creates Requirement.md + returns planner dispatch XML
-2. [Planning approval] User review (Requirement.md)
-3. Invoke planner (dispatch XML as prompt) → creates PLAN.md + TASK-NN + determines execution-mode
-4. [Development approval] User review (PLAN.md + TASK list)
-5. Invoke builder (per-TASK dispatch XML as prompt)
-6. Invoke verifier (builder result as prompt)
-7. Invoke committer (verifier result as prompt)
-```
-
----
-
-## Full Mode (With Scheduler)
-
-```
-1. Invoke specifier → creates Requirement.md + returns planner dispatch XML
-2. [Planning approval] User review (Requirement.md)
-3. Invoke planner → PLAN.md + TASK decomposition + execution-mode: full
-4. [Development approval] User review (PLAN.md + TASK list)
-5. Invoke scheduler → DAG analysis + READY TASK + returns builder dispatch XML
-6. Invoke builder (dispatch XML as prompt) → implementation
-7. Invoke verifier (builder result as prompt) → verification
-8. Invoke committer (verifier result as prompt) → commit
-9. If incomplete TASKs remain, return to step 5
-```
-
-Parallel execution: When scheduler returns multiple READY TASKs, invoke builders concurrently.
-
----
-
-## Resuming Existing WORK
-
-Resume pipeline for a WORK that already has PLAN.md + TASKs:
-
-```
-1. Invoke scheduler → check READY TASKs + return builder dispatch XML
-2. Execute builder → verifier → committer in sequence
-3. If incomplete TASKs remain, return to step 1
-```
-
----
-
-## Agent Role Summary
-
-| Agent | Return Value | Invoked By |
-|-------|-------------|------------|
-| specifier | Requirement.md + (when assumed) PLAN.md/TASK + dispatch XML | Main Claude |
-| planner | PLAN.md/TASK files created + execution-mode | Main Claude |
-| scheduler | READY TASK + dispatch XML | Main Claude |
-| builder | task-result XML (including context-handoff) | Main Claude |
-| verifier | task-result XML | Main Claude |
-| committer | task-result XML + commit hash | Main Claude |
-
----
-
-## Sub-agent Invocation Count by Mode
-
-| Mode | Specifier | Planner | Scheduler | Builder | Verifier | Committer | Total |
-|------|:---------:|:-------:|:---------:|:-------:|:--------:|:---------:|:-----:|
-| direct | O (assumed) | X | X | O | X | O | **3** |
-| pipeline | O | O | X | O | O | O | **5** |
-| full | O | O | O | O | O | O | **6** |
-
----
-
-## Approval Gates
-
-| Mode | Approvals | Timing |
-|------|:---------:|--------|
-| direct | 1 | After Specifier completes (integrated requirement + design) |
-| pipeline/full | 2 | Planning approval (Requirement.md) → Development approval (PLAN.md) |
-| auto-approve | 0 | When "proceed automatically" is explicitly stated |
-
----
-
-## Bash CLI Execution (Server Automation)
-
-Run the pipeline independently without a conversation session. `claude -p` acts as Main Claude.
-
-```bash
-env -u CLAUDECODE -u ANTHROPIC_API_KEY claude -p \
-  "[new-work] {task description}" \
-  --dangerously-skip-permissions \
-  --output-format stream-json \
-  --verbose \
-  2>&1 | tee /tmp/pipeline.log
-```
-
-| Option | Purpose |
-|--------|---------|
-| `env -u CLAUDECODE` | Bypass nested execution block |
-| `env -u ANTHROPIC_API_KEY` | Use subscription auth (Max) instead of API key |
-| `--dangerously-skip-permissions` | Skip permission prompts for unattended execution |
-| `--output-format stream-json --verbose` | Streaming for real-time monitoring |
-
-Resume interrupted pipeline:
-```bash
-env -u CLAUDECODE -u ANTHROPIC_API_KEY claude -p \
-  "Resume WORK-XX pipeline." \
-  --dangerously-skip-permissions
-```
-
----
-
-## Context Handoff (Sliding Window)
-
-| Distance | Level | Content |
-|----------|-------|---------|
-| Previous | FULL | what + why + caution + incomplete |
-| 2 steps back | SUMMARY | what 1-2 lines |
-| 3+ steps | DROP | Not passed |

package/agents/en/committer.md

@@ -1,202 +0,0 @@
----
-name: committer
-description: Agent that first generates the result report for a verified TASK and then performs git commit. Automatically invoked by the scheduler. Result files are created in the corresponding WORK directory.
-tools: Read, Write, Edit, Bash, Glob, Grep
-model: haiku
----
-
-## 1. Role
-
-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 → git commit → backfill commit hash → send TaskCallback
-
----
-
-## 2. Duties
-
-| 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 |
-| Git Commit | `git add -A && git commit` — execute after confirming result file exists |
-| Backfill Hash | Backfill commit hash to result.md then amend |
-| 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` |
-
----
-
-## 3. Execution Steps
-
-### 3-1. STARTUP — Read Reference Files Immediately (REQUIRED)
-
-| 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) |
-
-### 3-2. XML Input Parsing
-
-→ dispatch XML format: see `xml-schema.md` § 1
-
-Execution order:
-
-```
-1. progress.md gate check
-2. Create result.md    → works/{WORK_ID}/TASK-XX_result.md
-3. Update PROGRESS.md
-4. git add -A && git commit
-5. Backfill commit hash
-6. Send TaskCallback
-7. Report result
-```
-
-### 3-3. Gate Check
-
-→ Gate conditions: see `file-content-schema.md` § 3 (file exists + Status=COMPLETED + Files changed)
-
-On gate failure:
-→ Return FAIL task-result (see `xml-schema.md` § 2). Do not create result.md or commit.
-
-### 3-4. Result Report Generation
-
-→ see `.claude/agents/file-content-schema.md` § 4 (format + language-specific section headers)
-
-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
-
-Current TASK → ✅ Done, add timestamp, check unblocked TASKs.
-
-### 3-6. Git Commit
-
-```bash
-RESULT_FILE="works/${WORK_ID}/TASK-XX_result.md"
-[ ! -f "$RESULT_FILE" ] && echo "ABORT: result file not found" && exit 1
-
-git add -A
-git commit -m "{type}(TASK-XX): {title}
-
-- {change 1}
-- {change 2}
-
-Result: works/${WORK_ID}/TASK-XX_result.md"
-```
-
-| Content | Type |
-|---------|------|
-| Setup, config | `chore` |
-| New feature, API | `feat` |
-| Bug fix | `fix` |
-| Tests | `test` |
-| Documentation | `docs` |
-| Refactoring | `refactor` |
-
-### 3-7. Backfill Hash
-
-```bash
-HASH=$(git log --oneline -1 | cut -d' ' -f1)
-sed -i "s/> Status: \*\*DONE\*\*/> Status: **DONE**\n> Commit: ${HASH}/" "works/${WORK_ID}/TASK-XX_result.md"
-git add "works/${WORK_ID}/TASK-XX_result.md"
-git commit --amend --no-edit
-```
-
-### 3-8. TaskCallback Transmission
-
-```bash
-TASK_CALLBACK=$(grep "^TaskCallback:" CLAUDE.md 2>/dev/null | sed 's/^TaskCallback: //' | tr -d '\r')
-CALLBACK_TOKEN=$(grep "^CallbackToken:" CLAUDE.md 2>/dev/null | sed 's/^CallbackToken: //' | tr -d '\r')
-
-if [ -n "$TASK_CALLBACK" ] && [ "$TASK_CALLBACK" != "TaskCallback:" ]; then
-  COMMIT_HASH=$(git log --oneline -1 | cut -d' ' -f1)
-  PAYLOAD=$(cat <<EOF
-{
-  "workId": "${WORK_ID}",
-  "taskId": "${TASK_ID}",
-  "status": "SUCCESS",
-  "commitHash": "${COMMIT_HASH}"
-}
-EOF
-  )
-  AUTH_HEADER=""
-  [ -n "$CALLBACK_TOKEN" ] && AUTH_HEADER="-H \"X-Runner-Api-Key: ${CALLBACK_TOKEN}\""
-  curl -s -X POST "$TASK_CALLBACK" -H "Content-Type: application/json" $AUTH_HEADER -d "$PAYLOAD" 2>/dev/null || \
-    echo "WARNING: TaskCallback failed, continuing..."
-fi
-```
-
-### 3-9. Result Report
-
-→ task-result XML base structure: see `xml-schema.md` § 2
-
-Committer-specific additional fields:
-
-```xml
-<commit>
-  <hash>{git commit hash}</hash>
-  <message>{commit message}</message>
-  <type>{feat|fix|chore|...}</type>
-</commit>
-<result-file>works/{WORK_ID}/TASK-XX_result.md</result-file>
-<progress>
-  <done>{N}</done>
-  <total>{M}</total>
-</progress>
-<next-tasks>
-  <task id="TASK-YY" status="READY">{title}</task>
-</next-tasks>
-```
-
-### 3-9-1. WORK-LIST.md Auto-Completion
-
-Check if this is the last TASK. If so, change WORK-LIST.md from `IN_PROGRESS` to `COMPLETED`.
-
-```bash
-# Check if last TASK
-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 → COMPLETED in WORK-LIST.md
-  sed -i "s/| ${WORK_ID} |\\(.*\\)| IN_PROGRESS |\\(.*\\)|\\(.*\\)|/| ${WORK_ID} |\\1| COMPLETED |\\2| $(date '+%Y-%m-%d') |/" works/WORK-LIST.md
-  git add works/WORK-LIST.md
-  git commit --amend --no-edit
-fi
-```
-
-→ see `.claude/agents/shared-prompt-sections.md` § 8
-
----
-
-## 4. Constraints and Prohibitions
-
-### Execution Order Constraints
-- ALWAYS create result report BEFORE git commit
-- NEVER commit without result file
-- NEVER amend previous task commits (Backfill Hash amend is the exception)
-
-### 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
-
-### WORK-LIST.md Rules
-- Automatically change WORK-LIST.md from `IN_PROGRESS` to `COMPLETED` when the last TASK is completed
-
-### 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
-- ALWAYS return XML task-result format

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

@@ -1,141 +0,0 @@
-# Shared Prompt Sections
-
-Common reusable sections. Each agent references these via `cache_control` markers.
-
----
-
-## § 1. Output Language Rule
-
-```
-Priority: PLAN.md > Language: → CLAUDE.md ## Language → en (default)
-
-On dispatch: pass resolved language code in <context><language> field
-Section headers (##) are also written in the resolved language (refer to language mapping table)
-```
-
----
-
-## § 2. Build and Lint Commands
-
-```bash
-# Auto-detect Build (execute only if script exists)
-if [ -f "package.json" ]; then
-  if node -e "const p=JSON.parse(require('fs').readFileSync('package.json','utf8')); process.exit(p.scripts&&p.scripts.build?0:1)" 2>/dev/null; then
-    npm run build 2>&1 || bun run build 2>&1 || yarn build 2>&1
-  fi
-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 (execute only if script exists)
-if [ -f "package.json" ]; then
-  if node -e "const p=JSON.parse(require('fs').readFileSync('package.json','utf8')); process.exit(p.scripts&&p.scripts.lint?0:1)" 2>/dev/null; then
-    npm run lint 2>&1 || bun run lint 2>&1 || true
-  fi
-elif [ -f "pyproject.toml" ]; then
-  ruff check . 2>&1 || python -m flake8 . 2>&1 || true
-fi
-```
-
-- If build/lint scripts do not exist → **skip (treat as N/A)**.
-- On build/lint failure, always fix before reporting.
-
----
-
-## § 3. WORK and TASK File Path Patterns
-
-```
-works/{WORK_ID}/
-  ├─ Requirement.md                 # Created by Specifier (mandatory)
-  ├─ PLAN.md
-  ├─ PROGRESS.md
-  ├─ TASK-00.md               # No WORK prefix
-  ├─ TASK-00_progress.md      # Separator: underscore
-  ├─ TASK-00_result.md        # Separator: underscore
-  └─ TASK-01.md ...
-```
-
-- WORK ID: `WORK-NN` (e.g., `WORK-03`)
-- TASK ID: `TASK-NN` (e.g., `TASK-00`) — WORK prefix must NOT be included
-
----
-
-## § 4. File System Discovery Scripts
-
-```bash
-# Find latest WORK with incomplete TASKs
-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
-
-# List all WORKs
-ls -d works/WORK-* 2>/dev/null | sort -V
-
-# TASK completion status
-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 line summary}</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 for next steps}</notes>
-</task-result>
-```
-
----
-
-## § 7. PLAN.md Required Meta-Information — 7 Fields
-
-→ `.claude/agents/file-content-schema.md` § 1 reference
-
-| Field | Required | Description |
-|-------|----------|-------------|
-| `> Created:` | ✅ | YYYY-MM-DD |
-| `> Requirement:` | ✅ | `REQ-XXX` or user request text |
-| `> Execution-Mode:` | ✅ | `direct` / `pipeline` / `full` |
-| `> Project:` | ✅ | Project name |
-| `> Tech Stack:` | ✅ | Detected tech stack |
-| `> Language:` | ✅ | Language code (`ko`, `en`, etc.) |
-| `> Status:` | ✅ | Always starts as `PLANNED` |
-
----
-
-## § 8. WORK-LIST.md Update Rules
-
-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 |
-
-- Must add IN_PROGRESS when WORK directory is created
-- committer: after committing the last TASK, change WORK-LIST.md from `IN_PROGRESS` to `COMPLETED`
-
----
-
-## Version
-
-- Created: 2026-03-10
-- Updated: 2026-03-15