cclaw-cli 0.13.0 → 0.15.0

package/dist/cli.js

@@ -115,6 +115,17 @@ function buildInitSurfacePreview(harnesses) {
         ".cclaw/config.yaml",
         ".cclaw/commands/*.md",
         ".cclaw/skills/*/SKILL.md",
+        ".cclaw/contexts/*.md",
+        ".cclaw/templates/*",
+        ".cclaw/agents/*.md",
+        ".cclaw/hooks/*",
+        ".cclaw/rules/**",
+        ".cclaw/adapters/*.md",
+        ".cclaw/custom-skills/README.md",
+        ".cclaw/features/**",
+        ".cclaw/runs/**",
+        ".cclaw/artifacts/**",
+        ".cclaw/knowledge.jsonl",
         ".cclaw/state/*.json|*.jsonl",
         ".cclaw/references/**",
         "AGENTS.md (managed block)"

package/dist/config.js

@@ -15,7 +15,6 @@ const ALLOWED_CONFIG_KEYS = new Set([
     "version",
     "flowVersion",
     "harnesses",
-    "autoAdvance",
     "promptGuardMode",
     "tddEnforcement",
     "tddTestGlobs",
@@ -60,7 +59,6 @@ export function createDefaultConfig(harnesses = DEFAULT_HARNESSES, defaultTrack
         version: CCLAW_VERSION,
         flowVersion: FLOW_VERSION,
         harnesses,
-        autoAdvance: false,
         promptGuardMode: "advisory",
         tddEnforcement: "advisory",
         tddTestGlobs: ["**/*.test.*", "**/*.spec.*", "**/test/**"],
@@ -81,7 +79,6 @@ export function createProfileConfig(profile, overrides = {}) {
             return {
                 ...base,
                 harnesses: overrides.harnesses ?? ["claude"],
-                autoAdvance: false,
                 promptGuardMode: "advisory",
                 tddEnforcement: "advisory",
                 gitHookGuards: false,
@@ -92,7 +89,6 @@ export function createProfileConfig(profile, overrides = {}) {
             return {
                 ...base,
                 harnesses: overrides.harnesses ?? DEFAULT_HARNESSES,
-                autoAdvance: false,
                 promptGuardMode: "advisory",
                 tddEnforcement: "advisory",
                 gitHookGuards: false,
@@ -103,7 +99,6 @@ export function createProfileConfig(profile, overrides = {}) {
             return {
                 ...base,
                 harnesses: overrides.harnesses ?? DEFAULT_HARNESSES,
-                autoAdvance: false,
                 promptGuardMode: "strict",
                 tddEnforcement: "strict",
                 gitHookGuards: true,
@@ -147,8 +142,6 @@ export async function readConfig(projectRoot) {
     const harnesses = hasHarnessesField
         ? [...new Set(validatedHarnesses)]
         : DEFAULT_HARNESSES;
-    const autoAdvanceRaw = parsed.autoAdvance;
-    const autoAdvance = typeof autoAdvanceRaw === "boolean" ? autoAdvanceRaw : false;
     const promptGuardModeRaw = parsed.promptGuardMode;
     if (Object.prototype.hasOwnProperty.call(parsed, "promptGuardMode") &&
         promptGuardModeRaw !== "advisory" &&
@@ -261,7 +254,6 @@ export async function readConfig(projectRoot) {
         version: parsed.version ?? CCLAW_VERSION,
         flowVersion: parsed.flowVersion ?? FLOW_VERSION,
         harnesses,
-        autoAdvance,
         promptGuardMode,
         tddEnforcement,
         tddTestGlobs,

package/dist/constants.d.ts

@@ -7,6 +7,6 @@ export declare const DEFAULT_HARNESSES: HarnessId[];
 export declare const REQUIRED_DIRS: readonly [".cclaw", ".cclaw/commands", ".cclaw/skills", ".cclaw/contexts", ".cclaw/templates", ".cclaw/artifacts", ".cclaw/features", ".cclaw/state", ".cclaw/runs", ".cclaw/rules", ".cclaw/adapters", ".cclaw/agents", ".cclaw/hooks", ".cclaw/custom-skills"];
 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", "next", "status", "tree", "diff", "feature", "tdd-log", "retro", "rewind", "rewind-ack"];
+export declare const UTILITY_COMMANDS: readonly ["learn", "next", "view", "status", "tree", "diff", "ops", "feature", "tdd-log", "retro", "archive", "rewind", "rewind-ack"];
 export declare const SUBAGENT_SKILL_FOLDERS: readonly ["subagent-dev", "parallel-dispatch"];
 export type UtilityCommand = (typeof UTILITY_COMMANDS)[number];

package/dist/constants.js

@@ -54,12 +54,15 @@ export const COMMAND_FILE_ORDER = [
 export const UTILITY_COMMANDS = [
     "learn",
     "next",
+    "view",
     "status",
     "tree",
     "diff",
+    "ops",
     "feature",
     "tdd-log",
     "retro",
+    "archive",
     "rewind",
     "rewind-ack"
 ];

package/dist/content/archive-command.d.ts

@@ -0,0 +1,2 @@
+export declare function archiveCommandContract(): string;
+export declare function archiveCommandSkillMarkdown(): string;

package/dist/content/archive-command.js

@@ -0,0 +1,98 @@
+import { RUNTIME_ROOT } from "../constants.js";
+const ARCHIVE_SKILL_FOLDER = "flow-archive";
+const ARCHIVE_SKILL_NAME = "flow-archive";
+function flowStatePath() {
+    return `${RUNTIME_ROOT}/state/flow-state.json`;
+}
+function runsPath() {
+    return `${RUNTIME_ROOT}/runs`;
+}
+function activeArtifactsPath() {
+    return `${RUNTIME_ROOT}/artifacts`;
+}
+export function archiveCommandContract() {
+    return `# /cc-ops archive
+
+## Purpose
+
+Archive the active cclaw run from inside the harness flow (agent-first finish).
+
+This command removes the user-facing CLI gap: users can stay in \`/cc-*\` flow and
+finish with \`/cc-ops archive\` after ship + retro are complete.
+
+## HARD-GATE
+
+- Do not archive a shipped run when retro is still incomplete.
+- Do not manually move files between \`${activeArtifactsPath()}\` and \`${runsPath()}\`.
+- Use the archive runtime so state snapshots + manifest stay consistent.
+
+## Inputs
+
+\`/cc-ops archive [--name=<slug>] [--skip-retro --retro-reason=<text>]\`
+
+## Algorithm
+
+1. Read \`${flowStatePath()}\`.
+2. If ship is complete and \`retro.completedAt\` is absent:
+   - block with explicit instruction: run \`/cc-ops retro\` first.
+3. Build archive command:
+   - base: \`npx cclaw archive\`
+   - optional: \`--name=<slug>\`
+   - optional override: \`--skip-retro --retro-reason=<text>\`
+4. Execute archive command in project root.
+5. Surface result:
+   - archive id/path,
+   - reset stage (brainstorm/spec depending on track default),
+   - knowledge curation hint when threshold exceeded.
+
+## Output format
+
+\`\`\`
+cclaw archive
+  status: archived
+  run: <archive-id>
+  path: .cclaw/runs/<archive-id>
+  next: /cc <new-idea>
+\`\`\`
+
+## Primary skill
+
+**${RUNTIME_ROOT}/skills/${ARCHIVE_SKILL_FOLDER}/SKILL.md**
+`;
+}
+export function archiveCommandSkillMarkdown() {
+    return `---
+name: ${ARCHIVE_SKILL_NAME}
+description: "Archive the active cclaw run from harness flow and reset runtime safely."
+---
+
+# /cc-ops archive
+
+## HARD-GATE
+
+Never simulate archive by hand-editing runtime files. Always execute the archive
+runtime command so state snapshots and manifest generation stay atomic.
+
+## Protocol
+
+1. Read \`${flowStatePath()}\`:
+   - confirm whether ship is completed,
+   - check \`retro.completedAt\` for post-ship runs.
+2. If ship complete and retro incomplete -> stop and direct user to \`/cc-ops retro\`.
+3. Build shell command:
+   - \`npx cclaw archive\`
+   - append \`--name=<slug>\` when provided
+   - append \`--skip-retro --retro-reason=<text>\` only when user explicitly requests skip
+4. Run command from repo root.
+5. Relay key lines from output:
+   - archive destination under \`${runsPath()}\`
+   - flow reset confirmation
+   - knowledge curation recommendation
+
+## Validation
+
+- \`${runsPath()}\` contains a new archive folder.
+- \`${activeArtifactsPath()}\` is reset for the next run.
+- \`${flowStatePath()}\` is valid JSON and points to the initial stage.
+`;
+}

package/dist/content/contracts.js

@@ -36,7 +36,7 @@ ${schema.hardGate}
 ${hydrationLines}
 4. Stream \`.cclaw/knowledge.jsonl\` and apply relevant JSON-line entries (strict schema: type, trigger, action, confidence, domain, stage, created, project).
 5. Write stage output to ${writeStepPaths}.
-6. Do NOT copy artifacts into \`.cclaw/runs/\`; archival is handled only by \`cclaw archive\`.
+6. Do NOT copy artifacts into \`.cclaw/runs/\`; archival is handled by \`/cc-ops archive\` (agent-facing wrapper over archive runtime).
 
 ## Gates
 ${gateIds}

package/dist/content/diff-command.js

@@ -8,7 +8,7 @@ function snapshotPath() {
     return `${RUNTIME_ROOT}/state/flow-state.snapshot.json`;
 }
 export function diffCommandContract() {
-    return `# /cc-diff
+    return `# /cc-view diff
 
 ## Purpose
 
@@ -54,7 +54,7 @@ name: ${DIFF_SKILL_NAME}
 description: "Compare current flow-state against saved snapshot and render gate/stage deltas."
 ---
 
-# /cc-diff
+# /cc-view diff
 
 ## HARD-GATE
 

package/dist/content/feature-command.js

@@ -14,7 +14,7 @@ function runtimeStatePath() {
     return `${RUNTIME_ROOT}/state`;
 }
 export function featureCommandContract() {
-    return `# /cc-feature
+    return `# /cc-ops feature
 
 ## Purpose
 
@@ -34,19 +34,19 @@ Feature snapshots live under \`${featuresRoot()}/<feature-id>/\`.
 
 ## Subcommands
 
-### \`/cc-feature status\`
+### \`/cc-ops feature status\`
 Show active feature id and snapshot location.
 
-### \`/cc-feature list\`
+### \`/cc-ops feature list\`
 List all feature ids in \`${featuresRoot()}/\` (directory names).
 
-### \`/cc-feature new <feature-id>\`
+### \`/cc-ops feature new <feature-id>\`
 Create \`${featuresRoot()}/<feature-id>/artifacts\` and \`${featuresRoot()}/<feature-id>/state\`.
 
 Optional flag:
 - \`--clone-active\`: clone current active runtime into the new feature snapshot.
 
-### \`/cc-feature switch <feature-id>\`
+### \`/cc-ops feature switch <feature-id>\`
 1. Snapshot current active runtime into \`${featuresRoot()}/<active>/\`.
 2. Restore target snapshot from \`${featuresRoot()}/<feature-id>/\` into active runtime:
    - \`${runtimeArtifactsPath()}\`
@@ -73,7 +73,7 @@ name: ${FEATURE_SKILL_NAME}
 description: "Manage cclaw multi-feature workspaces (status/list/new/switch) while preserving active flow runtime."
 ---
 
-# /cc-feature — Feature Workspace Manager
+# /cc-ops feature — Feature Workspace Manager
 
 ## HARD-GATE
 
@@ -113,7 +113,7 @@ Do not switch feature by editing only \`active-feature.json\`. A valid switch mu
 
 ## Safety checks
 
-- If target feature does not exist: block and suggest \`/cc-feature new <id>\`.
+- If target feature does not exist: block and suggest \`/cc-ops feature new <id>\`.
 - If snapshot copy fails: abort switch, keep current active feature unchanged.
 - Preserve global pointer file \`active-feature.json\` when restoring state.
 `;

package/dist/content/harnesses-doc.js

@@ -65,15 +65,22 @@ All harnesses receive the same utility commands:
 
 - \`/cc\` - flow entry and resume
 - \`/cc-next\` - stage progression
+- \`/cc-view\` - read-only router for status/tree/diff
 - \`/cc-learn\` - knowledge capture/lookup
-- \`/cc-status\` - read-only visual flow snapshot
-- \`/cc-tree\` - deep flow tree (stages, artifacts, stale markers)
-- \`/cc-diff\` - before/after flow-state diff map
-- \`/cc-feature\` - multi-feature workspace management
-- \`/cc-tdd-log\` - explicit RED/GREEN/REFACTOR evidence log
-- \`/cc-retro\` - mandatory retrospective gate before archive
-- \`/cc-rewind\` - rewind flow and invalidate downstream stages
-- \`/cc-rewind-ack\` - clear stale stage markers after redo
+- \`/cc-ops\` - operations router for feature/tdd-log/retro/archive/rewind
+
+Read-only subcommands:
+- \`/cc-view status\` - visual flow snapshot
+- \`/cc-view tree\` - deep flow tree (stages, artifacts, stale markers)
+- \`/cc-view diff\` - before/after flow-state diff map
+
+Operations subcommands:
+- \`/cc-ops feature ...\` - multi-feature workspace management
+- \`/cc-ops tdd-log ...\` - explicit RED/GREEN/REFACTOR evidence log
+- \`/cc-ops retro\` - mandatory retrospective gate before archive
+- \`/cc-ops archive\` - archive active run from harness flow
+- \`/cc-ops rewind ...\` - rewind flow and invalidate downstream stages
+- \`/cc-ops rewind-ack ...\` - clear stale stage markers after redo
 
 Stage order remains canonical:
 \`brainstorm -> scope -> design -> spec -> plan -> tdd -> review -> ship\`

package/dist/content/hooks.js

@@ -496,7 +496,7 @@ To disable suggestions persistently set ${RUNTIME_ROOT}/state/suggestion-memory.
 fi
 if [ -n "$STALE_STAGES" ]; then
   CTX="$CTX
-Stale stages pending acknowledgement: $STALE_STAGES (use /cc-rewind-ack <stage> after redo)."
+Stale stages pending acknowledgement: $STALE_STAGES (use /cc-ops rewind-ack <stage> after redo)."
 fi
 if [ -n "$KNOWLEDGE_DIGEST" ]; then
   CTX="$CTX
@@ -742,7 +742,7 @@ if [ "$CHECKPOINT_WRITTEN" -eq 0 ]; then
   CHECKPOINT_NOTE="Checkpoint update failed. Review ${RUNTIME_ROOT}/state/checkpoint.json manually."
 fi
 
-RUN_SYNC_NOTE="Run metadata sync removed; active artifacts stay in ${RUNTIME_ROOT}/artifacts until cclaw archive."
+RUN_SYNC_NOTE="Run metadata sync removed; active artifacts stay in ${RUNTIME_ROOT}/artifacts until /cc-ops archive (or cclaw archive runtime)."
 
 # --- Escape for JSON ---
 ${ESCAPE_FN}

package/dist/content/learnings.d.ts

@@ -5,6 +5,3 @@
 export declare const KNOWLEDGE_JSONL_FIELDS: readonly ["type", "trigger", "action", "confidence", "domain", "stage", "created", "project"];
 export declare function learnSkillMarkdown(): string;
 export declare function learnCommandContract(): string;
-export declare function selfImprovementBlock(stageName: string): string;
-export declare function learningsSearchPreamble(stage: string): string;
-export declare function learningsAgentsMdBlock(): string;

package/dist/content/learnings.js

@@ -134,41 +134,3 @@ Do not edit source code from this command. Only operate on \`${KNOWLEDGE_PATH}\`
 | \`curate\` | — | Hand off to the **knowledge-curation** skill: read-only audit + soft-archive plan when the file exceeds the curation threshold. |
 `;
 }
-export function selfImprovementBlock(stageName) {
-    return `## Operational Self-Improvement
-
-After this stage, ask:
-- Did I discover a non-obvious reusable **rule** or **pattern**?
-- Did a failure reveal a reusable **lesson**?
-
-If yes, append one concise JSON line to the canonical knowledge store
-(\`${KNOWLEDGE_PATH}\`) using the strict 8-field schema:
-
-\`\`\`bash
-TS="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-printf '%s\\n' '{"type":"pattern","trigger":"when <situation>","action":"<concrete move>","confidence":"medium","domain":null,"stage":"${stageName}","created":"'"$TS"'","project":null}' >> ${KNOWLEDGE_PATH}
-\`\`\`
-
-Type must be exactly one of: \`rule\`, \`pattern\`, \`lesson\`, \`compound\`.
-Fields must appear in the order: \`type, trigger, action, confidence, domain, stage, created, project\`.
-Missing optional values must be emitted as \`null\`, never omitted.
-`;
-}
-export function learningsSearchPreamble(stage) {
-    return `## Prior Knowledge (load at stage start)
-
-Before stage work, stream \`${KNOWLEDGE_PATH}\` and filter for entries relevant to
-this stage (\`${stage}\`), affected domains, and key constraints. Apply matching
-entries explicitly. If the file is empty, continue normally.
-`;
-}
-export function learningsAgentsMdBlock() {
-    return `### Knowledge Store
-
-\`${KNOWLEDGE_PATH}\` — append-only JSONL memory with entry types \`rule\`, \`pattern\`, \`lesson\`, \`compound\`.
-Strict 8-field schema: \`type, trigger, action, confidence, domain, stage, created, project\`.
-At session start and stage transitions, tail the file and apply relevant entries.
-If a non-obvious reusable rule/pattern/lesson is discovered, append a new line
-through \`/cc-learn add\` (never hand-edit).
-`;
-}

package/dist/content/meta-skill.js

@@ -3,7 +3,7 @@ export const META_SKILL_NAME = "using-cclaw";
 export function usingCclawSkillMarkdown() {
     return `---
 name: using-cclaw
-description: "Routing brain for cclaw. Decide whether to start/resume a stage, answer directly, or use utility commands like /cc-learn, /cc-status, /cc-tree, and /cc-diff."
+description: "Routing brain for cclaw. Decide whether to start/resume a stage, answer directly, or use utility commands like /cc-learn, /cc-view, and /cc-ops."
 ---
 
 # Using Cclaw
@@ -27,7 +27,8 @@ Task arrives
   ├─ New software work? -> /cc <idea>
   ├─ Resume existing flow? -> /cc or /cc-next
   ├─ Knowledge operation? -> /cc-learn
-  └─ Workspace operation? -> /cc-status, /cc-tree, /cc-diff, /cc-feature, /cc-tdd-log, /cc-retro, /cc-rewind
+  ├─ Read-only workspace view? -> /cc-view [status|tree|diff]
+  └─ Workspace operation? -> /cc-ops [feature|tdd-log|retro|archive|rewind|rewind-ack]
 \`\`\`
 
 ## Task classification

package/dist/content/next-command.js

@@ -33,13 +33,13 @@ This is the only progression command the user needs to drive the entire flow. St
 
 - **Do not** invent gate completion: use only \`${flowPath}\` plus observable evidence in repo artifacts.
 - **Do not** skip stages: advance only from \`currentStage\` to its configured successor.
-- If the flow is at the terminal stage with all ship gates satisfied, **report completion**.
+- If the flow reaches terminal ship completion, route closeout in order: **/cc-ops retro -> /cc-ops archive**.
 
 ## Algorithm (mandatory)
 
 1. Read **\`${flowPath}\`**. If missing → **BLOCKED** (state missing).
 2. Parse JSON. Capture \`currentStage\` and \`stageGateCatalog[currentStage]\`.
-3. If \`staleStages[currentStage]\` exists, do not advance automatically. Re-run the stage artifact work, then clear the marker with \`/cc-rewind-ack <currentStage>\`.
+3. If \`staleStages[currentStage]\` exists, do not advance automatically. Re-run the stage artifact work, then clear the marker with \`/cc-ops rewind-ack <currentStage>\`.
 4. Let \`G\` = \`requiredGates\` for **\`currentStage\`** from the stage schema.
 5. Let \`catalog\` = \`stageGateCatalog[currentStage]\` from flow state.
 6. **Satisfied** for gate id \`g\`: \`g\` in \`catalog.passed\` and \`g\` not in \`catalog.blocked\`.
@@ -54,7 +54,10 @@ This is the only progression command the user needs to drive the entire flow. St
 
 ### Path B: Current stage IS complete (all gates passed, all delegations satisfied)
 
-→ If current stage's \`next\` is **\`done\`**: report **"Flow complete. All stages finished."** and stop.
+→ If current stage's \`next\` is **\`done\`**:
+  - if \`currentStage === "ship"\` and \`retro.completedAt\` is missing -> route to \`/cc-ops retro\`,
+  - if \`currentStage === "ship"\` and \`retro.completedAt\` is present -> route to \`/cc-ops archive\`,
+  - otherwise report **"Flow complete. All stages finished."** and stop.
 → Otherwise: load **\`${RUNTIME_ROOT}/skills/<skillFolder>/SKILL.md\`** and **\`${RUNTIME_ROOT}/commands/<nextStage>.md\`** for the successor stage. Execute that stage's protocol.
 
 ### Track-aware successor resolution
@@ -121,7 +124,7 @@ Do **not** mark gates satisfied from memory alone. Cite **artifact evidence** (p
 
 1. Open **\`${flowPath}\`**.
 2. Record \`currentStage\` and \`stageGateCatalog[currentStage]\`.
-3. If \`staleStages[currentStage]\` exists, re-run the stage and clear marker via \`/cc-rewind-ack <currentStage>\` before advancing.
+3. If \`staleStages[currentStage]\` exists, re-run the stage and clear marker via \`/cc-ops rewind-ack <currentStage>\` before advancing.
 4. If the file is missing or invalid JSON → **BLOCKED** (report and stop).
 
 ### Step 2: Evaluate gates
@@ -144,7 +147,11 @@ Execute the stage protocol. The stage skill handles interaction, STOP points, ga
 
 **Path B — stage IS complete (all gates met, all delegations done):**
 
-If \`next\` is \`done\` → report **"Flow complete. All stages finished."** and stop.
+If \`next\` is \`done\`:
+
+- If \`currentStage\` is \`ship\` and \`retro.completedAt\` is missing -> route to \`/cc-ops retro\`.
+- If \`currentStage\` is \`ship\` and \`retro.completedAt\` exists -> route to \`/cc-ops archive\`.
+- Otherwise report **"Flow complete. All stages finished."** and stop.
 
 Otherwise load the next stage's skill and command contract, begin execution.
 

package/dist/content/ops-command.d.ts

@@ -0,0 +1,2 @@
+export declare function opsCommandContract(): string;
+export declare function opsCommandSkillMarkdown(): string;

package/dist/content/ops-command.js

@@ -0,0 +1,60 @@
+import { RUNTIME_ROOT } from "../constants.js";
+const OPS_SKILL_FOLDER = "flow-ops";
+const OPS_SKILL_NAME = "flow-ops";
+export function opsCommandContract() {
+    return `# /cc-ops
+
+## Purpose
+
+Unified operational command surface for non-stage flow actions.
+
+Subcommands:
+- \`feature\` -> \`/cc-ops feature\`
+- \`tdd-log\` -> \`/cc-ops tdd-log\`
+- \`retro\` -> \`/cc-ops retro\`
+- \`archive\` -> \`/cc-ops archive\`
+- \`rewind\` -> \`/cc-ops rewind\`
+- \`rewind-ack\` -> \`/cc-ops rewind-ack\`
+
+## HARD-GATE
+
+- \`/cc-ops\` is a routing wrapper; execute only one target subcommand per call.
+- Preserve target command safety contracts (retro gate, archive gate, rewind atomicity, etc.).
+
+## Routing
+
+1. Parse required subcommand token.
+2. Dispatch:
+   - \`feature\` -> \`${RUNTIME_ROOT}/commands/feature.md\`
+   - \`tdd-log\` -> \`${RUNTIME_ROOT}/commands/tdd-log.md\`
+   - \`retro\` -> \`${RUNTIME_ROOT}/commands/retro.md\`
+   - \`archive\` -> \`${RUNTIME_ROOT}/commands/archive.md\`
+   - \`rewind\` -> \`${RUNTIME_ROOT}/commands/rewind.md\`
+   - \`rewind-ack\` -> \`${RUNTIME_ROOT}/commands/rewind-ack.md\`
+3. Unknown subcommand -> print supported values and stop.
+
+## Primary skill
+
+**${RUNTIME_ROOT}/skills/${OPS_SKILL_FOLDER}/SKILL.md**
+`;
+}
+export function opsCommandSkillMarkdown() {
+    return `---
+name: ${OPS_SKILL_NAME}
+description: "Unified operational router for feature/tdd-log/retro/archive/rewind commands."
+---
+
+# /cc-ops
+
+## HARD-GATE
+
+This wrapper only dispatches. It must not apply state mutations itself.
+
+## Protocol
+
+1. Require a subcommand (\`feature|tdd-log|retro|archive|rewind|rewind-ack\`).
+2. Route to the matching command contract + skill pair.
+3. Preserve pass-through args after the subcommand (e.g. \`/cc-ops rewind design\`).
+4. Echo which subcommand was dispatched for auditability.
+`;
+}

package/dist/content/protocols.js

@@ -46,8 +46,20 @@ Shared closeout sequence applied by every stage skill.
    - update \`guardEvidence\`.
 3. Persist stage artifact under \`.cclaw/artifacts/\`.
 4. Run \`npx cclaw doctor\` and resolve failures.
-5. Notify user with stage completion and next action (\`/cc-next\`).
-6. Stop; do not auto-run the next stage unless user asks.
+5. Capture reusable learnings from this stage artifact:
+   - append 1-3 strict-schema JSONL entries when the stage produced non-obvious
+     decisions, patterns, or lessons,
+   - use \`type=rule|pattern|lesson\` (\`compound\` stays retro-focused).
+6. Notify user with stage completion and next action (\`/cc-next\`).
+7. Stop; do not auto-run the next stage unless user asks.
+
+## Automatic learning capture policy
+
+- \`standard\` / \`medium\` tracks: required for \`design\`, \`tdd\`, and \`review\`;
+  recommended for other stages.
+- \`quick\` track: recommended only (avoid overhead for tiny fixes).
+- "No learning captured" is acceptable only when explicitly justified (e.g. pure
+  mechanical change, no new trade-offs).
 
 ## Resume protocol
 

package/dist/content/retro-command.js

@@ -11,7 +11,7 @@ function knowledgePath() {
     return `${RUNTIME_ROOT}/knowledge.jsonl`;
 }
 export function retroCommandContract() {
-    return `# /cc-retro
+    return `# /cc-ops retro
 
 ## Purpose
 
@@ -36,7 +36,7 @@ Mandatory retrospective gate before archive once ship is complete.
    - \`required: true\`
    - \`completedAt: <ISO>\`
    - \`compoundEntries: <count>\`
-5. Report completion summary and remind user that \`cclaw archive\` is now unblocked.
+5. Report completion summary and remind user that \`/cc-ops archive\` is now unblocked.
 
 ## Primary skill
 
@@ -49,7 +49,7 @@ name: ${RETRO_SKILL_NAME}
 description: "Run mandatory retrospective and record compound knowledge before archive."
 ---
 
-# /cc-retro
+# /cc-ops retro
 
 ## HARD-GATE
 

package/dist/content/rewind-command.js

@@ -11,7 +11,7 @@ function rewindLogPath() {
     return `${RUNTIME_ROOT}/state/rewind-log.jsonl`;
 }
 export function rewindCommandContract() {
-    return `# /cc-rewind
+    return `# /cc-ops rewind
 
 ## Purpose
 
@@ -25,7 +25,7 @@ Rewind active flow to an earlier stage and atomically invalidate downstream work
 
 ## Inputs
 
-\`/cc-rewind <target-stage> [reason]\`
+\`/cc-ops rewind <target-stage> [reason]\`
 
 ## Algorithm
 
@@ -55,7 +55,7 @@ Rewind active flow to an earlier stage and atomically invalidate downstream work
 `;
 }
 export function rewindAcknowledgeCommandContract() {
-    return `# /cc-rewind-ack
+    return `# /cc-ops rewind-ack
 
 ## Purpose
 
@@ -63,7 +63,7 @@ Acknowledge and clear stale-stage markers after downstream work is intentionally
 
 ## Input
 
-\`/cc-rewind-ack <stage>\`
+\`/cc-ops rewind-ack <stage>\`
 
 ## HARD-GATE
 
@@ -89,7 +89,7 @@ name: ${REWIND_SKILL_NAME}
 description: "Rewind active flow stage safely and acknowledge stale invalidations."
 ---
 
-# /cc-rewind + /cc-rewind-ack
+# /cc-ops rewind + /cc-ops rewind-ack
 
 ## HARD-GATE
 

package/dist/content/stage-common-guidance.js

@@ -24,9 +24,9 @@ Use this same closeout menu for every stage:
 
 - **A) Advance** — run \`/cc-next\` and continue.
 - **B) Revise this stage** — stay on current stage and apply feedback.
-- **C) Pause / park** — stop now and resume later.
-- **D) Rewind** — move to a prior stage explicitly chosen by the user.
-- **E) Abandon** — cancel this flow; artifacts remain on disk.
+- **C) Pause / park** — run \`/cc-view status\`, then stop and resume later.
+- **D) Rewind** — run \`/cc-ops rewind <target-stage>\`.
+- **E) Abandon** — archive with \`/cc-ops archive --skip-retro --retro-reason="<reason>"\` when user explicitly wants to end the run.
 
 Recommendation defaults:
 
@@ -58,8 +58,17 @@ Rollback / fallback: <if decision proves wrong>
 
 ## Self-improvement reminder
 
-If a reusable lesson appears during the stage, append one strict-schema JSONL
-entry via \`/cc-learn add\`. Do not keep operational lessons only in chat.
+Before closeout, capture 1-3 reusable insights in \`.cclaw/knowledge.jsonl\`
+whenever the stage produced non-obvious decisions, patterns, or lessons.
+Prefer \`type=rule|pattern|lesson\` (\`compound\` stays retro-focused).
+
+Track policy:
+- \`standard\` / \`medium\`: required for \`design\`, \`tdd\`, and \`review\`;
+  recommended for other stages.
+- \`quick\`: recommended only.
+
+"No learning captured" is acceptable only with an explicit reason
+(for example, purely mechanical edits with no new decisions).
 
 ## Progressive disclosure baseline