oh-my-claude-sisyphus 3.3.6 → 3.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oh-my-claude-sisyphus",
3
- "version": "3.3.6",
3
+ "version": "3.3.7",
4
4
  "description": "Multi-agent orchestration system for Claude Code - Inspired by oh-my-opencode",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -22,9 +22,9 @@ Autopilot is the ultimate hands-off mode. Give it a brief product idea (2-3 line
22
22
  ## Usage
23
23
 
24
24
  ```
25
- /autopilot <your idea>
26
- /ap "A CLI tool that tracks daily habits"
27
- /autopilot Add dark mode to the app
25
+ /oh-my-claudecode:autopilot <your idea>
26
+ /oh-my-claudecode:ap "A CLI tool that tracks daily habits"
27
+ /oh-my-claudecode:autopilot Add dark mode to the app
28
28
  ```
29
29
 
30
30
  ## Magic Keywords
@@ -115,7 +115,7 @@ Optional settings in `.claude/settings.json`:
115
115
  ## Cancellation
116
116
 
117
117
  ```
118
- /cancel-autopilot
118
+ /oh-my-claudecode:cancel-autopilot
119
119
  ```
120
120
 
121
121
  Or say: "stop", "cancel", "abort"
@@ -124,23 +124,23 @@ Progress is preserved for resume.
124
124
 
125
125
  ## Resume
126
126
 
127
- If autopilot was cancelled or failed, just run `/autopilot` again to resume from where it stopped.
127
+ If autopilot was cancelled or failed, just run `/oh-my-claudecode:autopilot` again to resume from where it stopped.
128
128
 
129
129
  ## Examples
130
130
 
131
131
  **New Project:**
132
132
  ```
133
- /autopilot A REST API for a bookstore inventory with CRUD operations
133
+ /oh-my-claudecode:autopilot A REST API for a bookstore inventory with CRUD operations
134
134
  ```
135
135
 
136
136
  **Feature Addition:**
137
137
  ```
138
- /autopilot Add user authentication with JWT tokens
138
+ /oh-my-claudecode:autopilot Add user authentication with JWT tokens
139
139
  ```
140
140
 
141
141
  **Enhancement:**
142
142
  ```
143
- /ap Add dark mode support with system preference detection
143
+ /oh-my-claudecode:ap Add dark mode support with system preference detection
144
144
  ```
145
145
 
146
146
  ## Best Practices
@@ -17,7 +17,7 @@ Cancel an active autopilot session gracefully.
17
17
  ## Usage
18
18
 
19
19
  ```
20
- /cancel-autopilot
20
+ /oh-my-claudecode:cancel-autopilot
21
21
  ```
22
22
 
23
23
  Or say: "stop autopilot", "cancel autopilot", "abort autopilot"
@@ -37,14 +37,14 @@ When cancelled, autopilot preserves:
37
37
  - Spec and plan files
38
38
  - Validation verdicts
39
39
 
40
- Run `/autopilot` to resume from where you left off.
40
+ Run `/oh-my-claudecode:autopilot` to resume from where you left off.
41
41
 
42
42
  ## Force Clear
43
43
 
44
44
  To completely clear all state (no resume):
45
45
 
46
46
  ```
47
- /cancel-autopilot --clear
47
+ /oh-my-claudecode:cancel-autopilot --clear
48
48
  ```
49
49
 
50
50
  This removes all autopilot files including:
@@ -35,9 +35,9 @@ After running this command, you are free to stop working. The persistent mode ho
35
35
 
36
36
  ## Note on Linked Modes
37
37
 
38
- Since v3.0, Ralph automatically activates Ultrawork for parallel execution. When you cancel Ralph, the linked Ultrawork is also cancelled. If you started Ultrawork separately (not via Ralph), use `/cancel-ultrawork` to cancel it independently.
38
+ Since v3.0, Ralph automatically activates Ultrawork for parallel execution. When you cancel Ralph, the linked Ultrawork is also cancelled. If you started Ultrawork separately (not via Ralph), use `/oh-my-claudecode:cancel-ultrawork` to cancel it independently.
39
39
 
40
40
  ## To Start Fresh
41
41
 
42
- - `/ralph "task"` - Start ralph with ultrawork (default)
43
- - `/ultrawork "task"` - Start ultrawork only (standalone)
42
+ - `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)
43
+ - `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)
@@ -22,8 +22,8 @@ After running this command, the QA cycling will stop.
22
22
 
