oh-my-claude-sisyphus 3.3.6 → 3.3.7

package/commands/ralplan.md

@@ -75,6 +75,38 @@ Ralplan maintains persistent state in `.omc/ralplan-state.json` to track progres
 
 **Phases**: `planner_planning` → `architect_consultation` → `critic_review` → `handling_verdict` → `complete`
 
+## Plan Mode Interaction (CRITICAL)
+
+**When ralplan is invoked while Plan mode is active:**
+
+The Planner agent has a PHASE 3.5 (CONFIRMATION) that normally requires user confirmation before proceeding. **This MUST be bypassed within ralplan because the Critic serves as the reviewer, not the user.**
+
+### Mandatory Constraints
+
+| Constraint | Rationale |
+|------------|-----------|
+| **Planner MUST skip PHASE 3.5 confirmation** | Critic reviews the plan, not the user |
+| **Critic MUST run before any plan approval** | No plan is approved without Critic verdict |
+| **DO NOT exit plan mode until Critic has rendered verdict** | Premature exit skips the review step |
+| **Log `[RALPLAN] Critic review required before approval`** | Observability for debugging |
+
+### Flow When Plan Mode Is Active
+
+```
+1. Orchestrator invokes ralplan skill
+2. Log: [RALPLAN] Starting - Critic review will be required
+3. Spawn Planner in DIRECT PLANNING MODE (no interview, no confirmation)
+4. Planner outputs PLAN_READY: <path>
+5. Log: [RALPLAN] Plan ready, invoking Critic for review
+6. Spawn Critic with plan path  <-- MUST HAPPEN
+7. Critic renders OKAY or REJECT
+8. ONLY THEN can plan be approved or refined
+```
+
+**CRITICAL: The Critic invocation is MANDATORY. If the Planner completes and signals plan ready, the orchestrator MUST invoke the Critic before any form of plan approval or user confirmation.**
+
+---
+
 ## Execution Protocol
 
 ### Initialization
@@ -96,12 +128,15 @@ The skill begins by establishing the planning environment:
 The Planner creates an initial plan based on task context:
 
 - Invoke Planner in **direct planning mode** (bypassing interview since task context is pre-gathered)
+- **CRITICAL: Planner MUST skip PHASE 3.5 (CONFIRMATION)** - the Critic will review, not the user
 - Planner receives task context directly without preliminary questioning
 - Planner mandatorily consults with Metis for gap detection
 - Planner generates plan directly to `.omc/plans/[feature-name].md`
 - Plan includes: requirements summary, concrete acceptance criteria, specific implementation steps with file references, risk identification with mitigations, and verification steps
 - Signal completion with `PLAN_READY: .omc/plans/[filename].md`
+- **After PLAN_READY: DO NOT approve or confirm the plan. Proceed to Critic Review.**
 - Extract plan path from completion signal and update state
+- Log: `[RALPLAN] Critic review required before approval`
 
 ### Architect Consultation (Conditional)
 
@@ -112,7 +147,11 @@ The Architect provides strategic guidance in two scenarios:
 
 When invoked, the Architect receives file paths to read for analysis, not summaries. This enables thorough examination of the existing codebase context before providing recommendations.
 
-### Critic Review
+### Critic Review (MANDATORY - CANNOT BE SKIPPED)
+
+**CRITICAL: This phase MUST execute. The Critic is the gatekeeper for plan approval.**
+
+Log at start: `[RALPLAN] Invoking Critic for plan review`
 
 The Critic examines the plan against quality standards:
 
@@ -120,6 +159,14 @@ The Critic examines the plan against quality standards:
 - Critic conducts thorough review of plan completeness and feasibility
 - Critic emits verdict: either `OKAY` (approval) or `REJECT` with specific issues
 
+**Enforcement Rules:**
+1. If Planner signals PLAN_READY, Critic MUST be invoked immediately
+2. DO NOT exit ralplan loop before Critic verdict
+3. DO NOT request user confirmation before Critic verdict
+4. DO NOT trigger any plan mode exit behavior before Critic verdict
+
+Log after Critic completes: `[RALPLAN] Critic verdict: <OKAY|REJECT>`
+
 ### Verdict Handling and Iteration
 
 Based on Critic's verdict, the skill either approves the plan or continues iteration:
@@ -127,7 +174,7 @@ Based on Critic's verdict, the skill either approves the plan or continues itera
 **If verdict is OKAY:**
 - Mark plan as approved
 - Log approval with iteration count
