@adamancyzhang/claude-orchestrator 0.3.2 → 0.4.0

package/dist/orchestrator/run.js

@@ -0,0 +1,181 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fork } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { loadConfig, loadGlobalConfig, saveInstanceConfig } from "../config.js";
+import { Logger } from "../utils/logger.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const logger = new Logger("Orchestrator");
+let shuttingDown = false;
+export async function runOrchestrator(config) {
+    // Phase 1: Environment self-check + config
+    await ensureEnvironment();
+    // Phase 2: Role assignment & worktree initialization
+    const { initializeWorktrees } = await import("../worker/worktree-initializer.js");
+    const worktreeConfigs = await initializeWorktrees(process.cwd(), config.workerCount);
+    logger.info(`Worktrees ready: ${worktreeConfigs.map(w => `${w.name}(${w.role})`).join(", ")}`);
+    // Phase 3: Start Leader TUI
+    const { startLeader } = await import("../leader/index.js");
+    const leaderReady = new Promise((resolve) => {
+        // Give leader a tick to start, then resolve
+        setTimeout(resolve, 500);
+    });
+    startLeader({
+        zkHosts: config.zkHosts,
+        name: config.name,
+        debug: config.debug ?? false,
+        worktreeConfigs,
+    }).catch((err) => {
+        logger.error("Leader failed", err);
+        process.exit(1);
+    });
+    await leaderReady;
+    // Phase 4: Start Worker child processes
+    const children = await startAllWorkers({
+        zkHosts: config.zkHosts,
+        configs: worktreeConfigs,
+        debug: config.debug ?? false,
+    });
+    // Phase 5: Wait for shutdown
+    await handleShutdown(children);
+}
+async function ensureEnvironment() {
+    // 1. Ensure global config ~/.claude-orchestrator/config.json
+    const existingGlobal = loadGlobalConfig();
+    if (!existingGlobal.commands?.["claude-cli"] || !existingGlobal.cache_dir) {
+        const prevCommands = existingGlobal.commands;
+        const prevHooks = existingGlobal.hooks;
+        saveInstanceConfig({
+            commands: {
+                "claude-cli": prevCommands?.["claude-cli"] || "claude --dangerously-skip-permissions --permission-mode dontAsk",
+            },
+            hooks: prevHooks || {
+                leader_message_start: null,
+                leader_message_end: null,
+                worker_message_start: null,
+                worker_message_end: null,
+            },
+            cache_dir: existingGlobal.cache_dir || "~/.claude-orchestrator/sessions",
+            zookeeper: existingGlobal.zookeeper || {
+                url: "127.0.0.1:2181",
+                root_path: "/claude-orchestrator",
+                auth: null,
+            },
+        }, true);
+    }
+    // 2. Copy templates to .claude-orchestrator/agents/
+    const templateDir = path.join(__dirname, "..", "templates");
+    const agentsDir = path.join(process.cwd(), ".claude-orchestrator", "agents");
+    const templates = {
+        "worker-decompose.md": path.join(templateDir, "agents", "worker-decompose.md"),
+        "worker-evaluate.md": path.join(templateDir, "agents", "worker-evaluate.md"),
+        "worker-plan.md": path.join(templateDir, "agents", "worker-plan.md"),
+        "worker-build.md": path.join(templateDir, "agents", "worker-build.md"),
+        "worker-verify.md": path.join(templateDir, "agents", "worker-verify.md"),
+        "worker-review.md": path.join(templateDir, "agents", "worker-review.md"),
+        "worker-accept.md": path.join(templateDir, "agents", "worker-accept.md"),
+    };
+    for (const [filename, srcPath] of Object.entries(templates)) {
+        const destPath = path.join(agentsDir, filename);
+        if (!fs.existsSync(destPath)) {
+            fs.mkdirSync(agentsDir, { recursive: true });
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+    // Copy team-level CLAUDE.md to project root (if not exists)
+    const teamClaudeSrc = path.join(templateDir, "claude-memory", "team-claude.md");
+    const teamClaudeDest = path.join(process.cwd(), "CLAUDE.md");
+    if (fs.existsSync(teamClaudeSrc) && !fs.existsSync(teamClaudeDest)) {
+        fs.copyFileSync(teamClaudeSrc, teamClaudeDest);
+    }
+    // 3. Copy skills to .claude/skills/
+    const skillsSrcDir = path.join(__dirname, "..", "skills");
+    const skillsDstDir = path.join(process.cwd(), ".claude", "skills");
+    const SKILLS_TO_COPY = [
+        "task-planning",
+        "task-execution",
+        "task-verification",
+        "task-review",
+        "task-acceptance",
+        "task-traceability",
+        "claude-orchestrator",
+    ];
+    if (fs.existsSync(skillsSrcDir)) {
+        for (const skillName of SKILLS_TO_COPY) {
+            const srcSkillPath = path.join(skillsSrcDir, skillName, "SKILL.md");
+            const dstSkillDir = path.join(skillsDstDir, skillName);
+            const dstSkillPath = path.join(dstSkillDir, "SKILL.md");
+            if (!fs.existsSync(srcSkillPath))
+                continue;
+            if (fs.existsSync(dstSkillDir)) {
+                fs.rmSync(dstSkillDir, { recursive: true, force: true });
+            }
+            fs.mkdirSync(dstSkillDir, { recursive: true });
+            fs.copyFileSync(srcSkillPath, dstSkillPath);
+        }
+    }
+}
+async function startAllWorkers(opts) {
+    const resolvedConfig = loadConfig({ zookeeper: opts.zkHosts });
+    const children = [];
+    const restartCount = new Map();
+    function spawnChild(cfg) {
+        const child = fork(path.join(__dirname, "..", "worker", "child.js"), [JSON.stringify({
+                worktreePath: cfg.worktreePath,
+                name: cfg.name,
+                role: cfg.role,
+                instanceId: cfg.instanceId,
+                branch: cfg.branch,
+                zkHosts: opts.zkHosts,
+                debug: opts.debug,
+                cliCommand: resolvedConfig.cliCommand,
+                cacheDir: resolvedConfig.cacheDir,
+            })], { stdio: "inherit" });
+        child.on("exit", (code, signal) => {
+            if (shuttingDown)
+                return;
+            const retries = restartCount.get(cfg.name) ?? 0;
+            if (code !== 0 && code !== null && retries < 3) {
+                logger.warn(`Worker ${cfg.name} exited (code=${code}), restart ${retries + 1}/3`);
+                restartCount.set(cfg.name, retries + 1);
+                const newChild = spawnChild(cfg);
+                const idx = children.indexOf(child);
+                if (idx !== -1)
+                    children[idx] = newChild;
+            }
+            else if (code !== 0 && code !== null) {
+                logger.error(`Worker ${cfg.name} max retries exceeded, giving up`);
+            }
+        });
+        return child;
+    }
+    for (const cfg of opts.configs) {
+        children.push(spawnChild(cfg));
+    }
+    return children;
+}
+async function handleShutdown(children) {
+    return new Promise((resolve) => {
+        const cleanup = () => {
+            shuttingDown = true;
+            for (const child of children) {
+                try {
+                    child.kill("SIGTERM");
+                }
+                catch { /* already dead */ }
+            }
+            resolve();
+        };
+        process.once("SIGINT", cleanup);
+        process.once("SIGTERM", cleanup);
+        process.on("exit", () => {
+            for (const child of children) {
+                try {
+                    child.kill("SIGTERM");
+                }
+                catch { /* already dead */ }
+            }
+        });
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/orchestrator/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/orchestrator/run.ts"],"names":[],"mappings":"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"}

package/dist/skills/CLAUDE.md

@@ -38,7 +38,7 @@ Leader (协调层)
 Multi-agent orchestration CLI backed by ZooKeeper。所有角色都使用它来完成基础设施操作：注册实例、认领任务、发送消息、读写共享上下文。
 
 - **入口**: `claude-orchestrator <command>`
-- **关键命令**: `register`, `claim-task`, `complete-task`, `push-task`, `send-message`, `set-context`, `get-context`
+- **关键命令**: `register`, `claim-task`, `complete-task`, `push-task`, `send-message`
 - **适用角色**: 所有角色
 
 ### task-planning

package/dist/skills/claude-orchestrator/SKILL.md

@@ -1,244 +1,102 @@
 ---
 name: claude-orchestrator
-description: Multi-agent orchestration CLI backed by ZooKeeper for service discovery. Register instances, distribute tasks, send messages, and share context across Claude Code instances. Use when the user wants to register, join a team, claim tasks, send messages, check status, or any orchestrator operation.
+description: Multi-agent orchestration system reference for Workers. Covers the v0.4 unified run command, worktree isolation, directory memory (CLAUDE.md), responsibility chain (Plan→Build→Verify→Review→Accept), output standards, and common pitfalls. Use this skill whenever a Worker executes any link in the responsibility chain — read it at session start and whenever you are unsure about process, output paths, or role boundaries.
 ---
 
-# Claude Orchestrator
+# Claude Orchestrator — Worker Reference
 
-A CLI that provides multi-agent orchestration directly on top of ZooKeeper. Every Claude Code instance becomes a discoverable agent — register, claim tasks, communicate, and share context without a middleman server.
+You are a Worker in a multi-agent orchestration system. Your work is coordinated through ZooKeeper. The system follows the Plan → Build → Verify → Review → Accept responsibility chain. This reference helps you stay on track.
 
-## Architecture
+## Quick Orientation
 
-```
-Claude Code  ──CLI──>  ZooKeeper
-(instance A)          (service discovery, task queue, messages, context)
+When you start working, locate these files:
 
-Claude Code  ──CLI──>  ZooKeeper
-(instance B)
-```
+| File | Purpose | Read When |
+|------|---------|-----------|
+| `CLAUDE.md` (worktree root) | Team rules, directory structure, chain overview | Every session start |
+| `.claude-orchestrator/docs/{your_name}/CLAUDE.md` | Your role-specific rules and output standards | Every session start |
+| `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/CLAUDE.md` | Today's session memory | Every session start (create if missing) |
+| `.claude/skills/task-traceability/SKILL.md` | Foundation: Trace → Execute → Map → Evidence → Record | Every task |
+| `.claude/skills/{your_link_skill}/SKILL.md` | Your link-specific process | When starting your link |
 
-Every CLI command talks directly to ZooKeeper. Instance discovery is via ephemeral znodes. Tasks use sequential znodes for FIFO ordering. Messages use watch-based push.
+## Directory Memory Rules (Non-Negotiable)
 
-## Setup
+1. **All your output goes under** `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/` (use today's date)
+2. **Every daily directory must have a `CLAUDE.md`** — update it after each completed sub-task
+3. **Read upstream artifacts from their docs directories** before starting your link
+4. **Write your artifact to the docs directory** so the next Worker can find it
 
-```bash
-npm install -g @adamancyzhang/claude-orchestrator
-docker-compose up -d   # start ZooKeeper
-```
+### Artifact Names by Link
 
-Initialize environment:
+| Your Link | Your Output File | Who Reads It |
+|-----------|-----------------|--------------|
+| plan | `blueprint.md` | Builder, Verifier, Reviewer, Accepter |
+| build | `traceability-map.md` + `evidence/` | Verifier, Reviewer, Accepter |
+| verify | `verification-map.md` + `evidence/` | Reviewer, Accepter |
+| review | `review-judgment.md` | Accepter |
+| accept | `acceptance-report.md` | (chain closes) |
 
-```bash
-# Leader (team coordinator):
-claude-orchestrator setup --leader --name Tom
+## Responsibility Chain Rules
 
-# Worker (the doers):
-claude-orchestrator setup --name Jerry --role builder
-```
+### Every Link Must
 
-This creates:
-- `.claude-orchestrator/agents/` — message templates (7 templates for leader + 5 worker links)
-- `.claude/skills/` — 8 Claude Code skills (responsibility chain + infrastructure)
-- `.claude-orchestrator/config.json` — project config (name, role)
-- `~/.claude-orchestrator/config.json` — global config (ZK hosts, CLI command, cache dir)
+1. **Trace** — Read upstream artifacts before starting. If missing → BLOCKED, report to Leader.
+2. **Execute** — Follow the standard process in your skill file.
+3. **Map** — Link every output to a specific upstream requirement.
+4. **Evidence** — Provide verifiable proof (not claims) for every output.
+5. **Record** — Write to BOTH `{{result_path}}` (for Leader) AND `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/{artifact}.md` (for downstream).
 
-Verify:
+### Role Boundaries
 
-```bash
-claude-orchestrator config
-# Shows current configuration
-```
+| Role | You DO | You DO NOT |
+|------|--------|------------|
+| **Planner** | Define blueprints with verifiable criteria | Implement code (Builder's job) |
+| **Builder** | Implement per blueprint, produce evidence | Make architectural decisions (Planner's job) |
+| **Verifier** | Check Builder output against Plan | Judge architecture (Reviewer's job) |
+| **Reviewer** | Judge full chain quality | Re-verify or re-implement |
+| **Accepter** | Validate against business criteria | Re-verify, re-review, or conditional-pass |
 
-## Global Options
+### Self-Evaluation
 
-| Option | Env var | Default | Description |
-|--------|---------|---------|-------------|
-| `--zookeeper`, `-z` | `ZK_HOSTS` | `127.0.0.1:2181` | ZooKeeper connection string |
-| `--instance-id`, `-i` | — | auto (from config) | Override stored instance ID |
+After completing your link, self-evaluate:
+- Criteria fully met AND artifacts in place → `activate_next`
+- Anything missing → `feedback` with specifics
+- Accept link passes → `close_chain`
 
-## Commands
+## Common Pitfalls (Avoid These)
 
-### Leader
+1. **Writing output to the wrong directory** — Always use `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/`, never scatter files at the worktree root.
+2. **Skipping upstream artifact read** — For build/verify/review/accept, you MUST find and read the previous Worker's output from their docs directory. If you skip this, the responsibility chain is broken.
+3. **Vague completion criteria** — "Works correctly" is not verifiable. Use specific commands and expected outputs (e.g., "curl -X POST /api/login returns 201 with a valid JWT in the response body").
+4. **"Code level already implemented"** — This phrase is banned. Every claim needs evidence: actual command output, test results, file contents.
+5. **Conditional pass (Accept link)** — There is no conditional GO. Zero issues for GO. If any criterion fails → NO-GO.
+6. **Not updating daily CLAUDE.md** — If your session is interrupted, your progress is lost. Update `CLAUDE.md` after each sub-task.
+7. **Overstepping your role** — Verifiers should not re-architect. Reviewers should not re-implement. Trust upstream, verify independently, stay in your lane.
+8. **Forgetting the dual-write** — You must write output to BOTH `{{result_path}}` AND `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/`. The first is for the Leader's evaluation, the second is for the next Worker to read.
 
-```bash
-claude-orchestrator leader --name Tom
-# Launches read-only TUI: team panel, task board, event log
-```
+## Startup Checklist (Every Session)
 
-Only one Leader at a time (ZK ephemeral node). The TUI shows who's online, what tasks are in each state, and a scrolling event log.
+- [ ] Read `CLAUDE.md` at worktree root
+- [ ] Read `.claude-orchestrator/docs/{your_name}/CLAUDE.md`
+- [ ] Read or create `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/CLAUDE.md`
+- [ ] Identify your current link and read the corresponding skill
+- [ ] For build/verify/review/accept: find upstream artifact paths in `docs/`
 
-### Registration
+## Shutdown Checklist (Every Session)
 
-**Setup** — one-time initialization:
+- [ ] Confirm today's artifact is in `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/`
+- [ ] Confirm evidence files are saved
+- [ ] Update daily CLAUDE.md with completion status and artifact paths
+- [ ] If build link: confirm code is committed with your name signature
+- [ ] Record any blockers or unfinished items for the next session
 
-```bash
-claude-orchestrator setup --leader --name Tom                    # Leader
-claude-orchestrator setup --name Jerry --role builder             # Worker
-claude-orchestrator setup --name Lucy --role verifier \
-  --cache-dir ~/shared/sessions --command "claude -p"             # Custom CLI
-```
+## Skills Reference
 
-Setup options:
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `--leader` | false | Initialize as Leader environment |
-| `--name <name>` | — | Instance display name |
-| `--role <role>` | builder | Role: planner, builder, verifier, reviewer, accepter |
-| `--cache-dir <path>` | `~/.claude-orchestrator/sessions` | Shared cache directory |
-| `--command <cmd>` | `claude --dangerously-skip-permissions --permission-mode dontAsk` | Claude CLI command |
-| `--global` | false | Write only global config, skip project files |
-
-**Register** — join the swarm:
-
-```bash
-# Connect and listen for messages (reads name/role from .claude-orchestrator/config.json):
-claude-orchestrator register
-# Worker Watcher starts, listens for messages, processes via claude -p
-# Press Ctrl+C to stop and unregister
-```
-
-Registration creates an ephemeral ZK node. The instance auto-deregisters on disconnect (Ctrl+C or timeout). The Worker Watcher listens for messages on `/messages/{instance_id}` and processes them using the template that matches the message's `link` field.
-
-**Unregister:**
-
-```bash
-claude-orchestrator unregister
-```
-
-### Tasks
-
-**Push a task** to the queue:
-
-```bash
-claude-orchestrator push-task --title "Implement login endpoint" --priority 0
-claude-orchestrator push-task --title "Verify auth module" --link verify --priority 1
-claude-orchestrator push-task --title "Review PR #42" --link review --assignee <instance-id>
-claude-orchestrator push-task --title "Part 2" --chain-id chain-001 --depends-on task-0000000001
-```
-
-Push options:
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `--title <text>` | required | Task title |
-| `--description <text>` | "" | Task description |
-| `--priority <n>` | 1 | 0=HIGH, 1=MEDIUM, 2=LOW |
-| `--assignee <id>` | — | Target instance ID |
-| `--link <link>` | — | Responsibility chain link: plan, build, verify, review, accept |
-| `--chain-id <id>` | — | Group related tasks under one chain |
-| `--depends-on <ids>` | — | Comma-separated task IDs this task depends on |
-| `--blocked-by <ids>` | — | Comma-separated task IDs blocking this task |
-
-**Claim a task** — FIFO, higher priority first, assigned-to-you tasks jump the queue:
-
-```bash
-claude-orchestrator claim-task
-# → { "id": "task-0000000001", "title": "Implement login endpoint", "status": "claimed", ... }
-# → { "status": "no_tasks", "message": "No pending tasks available." }
-```
-
-**Complete a task:**
-
-```bash
-claude-orchestrator complete-task --task-id task-0000000001 --result "PR #42 — login endpoint with tests"
-```
-
-**Poll tasks:**
-
-```bash
-claude-orchestrator poll-task
-claude-orchestrator poll-task --status pending
-claude-orchestrator poll-task --status claimed
-claude-orchestrator poll-task --status completed
-claude-orchestrator poll-task --status blocked
-claude-orchestrator poll-task --status failed
-```
-
-**Task lifecycle commands:**
-
-```bash
-claude-orchestrator task-block --task-id task-0000000001 --reason "Waiting for API key"
-claude-orchestrator task-fail --task-id task-0000000001 --reason "Test environment unavailable"
-claude-orchestrator task-retry --task-id task-0000000001
-# → Re-queued with retry_count + 1 (max 3 retries)
-```
-
-Task state machine:
-
-```
-pending → claimed → in_progress → completed
-                            → blocked → pending (retry)
-                            → failed  → pending (retry, max 3)
-claimed → pending (Worker disconnect, Leader recovers orphan)
-```
-
-### Messages
-
-**Send a direct message:**
-
-```bash
-claude-orchestrator send-message --to-name Jerry --content "Can you review my PR?"
-```
-
-**Broadcast to all:**
-
-```bash
-claude-orchestrator send-message --broadcast --content "CI is down, don't push"
-```
-
-**Request help** (broadcasts to all with help flag):
-
-```bash
-claude-orchestrator send-message --request-help --broadcast --content "How do I test the auth flow?"
-```
-
-**Poll messages:**
-
-```bash
-claude-orchestrator poll-message
-# [{ "id": "msg-...", "type": "direct", "from_name": "Tom", "content": "...", "read": true }]
-```
-
-**Delete a message:**
-
-```bash
-claude-orchestrator delete-message --message-id msg-0000000000
-```
-
-### Config
-
-```bash
-claude-orchestrator config
-# Shows global and project configuration
-```
-
-## Roles
-
-| Role | Value | Typical behavior |
-|------|-------|-----------------|
-| Leader | `leader` | Runs TUI, monitors team, recovers orphaned tasks |
-| Planner | `planner` | Uses `task-planning` + `task-traceability` skills |
-| Builder | `builder` | Uses `task-execution` + `task-traceability` skills |
-| Verifier | `verifier` | Uses `task-verification` + `task-traceability` skills |
-| Reviewer | `reviewer` | Uses `task-review` + `task-traceability` skills |
-| Accepter | `accepter` | Uses `task-acceptance` + `task-traceability` skills |
-
-## Workflow
-
-A typical agent session:
-
-```bash
-# 1. Initialize (first time only)
-claude-orchestrator setup --name Jerry --role builder
-
-# 2. Join the team — Worker Watcher auto-processes incoming messages via claude -p
-claude-orchestrator register
-# Press Ctrl+C to stop and unregister
-```
-
-## Error recovery
-
-- **ZooKeeper not connected**: check `docker-compose ps`, retry. ZK client auto-reconnects.
-- **"No instance_id found"**: run `setup` first, or check `.claude-orchestrator/config.json`
-- **Registration expired**: ephemeral nodes cleaned up on disconnect. Re-register to restore identity.
+| Skill File | When to Read |
+|------------|-------------|
+| `.claude/skills/task-traceability/SKILL.md` | Every link — foundation |
+| `.claude/skills/task-planning/SKILL.md` | Plan link only |
+| `.claude/skills/task-execution/SKILL.md` | Build link only |
+| `.claude/skills/task-verification/SKILL.md` | Verify link only |
+| `.claude/skills/task-review/SKILL.md` | Review link only |
+| `.claude/skills/task-acceptance/SKILL.md` | Accept link only |

package/dist/templates/agents/worker-accept.md

@@ -0,0 +1,48 @@
+Your link in the responsibility chain is **Accept** — the final gate. Validate the complete deliverable against business acceptance criteria. Make the Go/No-Go decision. No conditional pass.
+
+## Step 0: Restore Directory Memory
+
+Read `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` to restore session context (create the directory and seed it if new). Read your personal CLAUDE.md at `.claude-orchestrator/docs/{{name}}/CLAUDE.md`.
+
+## Task
+
+- **Title**: {{task_title}}
+- **Description**: {{task_description}}
+- **Criteria**: {{task_criteria}}
+- **Spec**: {{task_doc_path}}
+
+## Process
+
+Use the **task-acceptance** skill (read `.claude/skills/task-acceptance/SKILL.md`).
+
+**Read all four upstream artifacts (required)**:
+1. `.claude-orchestrator/docs/{planner_name}/YYYY-MM-DD/blueprint.md`
+2. `.claude-orchestrator/docs/{builder_name}/YYYY-MM-DD/traceability-map.md`
+3. `.claude-orchestrator/docs/{verifier_name}/YYYY-MM-DD/verification-map.md`
+4. `.claude-orchestrator/docs/{reviewer_name}/YYYY-MM-DD/review-judgment.md`
+Fallback: `{{task_doc_path}}`. If any is missing → cannot accept, report to Leader.
+
+For each acceptance criterion: does the deliverable exist? Are Verifier FAILUREs resolved? Are Reviewer CONCERNs addressed? Is evidence independently verifiable?
+
+- **GO**: All criteria met. Zero issues.
+- **NO-GO**: Any criterion unmet. Specify what's missing and which link must address it.
+
+## Outputs
+
+1. Write acceptance report to **{{result_path}}** (for Leader)
+2. Write identical copy to **.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/acceptance-report.md**
+
+## Completion Report
+
+```
+Link: accept
+Status: completed
+Decision: GO | NO-GO
+Criteria Checked: <count> | Passed: <count> | Failed: <count>
+Upstream Issues: Verifier FAILUREs <resolved>/<total>, Reviewer CONCERNs <addressed>/<total>
+Failed Criteria (NO-GO): <list each with responsible link>
+Acceptance Report: .claude-orchestrator/docs/{{name}}/YYYY-MM-DD/acceptance-report.md
+Upstream Artifacts Read: <list all four paths>
+```
+
+Update `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md`.

package/dist/templates/agents/worker-build.md

@@ -0,0 +1,38 @@
+Your link in the responsibility chain is **Build** — produce verifiable results according to the Planner's blueprint.
+
+## Step 0: Restore Directory Memory
+
+Read `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` to restore session context (create the directory and seed it if new). Read your personal CLAUDE.md at `.claude-orchestrator/docs/{{name}}/CLAUDE.md`.
+
+## Task
+
+- **Title**: {{task_title}}
+- **Description**: {{task_description}}
+- **Criteria**: {{task_criteria}}
+- **Spec**: {{task_doc_path}}
+
+## Process
+
+Use the **task-execution** skill (read `.claude/skills/task-execution/SKILL.md`). Use **task-traceability** (`.claude/skills/task-traceability/SKILL.md`) as the foundational layer. Follow Trace → Execute → Map → Evidence → Record.
+
+**Trace**: Read the Planner's blueprint from `.claude-orchestrator/docs/{planner_name}/YYYY-MM-DD/blueprint.md`. Fallback: `{{task_doc_path}}`. Extract every implementable requirement as a checklist.
+
+## Outputs
+
+1. Write traceability map to **{{result_path}}** (for Leader evaluation)
+2. Write identical copy to **.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/traceability-map.md** (for Verifier)
+3. Save evidence files to **.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/evidence/**
+
+## Completion Report
+
+```
+Link: build
+Status: completed
+Implemented: <count> items
+Deviations: <count> items (list each with reason)
+Evidence: .claude-orchestrator/docs/{{name}}/YYYY-MM-DD/evidence/
+Traceability Map: .claude-orchestrator/docs/{{name}}/YYYY-MM-DD/traceability-map.md
+Next Link Ready: yes
+```
+
+Update `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md`. Git commit with your name signature.

package/dist/templates/agents/worker-decompose.md

@@ -0,0 +1,40 @@
+Break down the requirement below into a chain of tasks following the Plan → Build → Verify → Review → Accept responsibility chain.
+
+## Step 0: Restore Directory Memory
+
+Read `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` (use today's date) to restore session context. If it doesn't exist, create the directory and seed it with today's date, your name and role. Read your personal CLAUDE.md at `.claude-orchestrator/docs/{{name}}/CLAUDE.md` for role-specific rules.
+
+## Requirement
+
+{{task_description}}
+
+## Instructions
+
+1. Analyze the requirement. Identify how many independent delivery chains are needed.
+2. For each chain, define five link tasks. Plan is optional (set to null when the requirement is clear enough to build directly). Build, Verify, Review, and Accept are mandatory.
+3. For each task, specify objectively verifiable completion criteria — use concrete commands and expected outputs, not vague descriptions.
+4. Assign priority: 0 (urgent), 1 (high), 2 (normal).
+
+## Output
+
+Write the result to {{result_path}}. Also save a copy to `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/chain-def.json`.
+
+```json
+{
+  "chain_id": "chain-<seq>",
+  "chain_title": "<short summary>",
+  "tasks": {
+    "plan": {"title": "<title>", "description": "<desc>", "criteria": "<verifiable criteria>", "priority": 1} | null,
+    "build": {"title": "<title>", "description": "<desc>", "criteria": "<verifiable criteria>", "priority": 1},
+    "verify": {"title": "<title>", "description": "<what and how to verify>", "criteria": "<verifiable criteria>", "priority": 1},
+    "review": {"title": "<title>", "description": "<what to review>", "criteria": "<verifiable criteria>", "priority": 1},
+    "accept": {"title": "<title>", "description": "<what to validate>", "criteria": "<verifiable criteria>", "priority": 1}
+  }
+}
+```
+
+Output ONLY the JSON. No explanation.
+
+## Record
+
+After completion, update `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` with the chain_id and chain_title.