oh-my-claude-sisyphus 3.8.9 → 3.8.11

package/docs/CLAUDE.md

@@ -227,7 +227,7 @@ Users don't need to learn commands. You detect intent and activate behaviors aut
 | `ralplan` | Iterative planning consensus | "ralplan this feature" |
 | `eco` | Token-efficient parallelism | "eco fix all errors" |
 
-**Combine them:** "ralph ulw: migrate database" = persistence + parallelism
+**ralph includes ultrawork:** When you activate ralph mode, it automatically includes ultrawork's parallel execution. No need to combine keywords.
 
 ### Stopping and Cancelling
 
@@ -274,6 +274,32 @@ User says "cancelomc", "stopomc" → Invoke unified `cancel` skill (automaticall
 | `tdd` | TDD enforcement: test-first development | "tdd", "test first" | `/oh-my-claudecode:tdd` |
 | `mcp-setup` | Configure MCP servers for extended capabilities | "setup mcp", "configure mcp" | `/oh-my-claudecode:mcp-setup` |
 | `learn-about-omc` | Usage pattern analysis | - | `/oh-my-claudecode:learn-about-omc` |
+| `build-fix` | Fix build and TypeScript errors with minimal changes | - | `/oh-my-claudecode:build-fix` |
+| `code-review` | Run a comprehensive code review | - | `/oh-my-claudecode:code-review` |
+| `security-review` | Run a comprehensive security review on code | - | `/oh-my-claudecode:security-review` |
+| `writer-memory` | Agentic memory system for writers - track characters, relationships, scenes | - | `/oh-my-claudecode:writer-memory` |
+| `project-session-manager` | Manage isolated dev environments with git worktrees and tmux | - | `/oh-my-claudecode:project-session-manager` |
+| `local-skills-setup` | Set up and manage local skills for automatic matching and invocation | - | `/oh-my-claudecode:local-skills-setup` |
+| `skill` | Manage local skills - list, add, remove, search, edit | - | `/oh-my-claudecode:skill` |
+
+### Choosing the Right Mode
+
+| If you want... | Use this mode | Trigger keyword |
+|----------------|---------------|-----------------|
+| Full autonomous build from idea | `autopilot` | "autopilot", "build me", "I want a" |
+| Parallel autopilot (3-5x faster) | `ultrapilot` | "ultrapilot", "parallel build" |
+| Persistence until verified done | `ralph` | "ralph", "don't stop", "must complete" |
+| Maximum parallelism, manual verify | `ultrawork` | "ulw", "ultrawork" |
+| Cost-efficient parallel execution | `ecomode` | "eco", "ecomode", "budget" |
+| Coordinated N agents on task pool | `swarm` | "swarm N agents" |
+| Sequential agent chaining | `pipeline` | "pipeline", "chain agents" |
+| QA cycling: test, fix, repeat | `ultraqa` | via autopilot transition |
+
+#### Mode Relationships
+
+- **ralph includes ultrawork**: When ralph is activated, it automatically enables ultrawork's parallel execution. No need to combine keywords.
+- **autopilot can transition**: Autopilot may transition to ralph (for persistence) or ultraqa (for QA cycling) during execution.
+- **ecomode = ultrawork + cheaper models**: Same parallel behavior but routes to haiku/sonnet agents for cost savings.
 
 ### All 32 Agents
 
@@ -528,9 +554,23 @@ Reusable verification protocol for workflows.
 
 Standardized state file locations.
 
-**Standard paths:**
-- Local: `.omc/state/{name}.json`
-- Global: `~/.omc/state/{name}.json`
+**Standard paths for all mode state files:**
+- Primary: `.omc/state/{name}.json` (local, per-project)
+- Global backup: `~/.omc/state/{name}.json` (global, session continuity)
+
+**Mode State Files:**
+| Mode | State File |
+|------|-----------|
+| ralph | `ralph-state.json` |
+| autopilot | `autopilot-state.json` |
+| ultrapilot | `ultrapilot-state.json` |
+| ultrawork | `ultrawork-state.json` |
+| ecomode | `ecomode-state.json` |
+| ultraqa | `ultraqa-state.json` |
+| pipeline | `pipeline-state.json` |
+| swarm | `swarm-summary.json` + `swarm-active.marker` |
+
+**Important:** Never store OMC state in `~/.claude/` - that directory is reserved for Claude Code itself.
 
 Legacy locations auto-migrated on read.
 

package/docs/FEATURES.md

@@ -562,7 +562,7 @@ if (validationStatus?.allApproved) {
 
 ### State Persistence
 
-All state is persisted to `.omc/autopilot-state.json` and includes:
+All state is persisted to `.omc/state/autopilot-state.json` and includes:
 
 - Active status and current phase
 - Original user idea

package/docs/MIGRATION.md

@@ -30,7 +30,7 @@ Maintenance release fixing test suite issues and continuing skill consolidation
 **Skill Consolidation:**
 - Continued cleanup from v3.5.3
 - Removed deprecated `cancel-*` skills (use `/cancel` instead)
-- Final skill count: 35 core skills
+- Final skill count: 37 core skills
 
 ### Migration Steps
 
@@ -103,7 +103,7 @@ The following skills have been **completely removed** in v3.5.3:
 ### Skill Count
 
 - v3.5: 42 skills
-- v3.5.3: 35 skills (8 removed, 1 added)
+- v3.5.3: 37 skills (8 removed, 3 added)
 
 ---
 
@@ -254,11 +254,11 @@ Include these anywhere in your message to explicitly activate behaviors. Use key
 | `ulw` / `ultrawork` | Maximum parallel execution | "ulw: fix all type errors" |
 | `plan` | Planning interview | "plan: new API design" |
 
-**Combine them for superpowers:**
+**ralph includes ultrawork:**
 ```
-ralph ulw: migrate the entire database
+ralph: migrate the entire database
     ↓
-Persistence (won't stop) + Ultrawork (maximum parallelism)
+Persistence (won't stop) + Ultrawork (maximum parallelism) built-in
 ```
 
 **No keywords?** Claude still auto-detects:

package/docs/REFERENCE.md

@@ -9,7 +9,7 @@ Complete reference for oh-my-claudecode. For quick start, see the main [README.m
 - [Installation](#installation)
 - [Configuration](#configuration)
 - [Agents (32 Total)](#agents-32-total)
-- [Skills (35 Total)](#skills-35-total)
+- [Skills (37 Total)](#skills-37-total)
 - [Slash Commands](#slash-commands)
 - [Hooks System](#hooks-system)
 - [Magic Keywords](#magic-keywords)
@@ -195,7 +195,7 @@ Always use `oh-my-claudecode:` prefix when calling via Task tool.
 
 ---
 
-## Skills (35 Total)
+## Skills (37 Total)
 
 ### Core Skills
 
@@ -241,6 +241,10 @@ Always use `oh-my-claudecode:` prefix when calling via Task tool.
 | `release` | Automated release workflow | `/oh-my-claudecode:release` |
 | `mcp-setup` | Configure MCP servers | `/oh-my-claudecode:mcp-setup` |
 | `learn-about-omc` | Usage pattern analysis | `/oh-my-claudecode:learn-about-omc` |
+| `writer-memory` | Agentic memory system for writers | `/oh-my-claudecode:writer-memory` |
+| `project-session-manager` | Manage isolated dev environments (git worktrees + tmux) | `/oh-my-claudecode:project-session-manager` |
+| `local-skills-setup` | Set up and manage local skills | `/oh-my-claudecode:local-skills-setup` |
+| `skill` | Manage local skills (list, add, remove, search, edit) | `/oh-my-claudecode:skill` |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-claude-sisyphus",
-  "version": "3.8.9",
+  "version": "3.8.11",
   "description": "Multi-agent orchestration system for Claude Code - Inspired by oh-my-opencode",
   "type": "module",
   "main": "dist/index.js",

package/scripts/keyword-detector.mjs

@@ -134,6 +134,64 @@ ${originalPrompt}
 IMPORTANT: Invoke the skill IMMEDIATELY. Do not proceed without loading the skill instructions.`;
 }
 
+/**
+ * Create multi-skill invocation message for combined keywords
+ */
+function createMultiSkillInvocation(skills, originalPrompt) {
+  if (skills.length === 0) return '';
+  if (skills.length === 1) {
+    return createSkillInvocation(skills[0].name, originalPrompt, skills[0].args);
+  }
+
+  const skillBlocks = skills.map((s, i) => {
+    const argsSection = s.args ? `\nArguments: ${s.args}` : '';
+    return `### Skill ${i + 1}: ${s.name.toUpperCase()}
+Skill: oh-my-claudecode:${s.name}${argsSection}`;
+  }).join('\n\n');
+
+  return `[MAGIC KEYWORDS DETECTED: ${skills.map(s => s.name.toUpperCase()).join(', ')}]
+
+You MUST invoke ALL of the following skills using the Skill tool, in order:
+
+${skillBlocks}
+
+User request:
+${originalPrompt}
+
+IMPORTANT: Invoke ALL skills listed above. Start with the first skill IMMEDIATELY. After it completes, invoke the next skill in order. Do not skip any skill.`;
+}
+
+/**
+ * Resolve conflicts between detected keywords
+ */
+function resolveConflicts(matches) {
+  const names = matches.map(m => m.name);
+
+  // Cancel is exclusive
+  if (names.includes('cancel')) {
+    return [matches.find(m => m.name === 'cancel')];
+  }
+
+  let resolved = [...matches];
+
+  // Ecomode beats ultrawork
+  if (names.includes('ecomode') && names.includes('ultrawork')) {
+    resolved = resolved.filter(m => m.name !== 'ultrawork');
+  }
+
+  // Ultrapilot beats autopilot
+  if (names.includes('ultrapilot') && names.includes('autopilot')) {
+    resolved = resolved.filter(m => m.name !== 'autopilot');
+  }
+
+  // Sort by priority order
+  const priorityOrder = ['cancel','ralph','autopilot','ultrapilot','ultrawork','ecomode',
+    'swarm','pipeline','ralplan','plan','tdd','research','ultrathink','deepsearch','analyze'];
+  resolved.sort((a, b) => priorityOrder.indexOf(a.name) - priorityOrder.indexOf(b.name));
+
+  return resolved;
+}
+
 /**
  * Create proper hook output with additionalContext (Claude Code hooks API)
  * The 'message' field is NOT a valid hook output - use hookSpecificOutput.additionalContext
@@ -169,27 +227,20 @@ async function main() {
 
     const cleanPrompt = removeCodeBlocks(prompt).toLowerCase();
 
-    // Priority order: cancel > ralph > autopilot > ultrapilot > ultrawork > ecomode > swarm > pipeline > ralplan > plan > tdd > research > ultrathink > deepsearch > analyze
+    // Collect all matching keywords
+    const matches = [];
 
-    // Priority 1: Cancel (BEFORE other modes - clears states)
-    // Use specific keywords to avoid false positives from natural language
-    // (e.g., "don't let it stop the context" or URLs containing "cancel")
+    // Cancel keywords
     if (/\b(cancelomc|stopomc)\b/i.test(cleanPrompt)) {
-      // Special: clear state files instead of creating them
-      clearStateFiles(directory, ['ralph', 'autopilot', 'ultrapilot', 'ultrawork', 'ecomode', 'swarm', 'pipeline']);
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('cancel', prompt))));
-      return;
+      matches.push({ name: 'cancel', args: '' });
     }
 
-    // Priority 2: Ralph keywords
+    // Ralph keywords
     if (/\b(ralph|don't stop|must complete|until done)\b/i.test(cleanPrompt)) {
-      activateState(directory, prompt, 'ralph');
-      activateState(directory, prompt, 'ultrawork');
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ralph', prompt))));
-      return;
+      matches.push({ name: 'ralph', args: '' });
     }
 
-    // Priority 3: Autopilot keywords
+    // Autopilot keywords
     if (/\b(autopilot|auto pilot|auto-pilot|autonomous|full auto|fullsend)\b/i.test(cleanPrompt) ||
         /\bbuild\s+me\s+/i.test(cleanPrompt) ||
         /\bcreate\s+me\s+/i.test(cleanPrompt) ||
@@ -199,101 +250,131 @@ async function main() {
         /\bhandle\s+it\s+all\b/i.test(cleanPrompt) ||
         /\bend\s+to\s+end\b/i.test(cleanPrompt) ||
         /\be2e\s+this\b/i.test(cleanPrompt)) {
-      activateState(directory, prompt, 'autopilot');
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('autopilot', prompt))));
-      return;
+      matches.push({ name: 'autopilot', args: '' });
     }
 
-    // Priority 4: Ultrapilot
+    // Ultrapilot keywords
     if (/\b(ultrapilot|ultra-pilot)\b/i.test(cleanPrompt) ||
         /\bparallel\s+build\b/i.test(cleanPrompt) ||
         /\bswarm\s+build\b/i.test(cleanPrompt)) {
-      activateState(directory, prompt, 'ultrapilot');
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ultrapilot', prompt))));
-      return;
+      matches.push({ name: 'ultrapilot', args: '' });
     }
 
-    // Priority 5: Ultrawork keywords
+    // Ultrawork keywords
     if (/\b(ultrawork|ulw|uw)\b/i.test(cleanPrompt)) {
-      activateState(directory, prompt, 'ultrawork');
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ultrawork', prompt))));
-      return;
+      matches.push({ name: 'ultrawork', args: '' });
     }
 
-    // Priority 6: Ecomode keywords (includes "efficient")
+    // Ecomode keywords
     if (/\b(eco|ecomode|eco-mode|efficient|save-tokens|budget)\b/i.test(cleanPrompt)) {
-      activateState(directory, prompt, 'ecomode');
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ecomode', prompt))));
-      return;
+      matches.push({ name: 'ecomode', args: '' });
     }
 
-    // Priority 7: Swarm - parse N from "swarm N agents"
+    // Swarm - parse N from "swarm N agents"
     const swarmMatch = cleanPrompt.match(/\bswarm\s+(\d+)\s+agents?\b/i);
     if (swarmMatch || /\bcoordinated\s+agents\b/i.test(cleanPrompt)) {
-      const agentCount = swarmMatch ? swarmMatch[1] : '3'; // default 3
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('swarm', prompt, agentCount))));
-      return;
+      const agentCount = swarmMatch ? swarmMatch[1] : '3';
+      matches.push({ name: 'swarm', args: agentCount });
     }
 
-    // Priority 8: Pipeline
+    // Pipeline keywords
     if (/\b(pipeline)\b/i.test(cleanPrompt) || /\bchain\s+agents\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('pipeline', prompt))));
-      return;
+      matches.push({ name: 'pipeline', args: '' });
     }
 
-    // Priority 9: Ralplan keyword (before plan to avoid false match)
+    // Ralplan keyword
     if (/\b(ralplan)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ralplan', prompt))));
-      return;
+      matches.push({ name: 'ralplan', args: '' });
     }
 
-    // Priority 10: Plan keywords
+    // Plan keywords
     if (/\b(plan this|plan the)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('plan', prompt))));
-      return;
+      matches.push({ name: 'plan', args: '' });
     }
 
-    // Priority 11: TDD
+    // TDD keywords
     if (/\b(tdd)\b/i.test(cleanPrompt) ||
         /\btest\s+first\b/i.test(cleanPrompt) ||
         /\bred\s+green\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('tdd', prompt))));
-      return;
+      matches.push({ name: 'tdd', args: '' });
     }
 
-    // Priority 12: Research
-    // "research" alone OR "analyze data" OR "statistics" trigger research skill
+    // Research keywords
     if (/\b(research)\b/i.test(cleanPrompt) ||
         /\banalyze\s+data\b/i.test(cleanPrompt) ||
         /\bstatistics\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('research', prompt))));
-      return;
+      matches.push({ name: 'research', args: '' });
     }
 
-    // Priority 13: Ultrathink/think keywords (keep inline message)
+    // Ultrathink keywords
     if (/\b(ultrathink|think hard|think deeply)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify(createHookOutput(ULTRATHINK_MESSAGE)));
-      return;
+      matches.push({ name: 'ultrathink', args: '' });
     }
 
-    // Priority 14: Deepsearch (RESTRICTED patterns)
+    // Deepsearch keywords
     if (/\b(deepsearch)\b/i.test(cleanPrompt) ||
         /\bsearch\s+(the\s+)?(codebase|code|files?|project)\b/i.test(cleanPrompt) ||
         /\bfind\s+(in\s+)?(codebase|code|all\s+files?)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('deepsearch', prompt))));
-      return;
+      matches.push({ name: 'deepsearch', args: '' });
     }
 
-    // Priority 15: Analyze (RESTRICTED patterns)
+    // Analyze keywords
     if (/\b(deep\s*analyze)\b/i.test(cleanPrompt) ||
         /\binvestigate\s+(the|this|why)\b/i.test(cleanPrompt) ||
         /\bdebug\s+(the|this|why)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify(createHookOutput(createSkillInvocation('analyze', prompt))));
+      matches.push({ name: 'analyze', args: '' });
+    }
+
+    // No matches - pass through
+    if (matches.length === 0) {
+      console.log(JSON.stringify({ continue: true }));
       return;
     }
 
-    // No keywords detected
-    console.log(JSON.stringify({ continue: true }));
+    // Resolve conflicts
+    const resolved = resolveConflicts(matches);
+
+    // Handle cancel specially - clear states and emit
+    if (resolved.length > 0 && resolved[0].name === 'cancel') {
+      clearStateFiles(directory, ['ralph', 'autopilot', 'ultrapilot', 'ultrawork', 'ecomode', 'swarm', 'pipeline']);
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('cancel', prompt))));
+      return;
+    }
+
+    // Activate states for modes that need them
+    const stateModes = resolved.filter(m => ['ralph', 'autopilot', 'ultrapilot', 'ultrawork', 'ecomode'].includes(m.name));
+    for (const mode of stateModes) {
+      activateState(directory, prompt, mode.name);
+    }
+
+    // Special: Ralph with ultrawork (only if ecomode NOT present)
+    const hasRalph = resolved.some(m => m.name === 'ralph');
+    const hasEcomode = resolved.some(m => m.name === 'ecomode');
+    const hasUltrawork = resolved.some(m => m.name === 'ultrawork');
+    if (hasRalph && !hasEcomode && !hasUltrawork) {
+      activateState(directory, prompt, 'ultrawork');
+    }
+
+    // Handle ultrathink specially - prepend message instead of skill invocation
+    const ultrathinkIndex = resolved.findIndex(m => m.name === 'ultrathink');
+    if (ultrathinkIndex !== -1) {
+      // Remove ultrathink from skill list
+      resolved.splice(ultrathinkIndex, 1);
+
+      // If ultrathink was the only match, emit message
+      if (resolved.length === 0) {
+        console.log(JSON.stringify(createHookOutput(ULTRATHINK_MESSAGE)));
+        return;
+      }
+
+      // Otherwise, prepend ultrathink message to skill invocation
+      const skillMessage = createMultiSkillInvocation(resolved, prompt);
+      console.log(JSON.stringify(createHookOutput(ULTRATHINK_MESSAGE + skillMessage)));
+      return;
+    }
+
+    // Emit skill invocation(s)
+    console.log(JSON.stringify(createHookOutput(createMultiSkillInvocation(resolved, prompt))));
   } catch (error) {
     // On any error, allow continuation
     console.log(JSON.stringify({ continue: true }));

package/skills/help/SKILL.md

@@ -28,7 +28,7 @@ You can include these words naturally in your request for explicit control:
 | **ulw** | Max parallelism | "ulw refactor the API" |
 | **plan** | Planning interview | "plan the new endpoints" |
 
-**Combine them:** "ralph ulw: migrate the database"
+**ralph includes ultrawork:** When you activate ralph mode, it automatically includes ultrawork's parallel execution. No need to combine keywords.
 
 ## Stopping Things
 

package/skills/omc-setup/SKILL.md

@@ -511,7 +511,7 @@ Just include these words naturally in your request:
 | eco | Token-efficient mode | "eco refactor the API" |
 | plan | Planning interview | "plan the new endpoints" |
 
-Combine them: "ralph ulw: migrate the database"
+**ralph includes ultrawork:** When you activate ralph mode, it automatically includes ultrawork's parallel execution. No need to combine keywords.
 
 MCP SERVERS:
 Run /oh-my-claudecode:mcp-setup to add tools like web search, GitHub, etc.