23
23
  ## To Start Fresh
24
24
 
25
- - `/ultraqa --tests` - Run until all tests pass
26
- - `/ultraqa --build` - Run until build succeeds
27
- - `/ultraqa --lint` - Run until no lint errors
28
- - `/ultraqa --typecheck` - Run until no type errors
29
- - `/ultraqa --custom "pattern"` - Run until pattern matches
25
+ - `/oh-my-claudecode:ultraqa --tests` - Run until all tests pass
26
+ - `/oh-my-claudecode:ultraqa --build` - Run until build succeeds
27
+ - `/oh-my-claudecode:ultraqa --lint` - Run until no lint errors
28
+ - `/oh-my-claudecode:ultraqa --typecheck` - Run until no type errors
29
+ - `/oh-my-claudecode:ultraqa --custom "pattern"` - Run until pattern matches
@@ -18,7 +18,7 @@ The Ultrawork mode has been cancelled. Clearing state files.
18
18
  cat .omc/ultrawork-state.json 2>/dev/null | jq -r '.linked_to_ralph // false'
19
19
  ```
20
20
 
21
- **If linked_to_ralph is true**: Use `/cancel-ralph` instead to cancel both Ralph and its linked Ultrawork.
21
+ **If linked_to_ralph is true**: Use `/oh-my-claudecode:cancel-ralph` instead to cancel both Ralph and its linked Ultrawork.
22
22
 
23
23
  **Otherwise**, execute this command to cancel Ultrawork:
24
24
 
@@ -33,10 +33,10 @@ After running this command, ultrawork mode will be deactivated and the HUD will
33
33
  ## Note on Linked Modes
34
34
 
35
35
  Since v3.0, Ralph automatically activates Ultrawork. If you see `linked_to_ralph: true` in the ultrawork state, it means Ultrawork was auto-activated by Ralph. In this case:
36
- - Use `/cancel-ralph` to cancel both modes
36
+ - Use `/oh-my-claudecode:cancel-ralph` to cancel both modes
37
37
  - If you only cancel ultrawork, Ralph will continue but without parallel execution benefits
38
38
 
39
39
  ## To Start Fresh
40
40
 
41
- - `/ultrawork "task"` - Start ultrawork only (standalone)
42
- - `/ralph "task"` - Start ralph with ultrawork (default)
41
+ - `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)
42
+ - `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)
@@ -14,16 +14,16 @@ Configure the OMC HUD (Heads-Up Display) for the statusline.
14
14
 
15
15
  | Command | Description |
16
16
  |---------|-------------|
17
- | `/hud` | Show current HUD status (auto-setup if needed) |
18
- | `/hud setup` | Install/repair HUD statusline |
19
- | `/hud minimal` | Switch to minimal display |
20
- | `/hud focused` | Switch to focused display (default) |
21
- | `/hud full` | Switch to full display |
22
- | `/hud status` | Show detailed HUD status |
17
+ | `/oh-my-claudecode:hud` | Show current HUD status (auto-setup if needed) |
18
+ | `/oh-my-claudecode:hud setup` | Install/repair HUD statusline |
19
+ | `/oh-my-claudecode:hud minimal` | Switch to minimal display |
20
+ | `/oh-my-claudecode:hud focused` | Switch to focused display (default) |
21
+ | `/oh-my-claudecode:hud full` | Switch to full display |
22
+ | `/oh-my-claudecode:hud status` | Show detailed HUD status |
23
23
 
24
24
  ## Auto-Setup
25
25
 
26
- When you run `/hud` or `/hud setup`, the system will automatically:
26
+ When you run `/oh-my-claudecode:hud` or `/oh-my-claudecode:hud setup`, the system will automatically:
27
27
  1. Check if `~/.claude/hud/omc-hud.mjs` exists
28
28
  2. Check if `statusLine` is configured in `~/.claude/settings.json`
29
29
  3. If missing, create the HUD wrapper script and configure settings
@@ -226,9 +226,9 @@ You can manually edit the config file:
226
226
  ## Troubleshooting
227
227
 
228
228
  If the HUD is not showing:
229
- 1. Run `/hud setup` to auto-install and configure
229
+ 1. Run `/oh-my-claudecode:hud setup` to auto-install and configure
230
230
  2. Restart Claude Code after setup completes
231
- 3. If still not working, run `/doctor` for full diagnostics
231
+ 3. If still not working, run `/oh-my-claudecode:doctor` for full diagnostics
232
232
 
233
233
  Manual verification:
234
234
  - HUD script: `~/.claude/hud/omc-hud.mjs`
@@ -27,7 +27,7 @@ If a potential skill fails any of these questions, it's not worth saving.
27
27
 
28
28
  ## Recognition Pattern
29
29
 
30
- Use /learner ONLY after:
30
+ Use /oh-my-claudecode:learner ONLY after:
31
31
  - Solving a tricky bug that required deep investigation
32
32
  - Discovering a non-obvious workaround specific to this codebase
33
33
  - Finding a hidden gotcha that wastes time when forgotten
@@ -132,5 +132,5 @@ If code helps, show it - but as illustration of the principle, not copy-paste ma
132
132
 
133
133
  ## Related Commands
134
134
 
135
- - /note - Save quick notes that survive compaction (less formal than skills)
136
- - /ralph - Start a development loop with learning capture
135
+ - /oh-my-claudecode:note - Save quick notes that survive compaction (less formal than skills)
136
+ - /oh-my-claudecode:ralph - Start a development loop with learning capture
@@ -0,0 +1,196 @@
1
+ ---
2
+ name: mcp-setup
3
+ description: Configure popular MCP servers for enhanced agent capabilities
4
+ user-invocable: true
5
+ ---
6
+
7
+ # MCP Setup
8
+
9
+ Configure Model Context Protocol (MCP) servers to extend Claude Code's capabilities with external tools like web search, file system access, and GitHub integration.
10
+
11
+ ## Overview
12
+
13
+ MCP servers provide additional tools that Claude Code agents can use. This skill helps you configure popular MCP servers in your `~/.claude/settings.json`.
14
+
15
+ ## Step 1: Show Available MCP Servers
16
+
17
+ Present the user with available MCP server options using AskUserQuestion:
18
+
19
+ **Question:** "Which MCP server would you like to configure?"
20
+
21
+ **Options:**
22
+ 1. **Context7** - Documentation and code context from popular libraries
23
+ 2. **Exa Web Search** - Enhanced web search (replaces built-in websearch)
24
+ 3. **Filesystem** - Extended file system access with additional capabilities
25
+ 4. **GitHub** - GitHub API integration for issues, PRs, and repository management
26
+ 5. **All of the above** - Configure all recommended MCP servers
27
+ 6. **Custom** - Add a custom MCP server
28
+
29
+ ## Step 2: Gather Required Information
30
+
31
+ ### For Context7:
32
+ No API key required. Ready to use immediately.
33
+
34
+ ### For Exa Web Search:
35
+ Ask for API key:
36
+ ```
37
+ Do you have an Exa API key?
38
+ - Get one at: https://exa.ai
39
+ - Enter your API key, or type 'skip' to configure later
40
+ ```
41
+
42
+ ### For Filesystem:
43
+ Ask for allowed directories:
44
+ ```
45
+ Which directories should the filesystem MCP have access to?
46
+ Default: Current working directory
47
+ Enter comma-separated paths, or press Enter for default
48
+ ```
49
+
50
+ ### For GitHub:
51
+ Ask for token:
52
+ ```
53
+ Do you have a GitHub Personal Access Token?
54
+ - Create one at: https://github.com/settings/tokens
55
+ - Recommended scopes: repo, read:org
56
+ - Enter your token, or type 'skip' to configure later
57
+ ```
58
+
59
+ ## Step 3: Update settings.json
60
+
61
+ Read the current `~/.claude/settings.json` and add/update the `mcpServers` section.
62
+
63
+ ### Context7 Configuration:
64
+ ```json
65
+ {
66
+ "mcpServers": {
67
+ "context7": {
68
+ "command": "npx",
69
+ "args": ["-y", "@context7/mcp"]
70
+ }
71
+ }
72
+ }
73
+ ```
74
+
75
+ ### Exa Web Search Configuration:
76
+ ```json
77
+ {
78
+ "mcpServers": {
79
+ "exa": {
80
+ "command": "npx",
81
+ "args": ["-y", "@anthropic/exa-mcp-server"],
82
+ "env": {
83
+ "EXA_API_KEY": "<user-provided-key>"
84
+ }
85
+ }
86
+ }
87
+ }
88
+ ```
89
+
90
+ ### Filesystem Configuration:
91
+ ```json
92
+ {
93
+ "mcpServers": {
94
+ "filesystem": {
95
+ "command": "npx",
96
+ "args": ["-y", "@anthropic/mcp-server-filesystem", "<allowed-directories>"]
97
+ }
98
+ }
99
+ }
100
+ ```
101
+
102
+ ### GitHub Configuration:
103
+ ```json
104
+ {
105
+ "mcpServers": {
106
+ "github": {
107
+ "command": "npx",
108
+ "args": ["-y", "@anthropic/github-mcp-server"],
109
+ "env": {
110
+ "GITHUB_TOKEN": "<user-provided-token>"
111
+ }
112
+ }
113
+ }
114
+ }
115
+ ```
116
+
117
+ ## Step 4: Merge Configuration
118
+
119
+ When updating settings.json:
120
+
121
+ 1. Read existing file: `~/.claude/settings.json`
122
+ 2. Parse as JSON (handle comments with jsonc-parser if needed)
123
+ 3. Merge new `mcpServers` entries with existing ones (don't overwrite user's other MCP servers)
124
+ 4. Write back to file with proper formatting
125
+
126
+ ```bash
127
+ # Backup existing settings first
128
+ cp ~/.claude/settings.json ~/.claude/settings.json.bak 2>/dev/null || true
129
+ ```
130
+
131
+ Use the Edit tool or Write tool to update the settings file, preserving existing configuration.
132
+
133
+ ## Step 5: Verify Installation
134
+
135
+ After configuration, verify the MCP servers are properly set up:
136
+
137
+ ```bash
138
+ # Check if settings.json has mcpServers
139
+ grep -q "mcpServers" ~/.claude/settings.json && echo "MCP servers configured" || echo "Configuration may have failed"
140
+
141
+ # List configured servers
142
+ node -e "const s = require('$HOME/.claude/settings.json'); console.log('Configured MCP servers:', Object.keys(s.mcpServers || {}).join(', ') || 'none')"
143
+ ```
144
+
145
+ ## Step 6: Show Completion Message
146
+
147
+ ```
148
+ MCP Server Configuration Complete!
149
+
150
+ CONFIGURED SERVERS:
151
+ [List the servers that were configured]
152
+
153
+ NEXT STEPS:
154
+ 1. Restart Claude Code for changes to take effect
155
+ 2. The configured MCP tools will be available to all agents
156
+
157
+ USAGE TIPS:
158
+ - Context7: Ask about library documentation (e.g., "How do I use React hooks?")
159
+ - Exa: Use for web searches (e.g., "Search the web for latest TypeScript features")
160
+ - Filesystem: Extended file operations beyond the working directory
161
+ - GitHub: Interact with GitHub repos, issues, and PRs
162
+
163
+ TROUBLESHOOTING:
164
+ - If MCP servers don't appear, check ~/.claude/settings.json for syntax errors
165
+ - Ensure you have Node.js 18+ installed for npx commands
166
+ - Run /oh-my-claudecode:doctor to diagnose issues
167
+
168
+ To add more MCP servers later, run: /oh-my-claudecode:mcp-setup
169
+ ```
170
+
171
+ ## Custom MCP Server
172
+
173
+ If user selects "Custom":
174
+
175
+ Ask for:
176
+ 1. Server name (identifier)
177
+ 2. Command to run (e.g., `npx`, `node`, path to executable)
178
+ 3. Arguments (comma-separated)
179
+ 4. Environment variables (optional, key=value pairs)
180
+
181
+ Then add to mcpServers section accordingly.
182
+
183
+ ## Common Issues
184
+
185
+ ### MCP Server Not Loading
186
+ - Ensure Node.js 18+ is installed
187
+ - Check that npx is available in PATH
188
+ - Verify no JSON syntax errors in settings.json
189
+
190
+ ### API Key Issues
191
+ - Exa: Verify key at https://dashboard.exa.ai
192
+ - GitHub: Ensure token has required scopes
193
+
194
+ ### Agents Still Using Built-in Tools
195
+ - Restart Claude Code after configuration
196
+ - The built-in websearch will be deprioritized when exa is configured
@@ -12,12 +12,12 @@ Save important context to `.omc/notepad.md` that survives conversation compactio
12
12
 
13
13
  | Command | Action |
14
14
  |---------|--------|
15
- | `/note <content>` | Add to Working Memory with timestamp |
16
- | `/note --priority <content>` | Add to Priority Context (always loaded) |
17
- | `/note --manual <content>` | Add to MANUAL section (never pruned) |
18
- | `/note --show` | Display current notepad contents |
19
- | `/note --prune` | Remove entries older than 7 days |
20
- | `/note --clear` | Clear Working Memory (keep Priority + MANUAL) |
15
+ | `/oh-my-claudecode:note <content>` | Add to Working Memory with timestamp |
16
+ | `/oh-my-claudecode:note --priority <content>` | Add to Priority Context (always loaded) |
17
+ | `/oh-my-claudecode:note --manual <content>` | Add to MANUAL section (never pruned) |
18
+ | `/oh-my-claudecode:note --show` | Display current notepad contents |
19
+ | `/oh-my-claudecode:note --prune` | Remove entries older than 7 days |
20
+ | `/oh-my-claudecode:note --clear` | Clear Working Memory (keep Priority + MANUAL) |
21
21
 
22
22
  ## Sections
23
23
 
@@ -39,11 +39,11 @@ Save important context to `.omc/notepad.md` that survives conversation compactio
39
39
  ## Examples
40
40
 
41
41
  ```