-- Prepare plan for execution with `/ralph` or manual orchestration
+- Prepare plan for execution with `/oh-my-claudecode:ralph` or manual orchestration
 - Set state `active: false, current_phase: "complete"`
 
 **If verdict is REJECT:**
@@ -203,15 +250,21 @@ CRITIC_FEEDBACK:
 
 To stop an active ralplan session:
 
-- Use `/cancel-ralph` (automatically detects ralplan via state file)
+- Use `/oh-my-claudecode:cancel-ralph` (automatically detects ralplan via state file)
 - Or manually delete `.omc/ralplan-state.json`
 
 ## Skill Workflow
 
 1. **Initialize state** and log: `[RALPLAN Iteration 0/5] Initializing...`
 2. **Parse task** from user input
-3. **Spawn Planner** in direct planning mode
-4. **Iterate** through planning loop with observability logging at each phase
-5. **Complete** when Critic approves or max iterations reached with warnings
+3. **Spawn Planner** in direct planning mode (SKIP Planner's PHASE 3.5 confirmation)
+4. **Wait for PLAN_READY** signal from Planner
+5. **Log:** `[RALPLAN] Critic review required before approval`
+6. **Invoke Critic** with plan file path (MANDATORY - CANNOT BE SKIPPED)
+7. **Log:** `[RALPLAN] Critic verdict: <verdict>`
+8. **Handle verdict** - if REJECT, loop back to step 3 with feedback
+9. **Complete** ONLY when Critic approves or max iterations reached with warnings
+
+**HARD RULE:** Steps 5-7 are NON-NEGOTIABLE. No plan approval, user confirmation, or plan mode exit can occur before the Critic has rendered its verdict. This prevents the plan mode confirmation flow from short-circuiting the ralplan review loop.
 
 The iterative loop refines the plan until it meets the rigorous standards of all three agents, ensuring comprehensive, architecturally sound work plans ready for execution.

package/commands/release.md

@@ -9,10 +9,10 @@ Automate the release process for oh-my-claudecode.
 ## Usage
 
 ```
-/release <version>
+/oh-my-claudecode:release <version>
 ```
 
-Example: `/release 2.4.0` or `/release patch` or `/release minor`
+Example: `/oh-my-claudecode:release 2.4.0` or `/oh-my-claudecode:release patch` or `/oh-my-claudecode:release minor`
 
 ## Release Checklist
 

package/commands/research.md

@@ -11,12 +11,12 @@ Orchestrate parallel scientist agents for comprehensive research workflows with
 ## Usage Examples
 
 ```
-/research <goal>                    # Standard research with user checkpoints
-/research AUTO: <goal>              # Fully autonomous until complete
-/research status                    # Check current research session status
-/research resume                    # Resume interrupted research session
-/research list                      # List all research sessions
-/research report <session-id>       # Generate report for session
+/oh-my-claudecode:research <goal>                    # Standard research with user checkpoints
+/oh-my-claudecode:research AUTO: <goal>              # Fully autonomous until complete
+/oh-my-claudecode:research status                    # Check current research session status
+/oh-my-claudecode:research resume                    # Resume interrupted research session
+/oh-my-claudecode:research list                      # List all research sessions
+/oh-my-claudecode:research report <session-id>       # Generate report for session
 ```
 
 ## Research Protocol
@@ -86,7 +86,7 @@ Sessions are stored at `.omc/research/{session-id}/` with:
 ## Cancellation
 
 ```
-/cancel-research
+/oh-my-claudecode:cancel-research
 ```
 
 Or say: "stop research", "cancel research", "abort"

package/commands/ultraqa.md

@@ -18,11 +18,11 @@ Parse the goal from arguments. Supported formats:
 
 | Invocation | Goal Type | What to Check |
 |------------|-----------|---------------|
-| `/ultraqa --tests` | tests | All test suites pass |
-| `/ultraqa --build` | build | Build succeeds with exit 0 |
-| `/ultraqa --lint` | lint | No lint errors |
-| `/ultraqa --typecheck` | typecheck | No TypeScript errors |
-| `/ultraqa --custom "pattern"` | custom | Custom success pattern in output |
+| `/oh-my-claudecode:ultraqa --tests` | tests | All test suites pass |
+| `/oh-my-claudecode:ultraqa --build` | build | Build succeeds with exit 0 |
+| `/oh-my-claudecode:ultraqa --lint` | lint | No lint errors |
+| `/oh-my-claudecode:ultraqa --typecheck` | typecheck | No TypeScript errors |
+| `/oh-my-claudecode:ultraqa --custom "pattern"` | custom | Custom success pattern in output |
 
 If no structured goal provided, interpret the argument as a custom goal.
 
@@ -106,7 +106,7 @@ Track state in `.omc/ultraqa-state.json`:
 
 ## Cancellation
 
-User can cancel with `/cancel-ultraqa` which clears the state file.
+User can cancel with `/oh-my-claudecode:cancel-ultraqa` which clears the state file.
 
 ## Important Rules
 

package/dist/__tests__/installer.test.js

@@ -269,7 +269,7 @@ describe('Installer Constants', () => {
         });
         it('should match package.json version', () => {
             // This is a runtime check - VERSION should match the package.json
-            expect(VERSION).toBe('3.3.4');
+            expect(VERSION).toBe('3.3.7');
         });
     });
     describe('File Paths', () => {

package/dist/installer/index.d.ts

@@ -31,7 +31,7 @@ export declare const VERSION_FILE: string;
  */
 export declare const CORE_COMMANDS: string[];
 /** Current version */
-export declare const VERSION = "3.3.4";
+export declare const VERSION = "3.3.7";
 /** Installation result */
 export interface InstallResult {
     success: boolean;

package/dist/installer/index.js

@@ -37,7 +37,7 @@ export const VERSION_FILE = join(CLAUDE_CONFIG_DIR, '.omc-version.json');
  */
 export const CORE_COMMANDS = [];
 /** Current version */
-export const VERSION = '3.3.4';
+export const VERSION = '3.3.7';
 /**
  * Check if the current Node.js version meets the minimum requirement
  */

package/docs/CLAUDE.md

@@ -160,35 +160,35 @@ User says "stop", "cancel", "abort" → You determine what to stop:
 
 | Skill | Purpose | Auto-Trigger | Manual |
 |-------|---------|--------------|--------|
-| `autopilot` | Full autonomous execution from idea to working code | "autopilot", "build me", "I want a" | `/autopilot` |
+| `autopilot` | Full autonomous execution from idea to working code | "autopilot", "build me", "I want a" | `/oh-my-claudecode:autopilot` |
 | `orchestrate` | Core multi-agent orchestration | Always active | - |
-| `ralph` | Persistence until verified complete | "don't stop", "must complete" | `/ralph` |
-| `ultrawork` | Maximum parallel execution | "fast", "parallel", "ulw" | `/ultrawork` |
-| `planner` | Strategic planning with interview | "plan this", broad requests | `/planner` |
-| `plan` | Start planning session | "plan" keyword | `/plan` |
-| `ralplan` | Iterative planning (Planner+Architect+Critic) | "ralplan" keyword | `/ralplan` |
-| `review` | Review plan with Critic | "review plan" | `/review` |
-| `analyze` | Deep analysis/investigation | "analyze", "debug", "why" | `/analyze` |
-| `deepsearch` | Thorough codebase search | "search", "find", "where" | `/deepsearch` |
-| `deepinit` | Generate AGENTS.md hierarchy | "index codebase" | `/deepinit` |
+| `ralph` | Persistence until verified complete | "don't stop", "must complete" | `/oh-my-claudecode:ralph` |
+| `ultrawork` | Maximum parallel execution | "fast", "parallel", "ulw" | `/oh-my-claudecode:ultrawork` |
+| `planner` | Strategic planning with interview | "plan this", broad requests | `/oh-my-claudecode:planner` |
+| `plan` | Start planning session | "plan" keyword | `/oh-my-claudecode:plan` |
+| `ralplan` | Iterative planning (Planner+Architect+Critic) | "ralplan" keyword | `/oh-my-claudecode:ralplan` |
+| `review` | Review plan with Critic | "review plan" | `/oh-my-claudecode:review` |
+| `analyze` | Deep analysis/investigation | "analyze", "debug", "why" | `/oh-my-claudecode:analyze` |
+| `deepsearch` | Thorough codebase search | "search", "find", "where" | `/oh-my-claudecode:deepsearch` |
+| `deepinit` | Generate AGENTS.md hierarchy | "index codebase" | `/oh-my-claudecode:deepinit` |
 | `frontend-ui-ux` | Design sensibility for UI | UI/component context | (silent) |
 | `git-master` | Git expertise, atomic commits | git/commit context | (silent) |
-| `ultraqa` | QA cycling: test/fix/repeat | "test", "QA", "verify" | `/ultraqa` |
-| `learner` | Extract reusable skill from session | "extract skill" | `/learner` |
-| `note` | Save to notepad for memory | "remember", "note" | `/note` |
-| `hud` | Configure HUD statusline | - | `/hud` |
-| `doctor` | Diagnose installation issues | - | `/doctor` |
+| `ultraqa` | QA cycling: test/fix/repeat | "test", "QA", "verify" | `/oh-my-claudecode:ultraqa` |
+| `learner` | Extract reusable skill from session | "extract skill" | `/oh-my-claudecode:learner` |
+| `note` | Save to notepad for memory | "remember", "note" | `/oh-my-claudecode:note` |
+| `hud` | Configure HUD statusline | - | `/oh-my-claudecode:hud` |
+| `doctor` | Diagnose installation issues | - | `/oh-my-claudecode:doctor` |
 | `help` | Show OMC usage guide | - | `/oh-my-claudecode:help` |
 | `omc-setup` | One-time setup wizard | - | `/oh-my-claudecode:omc-setup` |
 | `omc-default` | Configure local project | - | (internal) |
 | `omc-default-global` | Configure global settings | - | (internal) |
-| `ralph-init` | Initialize PRD for structured ralph | - | `/ralph-init` |
-| `release` | Automated release workflow | - | `/release` |
-| `cancel-autopilot` | Cancel active autopilot session | "stop autopilot", "cancel autopilot" | `/cancel-autopilot` |
-| `cancel-ralph` | Cancel active ralph loop | "stop" in ralph | `/cancel-ralph` |
-| `cancel-ultrawork` | Cancel ultrawork mode | "stop" in ultrawork | `/cancel-ultrawork` |
-| `cancel-ultraqa` | Cancel ultraqa workflow | "stop" in ultraqa | `/cancel-ultraqa` |
-| `research` | Parallel scientist orchestration | "research", "analyze data" | `/research` |
+| `ralph-init` | Initialize PRD for structured ralph | - | `/oh-my-claudecode:ralph-init` |
+| `release` | Automated release workflow | - | `/oh-my-claudecode:release` |
+| `cancel-autopilot` | Cancel active autopilot session | "stop autopilot", "cancel autopilot" | `/oh-my-claudecode:cancel-autopilot` |
+| `cancel-ralph` | Cancel active ralph loop | "stop" in ralph | `/oh-my-claudecode:cancel-ralph` |
+| `cancel-ultrawork` | Cancel ultrawork mode | "stop" in ultrawork | `/oh-my-claudecode:cancel-ultrawork` |
+| `cancel-ultraqa` | Cancel ultraqa workflow | "stop" in ultraqa | `/oh-my-claudecode:cancel-ultraqa` |
+| `research` | Parallel scientist orchestration | "research", "analyze data" | `/oh-my-claudecode:research` |
 
 ### All 28 Agents
 
@@ -429,8 +429,8 @@ Say "setup omc" or run `/oh-my-claudecode:omc-setup` to configure. After that, e
 
 ### Troubleshooting
 
-- `/doctor` - Diagnose and fix installation issues
-- `/hud setup` - Install/repair HUD statusline
+- `/oh-my-claudecode:doctor` - Diagnose and fix installation issues
+- `/oh-my-claudecode:hud setup` - Install/repair HUD statusline
 
 ---
 
@@ -448,9 +448,9 @@ Autopilot activates automatically and handles the rest. No commands needed.
 ## Migration from 2.x
 
 All old commands still work:
-- `/ralph "task"` → Still works (or just say "don't stop until done")
-- `/ultrawork "task"` → Still works (or just say "fast" or use `ulw`)
-- `/planner "task"` → Still works (or just say "plan this")
+- `/oh-my-claudecode:ralph "task"` → Still works (or just say "don't stop until done")
+- `/oh-my-claudecode:ultrawork "task"` → Still works (or just say "fast" or use `ulw`)
+- `/oh-my-claudecode:planner "task"` → Still works (or just say "plan this")
 
 The difference? You don't NEED them anymore. Everything auto-activates.
 

package/docs/FULL-README.md

@@ -10,7 +10,7 @@
 
 # oh-my-claudecode
 
-[![Version](https://img.shields.io/badge/version-3.3.4-ff6b6b)](https://github.com/Yeachan-Heo/oh-my-claudecode)
+[![Version](https://img.shields.io/badge/version-3.3.7-ff6b6b)](https://github.com/Yeachan-Heo/oh-my-claudecode)
 [![npm version](https://img.shields.io/npm/v/oh-my-claudecode?color=cb3837)](https://www.npmjs.com/package/oh-my-claudecode)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/Node.js-20+-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
@@ -46,7 +46,7 @@
 <remember priority>API client at src/api/client.ts</remember>
 
 # Or save notes manually
-/note Database schema uses PostgreSQL with Prisma ORM
+/oh-my-claudecode:note Database schema uses PostgreSQL with Prisma ORM
 ```
 
 ### 📋 Ralph Loop PRD Support
@@ -154,7 +154,7 @@ Choose **ONE** installation method below. Do not mix methods.
 claude plugin install oh-my-claude-sisyphus
 
 # Or from within Claude Code:
-/plugin oh-my-claude-sisyphus
+/oh-my-claudecode:plugin oh-my-claude-sisyphus
 ```
 
 Uses Node.js hooks from the plugin directory. Integrates directly with Claude Code's plugin system.
@@ -197,7 +197,7 @@ chmod +x scripts/install.sh
 Configure omc for the current project only:
 
 ```
-/omc-default
+/oh-my-claudecode:omc-default
 ```
 
 - Creates `./.claude/CLAUDE.md` in your current project
@@ -210,7 +210,7 @@ Configure omc for the current project only:
 Configure omc for all Claude Code sessions:
 
 ```
-/omc-default-global
+/oh-my-claudecode:omc-default-global
 ```
 
 - Creates `~/.claude/CLAUDE.md` globally
@@ -293,18 +293,18 @@ The installer adds to your Claude Code config (`~/.claude/`):
 │   ├── planner.md             # Strategic planner (Opus)
 │   └── qa-tester.md           # CLI/service testing (Sonnet)
 ├── commands/
-│   ├── orchestrate.md      # /orchestrate command
-│   ├── omc-default.md      # /omc-default command (project-scoped)
-│   ├── omc-default-global.md # /omc-default-global command (global)
-│   ├── ultrawork.md        # /ultrawork command
-│   ├── deepsearch.md       # /deepsearch command
-│   ├── analyze.md          # /analyze command
-│   ├── plan.md             # /plan command (planner)
-│   ├── review.md           # /review command (critic)
-│   ├── planner.md          # /planner command
-│   ├── orchestrator.md     # /orchestrator command
-│   ├── ralph-loop.md       # /ralph-loop command
-│   └── cancel-ralph.md     # /cancel-ralph command
+│   ├── orchestrate.md      # /oh-my-claudecode:orchestrate command
+│   ├── omc-default.md      # /oh-my-claudecode:omc-default command (project-scoped)
+│   ├── omc-default-global.md # /oh-my-claudecode:omc-default-global command (global)
+│   ├── ultrawork.md        # /oh-my-claudecode:ultrawork command
+│   ├── deepsearch.md       # /oh-my-claudecode:deepsearch command
+│   ├── analyze.md          # /oh-my-claudecode:analyze command
+│   ├── plan.md             # /oh-my-claudecode:plan command (planner)
+│   ├── review.md           # /oh-my-claudecode:review command (critic)
+│   ├── planner.md          # /oh-my-claudecode:planner command
+│   ├── orchestrator.md     # /oh-my-claudecode:orchestrator command
+│   ├── ralph-loop.md       # /oh-my-claudecode:ralph-loop command
+│   └── cancel-ralph.md     # /oh-my-claudecode:cancel-ralph command
 ├── skills/
 │   ├── ultrawork/SKILL.md  # Maximum performance mode
 │   ├── deepinit/SKILL.md   # Hierarchical AGENTS.md generation
@@ -363,22 +363,22 @@ claude
 /oh-my-claudecode:ultrawork implement user dashboard with charts
 
 # Initialize structured task with PRD
-/ralph-init implement user authentication with OAuth
+/oh-my-claudecode:ralph-init implement user authentication with OAuth
 
 # Maximum intensity with completion guarantee
-/ultrawork-ralph migrate database schema to PostgreSQL
+/oh-my-claudecode:ultrawork-ralph migrate database schema to PostgreSQL
 
 # Autonomous QA cycling
-/ultraqa all tests must pass with 90%+ coverage
+/oh-my-claudecode:ultraqa all tests must pass with 90%+ coverage
 
 # Save important discoveries
-/note Project uses Bun runtime instead of Node.js
+/oh-my-claudecode:note Project uses Bun runtime instead of Node.js
 
 # Deep search
-/deepsearch API endpoints that handle user data
+/oh-my-claudecode:deepsearch API endpoints that handle user data
 
 # Deep analysis
-/analyze performance bottleneck in the database layer
+/oh-my-claudecode:analyze performance bottleneck in the database layer
 ```
 
 ### Magic Keywords
@@ -867,7 +867,9 @@ If you're coming from oh-my-opencode:
 ## Requirements
 
 - [Claude Code](https://docs.anthropic.com/claude-code) installed
-- Anthropic API key (`ANTHROPIC_API_KEY` environment variable)
+- One of:
+  - **Claude Max/Pro subscription** (recommended for individuals)
+  - **Anthropic API key** (`ANTHROPIC_API_KEY` environment variable)
 - **Windows**: Node.js 20+ (for npm installation)
 - **macOS/Linux**: Bash shell (default) or Node.js 20+ (optional)
 

package/docs/MIGRATION-v3.md

@@ -81,11 +81,11 @@ Slash commands have been updated to use new naming:
 
 | Old Command | New Command |
 |-------------|-------------|
-| /sisyphus | /orchestrate |
-| /sisyphus-default | /omc-default |
-| /sisyphus-default-global | /omc-default-global |
-| /prometheus | /planner |
-| /mnemosyne | /learner |
+| /sisyphus | /oh-my-claudecode:orchestrate |
+| /sisyphus-default | /oh-my-claudecode:omc-default |
+| /sisyphus-default-global | /oh-my-claudecode:omc-default-global |
+| /prometheus | /oh-my-claudecode:planner |
+| /mnemosyne | /oh-my-claudecode:learner |
 
 ## Feature Flag Changes
 
@@ -183,4 +183,4 @@ After migration, verify your setup:
 If you encounter issues during migration:
 - Check the [GitHub Issues](https://github.com/Yeachan-Heo/oh-my-claude-sisyphus/issues)
 - Review the [Documentation](https://github.com/Yeachan-Heo/oh-my-claude-sisyphus/tree/main/docs)
-- Run `/doctor` to diagnose common issues
+- Run `/oh-my-claudecode:doctor` to diagnose common issues

package/docs/MIGRATION.md

@@ -4,7 +4,7 @@
 
 Your old commands still work! But now you don't need them.
 
-**Before 3.0:** Explicitly invoke 25+ commands like `/ralph "task"`, `/ultrawork "task"`
+**Before 3.0:** Explicitly invoke 25+ commands like `/oh-my-claudecode:ralph "task"`, `/oh-my-claudecode:ultrawork "task"`
 
 **After 3.0:** Just work naturally - Claude auto-activates the right behaviors. One-time setup: just say "setup omc"
 
@@ -18,13 +18,13 @@ You had to remember and explicitly invoke specific commands for each mode:
 
 ```bash
 # 2.x workflow: Multiple commands, lots to remember
-/ralph "implement user authentication"       # Persistence mode
-/ultrawork "refactor the API layer"          # Maximum parallelism
-/planner "plan the new dashboard"            # Planning interview
-/deepsearch "find database schema files"     # Deep search
-/git-master "commit these changes"           # Git expertise
-/deepinit ./src                              # Index codebase
-/analyze "why is this test failing?"         # Deep analysis
+/oh-my-claudecode:ralph "implement user authentication"       # Persistence mode
+/oh-my-claudecode:ultrawork "refactor the API layer"          # Maximum parallelism
+/oh-my-claudecode:planner "plan the new dashboard"            # Planning interview
+/oh-my-claudecode:deepsearch "find database schema files"     # Deep search
+/oh-my-claudecode:git-master "commit these changes"           # Git expertise
+/oh-my-claudecode:deepinit ./src                              # Index codebase
+/oh-my-claudecode:analyze "why is this test failing?"         # Deep analysis
 ```
 
 ### After (3.0): Auto-Activation + Keywords
@@ -49,20 +49,20 @@ All 2.x commands continue to work. Here's what changed:
 
 | 2.x Command | 3.0 Equivalent | Works? |
 |-------------|----------------|--------|
-| `/ralph "task"` | Say "don't stop until done" OR use `ralph` keyword | ✅ YES (both ways) |
-| `/ultrawork "task"` | Say "fast" or "parallel" OR use `ulw` keyword | ✅ YES (both ways) |
-| `/ultrawork-ralph` | Say "ralph ulw:" prefix | ✅ YES (keyword combo) |
-| `/planner "task"` | Say "plan this" OR use `plan` keyword | ✅ YES (both ways) |
-| `/plan "description"` | Start planning naturally | ✅ YES |
-| `/review [path]` | Invoke normally | ✅ YES (unchanged) |
-| `/deepsearch "query"` | Say "find" or "search" | ✅ YES (auto-detect) |
-| `/analyze "target"` | Say "analyze" or "investigate" | ✅ YES (auto-detect) |
-| `/deepinit [path]` | Invoke normally | ✅ YES (unchanged) |
-| `/git-master` | Say "git", "commit", "atomic commit" | ✅ YES (auto-detect) |
-| `/frontend-ui-ux` | Say "UI", "styling", "component", "design" | ✅ YES (auto-detect) |
-| `/note "content"` | Say "remember this" or "save this" | ✅ YES (auto-detect) |
-| `/cancel-ralph` | Say "stop", "cancel", or "abort" | ✅ YES (auto-detect) |
-| `/doctor` | Invoke normally | ✅ YES (unchanged) |
+| `/oh-my-claudecode:ralph "task"` | Say "don't stop until done" OR use `ralph` keyword | ✅ YES (both ways) |
+| `/oh-my-claudecode:ultrawork "task"` | Say "fast" or "parallel" OR use `ulw` keyword | ✅ YES (both ways) |
+| `/oh-my-claudecode:ultrawork-ralph` | Say "ralph ulw:" prefix | ✅ YES (keyword combo) |
+| `/oh-my-claudecode:planner "task"` | Say "plan this" OR use `plan` keyword | ✅ YES (both ways) |
+| `/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: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) |
+| `/oh-my-claudecode:note "content"` | Say "remember this" or "save this" | ✅ YES (auto-detect) |
+| `/oh-my-claudecode:cancel-ralph` | Say "stop", "cancel", or "abort" | ✅ YES (auto-detect) |
+| `/oh-my-claudecode:doctor` | Invoke normally | ✅ YES (unchanged) |
 | All other commands | Work exactly as before | ✅ YES |
 
 ---
@@ -113,7 +113,7 @@ If in planning       → End planning interview
 If multiple active   → Stop the most recent
 ```
 
-No more `/cancel-ralph` - just say "cancel"!
+No more `/oh-my-claudecode:cancel-ralph` - just say "cancel"!
 
 ---
 
@@ -126,10 +126,10 @@ No more `/cancel-ralph` - just say "cancel"!
 You can still use explicit commands if you prefer:
 
 ```bash
-/ralph "implement OAuth"           # Still works ✅
-/ultrawork "refactor everything"   # Still works ✅
-/planner "plan the feature"        # Still works ✅
-/cancel-ralph                      # Still works ✅
+/oh-my-claudecode:ralph "implement OAuth"           # Still works ✅
+/oh-my-claudecode:ultrawork "refactor everything"   # Still works ✅
+/oh-my-claudecode:planner "plan the feature"        # Still works ✅
+/oh-my-claudecode:cancel-ralph                      # Still works ✅
 ```
 
 These are now **optional** - use them if you like, but you don't have to.
@@ -172,7 +172,7 @@ See [MIGRATION-v3.md](MIGRATION-v3.md) for detailed 2.x → 3.0 naming changes.
 **No commands to memorize.** Work naturally:
 
 ```
-Before: "OK, I need to use /ultrawork for speed..."
+Before: "OK, I need to use /oh-my-claudecode:ultrawork for speed..."
 After:  "I'm in a hurry, go fast!"
         ↓
         Claude: "I'm activating ultrawork mode..."
@@ -194,7 +194,7 @@ Your request              Claude's action
 
 You don't ask for delegation - it happens automatically.
 
-### 3. Learned Skills (`/learner`)
+### 3. Learned Skills (`/oh-my-claudecode:learner`)
 
 Extract reusable insights from problem-solving:
 
@@ -219,7 +219,7 @@ See what Claude is doing in the status bar:
 [OMC] ralph:3/10 | US-002 | ultrawork skill:planner | ctx:67% | agents:2 | todos:2/5
 ```
 
-Run `/hud setup` to install. Presets: minimal, focused, full.
+Run `/oh-my-claudecode:hud setup` to install. Presets: minimal, focused, full.
 
 ### 5. Three-Tier Memory System
 
@@ -233,10 +233,10 @@ Permanently loaded on session start
 Never lost through compaction
 ```
 
-Or use `/note` to save discoveries manually:
+Or use `/oh-my-claudecode:note` to save discoveries manually:
 
 ```bash
-/note Project uses PostgreSQL with Prisma ORM
+/oh-my-claudecode:note Project uses PostgreSQL with Prisma ORM
 ```
 
 ### 6. Structured Task Tracking (PRD Support)
@@ -244,7 +244,7 @@ Or use `/note` to save discoveries manually:
 **Ralph Loop now uses Product Requirements Documents:**
 
 ```bash
-/ralph-init "implement OAuth with multiple providers"
+/oh-my-claudecode:ralph-init "implement OAuth with multiple providers"
     ↓
 Auto-creates PRD with user stories
     ↓
@@ -312,7 +312,7 @@ You're done - Claude handles the rest
 Apply oh-my-claudecode to current project only:
 
 ```
-/omc-default
+/oh-my-claudecode:omc-default
 ```
 
 Creates: `./.claude/CLAUDE.md`
@@ -322,7 +322,7 @@ Creates: `./.claude/CLAUDE.md`
 Apply to all Claude Code sessions:
 
 ```
-/omc-default-global
+/oh-my-claudecode:omc-default-global
 ```
 
 Creates: `~/.claude/CLAUDE.md`
@@ -337,7 +337,7 @@ Creates: `~/.claude/CLAUDE.md`
 
 **2.x Workflow:**
 ```
-/ultrawork "implement the todo list feature"
+/oh-my-claudecode:ultrawork "implement the todo list feature"
 ```
 
 **3.0 Workflow:**
@@ -353,7 +353,7 @@ Claude: "I'm activating ultrawork for maximum parallelism"
 
 **2.x Workflow:**
 ```
-/ralph "debug the memory leak"
+/oh-my-claudecode:ralph "debug the memory leak"
 ```
 
 **3.0 Workflow:**
@@ -369,7 +369,7 @@ Claude: "I'm activating ralph-loop to ensure completion"
 
 **2.x Workflow:**
 ```
-/planner "design the new authentication system"
+/oh-my-claudecode:planner "design the new authentication system"
 ```
 
 **3.0 Workflow:**
@@ -387,7 +387,7 @@ Interview begins automatically
 
 **2.x Workflow:**
 ```
-/cancel-ralph
+/oh-my-claudecode:cancel-ralph
 ```
 
 **3.0 Workflow:**
@@ -421,10 +421,10 @@ A: No. Keywords are optional shortcuts. Claude auto-detects intent without them.
 A: No. All 2.x commands continue to work exactly as before.
 
 **Q: What if I like explicit commands?**
-A: Keep using them! `/ralph`, `/ultrawork`, `/planner` all still work.
+A: Keep using them! `/oh-my-claudecode:ralph`, `/oh-my-claudecode:ultrawork`, `/oh-my-claudecode:planner` all still work.
 
 **Q: How do I know what Claude is doing?**
-A: Claude announces major behaviors: "I'm activating ralph-loop..." or set up `/hud` for real-time status.
+A: Claude announces major behaviors: "I'm activating ralph-loop..." or set up `/oh-my-claudecode:hud` for real-time status.
 
 **Q: Where's the old command list?**
 A: See [README.md](../README.md) for full command reference. All commands still work.
@@ -436,9 +436,9 @@ A: Keywords are explicit shortcuts. Natural language triggers auto-detection. Bo
 
 ## Need Help?
 
-- **Diagnose issues**: Run `/doctor`
+- **Diagnose issues**: Run `/oh-my-claudecode:doctor`
 - **See all commands**: Run `/oh-my-claudecode:help`
-- **View real-time status**: Run `/hud setup`
+- **View real-time status**: Run `/oh-my-claudecode:hud setup`
 - **Review detailed changelog**: See [CHANGELOG.md](../CHANGELOG.md)
 - **Report bugs**: [GitHub Issues](https://github.com/Yeachan-Heo/oh-my-claude-sisyphus/issues)