cclaw-cli 0.4.0 → 0.5.1

package/README.md

@@ -3,7 +3,7 @@
 **A focused, installer-first workflow that turns AI coding sessions into predictable shipped outcomes.**
 
 `cclaw` gives your agent one clear path:
-**brainstorm -> scope -> design -> spec -> plan -> test -> build -> review -> ship**
+**brainstorm -> scope -> design -> spec -> plan -> tdd -> review -> ship**
 
 No giant command jungle. No runtime daemon. No process theater.
 Just a disciplined flow that stays lightweight and works across major coding harnesses.
@@ -17,10 +17,9 @@ flowchart LR
     C --> D[Design]
     D --> E[Spec]
     E --> F[Plan]
-    F --> G[Test]
-    G --> H[Build]
-    H --> I[Review]
-    I --> J[Ship]
+    F --> G[TDD]
+    G --> H[Review]
+    H --> I[Ship]
 ```
 
 ```mermaid
@@ -29,7 +28,7 @@ sequenceDiagram
     participant H as Harness
     participant V as cclaw Hooks + Skills
     participant S as State + Learnings
-    U->>H: /cc-brainstorm
+    U->>H: /cc <idea>
     H->>V: Load stage contract + HARD-GATE
     V->>S: Read context (state/learnings)
     V-->>H: Structured execution guidance
@@ -65,7 +64,8 @@ npx cclaw-cli init
 Then run in your harness:
 
 ```text
-/cc-brainstorm
+/cc <idea>
+/cc-next
 ```
 
 Core installer lifecycle:

package/dist/constants.d.ts

@@ -5,8 +5,8 @@ export declare const CCLAW_VERSION = "0.1.1";
 export declare const FLOW_VERSION = "1.0.0";
 export declare const DEFAULT_HARNESSES: HarnessId[];
 export declare const REQUIRED_DIRS: readonly [".cclaw", ".cclaw/commands", ".cclaw/skills", ".cclaw/contexts", ".cclaw/templates", ".cclaw/artifacts", ".cclaw/state", ".cclaw/runs", ".cclaw/rules", ".cclaw/adapters", ".cclaw/agents", ".cclaw/hooks"];
-export declare const REQUIRED_GITIGNORE_PATTERNS: readonly ["# cclaw generated artifacts", ".cclaw/", ".claude/commands/cc-*.md", ".cursor/commands/cc-*.md", ".opencode/commands/cc-*.md", ".codex/commands/cc-*.md", ".claude/hooks/hooks.json", ".cursor/hooks.json", ".codex/hooks.json", ".opencode/plugins/cclaw-plugin.mjs", ".cursor/rules/cclaw-workflow.mdc"];
+export declare const REQUIRED_GITIGNORE_PATTERNS: readonly ["# cclaw generated artifacts", ".cclaw/", ".claude/commands/cc-*.md", ".claude/commands/cc.md", ".cursor/commands/cc-*.md", ".cursor/commands/cc.md", ".opencode/commands/cc-*.md", ".opencode/commands/cc.md", ".codex/commands/cc-*.md", ".codex/commands/cc.md", ".claude/hooks/hooks.json", ".cursor/hooks.json", ".codex/hooks.json", ".opencode/plugins/cclaw-plugin.mjs", ".cursor/rules/cclaw-workflow.mdc"];
 export declare const COMMAND_FILE_ORDER: FlowStage[];
-export declare const UTILITY_COMMANDS: readonly ["learn", "autoplan", "next"];
+export declare const UTILITY_COMMANDS: readonly ["learn", "next"];
 export declare const SUBAGENT_SKILL_FOLDERS: readonly ["subagent-dev", "parallel-dispatch"];
 export type UtilityCommand = (typeof UTILITY_COMMANDS)[number];

package/dist/constants.js

