ralph-loop

Automate iterative coding tasks with fresh context, filesystem memory, and git commits.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/Bradliebs/VolumeTurtle --skill ralph-loop-bradliebs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/Bradliebs/VolumeTurtle/tree/main/.github/skills/ralph-loop
Command: npx skills add https://github.com/Bradliebs/VolumeTurtle --skill ralph-loop-bradliebs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph Loop solves the problem of unstable, context-polluting task execution by delivering fresh context per iteration and using filesystem-based memory with git-backed versioning to track every change.

Core Features & Use Cases

  • Fresh context per iteration: Each executor runs with a clean slate to avoid cross-task contamination.
  • Filesystem-backed state: PRD.md and PROGRESS.md serve as persistent memory for planning and progress tracking.
  • Per-task commits and audits: Every completed task is committed, enabling granular rollback and traceability.
  • Phase-driven orchestration: Phase 0 planning, Phase 1 coordination, and Phase 2 completion ensure structured workflows.
  • Integration with CE workflows: Works with /lfg, /slfg, /ce-work, and /ce-review to automate compound tasks.

Quick Start

Run the Ralph loop with a task description to begin iterative task execution with fresh context.

Frequently Asked Questions about ralph-loop

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

FAQPage Schema
How do I automate iterative coding tasks without polluting the AI agent's context?

Automate iterative coding tasks with fresh context per iteration by using filesystem-based memory. This approach enforces a clean slate for each executor run, tracking progress in PRD.md and PROGRESS.md to avoid cross-task contamination.

What is the best way to track AI agent progress during multi-step development workflows?

Track AI agent progress during multi-step development workflows by using filesystem-backed state files. PRD.md and PROGRESS.md serve as persistent memory for planning and progress tracking, while git versioning commits every completed task for granular rollback.

How does phase-driven orchestration work for coding automation?

Phase-driven orchestration for coding automation structures workflows into Phase 0 planning, Phase 1 coordination, and Phase 2 completion. This enforces clear state files and per-task verification to ensure reliable completion and an auditable history.

Can I use git versioning to audit autonomous coding agent tasks?

You can use git versioning to audit autonomous coding agent tasks through per-task commits. Every completed task is committed automatically, enabling granular rollback and traceability for each iteration within the development workflow.

Do I need specific state files to start an autonomous coding loop?

You need clear state files like PRD.md and PROGRESS.md to start an autonomous coding loop. These files provide the persistent filesystem memory required for planning and progress tracking, ensuring each fresh context iteration executes reliably.

Why does my AI agent lose context during multi-step development workflows?

AI agents lose context during multi-step development workflows due to context pollution. Solving this requires enforcing fresh context per iteration and utilizing filesystem-based memory to maintain progress tracking without carrying over previous state data.