42
- /note Found auth bug in UserContext - missing useEffect dependency
43
- /note --priority Project uses TypeScript strict mode, all files in src/
44
- /note --manual Contact: api-team@company.com for backend questions
45
- /note --show
46
- /note --prune
42
+ /oh-my-claudecode:note Found auth bug in UserContext - missing useEffect dependency
43
+ /oh-my-claudecode:note --priority Project uses TypeScript strict mode, all files in src/
44
+ /oh-my-claudecode:note --manual Contact: api-team@company.com for backend questions
45
+ /oh-my-claudecode:note --show
46
+ /oh-my-claudecode:note --prune
47
47
  ```
48
48
 
49
49
  ## Behavior
@@ -151,7 +151,20 @@ fi
151
151
  grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin verified" || echo "Plugin NOT found - run: claude /install-plugin oh-my-claudecode"
152
152
  ```
153
153
 
154
- ## Step 5: Detect Upgrade from 2.x
154
+ ## Step 5: Offer MCP Server Configuration
155
+
156
+ MCP servers extend Claude Code with additional tools (web search, GitHub, etc.).
157
+
158
+ Ask user: "Would you like to configure MCP servers for enhanced capabilities? (Context7, Exa search, GitHub, etc.)"
159
+
160
+ If yes, invoke the mcp-setup skill:
161
+ ```
162
+ /oh-my-claudecode:mcp-setup
163
+ ```
164
+
165
+ If no, skip to next step.
166
+
167
+ ## Step 6: Detect Upgrade from 2.x
155
168
 
