ralph-supervisor

Supervise Claude and Codex coding loops with Git-backed validation gates.

729|67|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/joelhooks/swarm-tools --skill ralph-supervisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-supervisor
Source: https://github.com/joelhooks/swarm-tools/tree/main/packages/opencode-swarm-plugin/claude-plugin/skills/ralph-supervisor
Command: npx skills add https://github.com/joelhooks/swarm-tools --skill ralph-supervisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph Supervisor Pattern addresses context drift and unstable AI sessions by introducing fresh context per iteration, git-backed persistence, and a structured validation flow.

Core Features & Use Cases

  • Fresh context per iteration: Each Codex session starts clean to prevent drift and stale assumptions.
  • Git-backed persistence: Completed work is committed and tracked over time for traceability.
  • Validation gates: Each iteration requires verification before progression to ensure quality.
  • Learnings carry forward: Outcomes inform future iterations and improvements through a lightweight memory of results.

Quick Start

Initialize a Ralph session with ralph_init, add a story with ralph_story, then run iterations using ralph_loop or ralph_iterate, and finally review results with ralph_review.

Frequently Asked Questions about ralph-supervisor

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

FAQPage Schema
How do I prevent context drift when running autonomous coding loops?

To prevent context drift in autonomous coding loops, you can apply a pattern that starts each iteration with a fresh context. This approach resets the AI's working memory to eliminate stale assumptions and stabilize long-running development sessions.

What is the best way to persist progress between automated coding sessions?

The best way to persist progress between automated coding sessions is using Git-backed persistence. This approach commits completed work after every iteration, ensuring traceability and allowing you to track outcomes over time without losing state.

How do validation gates work in an iterative AI development workflow?

Validation gates work by requiring verification of the generated code before progression to the next iteration. This structured flow ensures that each automated coding cycle meets quality standards before the AI supervisor allows further development.

Can I supervise an autonomous coding loop using a dual AI agent setup?

Yes, you can supervise an autonomous coding loop using a dual agent setup where one AI acts as the supervisor and another as the executor. This pattern applies to iterative development tasks, coordinating context refreshes and automated reviews.

How do I get started with automating an iterative coding loop?

To get started with automating an iterative coding loop, initialize a session, add your development story, run the iteration loop, and finally review the results. This workflow applies validation gates and persists progress via Git.

Why does my AI coding session lose track of previous learnings over time?

Your AI coding session loses track of learnings over time due to context drift in long-running sessions. You can solve this by applying a lightweight memory system that carries outcomes forward to inform and improve future iterations.