Metis Ralph Plugin Help

Please explain the following to the user:

What is Metis Ralph?

Metis Ralph integrates the Ralph Wiggum technique with Metis document management for iterative AI-driven work loops.

Two modes:

1. Task Execution (/metis-ralph) - Execute a Metis task iteratively until complete
2. Initiative Decomposition (/metis-decompose) - Break down an initiative into tasks

Core concept:

• Claude receives a Metis document as the prompt
• Works on the task/decomposition
• Stop hook intercepts exit attempts
• Same prompt fed back for next iteration
• Claude sees previous work in files
• Continues until genuinely complete

Available Commands

/metis-ralph <SHORT_CODE> [OPTIONS]

Execute a Metis task with a Ralph loop.

Usage:

/metis-ralph PROJ-T-0001
/metis-ralph PROJ-T-0001 --max-iterations 20

What happens:

1. Task content read from Metis
2. Task transitioned to "active"
3. Claude works on implementation
4. Loop continues until complete
5. Task transitioned to "completed"

Completion: Output <promise>TASK COMPLETE</promise> after transitioning to completed.

---

/metis-decompose <SHORT_CODE> [OPTIONS]

Decompose a Metis initiative into tasks.

Usage:

/metis-decompose PROJ-I-0001
/metis-decompose PROJ-I-0001 --max-iterations 15

What happens:

1. Initiative content read from Metis
2. Initiative transitioned to "decompose"
3. Claude analyzes and creates tasks
4. Loop continues until decomposition complete
5. Initiative transitioned to "active"

Completion: Output <promise>DECOMPOSITION COMPLETE</promise> after transitioning to active.

---

/cancel-metis-ralph

Cancel an active Metis Ralph loop.

Usage:

/cancel-metis-ralph

Note: This removes the loop state but does NOT revert Metis document phase transitions.

---

Options

Option	Description
--max-iterations <n>	Stop after N iterations (default: unlimited)
--project-path <path>	Path to .metis folder (default: auto-detect)

When to Use

Good for:

• Tasks with clear success criteria
• Iterative work (getting tests to pass)
• Systematic initiative breakdown
• Autonomous execution with Metis tracking

Not good for:

• Tasks requiring human judgment
• Exploratory work
• One-shot operations