cclaw-cli 6.14.3 → 7.0.0

package/dist/artifact-linter.js

@@ -1,7 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { resolveArtifactPath as resolveStageArtifactPath } from "./artifact-paths.js";
-import { effectiveIntegrationOverseerMode, effectiveTddCheckpointMode, effectiveWorktreeExecutionMode } from "./flow-state.js";
 import { exists } from "./fs-utils.js";
 import { stageSchema } from "./content/stage-schema.js";
 import { readFlowState } from "./run-persistence.js";
@@ -110,7 +109,7 @@ export async function lintArtifact(projectRoot, stage, track = "standard", optio
     const overrideSet = isTrivialOverride
         ? new Set(schema.trivialOverrideSections.map((s) => normalizeHeadingTitle(s).toLowerCase()))
         : null;
-    // Wave 25: precompute the lite-tier signal so the per-section
+    // Precompute the lite-tier signal so the per-section
     // validators (Interaction Edge Case matrix today, others tomorrow)
     // can relax network-dependent mandatory rows for lite/quick/bugfix
     // runs without each validator having to re-derive the predicate.
@@ -119,15 +118,10 @@ export async function lintArtifact(projectRoot, stage, track = "standard", optio
     let activeStageFlags = [];
     let discoveryMode = "guided";
     let taskClass = null;
+    let packageVersion;
     let activeRunId = null;
     let completedStagesForAudit = [];
     let completedStageMetaForAudit;
-    let legacyContinuation = false;
-    let worktreeExecutionMode = "single-tree";
-    let tddCheckpointMode = "per-slice";
-    let integrationOverseerMode = "always";
-    let tddCutoverSliceId = "";
-    let tddWorktreeCutoverSliceId = "";
     try {
         const flowState = await readFlowState(projectRoot);
         const hint = flowState.interactionHints?.[stage];
@@ -135,29 +129,19 @@ export async function lintArtifact(projectRoot, stage, track = "standard", optio
             activeStageFlags.push("--skip-questions");
         discoveryMode = flowState.discoveryMode ?? "guided";
         taskClass = flowState.taskClass ?? null;
+        packageVersion = flowState.packageVersion;
         activeRunId = flowState.activeRunId ?? null;
         completedStagesForAudit = flowState.completedStages;
         completedStageMetaForAudit = flowState.completedStageMeta;
-        legacyContinuation = flowState.legacyContinuation === true;
-        worktreeExecutionMode = effectiveWorktreeExecutionMode(flowState);
-        tddCheckpointMode = effectiveTddCheckpointMode(flowState);
-        integrationOverseerMode = effectiveIntegrationOverseerMode(flowState);
-        tddCutoverSliceId = flowState.tddCutoverSliceId ?? "";
-        tddWorktreeCutoverSliceId = flowState.tddWorktreeCutoverSliceId ?? "";
     }
     catch {
         activeStageFlags = [];
         discoveryMode = "guided";
         taskClass = null;
+        packageVersion = undefined;
         activeRunId = null;
         completedStagesForAudit = [];
         completedStageMetaForAudit = undefined;
-        legacyContinuation = false;
-        worktreeExecutionMode = "single-tree";
-        tddCheckpointMode = "per-slice";
-        integrationOverseerMode = "always";
-        tddCutoverSliceId = "";
-        tddWorktreeCutoverSliceId = "";
     }
     for (const extra of options.extraStageFlags ?? []) {
         if (typeof extra === "string" && extra.length > 0 && !activeStageFlags.includes(extra)) {
@@ -165,9 +149,9 @@ export async function lintArtifact(projectRoot, stage, track = "standard", optio
         }
     }
     const liteTierForValidators = shouldDemoteArtifactValidationByTrack(track, taskClass);
-    // v6.11.0 (D5) — pre-resolve RED/GREEN Evidence pointers AND
+    // pre-resolve RED/GREEN Evidence pointers AND
     // delegation phase events so `validateSectionBody` (sync) can
-    // short-circuit. The Evidence: pointer mode (v6.10.0 T3) stays as a
+    // short-circuit. The Evidence: pointer mode (T3) stays as a
     // fallback alongside legacy markdown content; phase events with a
     // `phase=red`/`phase=green` row plus non-empty evidenceRefs auto-pass
     // the corresponding markdown validator.
@@ -294,12 +278,7 @@ export async function lintArtifact(projectRoot, stage, track = "standard", optio
         overrideSet,
         activeStageFlags,
         taskClass,
-        legacyContinuation,
-        worktreeExecutionMode,
-        tddCheckpointMode,
-        integrationOverseerMode,
-        tddCutoverSliceId,
-        tddWorktreeCutoverSliceId
+        packageVersion
     };
     switch (stage) {
         case "brainstorm":
@@ -404,7 +383,7 @@ export async function lintArtifact(projectRoot, stage, track = "standard", optio
                 continue;
             finding.required = false;
             finding.details =
-                `${finding.details} (Wave 25: demoted to advisory by track="${track}"` +
+                `${finding.details} (demoted to advisory by track="${track}"` +
                     (taskClass ? `, taskClass="${taskClass}"` : "") +
                     ").";
             demotedSections.push(finding.section);
@@ -440,7 +419,7 @@ export async function lintArtifact(projectRoot, stage, track = "standard", optio
     return { stage, file: relFile, passed, findings, ...(dedup ? { dedup } : {}) };
 }
 /**
- * Wave 25 (v6.1.0) — section names whose required-finding outcome is
+ * section names whose required-finding outcome is
  * demoted from blocking → advisory when
  * `shouldDemoteArtifactValidationByTrack(track, taskClass)` returns
  * `true`. Mirrors the user-reported quick-tier failure modes:
@@ -460,7 +439,7 @@ const ARTIFACT_VALIDATION_LITE_DEMOTE_SECTIONS = new Set([
     "Product Discovery Delegation (Strategist Mode)"
 ]);
 /**
- * v6.11.0 (D5) — pre-resolve `Evidence:` pointers and delegation
+ * pre-resolve `Evidence:` pointers and delegation
  * phase-event auto-satisfy state for the TDD stage's RED/GREEN
  * Evidence rows so `validateSectionBody` (sync) can short-circuit.
  *
@@ -471,7 +450,7 @@ const ARTIFACT_VALIDATION_LITE_DEMOTE_SECTIONS = new Set([
  * - Phase-event auto-satisfy fires when `delegation-events.jsonl`
  *   carries at least one slice-tagged event for the active run with
  *   `phase=red`/`phase=green` and non-empty `evidenceRefs`. This is the
- *   v6.11.0 replacement for the v6.10.0 sidecar auto-satisfy hook —
+replacement for the sidecar auto-satisfy hook —
  *   slice events are now the source of truth, the RED/GREEN markdown
  *   tables are auto-rendered from them, and the validators MUST NOT
  *   demand pasted stdout when the events already prove RED/GREEN.

package/dist/cli.js

@@ -152,7 +152,7 @@ function buildInitSurfacePreview(harnesses) {
             lines.push(".cursor/rules/cclaw-workflow.mdc");
         }
         if (harness === "codex") {
-            // v0.40.0: .codex/hooks.json is managed again now that Codex CLI
+            // .codex/hooks.json is managed because Codex CLI
             // grew a real hooks API (v0.114+, behind the `codex_hooks`
             // feature flag). Legacy `.codex/commands/*` is still auto-cleaned.
             lines.push(".codex/hooks.json (requires `codex_hooks = true` in ~/.codex/config.toml)");

package/dist/config.js

@@ -59,7 +59,7 @@ function assertOnlySupportedKeys(parsed, fullPath) {
     throw configValidationError(fullPath, `key(s) ${keyList} are no longer supported in cclaw 3.0.0; see CHANGELOG.md`);
 }
 export async function detectLanguageRulePacks(_projectRoot) {
-    // Wave 21: harness-only config. Language packs are no longer configurable.
+    // Harness-only config. Language packs are no longer configurable.
     return [];
 }
 export async function readConfig(projectRoot, _options = {}) {

package/dist/constants.js

@@ -77,7 +77,7 @@ export const REQUIRED_GITIGNORE_PATTERNS = [
     ".opencode/commands/cc-*.md",
     ".opencode/commands/cc.md",
     // Codex uses skill-kind shims under `.agents/skills/cc*/` since
-    // v0.40.0 (renamed from the `cclaw-cc*` layout in v0.39.0/v0.39.1).
+    // Codex shim layout (renamed from the older `cclaw-cc*` layout).
     // `cclaw sync` and `cclaw uninstall` both auto-remove the legacy
     // `cclaw-cc*` directories.
     ".agents/skills/cc/SKILL.md",

package/dist/content/core-agents.d.ts

@@ -36,6 +36,11 @@ export interface AgentDefinition {
     /** Markdown body rendered below the YAML frontmatter. */
     body: string;
 }
+/**
+ * Canonical slice-builder worker protocol text (embedded in the agent body and
+ * echoed in the TDD skill block).
+ */
+export declare function sliceBuilderProtocol(): string;
 /**
  * Canonical specialist roster materialized under `.cclaw/agents/`.
  *
@@ -171,15 +176,6 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly relatedStages: ["tdd", "review"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
-}, {
-    readonly name: "test-author";
-    readonly description: "MANDATORY in TDD stage. MUST BE USED for RED -> GREEN -> REFACTOR with evidence-first discipline.";
-    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"];
-    readonly model: "balanced";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["tdd"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
 }, {
     readonly name: "release-reviewer";
     readonly description: "MANDATORY during ship. MUST BE USED for release readiness, rollback, finalization mode, evidence freshness, and victory detector checks.";
@@ -199,27 +195,13 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
-    readonly name: "slice-implementer";
-    readonly description: "ON-DEMAND or PROACTIVE during TDD GREEN/REFACTOR for one bounded vertical slice after RED evidence exists and file ownership is non-overlapping.";
+    readonly name: "slice-builder";
+    readonly description: "MANDATORY for every TDD slice. Owns RED → GREEN → REFACTOR → per-slice DOC for one bounded vertical slice in a single delegated span. Multiple slice-builder spans run in parallel inside one wave when their `claimedPaths` are disjoint.";
     readonly tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"];
     readonly model: "balanced";
-    readonly activation: "on-demand";
-    readonly relatedStages: ["tdd"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "slice-documenter";
-    readonly description: "MANDATORY in PARALLEL with slice-implementer for every TDD slice (regardless of discoveryMode, v6.12.0 Phase R). Writes per-slice prose summary to `<artifacts-dir>/tdd-slices/S-<id>.md`. Does NOT implement, does NOT write tests. Linter rule `tdd_slice_documenter_missing` blocks the gate when a `phase=doc` event is missing for a green slice.";
-    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob"];
-    readonly model: "fast";
     readonly activation: "mandatory";
     readonly relatedStages: ["tdd"];
-    readonly returnSchema: {
-        readonly statusField: "status";
-        readonly allowedStatuses: ["DONE", "DONE_WITH_CONCERNS", "NEEDS_CONTEXT", "BLOCKED"];
-        readonly requiredFields: ["status", "summaryMd", "learnings", "evidenceRefs", "blockers"];
-        readonly evidenceFields: ["summaryMd", "evidenceRefs"];
-    };
+    readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
     readonly name: "fixer";

package/dist/content/core-agents.js

@@ -53,22 +53,19 @@ Before doing substantive work, return an ACK object that the parent can record:
 Finish with the required return schema plus the same \`spanId\` and \`dispatchId\`. The parent must not claim isolated completion unless ACK/result proof matches the ledger/event span.`;
 }
 /**
- * v6.14.1 — TDD worker self-record contract. The parent records
- * `scheduled` and `launched` rows BEFORE dispatching the Task; the
- * worker is responsible for `acknowledged` (on entry) and `completed`
- * (on exit). This contract restores the v6.13.1 discipline that
- * v6.14.0 dropped — the controller-side fix in v6.14.1's TDD skill
- * text is paired with this worker-side self-record helper template.
+ * TDD worker self-record contract. The parent records `scheduled` and
+ * `launched` rows BEFORE dispatching the Task; the worker records
+ * `acknowledged` (on entry) and `completed` (on exit).
  */
 function tddWorkerSelfRecordContract(agentName) {
-    const isImplementer = agentName === "slice-implementer";
-    const refactorOutcomeFlag = isImplementer
+    const isBuilder = agentName === "slice-builder";
+    const refactorOutcomeFlag = isBuilder
         ? " --refactor-outcome=inline|deferred [--refactor-rationale=\"<why>\"]"
         : "";
-    const laneFlags = isImplementer
+    const laneFlags = isBuilder
         ? " [--claim-token=<t>] [--lane-id=<lane>] [--lease-until=<iso>]"
         : "";
-    return `## TDD Worker Self-Record Contract (v6.14.2)
+    return `## TDD worker delegation self-record contract
 
 You are a TDD worker dispatched via \`Task\`. The parent already wrote your \`scheduled\` and \`launched\` ledger rows BEFORE invoking you. **Your responsibility is to self-record \`acknowledged\` on entry and \`completed\` on exit** by invoking \`.cclaw/hooks/delegation-record.mjs\` directly. Do NOT skip these — the controller depends on them, the linter validates them, and back-fill via \`--repair\` is reserved for recovery only.
 
@@ -100,7 +97,7 @@ node .cclaw/hooks/delegation-record.mjs \\
   --json
 \`\`\`
 
-Reuse the same \`<spanId>\` and \`<dispatchId>\` across both rows. **v6.14.2 evidence-freshness contract** (slice-implementer GREEN only): the FIRST \`--evidence-ref\` MUST (1) reference the same test the matching \`phase=red\` row cited (basename/stem substring; reject \`green_evidence_red_test_mismatch\`), (2) include a recognized passing-runner line such as \`=> N passed; 0 failed\`, \`N passed in 0.42s\`, or \`ok pkg 0.12s\` (reject \`green_evidence_passing_assertion_missing\`), AND (3) be captured AFTER \`ackTs\` of this span — \`completedTs - ackTs\` must be ≥ \`flow-state.json::tddGreenMinElapsedMs\` (default 4000ms; reject \`green_evidence_too_fresh\`). Escape clause for legitimate observational GREEN: pass BOTH \`--allow-fast-green --green-mode=observational\`. \`--ack-ts\` and \`--completed-ts\` must be monotonic on the span (\`startTs ≤ launchedTs ≤ ackTs ≤ completedTs\`); the helper rejects out-of-order writes with \`delegation_timestamp_non_monotonic\`. If the helper rejects with \`dispatch_active_span_collision\` against a stale span, surface the conflicting \`spanId\` to the parent — do NOT silently retry with \`--allow-parallel\`.`;
+Reuse the same \`<spanId>\` and \`<dispatchId>\` across both rows. **GREEN evidence freshness** (slice-builder): the FIRST \`--evidence-ref\` MUST (1) reference the same test the matching \`phase=red\` row cited (basename/stem substring; reject \`green_evidence_red_test_mismatch\`), (2) include a recognized passing-runner line such as \`=> N passed; 0 failed\`, \`N passed in 0.42s\`, or \`ok pkg 0.12s\` (reject \`green_evidence_passing_assertion_missing\`), AND (3) be captured AFTER \`ackTs\` of this span — \`completedTs - ackTs\` must be ≥ \`flow-state.json::tddGreenMinElapsedMs\` (default 4000ms; reject \`green_evidence_too_fresh\`). Escape clause for legitimate observational GREEN: pass BOTH \`--allow-fast-green --green-mode=observational\`. \`--ack-ts\` and \`--completed-ts\` must be monotonic on the span (\`startTs ≤ launchedTs ≤ ackTs ≤ completedTs\`); the helper rejects out-of-order writes with \`delegation_timestamp_non_monotonic\`. If the helper rejects with \`dispatch_active_span_collision\` against a stale span, surface the conflicting \`spanId\` to the parent — do NOT silently retry with \`--allow-parallel\`.`;
 }
 function formatReturnSchema(schema) {
     const lines = [
@@ -146,6 +143,29 @@ function activationModeSummary() {
         proactive: [...proactive].join(", ")
     };
 }
+/**
+ * Canonical slice-builder worker protocol text (embedded in the agent body and
+ * echoed in the TDD skill block).
+ */
+export function sliceBuilderProtocol() {
+    return [
+        "## slice-builder protocol",
+        "",
+        "**slice-builder** is the canonical worker for **one bounded vertical slice** end-to-end: **RED → GREEN → REFACTOR → inline DOC** in **one** delegated span. Multiple slice-builder spans run in parallel under a single wave when the wave plan declares disjoint `claimedPaths`.",
+        "",
+        "### Invariants",
+        "- Produce failing RED evidence (or cite the delegated RED artifact) **before** production edits.",
+        "- Stay inside the slice contract: `claimedPaths`, acceptance mapping, and forbidden-change lists from the parent.",
+        "- After GREEN, refactor inline **or** record deferred refactor via the same `--refactor-outcome` mechanics the controller specifies.",
+        "- Own the prose slice summary at `<artifacts-dir>/tdd-slices/S-<id>.md` yourself.",
+        "",
+        "### Events",
+        "- Honor every `delegation-record`/`delegation-record.mjs` row shape the controller requests so artifact linters keep passing.",
+        "- The umbrella `slice-completed` row ties RED/GREEN/REFACTOR/DOC timestamps to your builder span.",
+        "",
+        "**Role boundary:** do not widen scope, do not self-approve ship-level review, and do not recurse into other agents unless the parent explicitly directs it."
+    ].join("\n");
+}
 /**
  * Canonical specialist roster materialized under `.cclaw/agents/`.
  *
@@ -496,7 +516,7 @@ export const CCLAW_AGENTS = [
         body: [
             "You are an **integration overseer** for TDD fan-out runs.",
             "",
-            "You are dispatched after parallel `slice-implementer` lanes complete.",
+            "You are dispatched after parallel `slice-builder` lanes complete.",
             "",
             "Checks:",
             "- every integration test named in `cohesion-contract.md` passes (or has explicit gap rationale)",
@@ -510,27 +530,6 @@ export const CCLAW_AGENTS = [
             "**Role boundary:** integration and cohesion oversight only; do NOT implement production code."
         ].join("\n")
     },
-    {
-        name: "test-author",
-        description: "MANDATORY in TDD stage. MUST BE USED for RED -> GREEN -> REFACTOR with evidence-first discipline.",
-        tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"],
-        model: "balanced",
-        activation: "mandatory",
-        relatedStages: ["tdd"],
-        returnSchema: WORKER_RETURN_SCHEMA,
-        body: [
-            "You are a **test-driven development** specialist.",
-            "",
-            "**Iron law:** no production code without a failing test first during RED. In design, focus on testability and verification evidence without editing production code.",
-            "",
-            "Process:",
-            "1. RED: write a failing test for the desired behavior.",
-            "2. Verify RED fails for the right reason.",
-            "3. GREEN: implement minimal code to pass.",
-            "4. Verify GREEN on relevant suite/full suite.",
-            "5. REFACTOR with behavior preserved."
-        ].join("\n")
-    },
     {
         name: "release-reviewer",
         description: "MANDATORY during ship. MUST BE USED for release readiness, rollback, finalization mode, evidence freshness, and victory detector checks.",
@@ -567,66 +566,23 @@ export const CCLAW_AGENTS = [
         ].join("\n")
     },
     {
-        name: "slice-implementer",
-        description: "ON-DEMAND or PROACTIVE during TDD GREEN/REFACTOR for one bounded vertical slice after RED evidence exists and file ownership is non-overlapping.",
+        name: "slice-builder",
+        description: "MANDATORY for every TDD slice. Owns RED → GREEN → REFACTOR → per-slice DOC for one bounded vertical slice in a single delegated span. Multiple slice-builder spans run in parallel inside one wave when their `claimedPaths` are disjoint.",
         tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"],
         model: "balanced",
-        activation: "on-demand",
+        activation: "mandatory",
         relatedStages: ["tdd"],
         returnSchema: WORKER_RETURN_SCHEMA,
         body: [
-            "You are a **vertical-slice implementation worker**.",
+            "You are **slice-builder**, the canonical vertical-slice TDD worker.",
             "",
-            "**Mode: TDD-bound** (default)",
-            "- Requires RED evidence before production edits.",
-            "- Requires explicit file boundaries and acceptance mapping from the slice contract.",
+            sliceBuilderProtocol(),
             "",
-            "**Mode: Generic** (only when withTDD=false on quick-track)",
-            "- Allows bounded implementation without full RED/GREEN loop.",
-            "- Still requires explicit scope boundaries and verification evidence.",
-            "",
-            "Rules:",
-            "1. Start only from the assigned RED failure and acceptance mapping.",
-            "2. Edit only the allowed files for the slice.",
-            "3. Implement the minimal GREEN change, then preserve behavior during REFACTOR.",
-            "4. Return files changed, tests run, evidence refs, concerns, and blockers.",
+            "**Mode hints:**",
+            "- **TDD-bound (default)** — RED evidence precedes GREEN; preserve behavior across REFACTOR; document outcomes in `tdd-slices/S-<id>.md`.",
+            "- **Generic** — only when the parent explicitly disables TDD gates for quick-track breadth; bounded scope and verification still apply.",
             "",
-            "**Role boundary:** do not broaden scope, do not review your own work as final approval, and do not spawn subagents."
-        ].join("\n")
-    },
-    {
-        name: "slice-documenter",
-        description: "MANDATORY in PARALLEL with slice-implementer for every TDD slice (regardless of discoveryMode, v6.12.0 Phase R). Writes per-slice prose summary to `<artifacts-dir>/tdd-slices/S-<id>.md`. Does NOT implement, does NOT write tests. Linter rule `tdd_slice_documenter_missing` blocks the gate when a `phase=doc` event is missing for a green slice.",
-        tools: ["Read", "Write", "Edit", "Grep", "Glob"],
-        model: "fast",
-        activation: "mandatory",
-        relatedStages: ["tdd"],
-        returnSchema: {
-            statusField: "status",
-            allowedStatuses: ["DONE", "DONE_WITH_CONCERNS", "NEEDS_CONTEXT", "BLOCKED"],
-            requiredFields: ["status", "summaryMd", "learnings", "evidenceRefs", "blockers"],
-            evidenceFields: ["summaryMd", "evidenceRefs"]
-        },
-        body: [
-            "You are a **slice-documenter** dispatched in PARALLEL with `slice-implementer` for the same slice.",
-            "",
-            "**Mission:** capture per-slice prose summary while production code is being written.",
-            "Because your only `claimedPath` is `<artifacts-dir>/tdd-slices/S-<id>.md` and the implementer's `claimedPaths` are production code, the file-overlap scheduler auto-allows the parallel dispatch.",
-            "",
-            "When invoked:",
-            "1. Read the active plan unit, acceptance criterion, and the failing RED test for this slice.",
-            "2. Write a thin per-slice file at `<artifacts-dir>/tdd-slices/S-<id>.md` with the headings:",
-            "   - `# Slice S-<id>`",
-            "   - `## Plan unit` (T-... pointer)",
-            "   - `## Acceptance criteria` (AC-... ids)",
-            "   - `## Why this slice`",
-            "   - `## What was tested`",
-            "   - `## What was implemented`",
-            "   - `## REFACTOR notes`",
-            "   - `## Learnings`",
-            "3. Return JSON: `{ status, summaryMd, learnings: string[], evidenceRefs: [\"<artifacts-dir>/tdd-slices/S-<id>.md\"], blockers: [] }`.",
-            "",
-            "**Forbidden:** edit `06-tdd.md`, test files, or production code. Edit ONLY your slice file."
+            "**Role boundary:** obey the parent's phase flags (`--phase=red|green|refactor|doc`); never improvise undeclared parallelism."
         ].join("\n")
     },
     {
@@ -651,15 +607,12 @@ export const CCLAW_AGENTS = [
     }
 ];
 /**
- * v6.14.1 — agents whose rendered `.cclaw/agents/<name>.md` file gets the
- * TDD worker self-record helper template. These agents are the ones the
- * controller dispatches via `Task` during a TDD wave; they are
- * responsible for `acknowledged` and `completed` ledger writes.
+ * Agents whose rendered `.cclaw/agents/<name>.md` file gets the TDD worker
+ * self-record helper template. Controllers dispatch these via `Task` during
+ * TDD; they own `acknowledged` and `completed` ledger writes.
  */
 const TDD_WORKER_SELF_RECORD_AGENTS = new Set([
-    "test-author",
-    "slice-implementer",
-    "slice-documenter",
+    "slice-builder",
     "integration-overseer"
 ]);
 import { stageDelegationSummary } from "./stage-schema.js";
@@ -751,7 +704,7 @@ export function agentCostTierTable() {
     return `| Tier | Use for | Example agents |
 |---|---|---|
 | \`deep\` | one heavy planning/strategy pass per stage | planner, product-discovery |
-| \`balanced\` | discovery, criticism, review, TDD, and bounded worker execution | critic, spec-document-reviewer, coherence-reviewer, scope-guardian-reviewer, feasibility-reviewer, reviewer, security-reviewer, test-author, slice-implementer, fixer |
+| \`balanced\` | discovery, criticism, review, TDD, and bounded worker execution | critic, spec-document-reviewer, coherence-reviewer, scope-guardian-reviewer, feasibility-reviewer, reviewer, security-reviewer, slice-builder, fixer |
 | \`fast\` | bounded maintenance updates with limited blast radius | doc-updater |
 `;
 }
@@ -770,7 +723,8 @@ ${rows}`;
 export function agentsAgentsMdBlock() {
     return `### Agent Specialists
 
-cclaw materializes specialist agents under \`.cclaw/agents/\`: ${CCLAW_AGENTS.map((agent) => agent.name).join(", ")}.
+cclaw defines specialist personas for \`.cclaw/agents/\`: ${CCLAW_AGENTS.map((agent) => agent.name).join(", ")}.
+**TDD work** is owned end-to-end by **slice-builder** — one worker per slice, multiple workers in parallel within a wave when \`claimedPaths\` are disjoint.
 
 ${agentRoutingTable()}
 

package/dist/content/examples.d.ts

@@ -1,6 +1,6 @@
 import type { FlowStage } from "../types.js";
 /**
- * Round 5 (v6.6.0) — short bad → good behavior anchor per stage.
+ * short bad → good behavior anchor per stage.
  *
  * Each entry is rendered exactly once in the corresponding stage skill md
  * (via `behaviorAnchorBlock` in `skills.ts`) and exactly once in the stage's

package/dist/content/examples.js

@@ -36,10 +36,10 @@ export const BEHAVIOR_ANCHORS = [
     },
     {
         stage: "tdd",
-        section: "Vertical Slice Cycle",
-        bad: "Controller writes the failing test, the GREEN fix, AND per-slice prose into `06-tdd.md` itself, then hand-edits Watched-RED / Vertical Slice Cycle tables. `phase=red`/`green`/`doc` events missing; `tdd_slice_implementer_missing` and `tdd_slice_documenter_missing` block the gate.",
-        good: "Per slice: (1) `Task(\"test-author --slice S-1 --phase red\")`. Verify the event. (2) ONE message, TWO Tasks — `slice-implementer --phase green` AND `slice-documenter --phase doc`. (3) `slice-implementer --phase refactor` (or `refactor-deferred`). Linter auto-renders Vertical Slice Cycle from events.",
-        ruleHint: "Per-Slice Ritual (v6.12.0+): RED → verify → GREEN+DOC fan-out (one message, two Tasks) → REFACTOR. Controller never writes GREEN code or per-slice prose. Mandatory regardless of `discoveryMode`."
+        section: "RED Evidence",
+        bad: "Controller edits production code or per-slice prose directly, skips ledger rows, then hand-edits auto-render tables. Slice workers never ran; lint blocks on missing span history.",
+        good: "`Task(\"slice-builder --slice S-1 --paths …\")` when major ≥7; otherwise the historical trio must still log `phase=red|green|doc` rows. Controller records before dispatch; linter mirrors history into auto-render blocks.",
+        ruleHint: "Wave-status first, record-before-dispatch, one delegated worker owns RED→GREEN→REFACTOR→slice doc; controller stays out of production edits."
     },
     {
         stage: "review",