oh-my-claude-sisyphus 3.5.3 → 3.5.5

package/skills/ralplan/SKILL.md

@@ -3,269 +3,38 @@ name: ralplan
 description: Iterative planning with Planner, Architect, and Critic until consensus
 ---
 
-# Ralplan Skill
+# Ralplan Command
 
-## Overview
+**This is an alias for `/plan --consensus`**
 
-Ralplan orchestrates three specialized agents—Planner, Architect, and Critic—in an iterative loop until consensus is reached on a comprehensive work plan. This skill ensures plans are strategically sound, architecturally valid, and thoroughly reviewed before execution.
+Ralplan orchestrates three specialized agents—Planner, Architect, and Critic—in an iterative loop until consensus is reached on a comprehensive work plan.
 
-## The Planning Triad
+## Usage
 
-Three agents collaborate in structured phases to validate and refine work plans:
-
-| Agent | Role | Output |
-|-------|------|--------|
-| **Planner** | Strategic Planner | Creates/refines the work plan |
-| **Architect** | Strategic Advisor | Answers questions, validates architecture |
-| **Critic** | Ruthless Reviewer | Critiques and identifies gaps |
-
-## The Iteration Loop
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                       RALPLAN LOOP                              │
-│                                                                 │
-│    ┌──────────────┐                                             │
-│    │   PLANNER    │◄────────────────────────────────┐           │
-│    │   (Plans)    │                                 │           │
-│    └──────┬───────┘                                 │           │
-│           │                                         │           │
-│           ▼                                         │           │
-│    ┌──────────────┐     Questions?    ┌───────────┐ │           │
-│    │   Has open   │─────────────────► │ ARCHITECT │ │           │
-│    │  questions?  │                   │ (Advises) │ │           │
-│    └──────┬───────┘                   └─────┬─────┘ │           │
-│           │                                 │       │           │
-│           │ No questions                    │       │           │
-│           ▼                                 ▼       │           │
-│    ┌──────────────┐                  ┌──────────┐   │           │
-│    │    CRITIC    │◄─────────────────│ Answers  │   │           │
-│    │  (Reviews)   │                  └──────────┘   │           │
-│    └──────┬───────┘                                 │           │
-│           │                                         │           │
-│           ▼                                         │           │
-│    ┌──────────────┐     REJECT      ┌──────────────┐│           │
-│    │   Verdict?   │─────────────────►│  Feedback   ││           │
-│    └──────┬───────┘                  │ to Planner  │┘           │
-│           │                          └─────────────┘            │
-│           │ OKAY                                                │
-│           ▼                                                     │
-│    ┌──────────────────────────────────────────────────────────┐ │
-│    │                  PLAN APPROVED                           │ │
-│    │           Ready for /ralph execution                     │ │
-│    └──────────────────────────────────────────────────────────┘ │
-└─────────────────────────────────────────────────────────────────┘
 ```
-
-## State Management
-
-Ralplan maintains persistent state in `.omc/ralplan-state.json` to track progress and enable recovery across interruptions:
-
-```json
-{
-  "active": true,
-  "mode": "ralplan",
-  "iteration": 1,
-  "max_iterations": 5,
-  "plan_path": ".omc/plans/[feature].md",
-  "current_phase": "planner_planning",
-  "started_at": "ISO-timestamp",
-  "task_description": "[original task]"
-}
+/oh-my-claudecode:ralplan [task]
 ```
 
-**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
-
-The skill begins by establishing the planning environment:
-
-1. Create `.omc/plans/` directory if it doesn't exist
-2. Read task description from user input
-3. Create `ralplan-state.json` with initial values:
-   - `active: true`
-   - `iteration: 0`
-   - `max_iterations: 5`
-   - `current_phase: "planner_planning"`
-   - `started_at`: Current ISO timestamp
-   - `task_description`: User's task description
-
-### Planner Planning Phase
-
-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)
-
-The Architect provides strategic guidance in two scenarios:
-
-1. **After Planner**: If Planner raises architectural questions needing strategic input
-2. **After Critic rejection**: If Critic identifies questions requiring expert guidance
+## What It Does
 
-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.
+Invokes the plan skill with --consensus mode, which:
+1. Creates initial plan with Planner agent
+2. Consults Architect for architectural questions
+3. Reviews with Critic agent
+4. Iterates until Critic approves (max 5 iterations)
 
-### Critic Review (MANDATORY - CANNOT BE SKIPPED)
+## Implementation
 
-**CRITICAL: This phase MUST execute. The Critic is the gatekeeper for plan approval.**
+When this skill is invoked, immediately invoke the plan skill with consensus mode:
 
-Log at start: `[RALPLAN] Invoking Critic for plan review`
-
-The Critic examines the plan against quality standards:
-
-- Critic receives the plan file path (per its design)
-- 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:
-
-**If verdict is OKAY:**
-- Mark plan as approved
-- Log approval with iteration count
-- Prepare plan for execution with `/oh-my-claudecode:ralph` or manual orchestration
-- Set state `active: false, current_phase: "complete"`
-
-**If verdict is REJECT:**
-- Extract Critic feedback with specific issues
-- Increment iteration counter
-- If `iteration >= max_iterations` (5):
-  - Force approval with warning about unresolved concerns
-  - Recommend manual review before execution
-- Otherwise:
-  - Feed Critic feedback back to Planner
-  - Return to Planner Planning phase for refinement
-
-## Iteration Rules
-
-| Rule | Description |
-|------|-------------|
-| **Max 5 iterations** | Safety limit prevents infinite loops |
-| **Planner owns plan** | Only Planner writes to plan file |
-| **Architect provides wisdom** | Architect reads and advises, never modifies |
-| **Critic has final say** | Plan approved only when Critic signals OKAY |
-| **Feedback is specific** | Each rejection includes actionable improvements |
-| **State persists** | Progress survives session interruptions |
-
-## Quality Gates
-
-The orchestrator must verify these gates before invoking Critic for each review:
-
-1. **Plan file exists** at the path specified in state
-2. **File references are valid** - Verify all mentioned files exist in codebase
-3. **Acceptance criteria are concrete** - No vague "improve" or "optimize" without measurable metrics
-4. **No ambiguous language** - Each task clearly specifies what to do
-
-If any gate fails, return to Planner with specific failure feedback for remediation.
-
-## Agent Communication Protocol
-
-### Planner to Architect Questions
-
-```
-ARCHITECT_QUESTION:
-- Topic: [Architecture/Performance/Security/Pattern]
-- Context: [What we're planning]
-- Files to examine: [specific paths]
-- Specific Question: [What we need answered]
-```
-
-### Architect to Planner Answers
-
-```
-ARCHITECT_ANSWER:
-- Topic: [Matching topic]
-- Analysis: [What Architect found after reading files]
-- Recommendation: [Specific guidance]
-- Trade-offs: [What to consider]
-- References: [file:line citations from codebase]
 ```
-
-### Critic to Planner Feedback
-
+Invoke Skill: plan --consensus {{ARGUMENTS}}
 ```
-CRITIC_FEEDBACK:
-- Verdict: REJECT
-- Critical Issues:
-  1. [Issue with specific fix required]
-  2. [Issue with specific fix required]
-- Minor Issues:
-  1. [Nice to fix]
-- Questions for Architect (if any):
-  1. [Architectural question needing expert input]
-```
-
-## Cancellation
-
-To stop an active ralplan session:
-
-- 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 (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
+Pass all arguments to the plan skill. The plan skill handles all consensus logic, state management, and iteration.
 
-**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.
+## See Also
 
-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.
+- `/plan` - Base planning skill with all modes
+- `/plan --consensus` - Direct invocation of consensus mode
+- `/cancel` - Cancel active planning session

package/skills/research/SKILL.md

@@ -145,7 +145,7 @@ Pending stages: {{PENDING_STAGES}}
 1. **Max Iterations:** 10 (configurable)
 2. **Continue until:** Promise tag emitted OR max iterations
 3. **State tracking:** Persist after each stage completion
-4. **Cancellation:** `/cancel-research` or "stop", "cancel"
+4. **Cancellation:** `/oh-my-claudecode:cancel` or "stop", "cancel"
 
 ### AUTO Mode Example
 
@@ -480,7 +480,7 @@ Optional settings in `.claude/settings.json`:
 ## Cancellation
 
 ```
-/oh-my-claudecode:cancel-research
+/oh-my-claudecode:cancel
 ```
 
 Or say: "stop research", "cancel research", "abort"

package/skills/ultrapilot/SKILL.md

@@ -318,7 +318,7 @@ Optional settings in `.claude/settings.json`:
 ## Cancellation
 
 ```
-/oh-my-claudecode:cancel-ultrapilot
+/oh-my-claudecode:cancel
 ```
 
 Or say: "stop", "cancel ultrapilot", "abort"

package/skills/ultraqa/SKILL.md

@@ -107,7 +107,7 @@ Track state in `.omc/ultraqa-state.json`:
 
 ## Cancellation
 
-User can cancel with `/oh-my-claudecode:cancel-ultraqa` which clears the state file.
+User can cancel with `/oh-my-claudecode:cancel` which clears the state file.
 
 ## Important Rules
 

package/commands/cancel-autopilot.md

@@ -1,35 +0,0 @@
----
-description: Cancel active autopilot session
----
-
-# Cancel Autopilot
-
-[CANCELLING AUTOPILOT]
-
-You are cancelling the active autopilot session.
-
-## Action
-
-1. Call the cancel function to clean up state
-2. Report what was cancelled
-3. Show preserved progress
-
-## Steps
-
-1. Check if autopilot is active
-2. Clean up Ralph/UltraQA if active
-3. Preserve autopilot state for resume
-4. Report status
-
-## Arguments
-
-{{ARGUMENTS}}
-
-If `--clear` is passed, completely clear all state instead of preserving.
-
-## Output
-
-Report:
-- What phase was cancelled
-- What modes were cleaned up
-- How to resume

package/commands/cancel-ecomode.md

@@ -1,71 +0,0 @@
----
-description: Cancel active Ecomode mode (deprecated - use /oh-my-claudecode:cancel instead)
----
-
-# Cancel Ecomode
-
-[ECOMODE CANCELLED]
-
-**DEPRECATION NOTICE:** This command is deprecated. Use `/oh-my-claudecode:cancel` instead, which intelligently detects and cancels any active mode including ecomode.
-
-The unified cancel command is safer because it:
-- Checks if ecomode is linked to Ralph and handles both
-- Prevents orphaned state files
-- Provides consistent cancellation experience
-
-## Legacy Behavior
-
-If you still use this command, it will:
-
-1. Check if ecomode is linked to Ralph
-2. If linked → Warn and suggest using `/oh-my-claudecode:cancel-ralph`
-3. If standalone → Cancel ecomode only
-
-## Arguments
-
-{{ARGUMENTS}}
-
-## Recommended Action
-
-Use the unified cancel command:
-```
-/oh-my-claudecode:cancel
-```
-
-This will detect ecomode and cancel it properly, along with any linked modes.
-
-## Implementation
-
-If you must cancel ecomode directly:
-
-```bash
-# Check if linked to ralph
-LINKED=$(cat .omc/ecomode-state.json 2>/dev/null | jq -r '.linked_to_ralph // false')
-
-if [[ "$LINKED" == "true" ]]; then
-  echo "Warning: Ecomode is linked to Ralph."
-  echo "Use /oh-my-claudecode:cancel to cancel both modes."
-  exit 1
-fi
-
-# Cancel standalone ecomode
-mkdir -p .omc ~/.claude
-rm -f .omc/ecomode-state.json
-rm -f ~/.claude/ecomode-state.json
-
-echo "Ecomode cancelled. Token-efficient execution mode deactivated."
-```
-
-## Migration
-
-Replace:
-```bash
-/oh-my-claudecode:cancel-ecomode
-```
-
-With:
-```bash
-/oh-my-claudecode:cancel
-```
-
-The new unified cancel is smarter and safer.

package/commands/cancel-ralph.md

@@ -1,41 +0,0 @@
----
-description: Cancel active Ralph (and linked ultrawork if auto-activated)
----
-
-# Cancel Ralph
-
-[RALPH CANCELLED]
-
-Ralph has been cancelled. You MUST now deactivate the state files.
-
-## MANDATORY ACTION
-
-Execute this command to fully cancel ALL persistent modes:
-
-```bash
-mkdir -p .omc ~/.claude && \
-echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph"}' > .omc/ralph-state.json && \
-echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph", "linked_to_ralph": false}' > .omc/ultrawork-state.json && \
-echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph"}' > .omc/ralph-plan-state.json && \
-echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph"}' > ~/.claude/ralph-state.json && \
-echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph"}' > ~/.claude/ultrawork-state.json && \
-rm -f .omc/ralph-verification.json
-```
-
-After running this command, you are free to stop working. The persistent mode hook will no longer force continuation.
-
-## What Was Cancelled
-
-- **Ralph**: Self-referential completion loop
-- **Ultrawork**: Parallel execution mode (auto-activated with Ralph by default)
-- **Ralph Plan**: Iterative planning loop (if active via /ralplan)
-- **Verification State**: Any pending architect verification
-
-## Note on Linked Modes
-
-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.
-
-## To Start Fresh
-
-- `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)
-- `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)

package/commands/cancel-ultraqa.md

@@ -1,27 +0,0 @@
----
-description: Cancel active UltraQA cycling workflow
----
-
-# Cancel UltraQA
-
-[ULTRAQA CANCELLED]
-
-The UltraQA cycling workflow has been cancelled. Clearing state file.
-
-## MANDATORY ACTION
-
-Execute this command to cancel UltraQA:
-
-```bash
-mkdir -p .sisyphus && echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ultraqa"}' > .omc/ultraqa-state.json
-```
-
-After running this command, the QA cycling will stop.
-
-## To Start Fresh
-
-- `/oh-my-claudecode:ultraqa --tests` - Run until all tests pass
-- `/oh-my-claudecode:ultraqa --build` - Run until build succeeds
-- `/oh-my-claudecode:ultraqa --lint` - Run until no lint errors
-- `/oh-my-claudecode:ultraqa --typecheck` - Run until no type errors
-- `/oh-my-claudecode:ultraqa --custom "pattern"` - Run until pattern matches

package/commands/cancel-ultrawork.md

@@ -1,40 +0,0 @@
----
-description: Cancel active Ultrawork mode
----
-
-# Cancel Ultrawork
-
-[ULTRAWORK CANCELLED]
-
-The Ultrawork mode has been cancelled. Clearing state files.
-
-## MANDATORY ACTION
-
-**First**, check if ultrawork is linked to an active Ralph loop:
-
-```bash
-cat .omc/ultrawork-state.json 2>/dev/null | jq -r '.linked_to_ralph // false'
-```
-
-**If linked_to_ralph is true**: Use `/oh-my-claudecode:cancel-ralph` instead to cancel both Ralph and its linked Ultrawork.
-
-**Otherwise**, execute this command to cancel Ultrawork:
-
-```bash
-mkdir -p .omc && \
-echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ultrawork"}' > .omc/ultrawork-state.json && \
-echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ultrawork"}' > ~/.claude/ultrawork-state.json
-```
-
-After running this command, ultrawork mode will be deactivated and the HUD will update.
-
-## Note on Linked Modes
-
-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:
-- Use `/oh-my-claudecode:cancel-ralph` to cancel both modes
-- If you only cancel ultrawork, Ralph will continue but without parallel execution benefits
-
-## To Start Fresh
-
-- `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)
-- `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)