156
169
  Check if user has existing configuration:
157
170
  ```bash
@@ -161,7 +174,7 @@ ls ~/.claude/commands/ralph-loop.md 2>/dev/null || ls ~/.claude/commands/ultrawo
161
174
 
162
175
  If found, this is an upgrade from 2.x.
163
176
 
164
- ## Step 6: Show Welcome Message
177
+ ## Step 7: Show Welcome Message
165
178
 
166
179
  ### For New Users:
167
180
 
@@ -188,6 +201,9 @@ Just include these words naturally in your request:
188
201
 
189
202
  Combine them: "ralph ulw: migrate the database"
190
203
 
204
+ MCP SERVERS:
205
+ Run /oh-my-claudecode:mcp-setup to add tools like web search, GitHub, etc.
206
+
191
207
  HUD STATUSLINE:
192
208
  The status bar now shows OMC state. Restart Claude Code to see it.
193
209
 
@@ -55,7 +55,7 @@ Started: [ISO timestamp]
55
55
  3. **Independent stories**: Minimize dependencies between stories
56
56
  4. **Priority order**: Foundational work (DB, types) before UI
57
57
 
58
- After creating files, report summary and suggest running `/ralph-loop` to start.
58
+ After creating files, report summary and suggest running `/oh-my-claudecode:ralph-loop` to start.
59
59
 
60
60
  Task to break down:
61
61
  {{ARGUMENTS}}
@@ -77,6 +77,38 @@ Ralplan maintains persistent state in `.omc/ralplan-state.json` to track progres
77
77
 
78
78
  **Phases**: `planner_planning` → `architect_consultation` → `critic_review` → `handling_verdict` → `complete`
79
79
 
80
+ ## Plan Mode Interaction (CRITICAL)
81
+
82
+ **When ralplan is invoked while Plan mode is active:**
83
+
84
+ 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.**
85
+
86
+ ### Mandatory Constraints
87
+
88
+ | Constraint | Rationale |
89
+ |------------|-----------|
90
+ | **Planner MUST skip PHASE 3.5 confirmation** | Critic reviews the plan, not the user |
91
+ | **Critic MUST run before any plan approval** | No plan is approved without Critic verdict |
92
+ | **DO NOT exit plan mode until Critic has rendered verdict** | Premature exit skips the review step |
93
+ | **Log `[RALPLAN] Critic review required before approval`** | Observability for debugging |
94
+
95
+ ### Flow When Plan Mode Is Active
96
+
97
+ ```
98
+ 1. Orchestrator invokes ralplan skill
99
+ 2. Log: [RALPLAN] Starting - Critic review will be required
100
+ 3. Spawn Planner in DIRECT PLANNING MODE (no interview, no confirmation)
101
+ 4. Planner outputs PLAN_READY: <path>
102
+ 5. Log: [RALPLAN] Plan ready, invoking Critic for review
103
+ 6. Spawn Critic with plan path <-- MUST HAPPEN
104
+ 7. Critic renders OKAY or REJECT
105
+ 8. ONLY THEN can plan be approved or refined
106
+ ```
107
+
108
+ **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.**
109
+
110
+ ---
111
+
80
112
  ## Execution Protocol
81
113
 
82
114
  ### Initialization
@@ -98,12 +130,15 @@ The skill begins by establishing the planning environment:
98
130
  The Planner creates an initial plan based on task context:
99
131
 
100
132
  - Invoke Planner in **direct planning mode** (bypassing interview since task context is pre-gathered)
133
+ - **CRITICAL: Planner MUST skip PHASE 3.5 (CONFIRMATION)** - the Critic will review, not the user
101
134
  - Planner receives task context directly without preliminary questioning
102
135
  - Planner mandatorily consults with Metis for gap detection
103
136
  - Planner generates plan directly to `.omc/plans/[feature-name].md`
104
137
  - Plan includes: requirements summary, concrete acceptance criteria, specific implementation steps with file references, risk identification with mitigations, and verification steps
105
138
  - Signal completion with `PLAN_READY: .omc/plans/[filename].md`
139
+ - **After PLAN_READY: DO NOT approve or confirm the plan. Proceed to Critic Review.**
106
140
  - Extract plan path from completion signal and update state
141
+ - Log: `[RALPLAN] Critic review required before approval`
107
142
 
108
143
  ### Architect Consultation (Conditional)
109
144
 
@@ -114,7 +149,11 @@ The Architect provides strategic guidance in two scenarios:
114
149
 
115
150
  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.
116
151
 
117
- ### Critic Review
152
+ ### Critic Review (MANDATORY - CANNOT BE SKIPPED)
153
+
154
+ **CRITICAL: This phase MUST execute. The Critic is the gatekeeper for plan approval.**
155
+
156
+ Log at start: `[RALPLAN] Invoking Critic for plan review`
118
157
 
119
158
  The Critic examines the plan against quality standards:
120
159
 
@@ -122,6 +161,14 @@ The Critic examines the plan against quality standards:
122
161
  - Critic conducts thorough review of plan completeness and feasibility
123
162
  - Critic emits verdict: either `OKAY` (approval) or `REJECT` with specific issues
124
163
 
164
+ **Enforcement Rules:**
165
+ 1. If Planner signals PLAN_READY, Critic MUST be invoked immediately
166
+ 2. DO NOT exit ralplan loop before Critic verdict
167
+ 3. DO NOT request user confirmation before Critic verdict
168
+ 4. DO NOT trigger any plan mode exit behavior before Critic verdict
169
+
170
+ Log after Critic completes: `[RALPLAN] Critic verdict: <OKAY|REJECT>`
171
+
125
172
  ### Verdict Handling and Iteration
126
173
 
127
174
  Based on Critic's verdict, the skill either approves the plan or continues iteration:
@@ -129,7 +176,7 @@ Based on Critic's verdict, the skill either approves the plan or continues itera
129
176
  **If verdict is OKAY:**
130
177
  - Mark plan as approved
131
178
  - Log approval with iteration count
132
- - Prepare plan for execution with `/ralph` or manual orchestration
179
+ - Prepare plan for execution with `/oh-my-claudecode:ralph` or manual orchestration
133
180
  - Set state `active: false, current_phase: "complete"`
134
181
 
135
182
  **If verdict is REJECT:**
@@ -205,15 +252,21 @@ CRITIC_FEEDBACK:
205
252
 
206
253
  To stop an active ralplan session:
207
254
 
208
- - Use `/cancel-ralph` (automatically detects ralplan via state file)
255
+ - Use `/oh-my-claudecode:cancel-ralph` (automatically detects ralplan via state file)
209
256
  - Or manually delete `.omc/ralplan-state.json`
210
257
 
211
258
  ## Skill Workflow
212
259
 
213
260
  1. **Initialize state** and log: `[RALPLAN Iteration 0/5] Initializing...`
214
261
  2. **Parse task** from user input
215
- 3. **Spawn Planner** in direct planning mode
216
- 4. **Iterate** through planning loop with observability logging at each phase
217
- 5. **Complete** when Critic approves or max iterations reached with warnings
262
+ 3. **Spawn Planner** in direct planning mode (SKIP Planner's PHASE 3.5 confirmation)
263
+ 4. **Wait for PLAN_READY** signal from Planner
264
+ 5. **Log:** `[RALPLAN] Critic review required before approval`
265
+ 6. **Invoke Critic** with plan file path (MANDATORY - CANNOT BE SKIPPED)
266
+ 7. **Log:** `[RALPLAN] Critic verdict: <verdict>`
267
+ 8. **Handle verdict** - if REJECT, loop back to step 3 with feedback
268
+ 9. **Complete** ONLY when Critic approves or max iterations reached with warnings
269
+
270
+ **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.
218
271
 
219
272
  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.
@@ -11,10 +11,10 @@ Automate the release process for oh-my-claudecode.
11
11
  ## Usage
12
12
 
13
13
  ```
