claudecode-omc 4.8.2 → 4.8.4

package/dist/utils/skill-pipeline.js

@@ -0,0 +1,97 @@
+import { parseFrontmatterList, stripOptionalQuotes } from './frontmatter.js';
+function normalizeSkillReference(value) {
+    if (!value)
+        return undefined;
+    const trimmed = stripOptionalQuotes(value).trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed
+        .replace(/^\/oh-my-claudecode:/i, '')
+        .replace(/^oh-my-claudecode:/i, '')
+        .replace(/^\//, '')
+        .trim()
+        .toLowerCase() || undefined;
+}
+function uniqueStrings(values) {
+    const seen = new Set();
+    const results = [];
+    for (const value of values) {
+        const normalized = value.trim();
+        if (!normalized)
+            continue;
+        const key = normalized.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        results.push(normalized);
+    }
+    return results;
+}
+export function parseSkillPipelineMetadata(frontmatter) {
+    const steps = uniqueStrings(parseFrontmatterList(frontmatter.pipeline)
+        .map((step) => normalizeSkillReference(step))
+        .filter((step) => Boolean(step)));
+    const nextSkill = normalizeSkillReference(frontmatter['next-skill']);
+    const nextSkillArgs = stripOptionalQuotes(frontmatter['next-skill-args'] ?? '').trim() || undefined;
+    const handoff = stripOptionalQuotes(frontmatter.handoff ?? '').trim() || undefined;
+    if (steps.length === 0 && !nextSkill && !nextSkillArgs && !handoff) {
+        return undefined;
+    }
+    return {
+        steps,
+        nextSkill,
+        nextSkillArgs,
+        handoff,
+    };
+}
+export function renderSkillPipelineGuidance(skillName, pipeline) {
+    if (!pipeline) {
+        return '';
+    }
+    const currentSkill = normalizeSkillReference(skillName) ?? skillName.trim().toLowerCase();
+    const steps = uniqueStrings([
+        ...pipeline.steps,
+        currentSkill,
+        ...(pipeline.nextSkill ? [pipeline.nextSkill] : []),
+    ]);
+    const nextInvocation = pipeline.nextSkill
+        ? [
+            `Skill("oh-my-claudecode:${pipeline.nextSkill}")`,
+            pipeline.nextSkillArgs ? `with arguments \`${pipeline.nextSkillArgs}\`` : undefined,
+            'using the handoff context from this stage',
+        ].filter(Boolean).join(' ')
+        : undefined;
+    const lines = [
+        '## Skill Pipeline',
+    ];
+    if (steps.length > 0) {
+        lines.push(`Pipeline: \`${steps.join(' → ')}\``);
+    }
+    lines.push(`Current stage: \`${currentSkill}\``);
+    if (pipeline.nextSkill) {
+        lines.push(`Next skill: \`${pipeline.nextSkill}\``);
+    }
+    if (pipeline.nextSkillArgs) {
+        lines.push(`Next skill arguments: \`${pipeline.nextSkillArgs}\``);
+    }
+    if (pipeline.handoff) {
+        lines.push(`Handoff artifact: \`${pipeline.handoff}\``);
+    }
+    lines.push('');
+    if (pipeline.nextSkill) {
+        lines.push('When this stage completes:');
+        if (pipeline.handoff) {
+            lines.push(`1. Write or update the handoff artifact at \`${pipeline.handoff}\`.`);
+        }
+        else {
+            lines.push('1. Write a concise handoff note before moving to the next skill.');
+        }
+        lines.push('2. Carry forward the concrete output, decisions made, and remaining risks or assumptions.');
+        lines.push(`3. Invoke ${nextInvocation}.`);
+    }
+    else {
+        lines.push('This is the terminal stage in the declared skill pipeline. Do not hand off to another skill unless the user explicitly asks.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=skill-pipeline.js.map

package/dist/utils/skill-pipeline.js.map

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

package/docs/AGENTS.md

@@ -26,7 +26,7 @@ This directory contains documentation for end-users and developers:
 | `TIERED_AGENTS_V2.md` | Model routing and tiered agent design |
 | `DELEGATION-ENFORCER.md` | Delegation protocol documentation |
 | `SYNC-SYSTEM.md` | State synchronization system |
-| `ANALYTICS-SYSTEM.md` | Analytics collection documentation |
+| `ANALYTICS-SYSTEM.md` | Historical note on the removed analytics subsystem and current monitoring replacements |
 | `LOCAL_PLUGIN_INSTALL.md` | Plugin installation guide |
 
 ## Subdirectories

package/docs/ANALYTICS-SYSTEM.md

@@ -1,147 +1,38 @@
-# OMC Analytics System
+# Analytics System (Removed)
 
-## Overview
+## Status
 
-Automatic token tracking and cost estimation for Claude API usage in oh-my-claudecode.
+The legacy analytics subsystem referenced by issue #1533 no longer exists on current `dev`.
 
-## Features
+The original code paths (`src/analytics/session-manager.ts`, `src/analytics/query-engine.ts`, and the related `omc-analytics` / `omc cost` / `omc backfill` workflow) were removed in commit `8011af06` as part of the broader analytics cleanup.
 
-- **Automatic Token Tracking**: Zero manual recording - tracks every HUD render
-- **Cost Estimation**: Model-specific pricing with cache economics
-- **Session Management**: Track costs across multiple sessions
-- **Beautiful CLI**: Enhanced analytics visualization
-- **HUD Integration**: Real-time cost display in statusline
+## What Replaced It
 
-## Architecture
+Current builds still expose useful monitoring surfaces, but they are different from the removed analytics stack:
 
-```
-StatuslineStdin → TokenExtractor → TokenTracker → Analytics Summary
-                                         ↓
-                                    HUD Display
-                                         ↓
-                                    CLI Reports
-```
-
-## Auto-Tracking
-
-Token usage is automatically captured on every HUD render:
-
-1. **TokenExtractor** parses StatuslineStdin for token data
-2. **Delta Calculation** computes change from previous render
-3. **Agent Correlation** associates tokens with running agents
-4. **TokenTracker** records usage to JSONL log
-5. **Summary Files** provide fast <10ms session loading
+- **Agent Observatory** — real-time agent status in the HUD / API
+- **Session Replay** — `.omc/state/agent-replay-*.jsonl` event timelines
+- **Session-end summaries** — `.omc/sessions/<sessionId>.json` written by the `session-end` hook
+- **Session-end notifications/callbacks** — summary payloads sent through configured notification channels
 
-## Output Token Estimation
+## What Is No Longer Available
 
-Since StatuslineStdin only provides input tokens, output tokens are estimated:
+The following legacy surfaces should be treated as removed:
 
-- **Haiku**: 30% of input tokens
-- **Sonnet**: 40% of input tokens
-- **Opus**: 50% of input tokens
+- `omc-analytics`
+- `omc cost`, `omc sessions`, `omc export`, `omc backfill`
+- the HUD `analytics` preset
+- `src/analytics/*` implementation files
+- the old metrics cleanup pipeline described in issue #1533
 
-All costs displayed with "~" prefix to indicate estimation.
+## If You Need Session Metrics Today
 
-## HUD Integration
-
-Real-time analytics in statusline:
-
-- Session cost and tokens
-- Cost per hour
-- Cache efficiency
-- Budget warnings (>$2 warning, >$5 critical)
-
-Use `analytics` preset for detailed display.
-
-## CLI Usage
+Use the currently supported surfaces instead:
 
 ```bash
-# View everything (default dashboard)
-omc
-
-# Cost reports
-omc cost daily
-omc cost weekly
-omc cost monthly
-
-# Session history
-omc sessions
-
-# Agent observability is shown in HUD/replay logs
-# (legacy standalone agent-breakdown command was removed)
-
-# Export data
-omc export cost csv ./costs.csv
+omc hud
+tail -20 .omc/state/agent-replay-*.jsonl
+ls .omc/sessions/*.json
 ```
 
-## Performance
-
-- **HUD Render**: <100ms total (including analytics)
-- **Token Extraction**: <5ms per render
-- **Summary Loading**: <10ms (mtime-cached)
-- **CLI Startup**: <500ms
-
-## Files
-
-- `src/analytics/token-extractor.ts` - Token extraction
-- `src/analytics/output-estimator.ts` - Output estimation & session ID
-- `src/analytics/analytics-summary.ts` - Fast summary loading
-- `src/hud/index.ts` - Auto-recording integration
-- `.omc/state/token-tracking.jsonl` - Append-only token log
-- `.omc/state/analytics-summary-{sessionId}.json` - Cached summaries
-
-## Offline Transcript Analysis
-
-### Overview
-
-The analytics system can analyze historical Claude Code session transcripts from `~/.claude/projects/` to backfill token usage data.
-
-### The `omc backfill` Command
-
-Extracts actual token usage from Claude Code transcripts and adds them to the analytics database.
-
-```bash
-omc backfill [options]
-```
-
-#### Options
-
-| Option | Description |
-|--------|-------------|
-| `--project <glob>` | Filter to specific project paths |
-| `--from <date>` | Only process transcripts modified after date (ISO format) |
-| `--to <date>` | Only process transcripts modified before date |
-| `--dry-run` | Preview without writing to database |
-| `--reset` | Clear deduplication index and re-process all |
-| `--verbose` | Show detailed per-file progress |
-| `--json` | Output as JSON |
-
-#### Examples
-
-```bash
-# Preview all available transcripts
-omc backfill --dry-run
-
-# Backfill specific project
-omc backfill --project "*VibeQuant*"
-
-# Backfill recent transcripts only
-omc backfill --from "2026-01-01"
-
-# Re-process everything
-omc backfill --reset
-```
-
-### Auto-Backfill
-
-The `omc` CLI automatically runs a silent backfill on startup if more than 24 hours have passed since the last backfill. This ensures your analytics stay up-to-date without manual intervention.
-
-### Data Sources
-
-- **Transcript Location**: `~/.claude/projects/<encoded-path>/<uuid>.jsonl`
-- **Token Data**: Actual `output_tokens` from API responses (not estimates)
-- **Agent Detection**: Extracted from `tool_use` blocks with Task tool
-
-### Deduplication
-
-Entries are deduplicated using a hash of `sessionId + timestamp + model`. Safe to run multiple times.
+For integration hooks, inspect the `session-end` summary JSON and notification payloads rather than looking for the removed analytics commands.

package/docs/CLAUDE.md

@@ -1,184 +1,85 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:4.6.0 -->
+<!-- OMC:VERSION:4.7.10 -->
 
 # oh-my-claudecode - Intelligent Multi-Agent Orchestration
 
 You are running with oh-my-claudecode (OMC), a multi-agent orchestration layer for Claude Code.
-Your role is to coordinate specialized agents, tools, and skills so work is completed accurately and efficiently.
+Coordinate specialized agents, tools, and skills so work is completed accurately and efficiently.
 
 <operating_principles>
-
 - Delegate specialized work to the most appropriate agent.
-- Keep users informed with concise progress updates.
-- Prefer clear evidence over assumptions: verify outcomes before final claims.
-- Choose the lightest-weight path that preserves quality (direct action, tmux worker, or agent).
-- Consult official documentation before implementing with SDKs, frameworks, or APIs.
-  </operating_principles>
+- Prefer evidence over assumptions: verify outcomes before final claims.
+- Choose the lightest-weight path that preserves quality.
+- Consult official docs before implementing with SDKs/frameworks/APIs.
+</operating_principles>
 
 <delegation_rules>
-Delegate for: multi-file changes, refactors, debugging, reviews, planning, research, verification, specialist work.
-Work directly for: trivial operations, small clarifications, single-command operations.
-Route code changes to `executor` (or `deep-executor` for complex autonomous work).
-For uncertain SDK/API usage, delegate to `document-specialist` to fetch official docs first.
+Delegate for: multi-file changes, refactors, debugging, reviews, planning, research, verification.
+Work directly for: trivial ops, small clarifications, single commands.
+Route code to `executor` (use `model=opus` for complex work). Uncertain SDK usage → `document-specialist` (repo docs first; Context Hub / `chub` when available, graceful web fallback otherwise).
 </delegation_rules>
 
 <model_routing>
-Pass `model` on Task calls: `haiku` (quick lookups), `sonnet` (standard implementation), `opus` (architecture, deep analysis).
+`haiku` (quick lookups), `sonnet` (standard), `opus` (architecture, deep analysis).
 Direct writes OK for: `~/.claude/**`, `.omc/**`, `.claude/**`, `CLAUDE.md`, `AGENTS.md`.
-For source-code edits, prefer delegation to implementation agents.
 </model_routing>
 
 <agent_catalog>
-Use `oh-my-claudecode:` prefix for Task subagent types.
-
-Build/Analysis:
-
-- `explore` (haiku): codebase discovery, symbol/file mapping
-- `analyst` (opus): requirements clarity, acceptance criteria
-- `planner` (opus): task sequencing, execution plans
-- `architect` (opus): system design, boundaries, interfaces
-- `debugger` (sonnet): root-cause analysis, regression isolation
-- `executor` (sonnet): code implementation, refactoring
-- `deep-executor` (opus): complex autonomous goal-oriented tasks
-- `verifier` (sonnet): completion evidence, claim validation
-
-Review:
-
-- `quality-reviewer` (sonnet): logic defects, maintainability, anti-patterns, performance
-- `security-reviewer` (sonnet): vulnerabilities, trust boundaries, authn/authz
-- `code-reviewer` (opus): comprehensive review, API contracts, backward compatibility
-
-Domain:
-
-- `test-engineer` (sonnet): test strategy, coverage, flaky-test hardening
-- `build-fixer` (sonnet): build/toolchain/type failures
-- `designer` (sonnet): UX/UI architecture, interaction design
-- `writer` (haiku): docs, migration notes, user guidance
-- `qa-tester` (sonnet): interactive CLI/service runtime validation
-- `scientist` (sonnet): data/statistical analysis
-- `document-specialist` (sonnet): external documentation & reference lookup
-- `git-master` (sonnet): git operations, commit history management
-- `code-simplifier` (opus): code clarity and simplification
+Prefix: `oh-my-claudecode:`. See `agents/*.md` for full prompts.
 
-Coordination:
-
-- `critic` (opus): plan/design critical challenge
-  </agent_catalog>
+explore (haiku), analyst (opus), planner (opus), architect (opus), debugger (sonnet), executor (sonnet), verifier (sonnet), security-reviewer (sonnet), code-reviewer (opus), test-engineer (sonnet), designer (sonnet), writer (haiku), qa-tester (sonnet), scientist (sonnet), document-specialist (sonnet), git-master (sonnet), code-simplifier (opus), critic (opus)
+</agent_catalog>
 
 <tools>
-External AI (tmux CLI workers):
-- Claude agents: `/team N:executor "task"` via `TeamCreate`/`Task`
-- Codex/Gemini workers: `omc team N:codex|gemini "..."` (plus `omc team status <team-name>` / `omc team shutdown <team-name>`)
-- Provider advisor CLI: `omc ask <claude|codex|gemini> ...` (writes artifacts to `.omc/artifacts/ask/`)
-- Ask shortcuts: `/oh-my-claudecode:ask-codex` and `/oh-my-claudecode:ask-gemini` route to the same `omc ask` flow
-- CCG skill route: `/oh-my-claudecode:ccg` fans out via `ask-codex` + `ask-gemini`, then Claude synthesizes
-
+External AI: `/team N:executor "task"`, `omc team N:codex|gemini "..."`, `omc ask <claude|codex|gemini>`, `/ccg`
 OMC State: `state_read`, `state_write`, `state_clear`, `state_list_active`, `state_get_status`
-
-- Stored at `{worktree}/.omc/state/{mode}-state.json`; session-scoped under `.omc/state/sessions/{sessionId}/`
-
-Team Coordination: `TeamCreate`, `TeamDelete`, `SendMessage`, `TaskCreate`, `TaskList`, `TaskGet`, `TaskUpdate`
-
-Notepad (`{worktree}/.omc/notepad.md`): `notepad_read`, `notepad_write_priority`, `notepad_write_working`, `notepad_write_manual`, `notepad_prune`, `notepad_stats`
-
-Project Memory (`{worktree}/.omc/project-memory.json`): `project_memory_read`, `project_memory_write`, `project_memory_add_note`, `project_memory_add_directive`
-
-Code Intelligence:
-
-- LSP: `lsp_hover`, `lsp_goto_definition`, `lsp_find_references`, `lsp_document_symbols`, `lsp_workspace_symbols`, `lsp_diagnostics`, `lsp_diagnostics_directory`, `lsp_prepare_rename`, `lsp_rename`, `lsp_code_actions`, `lsp_code_action_resolve`, `lsp_servers`
-- AST: `ast_grep_search`, `ast_grep_replace`
-- `python_repl`: persistent Python REPL for data analysis
-  </tools>
-
-<passive-behaviors>
-These behaviors apply unconditionally — no skill invocation required:
-- ALWAYS delegate source code edits (.ts/.py/.go/.js/.tsx etc.) to `executor`; never write them directly
-- ALWAYS run `verifier` before claiming a task complete
-- "build me" / "I want a [project]" / "create a [app]" → start autopilot workflow immediately
-- "don't stop" / "must complete" → ralph mode, loop until verified complete
-- broad request (vague verb, no target file/function, touches 3+ areas) → explore first, then plan skill
-- project has AGENTS.md files → read them as authoritative passive context before any codebase work
-</passive-behaviors>
-
-Workflow:
-
-- `autopilot` ("autopilot", "build me", "I want a"): full autonomous execution from idea to working code
-- `ralph` ("ralph", "don't stop", "must complete"): self-referential loop with verifier verification; includes ultrawork
-- `ultrawork` ("ulw", "ultrawork"): maximum parallelism with parallel agent orchestration
-- `team` ("team", "coordinated team", "team ralph"): N coordinated Claude agents with stage-aware routing; `team ralph` for persistent team execution
-- `ccg` ("ccg", "tri-model", "claude codex gemini"): fan out via `ask-codex` + `ask-gemini`, then Claude synthesizes
-- `ultraqa` (activated by autopilot): QA cycling -- test, verify, fix, repeat
-- `omc-plan` (manual command): strategic planning; supports `--consensus` and `--review`
-- `ralplan` ("ralplan", "consensus plan"): alias for `/omc-plan --consensus` -- iterative planning with Planner, Architect, Critic until consensus; short deliberation by default, `--deliberate` for high-risk work (adds pre-mortem + expanded unit/integration/e2e/observability test planning)
-- `sciomc` ("sciomc"): parallel scientist agents for comprehensive analysis
-- `external-context`: parallel document-specialist agents for web searches
-- `deepinit` ("deepinit"): deep codebase init with hierarchical AGENTS.md
-
-Agent Shortcuts (thin wrappers):
-
-- `analyze` -> `debugger`: "analyze", "debug", "investigate"
-- `tdd` -> `test-engineer`: "tdd", "test first", "red green"
-- `build-fix` -> `build-fixer`: "fix build", "type errors"
-- `code-review` -> `code-reviewer`: "review code"
-- `security-review` -> `security-reviewer`: "security review"
-- `review` -> `omc-plan --review`: "review plan", "critique plan"
-
-Notifications: `configure-notifications` ("configure discord", "setup telegram", "configure slack")
-Utilities: `ask-codex`, `ask-gemini`, `cancel`, `note`, `learner`, `omc-setup`, `mcp-setup`, `hud`, `omc-doctor`, `omc-help`, `trace`, `release`, `project-session-manager`, `skill`, `writer-memory`, `ralph-init`, `learn-about-omc`
-
-Disambiguation: prompts like "ask/use/delegate to codex|gemini" -> `ask-codex` / `ask-gemini`; "claude codex gemini" -> ccg.
+Teams: `TeamCreate`, `TeamDelete`, `SendMessage`, `TaskCreate`, `TaskList`, `TaskGet`, `TaskUpdate`
+Notepad: `notepad_read`, `notepad_write_priority`, `notepad_write_working`, `notepad_write_manual`
+Project Memory: `project_memory_read`, `project_memory_write`, `project_memory_add_note`, `project_memory_add_directive`
+Code Intel: LSP (`lsp_hover`, `lsp_goto_definition`, `lsp_find_references`, `lsp_diagnostics`, etc.), AST (`ast_grep_search`, `ast_grep_replace`), `python_repl`
+</tools>
+
+<skills>
+Invoke via `/oh-my-claudecode:<name>`. Trigger patterns auto-detect keywords.
+
+Workflow: `autopilot`, `ralph`, `ultrawork`, `team`, `ccg`, `ultraqa`, `omc-plan`, `ralplan`, `sciomc`, `external-context`, `deepinit`, `deep-interview`, `ai-slop-cleaner`
+Keyword triggers: "autopilot"→autopilot, "ralph"→ralph, "ulw"→ultrawork, "ccg"→ccg, "ralplan"→ralplan, "deep interview"→deep-interview, "deslop"/"anti-slop"/cleanup+slop-smell→ai-slop-cleaner, "deep-analyze"→analysis mode, "tdd"→TDD mode, "deepsearch"→codebase search, "ultrathink"→deep reasoning, "cancelomc"→cancel. Team orchestration is explicit via `/team`.
+Utilities: `ask-codex`, `ask-gemini`, `cancel`, `note`, `learner`, `omc-setup`, `mcp-setup`, `hud`, `omc-doctor`, `omc-help`, `trace`, `release`, `project-session-manager`, `skill`, `writer-memory`, `ralph-init`, `configure-notifications`, `learn-about-omc`
 </skills>
 
 <team_pipeline>
-Team is the default multi-agent orchestrator: `team-plan -> team-prd -> team-exec -> team-verify -> team-fix (loop)`
-
-Stage routing:
-
-- `team-plan`: `explore` + `planner`, optionally `analyst`/`architect`
-- `team-prd`: `analyst`, optionally `critic`
-- `team-exec`: `executor` + specialists (`designer`, `build-fixer`, `writer`, `test-engineer`, `deep-executor`)
-- `team-verify`: `verifier` + reviewers as needed
-- `team-fix`: `executor`/`build-fixer`/`debugger` depending on defect type
-
-Fix loop bounded by max attempts. Terminal states: `complete`, `failed`, `cancelled`.
-`team ralph` links both modes; cancelling either cancels both.
+Stages: `team-plan` → `team-prd` → `team-exec` → `team-verify` → `team-fix` (loop).
+Fix loop bounded by max attempts. `team ralph` links both modes.
 </team_pipeline>
 
 <verification>
-Verify before claiming completion. Sizing: small (<5 files) -> `verifier` haiku; standard -> sonnet; large/security -> opus.
-Loop: identify proof, run verification, read output, report with evidence. If verification fails, keep iterating.
+Verify before claiming completion. Size appropriately: small→haiku, standard→sonnet, large/security→opus.
+If verification fails, keep iterating.
 </verification>
 
 <execution_protocols>
-Broad requests (vague verbs, no file/function targets, 3+ areas): explore first, then use plan skill.
-Parallelization: 2+ independent tasks in parallel; Team mode preferred; `run_in_background` for builds/tests.
-Continuation: before concluding, confirm zero pending tasks, tests passing, zero errors, verifier evidence collected.
+Broad requests: explore first, then plan. 2+ independent tasks in parallel. `run_in_background` for builds/tests.
+Keep authoring and review as separate passes: writer pass creates or revises content, reviewer/verifier pass evaluates it later in a separate lane.
+Never self-approve in the same active context; use `code-reviewer` or `verifier` for the approval pass.
+Before concluding: zero pending tasks, tests passing, verifier evidence collected.
 </execution_protocols>
 
 <hooks_and_context>
-Hooks inject context via `<system-reminder>` tags:
-
-- `hook success: Success` -- proceed normally
-- `hook additional context: ...` -- read it; relevant to your task
-- `[MAGIC KEYWORD: ...]` -- invoke the indicated skill immediately
-- `The boulder never stops` -- ralph/ultrawork mode; keep working
-
-Persistence: `<remember>info</remember>` (7 days), `<remember priority>info</remember>` (permanent).
-Kill switches: `DISABLE_OMC` (all hooks), `OMC_SKIP_HOOKS` (comma-separated).
+Hooks inject `<system-reminder>` tags. Key patterns: `hook success: Success` (proceed), `[MAGIC KEYWORD: ...]` (invoke skill), `The boulder never stops` (ralph/ultrawork active).
+Persistence: `<remember>` (7 days), `<remember priority>` (permanent).
+Kill switches: `DISABLE_OMC`, `OMC_SKIP_HOOKS` (comma-separated).
 </hooks_and_context>
 
 <cancellation>
-Invoke `/oh-my-claudecode:cancel` to end execution modes (`--force` to clear all state).
-Cancel when: tasks done and verified, work blocked (explain first), user says "stop".
-Do not cancel when: stop hook fires but work is still incomplete.
+`/oh-my-claudecode:cancel` ends execution modes. Cancel when done+verified or blocked. Don't cancel if work incomplete.
 </cancellation>
 
 <worktree_paths>
-All OMC state lives under git worktree root: `.omc/state/` (mode state), `.omc/state/sessions/{sessionId}/` (session state), `.omc/notepad.md`, `.omc/project-memory.json`, `.omc/plans/`, `.omc/research/`, `.omc/logs/`.
+State: `.omc/state/`, `.omc/state/sessions/{sessionId}/`, `.omc/notepad.md`, `.omc/project-memory.json`, `.omc/plans/`, `.omc/research/`, `.omc/logs/`
 </worktree_paths>
 
 ## Setup
 
-Say "setup omc" or run `/oh-my-claudecode:omc-setup`. Announce major behavior activations to keep users informed.
+Say "setup omc" or run `/oh-my-claudecode:omc-setup`.
 
 <!-- OMC:END -->

package/docs/MIGRATION.md

@@ -178,12 +178,12 @@ The project was rebranded to better reflect its purpose and improve discoverabil
 - **Project/brand name**: `oh-my-claudecode` (GitHub repo, plugin name, commands)
 - **npm package name**: `claudecode-omc`
 
-> **Why the difference?** The npm package name `claudecode-omc` is used for distribution, while the project, GitHub repository, plugin, and commands use `oh-my-claudecode`.
+> **Why the difference?** The npm package name `claudecode-omc` is used for distribution, while the project, GitHub repository, plugin, and all commands use `oh-my-claudecode`.
 
 #### NPM Install Command
 
 ```bash
-npm install -g claudecode-omc
+npm i -g claudecode-omc@latest
 ```
 
 ### What Changed
@@ -276,7 +276,7 @@ All 2.x commands continue to work. Here's what changed:
 | `/oh-my-claudecode:plan "description"` | Start planning naturally                           | ✅ YES                 |
 | `/oh-my-claudecode:review [path]`      | Invoke normally                                    | ✅ YES (unchanged)     |
 | `/oh-my-claudecode:deepsearch "query"` | Say "find" or "search"                             | ✅ YES (auto-detect)   |
-| `/oh-my-claudecode:analyze "target"`   | Say "analyze" or "investigate"                     | ✅ YES (auto-detect)   |
+| `/oh-my-claudecode:analyze "target"`   | Say "analyze" — routes to debugger/architect agent | ✅ YES (keyword route) |
 | `/oh-my-claudecode:deepinit [path]`    | Invoke normally                                    | ✅ YES (unchanged)     |
 | `/oh-my-claudecode:git-master`         | Say "git", "commit", "atomic commit"               | ✅ YES (auto-detect)   |
 | `/oh-my-claudecode:frontend-ui-ux`     | Say "UI", "styling", "component", "design"         | ✅ YES (auto-detect)   |
@@ -671,7 +671,7 @@ Chain agents with data passing between stages:
 
 - `review` - explore → architect → critic → executor
 - `implement` - planner → executor → tdd-guide
-- `debug` - explore → architect → build-fixer
+- `debug` - explore → architect → debugger
 - `research` - parallel(document-specialist, explore) → architect → writer
 - `refactor` - explore → architect-medium → executor-high → qa-tester
 - `security` - explore → security-reviewer → executor → security-reviewer-low

package/docs/OPENCLAW-ROUTING.md

@@ -0,0 +1,102 @@
+# OpenClaw / Clawhip Routing Contract
+
+This document defines the normalized event contract OMC emits through the OpenClaw bridge for native Clawhip-style consumers.
+
+## Goals
+
+- Keep the raw hook event (`event`) for backward compatibility.
+- Add a normalized `signal` object for routing and dedupe-friendly filtering.
+- Make command/native gateways receive the same logical payload shape as HTTP gateways.
+
+## Payload shape
+
+HTTP gateways receive JSON with this structure:
+
+```json
+{
+  "event": "post-tool-use",
+  "instruction": "...",
+  "timestamp": "2026-03-09T00:00:00.000Z",
+  "sessionId": "...",
+  "projectPath": "...",
+  "projectName": "...",
+  "tmuxSession": "...",
+  "tmuxTail": "...",
+  "signal": {
+    "kind": "test",
+    "name": "test-run",
+    "phase": "failed",
+    "routeKey": "test.failed",
+    "priority": "high",
+    "toolName": "Bash",
+    "command": "pnpm test",
+    "testRunner": "package-test",
+    "summary": "FAIL src/example.test.ts | ..."
+  },
+  "context": {
+    "sessionId": "...",
+    "projectPath": "...",
+    "toolName": "Bash"
+  }
+}
+```
+
+## `signal` contract
+
+| Field      | Meaning                                                                           |
+| ---------- | --------------------------------------------------------------------------------- |
+| `kind`     | Routing family: `session`, `tool`, `test`, `pull-request`, `question`, `keyword`  |
+| `name`     | Stable logical signal name                                                        |
+| `phase`    | Lifecycle phase: `started`, `finished`, `failed`, `idle`, `detected`, `requested` |
+| `routeKey` | Canonical routing key for downstream consumers                                    |
+| `priority` | `high` for operational signals, `low` for generic tool noise                      |
+
+Additional fields may appear when applicable:
+
+- `toolName`
+- `command`
+- `testRunner`
+- `prUrl`
+- `summary`
+
+## Native command gateway contract
+
+Command gateways now get the same normalized payload through both:
+
+- template variable: `{{payloadJson}}`
+- env var: `OPENCLAW_PAYLOAD_JSON`
+
+They also receive convenience env vars:
+
+- `OPENCLAW_SIGNAL_ROUTE_KEY`
+- `OPENCLAW_SIGNAL_PHASE`
+- `OPENCLAW_SIGNAL_KIND`
+
+That lets native Clawhip routing consume one contract whether the transport is HTTP or shell-command based.
+
+## Current high-priority route keys
+
+- `session.started`
+- `session.finished`
+- `session.idle`
+- `question.requested`
+- `test.started`
+- `test.finished`
+- `test.failed`
+- `pull-request.started`
+- `pull-request.created`
+- `pull-request.failed`
+- `tool.failed`
+
+Generic `tool.started` / `tool.finished` remain available as low-priority fallback signals.
+
+## Noise reduction
+
+- `AskUserQuestion` now emits only the dedicated `question.requested` signal instead of also emitting generic tool lifecycle events.
+- Consumers should prefer `signal.priority === "high"` or explicit `signal.routeKey` filters instead of routing directly on raw hook names.
+
+## Stability notes
+
+- Raw `event` names are preserved for backward compatibility.
+- `signal` is the preferred routing surface for new native Clawhip integrations.
+- `context` remains a whitelisted subset; internal raw tool input/output are used only to derive normalized signals and are not forwarded in `payload.context`.