ralph-operations

Manage Ralph orchestration loops by analyzing diagnostic data and debugging loop behavior.

3.1k|286|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill ralph-operations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-operations
Source: https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/ralph-operations
Command: npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill ralph-operations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps operators manage Ralph orchestration loops by analyzing diagnostic data and debugging loop behavior.

Core Features & Use Cases

  • Monitor and diagnose Ralph loops
  • Inspect loop status, logs, and artifacts
  • Debug hat selection and backpressure
  • Perform post-mortem analysis to identify root causes
  • Use case: triage a stuck loop by listing active loops, viewing logs, and diffing state

Quick Start

Start by listing active loops and inspecting a loop with its ID, then view logs and diff state to understand issues. Example: ralph loops ralph loops diff <id> ralph loops logs <id> -f ralph loops stop <id>

Frequently Asked Questions about ralph-operations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a stuck Ralph orchestration loop?

To diagnose a stuck Ralph orchestration loop, list active loops, inspect loop logs, and diff state to understand the issue. Follow a structured workflow using commands to list, view logs, and stop loops for troubleshooting.

What is a Ralph loop post-mortem analysis and when do I need it?

A Ralph loop post-mortem analysis identifies root causes of orchestration failures by inspecting logs and artifacts. Perform this analysis after a loop stops or fails to understand what went wrong in the execution lifecycle.

How do I monitor backpressure in Ralph loops?

Monitor backpressure in Ralph loops by inspecting diagnostic data and loop status. Use commands to view logs and artifacts to detect when the system cannot handle incoming workload volume.

Can I view state diffs for active Ralph orchestration loops?

Yes, you can view state diffs for active Ralph orchestration loops. Use the diff command with a loop ID to compare current state against previous states, helping you debug hat selection and loop behavior.

What's the best way to triage Ralph loop issues using logs and worktree artifacts?

The best way to triage Ralph loop issues is reading worktree artifacts and streaming logs. Start by listing active loops, inspect a specific loop with its ID, then view logs and diff state to pinpoint the failure.

Why does my Ralph loop fail during hat selection and how do I debug it?

Ralph loops may fail during hat selection due to state corruption or backpressure. Debug by inspecting diagnostic data, viewing logs, and diffing loop state to identify where the selection process broke down.