ralph-loop

Orchestrate autonomous coding tasks through iterative read-plan-execute-lint-test-fix loops until acceptance criteria pass.

1|Updated May 7, 2026
One-click install
npx skills add https://github.com/wesleysimplicio/simplicio-mapper --skill ralph-loop-wesleysimplicio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/wesleysimplicio/simplicio-mapper/tree/main/.skills/ralph-loop
Command: npx skills add https://github.com/wesleysimplicio/simplicio-mapper --skill ralph-loop-wesleysimplicio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Loop autônomo de coding (read → plan → execute → lint → unit → e2e → fix → repeat) until DoD verde. This pattern standardizes every technical task with measurable acceptance criteria across the project, reducing context switching and manual coordination.

Core Features & Use Cases

  • A defined sequence that moves from reading context and requirements to planning, executing changes, linting, unit testing, and end-to-end validation.
  • Iterative loop until the DoD is green, ensuring quality gates are satisfied before closing tasks.
  • Structured collaboration with subagents and explicit status reporting to enable traceability.

Quick Start

Initiate the loop by issuing an objective to start the Read→Plan→Execute→Lint→Unit→E2E→Fix→Repeat cycle.

Frequently Asked Questions about ralph-loop

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

FAQPage Schema
How do I automate coding tasks with an iterative loop until acceptance criteria pass?

Autonomous coding loops automate technical tasks by following a fixed sequence—read, plan, execute, lint, unit test, e2e test, fix, and repeat—until the Definition of Done is green. This standardizes task execution and reduces manual coordination.

What is the best way to structure autonomous coding workflows with subagents?

Structured autonomous coding workflows orchestrate subagents through explicit status reporting and task decomposition, enabling parallel agent collaboration and traceability across iterative development cycles until quality gates are satisfied.

Can I use an automated planning and testing loop for tasks with measurable acceptance criteria?

Yes, automated planning and testing loops are designed for technical tasks with measurable acceptance criteria. They enforce quality gates like linting, unit testing, and end-to-end validation before allowing a pull request to complete.

How does an autonomous coding loop handle linting and end-to-end validation?

Autonomous coding loops integrate linting and end-to-end validation as mandatory steps within each iteration. If validation fails, the loop automatically triggers a fix phase and repeats the cycle until all strict exit criteria are met.

When should I use an autonomous loop for task decomposition instead of manual coding?

Use an autonomous loop when technical tasks have clear, measurable acceptance criteria and require automated planning, parallel agent collaboration, and strict exit validation. It reduces context switching compared to manual coordination for complex coding workflows.

Does an autonomous coding loop require defined exit criteria before completing a pull request?

Yes, an autonomous coding loop enforces strict exit criteria, requiring the Definition of Done to be green. It ensures all linting, unit tests, and end-to-end checks pass before completing and submitting a pull request.