uctm 1.1.0 → 1.1.1

package/README.md

@@ -60,24 +60,6 @@ uc-taskmanager was built to solve this. When you provide a requirement as input,
 
 Each step runs in an **isolated subagent pipeline**, so your context stays clean and every decision is documented.
 
-### The Bigger Picture
-
-This agent is designed to work with an **SDD-based requirement management and automated development system** — a server application that links requirement management → automated development → plans and artifacts. The full system architecture is documented in [`docs/spec_SDD_with_ucagent_requirement.md`](docs/spec_SDD_with_ucagent_requirement.md). Use it as a reference to build your own system tailored to your needs.
-
-### A Note on Language
-
-Starting from v1.1.0, uctm supports **multi-language agent prompts**. Use `uctm init --lang en` for English or `--lang ko` for Korean. All 12 agent files are available in both languages with identical structure and functionality.
-
-I'm Korean, so you'll find Korean in some internal documents (design specs, commit messages). Modern translation tools handle Korean well, so this shouldn't be a barrier.
-
-### What This Took
-
-I built this agent and the accompanying SDD requirement management system in roughly **one calendar month — about 2 weeks of actual development time** (8 hours/day). Ideas become reality. The technical and time barriers that once stopped you have fallen. This is the age of AI agents.
-
-**Good luck. Build something great.**
-
-This project is open source. Use it freely, share your ideas, and let's push this forward together.
-
 ---
 
 Six subagents work across any project and any language, automatically handling **request routing → task decomposition → dependency management → code implementation → verification → commit**.