14
- /release <version>
14
+ /oh-my-claudecode:release <version>
15
15
  ```
16
16
 
17
- Example: `/release 2.4.0` or `/release patch` or `/release minor`
17
+ Example: `/oh-my-claudecode:release 2.4.0` or `/oh-my-claudecode:release patch` or `/oh-my-claudecode:release minor`
18
18
 
19
19
  ## Release Checklist
20
20
 
@@ -21,20 +21,20 @@ Research is a multi-stage workflow that decomposes complex research goals into p
21
21
  ## Usage Examples
22
22
 
23
23
  ```
24
- /research <goal> # Standard research with user checkpoints
25
- /research AUTO: <goal> # Fully autonomous until complete
26
- /research status # Check current research session status
27
- /research resume # Resume interrupted research session
28
- /research list # List all research sessions
29
- /research report <session-id> # Generate report for session
24
+ /oh-my-claudecode:research <goal> # Standard research with user checkpoints
25
+ /oh-my-claudecode:research AUTO: <goal> # Fully autonomous until complete
26
+ /oh-my-claudecode:research status # Check current research session status
27
+ /oh-my-claudecode:research resume # Resume interrupted research session
28
+ /oh-my-claudecode:research list # List all research sessions
29
+ /oh-my-claudecode:research report <session-id> # Generate report for session
30
30
  ```
31
31
 
32
32
  ### Quick Examples
33
33
 
34
34
  ```