@@ -26,9 +26,13 @@ export const REQUIRED_GITIGNORE_PATTERNS = [
     "# cclaw generated artifacts",
     `${RUNTIME_ROOT}/`,
     ".claude/commands/cc-*.md",
+    ".claude/commands/cc.md",
     ".cursor/commands/cc-*.md",
+    ".cursor/commands/cc.md",
     ".opencode/commands/cc-*.md",
+    ".opencode/commands/cc.md",
     ".codex/commands/cc-*.md",
+    ".codex/commands/cc.md",
     ".claude/hooks/hooks.json",
     ".cursor/hooks.json",
     ".codex/hooks.json",
@@ -41,12 +45,11 @@ export const COMMAND_FILE_ORDER = [
     "design",
     "spec",
     "plan",
-    "test",
-    "build",
+    "tdd",
     "review",
     "ship"
 ];
-export const UTILITY_COMMANDS = ["learn", "autoplan", "next"];
+export const UTILITY_COMMANDS = ["learn", "next"];
 export const SUBAGENT_SKILL_FOLDERS = [
     "subagent-dev",
     "parallel-dispatch"

package/dist/content/agents.d.ts

@@ -30,7 +30,7 @@ export declare const CCLAW_AGENTS: AgentDefinition[];
  */
 export declare function agentMarkdown(agent: AgentDefinition): string;
 /**
- * Markdown table mapping Cclaw slash commands to recommended specialist agents.
+ * Markdown table mapping Cclaw stage entry points to specialist agents.
  */
 export declare function agentRoutingTable(): string;
 /**

package/dist/content/agents.js

@@ -41,7 +41,7 @@ export const CCLAW_AGENTS = [
     },
     {
         name: "spec-reviewer",
-        description: "MANDATORY after implementation: MUST BE USED during `/cc-review` (and any review gate) to verify acceptance criteria against the actual codebase — not against claims.",
+        description: "MANDATORY after implementation: MUST BE USED during the review stage (via `/cc-next`) to verify acceptance criteria against the actual codebase — not against claims.",
         tools: ["Read", "Grep", "Glob"],
         model: "balanced",
         activation: "mandatory",
@@ -64,7 +64,7 @@ export const CCLAW_AGENTS = [
     },
     {
         name: "code-reviewer",
-        description: "MANDATORY for all code changes: MUST BE USED during `/cc-review` for any diff/PR-sized work — correctness, maintainability, and ship risk.",
+        description: "MANDATORY for all code changes: MUST BE USED during the review stage (via `/cc-next`) for any diff/PR-sized work — correctness, maintainability, and ship risk.",
         tools: ["Read", "Grep", "Glob"],
         model: "balanced",
         activation: "mandatory",
@@ -128,7 +128,7 @@ export const CCLAW_AGENTS = [
         tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"],
         model: "balanced",
         activation: "proactive",
-        relatedStages: ["test", "build"],
+        relatedStages: ["tdd"],
         body: [
             "You are a **test-driven development** guide and implementer.",
             "",
@@ -157,7 +157,7 @@ export const CCLAW_AGENTS = [
         tools: ["Read", "Write", "Edit", "Grep", "Glob"],
         model: "fast",
         activation: "proactive",
-        relatedStages: ["build", "ship"],
+        relatedStages: ["tdd", "ship"],
         body: [
             "You are a **documentation and comment maintenance** specialist.",
             "",
@@ -208,20 +208,16 @@ ${taskDelegation}
 `;
 }
 /**
- * Markdown table mapping Cclaw slash commands to recommended specialist agents.
+ * Markdown table mapping Cclaw stage entry points to specialist agents.
  */
 export function agentRoutingTable() {
-    return `| Command | Primary Agent | Supporting Agents |
+    return `| Stage Entry | Primary Agent | Supporting Agents |
 |---|---|---|
-| /cc-brainstorm | planner | — |
-| /cc-scope | planner | — |
-| /cc-design | planner, security-reviewer | — |
-| /cc-spec | planner | spec-reviewer |
-| /cc-plan | planner | — |
-| /cc-test | test-author | — |
-| /cc-build | test-author | doc-updater |
-| /cc-review | spec-reviewer, code-reviewer | security-reviewer |
-| /cc-ship | — | doc-updater |
+| Brainstorm (start with \`/cc <idea>\`) | planner | — |
+| Scope / Design / Spec / Plan (advance via \`/cc-next\`) | planner | security-reviewer on design, spec-reviewer on spec |
+| TDD (via \`/cc-next\`) | test-author | doc-updater |
+| Review (via \`/cc-next\`) | spec-reviewer, code-reviewer | security-reviewer |
+| Ship (via \`/cc-next\`) | — | doc-updater |
 `;
 }
 /**
@@ -235,7 +231,7 @@ Cclaw provides specialist agents under \`.cclaw/agents/\` for targeted delegatio
 ${agentRoutingTable()}
 
 **Activation modes:**
-- **Mandatory:** MUST be used when the related stage runs (spec-reviewer, code-reviewer during /review)
+- **Mandatory:** MUST be used when the related stage runs (spec-reviewer, code-reviewer during review)
 - **Proactive:** Should be used automatically when context matches (planner for complex features, security-reviewer for auth code)
 - **On-demand:** Invoked only when explicitly requested
 

package/dist/content/examples.js

@@ -167,7 +167,7 @@ T1 ──▶ T2 ──▶ T3
 ### Risk note
 
 If T3 grows too large, split “transport” vs “UI state machine” into two tasks while keeping the dependency graph acyclic.`,
-    test: `### RED test (Vitest) — written before production code
+    tdd: `### RED test (Vitest) — written before production code
 
 \`\`\`typescript
 import { describe, it, expect } from "vitest";
@@ -204,8 +204,9 @@ Error: Cannot find module '../notificationFeed' imported from src/notificationFe
 ### Common mistakes to avoid
 
 - “GREEN” that secretly imports a helper that already implements the behavior (that is skipping RED).
-- Assertions that pass because the function returns \`undefined\` and the matcher is too loose.`,
-    build: `### GREEN (minimal implementation to pass RED)
+- Assertions that pass because the function returns \`undefined\` and the matcher is too loose.
+
+### GREEN (minimal implementation to pass RED)
 
 \`\`\`typescript
 export type FeedItem = { dedupeKey: string; read: boolean };

package/dist/content/hooks.js

@@ -270,8 +270,7 @@ if [ "$SUGGESTIONS_ENABLED" = "true" ] && [ "$STAGE_MUTED" != "true" ]; then
     design) STAGE_SUGGESTION="Suggestion: map failure modes per new codepath and confirm architecture boundaries before moving forward." ;;
     spec) STAGE_SUGGESTION="Suggestion: ensure every acceptance criterion is measurable and mapped to a concrete test." ;;
     plan) STAGE_SUGGESTION="Suggestion: group tasks into dependency waves and keep WAIT_FOR_CONFIRM pending until approval." ;;
-    test) STAGE_SUGGESTION="Suggestion: RED only in this stage — capture failing output for each selected slice." ;;
-    build) STAGE_SUGGESTION="Suggestion: apply minimal GREEN change, run full suite, then document REFACTOR notes." ;;
+    tdd) STAGE_SUGGESTION="Suggestion: execute RED → GREEN → REFACTOR for each selected slice and capture evidence per cycle." ;;
     review) STAGE_SUGGESTION="Suggestion: run Layer 1 before Layer 2 and reconcile findings into 07-review-army.json." ;;
     ship) STAGE_SUGGESTION="Suggestion: verify preflight + rollback plan before selecting exactly one finalization mode." ;;
     *) STAGE_SUGGESTION="" ;;
@@ -401,7 +400,7 @@ if [ "$STAGE" != "none" ] && [ -n "$STAGE_LEARNING_LINES" ] && command -v jq >/d
 fi
 
 # --- Build context message ---
-CTX="cclaw loaded. Flow: stage=$STAGE ($COMPLETED/9 completed, run=$ACTIVE_RUN). Active run artifacts: ${RUNTIME_ROOT}/runs/$ACTIVE_RUN/artifacts/"
+CTX="cclaw loaded. Flow: stage=$STAGE ($COMPLETED/8 completed, run=$ACTIVE_RUN). Active run artifacts: ${RUNTIME_ROOT}/runs/$ACTIVE_RUN/artifacts/"
 if [ -n "$CONTEXT_MODE_NOTE" ]; then
   CTX="$CTX
 $CONTEXT_MODE_NOTE"
@@ -932,8 +931,7 @@ export default function cclawPlugin(ctx) {
       design: "Suggestion: map failure modes per new codepath and confirm architecture boundaries before moving forward.",
       spec: "Suggestion: ensure every acceptance criterion is measurable and mapped to a concrete test.",
       plan: "Suggestion: group tasks into dependency waves and keep WAIT_FOR_CONFIRM pending until approval.",
-      test: "Suggestion: RED only in this stage — capture failing output for each selected slice.",
-      build: "Suggestion: apply minimal GREEN change, run full suite, then document REFACTOR notes.",
+      tdd: "Suggestion: execute RED → GREEN → REFACTOR for each selected slice and capture evidence per cycle.",
       review: "Suggestion: run Layer 1 before Layer 2 and reconcile findings into 07-review-army.json.",
       ship: "Suggestion: verify preflight + rollback plan before selecting exactly one finalization mode."
     };
@@ -995,7 +993,7 @@ export default function cclawPlugin(ctx) {
     const contextMode = readContextMode();
     const stageSuggestion = readStageSuggestion(stage);
     const stageLearnings = readStageLearnings(stage);
-    const parts = [\`cclaw loaded. Flow: stage=\${stage} (\${completed}/9 completed, run=\${activeRunId}). Active run artifacts: ${RUNTIME_ROOT}/runs/\${activeRunId}/artifacts/\`];
+    const parts = [\`cclaw loaded. Flow: stage=\${stage} (\${completed}/8 completed, run=\${activeRunId}). Active run artifacts: ${RUNTIME_ROOT}/runs/\${activeRunId}/artifacts/\`];
     parts.push(
       contextMode.guide
         ? \`Context mode: \${contextMode.mode} (guide: \${contextMode.guide})\`

package/dist/content/learnings.js

@@ -44,7 +44,7 @@ Treat learnings as durable project memory: patterns, pitfalls, preferences, arch
 **Minimal valid example (conceptual):**
 
 \`\`\`json
-{"ts":"2026-04-11T12:00:00Z","skill":"build","type":"pattern","key":"run-migrations-before-seed","insight":"Seed scripts assume schema v7; run sqlx migrate before npm run seed.","confidence":8,"source":"observed","files":["scripts/seed.ts"]}
+{"ts":"2026-04-11T12:00:00Z","skill":"tdd","type":"pattern","key":"run-migrations-before-seed","insight":"Seed scripts assume schema v7; run sqlx migrate before npm run seed.","confidence":8,"source":"observed","files":["scripts/seed.ts"]}
 \`\`\`
 
 ## Confidence Decay Rules

package/dist/content/meta-skill.js

@@ -19,34 +19,26 @@ This meta-skill helps you discover and apply the right cclaw stage for the curre
 
 ## Skill Discovery Flowchart
 
-When a task arrives, identify the development phase and invoke the matching command:
+Use \`/cc\` to start or \`/cc-next\` to continue:
 
 \`\`\`
 Task arrives
     |
-    +-- Vague idea / needs exploration?  --> /cc-brainstorm
-    +-- Need to shape scope / challenge premises?  --> /cc-scope
-    +-- Have scope, need architecture / design lock?  --> /cc-design
-    +-- Have design, need formal specification?  --> /cc-spec
-    +-- Have spec, need task breakdown / plan?  --> /cc-plan
-    +-- Have plan, need to write tests first?  --> /cc-test
-    +-- Have failing tests, need implementation?  --> /cc-build
-    +-- Have implementation, need review?  --> /cc-review
-    +-- Reviewed and approved, need to ship?  --> /cc-ship
-    |
-    +-- Cross-cutting:
-    |   +-- Want to check/add project learnings?  --> /cc-learn
-    |   +-- Want full brainstorm-to-plan in one shot?  --> /cc-autoplan
-    |
+    +-- New idea / starting fresh?  --> /cc <idea>  (starts brainstorm)
+    +-- Resuming / continuing?  --> /cc  or  /cc-next
+    +-- Want to check/add project learnings?  --> /cc-learn
     +-- No cclaw stage applies?  --> Respond normally
 \`\`\`
 
+Stage progression is handled automatically by \`/cc-next\`. The flow moves through:
+brainstorm → scope → design → spec → plan → tdd → review → ship
+
 ## Flow State Check
 
 Before starting work, ALWAYS:
 
 1. Read \`.cclaw/state/flow-state.json\` for the current stage.
-2. If a stage is active, invoke the matching \`/cc-*\` command.
+2. If a stage is active, continue with \`/cc\` or \`/cc-next\` (do not jump directly to per-stage commands).
 3. If no stage applies (e.g. simple question, unrelated task), respond normally.
 
 ## Activation Rules
@@ -56,25 +48,24 @@ Before starting work, ALWAYS:
 3. **One stage at a time.** Complete the current stage before advancing to the next.
 4. **Gates must pass.** Every stage has required gates — the agent cannot claim completion without satisfying them.
 5. **Artifacts are mandatory.** Each stage writes to \`.cclaw/artifacts/\` and keeps the active run copy in \`.cclaw/runs/<activeRunId>/artifacts/\` — this is the evidence trail.
-6. **When in doubt, start with brainstorm.** If the task is non-trivial and there's no prior artifact, begin with \`/cc-brainstorm\`.
+6. **When in doubt, use \`/cc\`.** If the task is non-trivial and there's no prior artifact, run \`/cc <idea>\` to start brainstorming.
 
 ## Stage Quick Reference
 
-| Stage | Command | HARD-GATE | Artifact |
-|-------|---------|-----------|----------|
-| Brainstorm | \`/cc-brainstorm\` | No implementation planning | \`01-brainstorm.md\` |
-| Scope | \`/cc-scope\` | Challenge premises first | \`02-scope.md\` |
-| Design | \`/cc-design\` | Search before building | \`03-design.md\` |
-| Spec | \`/cc-spec\` | Observable + testable criteria | \`04-spec.md\` |
-| Plan | \`/cc-plan\` | One task = one purpose | \`05-plan.md\` |
-| Test | \`/cc-test\` | RED tests fail first | \`06-tdd.md\` |
-| Build | \`/cc-build\` | Minimal code to pass RED | \`06-tdd.md\` (shared with test) |
-| Review | \`/cc-review\` | Two-layer review | \`07-review.md\` |
-| Ship | \`/cc-ship\` | All tests green on merge | \`08-ship.md\` |
+| Stage | How to enter | HARD-GATE | Artifact |
+|-------|--------------|-----------|----------|
+| Brainstorm | \`/cc <idea>\` (or \`/cc\` on fresh flow) | No implementation planning | \`01-brainstorm.md\` |
+| Scope | via \`/cc-next\` | Challenge premises first | \`02-scope.md\` |
+| Design | via \`/cc-next\` | Search before building | \`03-design.md\` |
+| Spec | via \`/cc-next\` | Observable + testable criteria | \`04-spec.md\` |
+| Plan | via \`/cc-next\` | One task = one purpose | \`05-plan.md\` |
+| TDD | via \`/cc-next\` | RED → GREEN → REFACTOR per slice | \`06-tdd.md\` |
+| Review | via \`/cc-next\` | Two-layer review | \`07-review.md\` |
+| Ship | via \`/cc-next\` | All tests green on merge | \`08-ship.md\` |
 
 ## Skill Loading
 
-Each \`/cc-*\` command loads:
+\`/cc-next\` (and \`/cc\`) automatically loads the right stage files:
 1. **\`.cclaw/skills/<stage>/SKILL.md\`** — the full procedural guide (read this first and follow it)
 2. **\`.cclaw/commands/<stage>.md\`** — thin orchestrator (entry/exit summary, gates, anchors)
 
@@ -118,8 +109,6 @@ Use this loading order to keep context lean while preserving depth:
 ### See also
 - \`.cclaw/skills/session/SKILL.md\` for session start/stop/resume behavior
 - \`.cclaw/skills/learnings/SKILL.md\` for durable memory capture and reuse
-- \`.cclaw/skills/autoplan/SKILL.md\` when user requests multi-stage orchestration
-
 ## Decision Protocol
 
 When a stage requires user input (approval, choice, direction), use this structured pattern:
@@ -143,7 +132,7 @@ When a stage requires user input (approval, choice, direction), use this structu
 ## Failure Modes
 
 Watch for these anti-patterns:
-- **Skipping stages** — jumping from brainstorm to build without design/spec/plan
+- **Skipping stages** — jumping from brainstorm to tdd without design/spec/plan
 - **Ignoring gates** — claiming completion without evidence
 - **Premature implementation** — writing code before RED tests exist
 - **Hollow reviews** — "looks good" without checking spec compliance

package/dist/content/next-command.js

@@ -27,7 +27,7 @@ export function nextCommandContract() {
 - **Current stage complete (all gates passed)** → advance \`currentStage\` and load the next skill.
 - **Flow complete** → report done.
 
-This is the only command the user needs to drive the entire flow. Individual \`/cc-<stage>\` commands are shortcuts for jumping to a specific stage.
+This is the only progression command the user needs to drive the entire flow. Stage command contracts are internal implementation details loaded by \`/cc-next\`.
 
 ## HARD-GATE
 
@@ -74,7 +74,7 @@ This is the only command the user needs to drive the entire flow. Individual \`/
 export function nextCommandSkillMarkdown() {
     const flowPath = flowStatePath();
     const delegationPath = delegationLogPathLine();
-    const stageRows = ["brainstorm", "scope", "design", "spec", "plan", "test", "build", "review", "ship"]
+    const stageRows = ["brainstorm", "scope", "design", "spec", "plan", "tdd", "review", "ship"]
         .map((stage) => {
         const schema = stageSchema(stage);
         const next = schema.next === "done" ? "(terminal)" : schema.next;

package/dist/content/observe.js

@@ -226,10 +226,9 @@ stage_index() {
     design) echo 3 ;;
     spec) echo 4 ;;
     plan) echo 5 ;;
-    test) echo 6 ;;
-    build) echo 7 ;;
-    review) echo 8 ;;
-    ship) echo 9 ;;
+    tdd) echo 6 ;;
+    review) echo 7 ;;
+    ship) echo 8 ;;
     *) echo 0 ;;
   esac
 }
@@ -262,8 +261,8 @@ is_preimplementation_stage() {
 
 detect_target_stage() {
   local text="$1"
-  for stage in brainstorm scope design spec plan test build review ship; do
-    if printf '%s' "$text" | grep -Eq "(/cc-$stage|cc-$stage)\\b"; then
+  for stage in brainstorm scope design spec plan tdd review ship; do
+    if printf '%s' "$text" | grep -Eq "(/cc-$stage|cc-$stage)([^[:alnum:]_-]|$)"; then
       printf '%s' "$stage"
       return 0
     fi
@@ -272,7 +271,22 @@ detect_target_stage() {
   return 0
 }
 
+is_flow_progression_command() {
+  local text="$1"
+  if printf '%s' "$text" | grep -Eq '(/cc-next|cc-next)([^[:alnum:]_-]|$)'; then
+    return 0
+  fi
+  if printf '%s' "$text" | grep -Eq '/cc([^[:alnum:]_-]|$)'; then
+    return 0
+  fi
+  return 1
+}
+
 TARGET_STAGE=$(detect_target_stage "$PAYLOAD_LOWER")
+FLOW_COMMAND_INVOKED=0
+if is_flow_progression_command "$PAYLOAD_LOWER"; then
+  FLOW_COMMAND_INVOKED=1
+fi
 if [ -n "$TARGET_STAGE" ] && [ "$CURRENT_STAGE" != "none" ]; then
   CURRENT_IDX=$(stage_index "$CURRENT_STAGE")
   TARGET_IDX=$(stage_index "$TARGET_STAGE")
@@ -305,7 +319,7 @@ if is_preimplementation_stage "$CURRENT_STAGE" && ! is_plan_mode_safe_tool "$TOO
   fi
 fi
 
-if [ -n "$TARGET_STAGE" ]; then
+if [ -n "$TARGET_STAGE" ] || [ "$FLOW_COMMAND_INVOKED" -eq 1 ]; then
   if [ "$LAST_FLOW_READ_AT" -le 0 ] || [ "$NOW_EPOCH" -le 0 ] || [ $((NOW_EPOCH - LAST_FLOW_READ_AT)) -gt "$MAX_FLOW_READ_AGE_SEC" ]; then
     if [ -n "$REASONS" ]; then
       REASONS="$REASONS,stage_invocation_without_recent_flow_read"
@@ -357,7 +371,7 @@ PY
 fi
 
 if [ -n "$REASONS" ]; then
-  NOTE="Cclaw workflow guard: detected potential flow violation (\${REASONS}). Re-read ${RUNTIME_ROOT}/state/flow-state.json, avoid source edits before build/test stages, and continue from current stage ordering."
+  NOTE="Cclaw workflow guard: detected potential flow violation (\${REASONS}). Re-read ${RUNTIME_ROOT}/state/flow-state.json, avoid source edits before tdd stage, and continue from current stage ordering."
   if command -v jq >/dev/null 2>&1; then
     ENTRY=$(jq -n -c \
       --arg ts "$TS" \

package/dist/content/session-hooks.js

@@ -90,7 +90,7 @@ When creating a checkpoint at session boundaries:
 
 \`\`\`json
 {
-  "stage": "build",
+  "stage": "tdd",
   "status": "in_progress",
   "lastCompletedStep": "GREEN for task T2",
   "remainingSteps": ["REFACTOR T2", "RED T3", "GREEN T3", "REFACTOR T3"],

package/dist/content/skills.js

@@ -133,7 +133,7 @@ Mandatory agents for this stage: ${mandatoryList}. Stage transition is BLOCKED u
 On session stop or stage completion, the agent should write delegation entries to \`${delegationLogRel}\` for audit.
 `;
 }
-const VERIFICATION_STAGES = ["build", "review", "ship"];
+const VERIFICATION_STAGES = ["tdd", "review", "ship"];
 function waveExecutionModeBlock(stage) {
     const schema = stageSchema(stage);
     if (!schema.waveExecutionAllowed) {
@@ -158,9 +158,15 @@ function stageCompletionProtocol(schema) {
         : `   - Add \`"${stage}"\` to \`completedStages\` array
    - Move all gate IDs for this stage (${gateList}) into \`stageGateCatalog.${stage}.passed\`
    - Clear \`stageGateCatalog.${stage}.blocked\``;
-    const nextAction = nextStage
-        ? `3. Tell the user: **"Stage \`${stage}\` complete. Next stage: \`${nextStage}\`. Run \`/cc-next\` to continue."**`
-        : `3. Tell the user: **"Flow complete. All stages finished."**`;
+    let nextAction;
+    if (nextStage) {
+        const nextSchema = stageSchema(nextStage);
+        const nextDescription = nextSchema.skillDescription.charAt(0).toLowerCase() + nextSchema.skillDescription.slice(1);
+        nextAction = `3. Tell the user:\n\n   > **Stage \`${stage}\` complete.** Next: **${nextStage}** — ${nextDescription}\n   >\n   > Run \`/cc-next\` to continue.`;
+    }
+    else {
+        nextAction = `3. Tell the user:\n\n   > **Flow complete.** All stages finished. The project is ready for release.`;
+    }
     return `## Stage Completion Protocol
 
 When all required gates are satisfied and the artifact is written:
@@ -197,12 +203,9 @@ function progressiveDisclosureBlock(stage) {
             "- `.cclaw/skills/subagent-dev/SKILL.md` — for specialist delegation prompts by task slice",
             "- `.cclaw/skills/parallel-dispatch/SKILL.md` — for multi-agent review planning and reconciliation setup"
         ],
-        test: [
-            "- `.cclaw/skills/debugging/SKILL.md` — when RED behavior is unclear or flakes appear",
-            "- `.cclaw/skills/subagent-dev/SKILL.md` — for machine-only test-slice delegation"
-        ],
-        build: [
-            "- `.cclaw/skills/debugging/SKILL.md` — for root-cause workflow when implementation fails tests",
+        tdd: [
+            "- `.cclaw/skills/debugging/SKILL.md` — when RED behavior is unclear, flakes appear, or implementation fails tests",
+            "- `.cclaw/skills/subagent-dev/SKILL.md` — for machine-only test-slice delegation",
             "- `.cclaw/skills/performance/SKILL.md` — when implementation choices impact latency/throughput"
         ],
         review: [

package/dist/content/stage-schema.d.ts

@@ -69,7 +69,7 @@ export interface StageSchema {
     artifactValidation: ArtifactValidation[];
     namedAntiPattern?: NamedAntiPattern;
     decisionRecordFormat?: string;
-    /** When true, stage skill includes wave auto-execute guidance (test/build). */
+    /** When true, stage skill includes wave auto-execute guidance (tdd). */
     waveExecutionAllowed?: boolean;
     /** Agent names that MUST be dispatched (or waived) before stage transition — derived from mandatory auto-subagent rows. */
     mandatoryDelegations: string[];