@@ -265,7 +247,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/*.md .claude/agents/
+cp /tmp/uc-tm/agents/en/*.md .claude/agents/   # or agents/ko/ for Korean
 rm -rf /tmp/uc-tm
 git add .claude/agents/ && git commit -m "chore: add uc-taskmanager agents"
 ```
@@ -953,6 +935,12 @@ The dashboard is still available at `http://localhost:PORT` — it just won't au
 
 ---
 
+## The Bigger Picture
+
+This agent is designed to work with an **SDD-based requirement management and automated development system** — a server application that links requirement management → automated development → plans and artifacts. The full system architecture is documented in [`docs/spec_SDD_with_ucagent_requirement.md`](docs/spec_SDD_with_ucagent_requirement.md). Use it as a reference to build your own system tailored to your needs.
+
+---
+
 ## License
 
 GPL-3.0

package/agents/en/agent-flow.md

@@ -1,106 +1,106 @@
-# Agent Flow — Main Claude Orchestration Guide
-
-> **All agent invocations are performed by Main Claude.**
-> Subagents only return results (dispatch XML or task-result XML) after completing their work.
-> Main Claude receives the return values and invokes the next agent.
-
----
-
-## Execution Mode Decision
-
-```
-[] tag detected → invoke router
-    │
-    Check router return value (execution-mode)
-    │
-    ├─ direct   → router handles everything (no additional invocations)
-    ├─ pipeline → Execute § pipeline procedure
-    └─ full     → Execute § full procedure
-```
-
----
-
-## direct Mode
-
-Router handles everything on its own. No additional invocations by Main Claude.
-
----
-
-## pipeline Mode
-
-```
-1. Invoke router → creates PLAN.md + TASK-00.md + returns builder dispatch XML
-2. Invoke builder (dispatch XML as prompt)
-3. Invoke verifier (builder result as prompt)
-4. Invoke committer (verifier result as prompt)
-```
-
----
-
-## full Mode
-
-```
-1. Invoke router → creates WORK directory + returns planner dispatch XML
-2. Invoke planner (dispatch XML as prompt) → creates PLAN.md + TASK files
-3. Invoke scheduler → DAG analysis + READY TASK + returns builder dispatch XML
-4. Invoke builder (dispatch XML as prompt) → implementation
-5. Invoke verifier (builder result as prompt) → verification
-6. Invoke committer (verifier result as prompt) → commit
-7. If incomplete TASKs remain, return to step 3
-```
-
-Parallel execution: If scheduler returns multiple READY TASKs, invoke builders concurrently.
-
----
-
-## Agent Role Summary
-
-| Agent | Return Value | Invoked By |
-|-------|-------------|------------|
-| router | execution-mode + dispatch XML | Main Claude |
-| planner | PLAN.md/TASK file creation completion report | Main Claude |
-| scheduler | READY TASK + dispatch XML | Main Claude |
-| builder | task-result XML (includes context-handoff) | Main Claude |
-| verifier | task-result XML | Main Claude |
-| committer | task-result XML + commit hash | Main Claude |
-
----
-
-## Bash CLI Execution (Server Automation)
-
-Method to run pipeline independently without an interactive 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 blocking |
-| `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
-```
-
-Verification result (WORK-24): `claude -p` → 9 Task tool invocations → full auto-completion of router/planner/scheduler/builder/verifier/committer confirmed.
-
----
-
-## Context Transfer (Sliding Window)
-
-| Distance | Level | Content |
-|----------|-------|---------|
-| Immediate predecessor | FULL | what + why + caution + incomplete |
-| 2 steps back | SUMMARY | what only, 1-2 lines |
-| 3+ steps back | DROP | Not transmitted |
+# Agent Flow — Main Claude Orchestration Guide
+
+> **All agent invocations are performed by Main Claude.**
+> Subagents only return results (dispatch XML or task-result XML) after completing their work.
+> Main Claude receives the return values and invokes the next agent.
+
+---
+
+## Execution Mode Decision
+
+```
+[] tag detected → invoke router
+    │
+    Check router return value (execution-mode)
+    │
+    ├─ direct   → router handles everything (no additional invocations)
+    ├─ pipeline → Execute § pipeline procedure
+    └─ full     → Execute § full procedure
+```
+
+---
+
+## direct Mode
+
+Router handles everything on its own. No additional invocations by Main Claude.
+
+---
+
+## pipeline Mode
+
+```
+1. Invoke router → creates PLAN.md + TASK-00.md + returns builder dispatch XML
+2. Invoke builder (dispatch XML as prompt)
+3. Invoke verifier (builder result as prompt)
+4. Invoke committer (verifier result as prompt)
+```
+
+---
+
+## full Mode
+
+```
+1. Invoke router → creates WORK directory + returns planner dispatch XML
+2. Invoke planner (dispatch XML as prompt) → creates PLAN.md + TASK files
+3. Invoke scheduler → DAG analysis + READY TASK + returns builder dispatch XML
+4. Invoke builder (dispatch XML as prompt) → implementation
+5. Invoke verifier (builder result as prompt) → verification
+6. Invoke committer (verifier result as prompt) → commit
+7. If incomplete TASKs remain, return to step 3
+```
+
+Parallel execution: If scheduler returns multiple READY TASKs, invoke builders concurrently.
+
+---
+
+## Agent Role Summary
+
+| Agent | Return Value | Invoked By |
+|-------|-------------|------------|
+| router | execution-mode + dispatch XML | Main Claude |
+| planner | PLAN.md/TASK file creation completion report | Main Claude |
+| scheduler | READY TASK + dispatch XML | Main Claude |
+| builder | task-result XML (includes context-handoff) | Main Claude |
+| verifier | task-result XML | Main Claude |
+| committer | task-result XML + commit hash | Main Claude |
+
+---
+
+## Bash CLI Execution (Server Automation)
+
+Method to run pipeline independently without an interactive 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 blocking |
+| `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
+```
+
+Verification result (WORK-24): `claude -p` → 9 Task tool invocations → full auto-completion of router/planner/scheduler/builder/verifier/committer confirmed.
+
+---
+
+## Context Transfer (Sliding Window)
+
+| Distance | Level | Content |
+|----------|-------|---------|
+| Immediate predecessor | FULL | what + why + caution + incomplete |
+| 2 steps back | SUMMARY | what only, 1-2 lines |
+| 3+ steps back | DROP | Not transmitted |

package/agents/en/builder.md

@@ -35,11 +35,11 @@ You are the **Builder** — the implementation agent that receives a TASK specif
 
 | File | Purpose |
 |------|---------|
-| `agents/file-content-schema.md` | File format schema |
-| `agents/shared-prompt-sections.md` | Common rules (TASK ID, PLAN.md 7 fields, WORK-LIST) |
-| `agents/xml-schema.md` | XML communication format |
-| `agents/context-policy.md` | Sliding window rules |
-| `agents/work-activity-log.md` | Activity Log rules (log_work function, STAGE table) |
+| `.claude/agents/file-content-schema.md` | File format schema |
+| `.claude/agents/shared-prompt-sections.md` | Common rules (TASK ID, PLAN.md 7 fields, WORK-LIST) |
+| `.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
 

package/agents/en/committer.md

@@ -35,11 +35,11 @@ You are the **Committer** — the agent that generates the result report for a v
 
 | File | Purpose |
 |------|---------|
-| `agents/file-content-schema.md` | File format schema |
-| `agents/shared-prompt-sections.md` | Common rules |
-| `agents/xml-schema.md` | XML communication format |
-| `agents/context-policy.md` | Sliding window rules |
-| `agents/work-activity-log.md` | Activity Log rules (log_work function, STAGE table) |
+| `.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
 
@@ -66,7 +66,7 @@ On gate failure:
 
 ### 3-4. Result Report Generation
 
-→ see `agents/file-content-schema.md` § 4 (format + language-specific section headers)
+→ 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
@@ -156,7 +156,7 @@ Committer-specific additional fields:
 ```
 
 Do not change WORK-LIST.md to COMPLETED — changed only at git push time.
-→ see `agents/shared-prompt-sections.md` § 8
+→ see `.claude/agents/shared-prompt-sections.md` § 8
 
 ---
 

package/agents/en/context-policy.md

@@ -56,7 +56,7 @@ Processing:
 2. Gate passed → write result.md + git commit
 3. Gate failed → return FAIL (triggers scheduler retry)
 
-Output: → `agents/file-content-schema.md` § 4 reference
+Output: → `.claude/agents/file-content-schema.md` § 4 reference
 
 ## Inter-TASK Dependency Transfer