35
- /research What are the performance characteristics of different sorting algorithms?
36
- /research AUTO: Analyze authentication patterns in this codebase
37
- /research How does the error handling work across the API layer?
35
+ /oh-my-claudecode:research What are the performance characteristics of different sorting algorithms?
36
+ /oh-my-claudecode:research AUTO: Analyze authentication patterns in this codebase
37
+ /oh-my-claudecode:research How does the error handling work across the API layer?
38
38
  ```
39
39
 
40
40
  ## Research Protocol
@@ -151,7 +151,7 @@ Pending stages: {{PENDING_STAGES}}
151
151
  ### AUTO Mode Example
152
152
 
153
153
  ```
154
- /research AUTO: Comprehensive security analysis of the authentication system
154
+ /oh-my-claudecode:research AUTO: Comprehensive security analysis of the authentication system
155
155
 
156
156
  [Decomposition]
157
157
  - Stage 1 (LOW): Enumerate auth-related files
@@ -281,12 +281,12 @@ Batch 2: Stages 6-7 (parallel)
281
281
 
282
282
  | Command | Action |
283
283
  |---------|--------|
284
- | `/research status` | Show current session progress |
285
- | `/research resume` | Resume most recent interrupted session |
286
- | `/research resume <session-id>` | Resume specific session |
287
- | `/research list` | List all sessions with status |
288
- | `/research report <session-id>` | Generate/regenerate report |
289
- | `/research cancel` | Cancel current session (preserves state) |
284
+ | `/oh-my-claudecode:research status` | Show current session progress |
285
+ | `/oh-my-claudecode:research resume` | Resume most recent interrupted session |
286
+ | `/oh-my-claudecode:research resume <session-id>` | Resume specific session |
287
+ | `/oh-my-claudecode:research list` | List all sessions with status |
288
+ | `/oh-my-claudecode:research report <session-id>` | Generate/regenerate report |
289
+ | `/oh-my-claudecode:research cancel` | Cancel current session (preserves state) |
290
290
 
291
291
  ## Tag Extraction
292
292
 
@@ -481,7 +481,7 @@ Optional settings in `.claude/settings.json`:
481
481
  ## Cancellation
482
482
 
483
483
  ```
484
- /cancel-research
484
+ /oh-my-claudecode:cancel-research
485
485
  ```
486
486
 
487
487
  Or say: "stop research", "cancel research", "abort"