ralph

Loop task execution until an architect verifies completion.

Updated Jul 3, 2025
One-click install
npx skills add https://github.com/andrew-t-james/dotfiles --skill ralph-andrew-t-james
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/andrew-t-james/dotfiles/tree/main/dot_codex/skills/ralph
Command: npx skills add https://github.com/andrew-t-james/dotfiles --skill ralph-andrew-t-james

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates a persistence loop that keeps working on a task until it is fully complete and architect-verified, preventing silent incompletion.

Core Features & Use Cases

  • Persistence across iterations with automatic retries on failure
  • Parallel delegation to specialist agents with explicit sign-off for completion
  • Built-in state management and guardrails to require architect verification before finishing
  • Suitable for multi-step tasks that span sessions and tools

Quick Start

Initiate the Ralph loop with your task and allow it to persistently iterate until the task is architect-verified as complete.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I guarantee task completion for long-running, multi-step automation workflows?

To guarantee task completion, you can use a persistence loop that continuously executes a multi-step workflow until an architect formally verifies the final output, preventing silent incompletion and enforcing sign-off.

What is an architect-verified persistence loop in automation agents?

An architect-verified persistence loop is an execution policy where automation agents iterate on a task, persist context across sessions, and require explicit sign-off from an architect role before reporting the task as complete.

How do I automate retries and state management for workflows that span multiple sessions?

Automate retries and state management by implementing a persistence loop with built-in guardrails that handle background runs for lengthy operations and maintain context persistence across iterations until verification succeeds.

Can I use parallel delegation with specialist agents and still require formal sign-off?

Yes, parallel delegation to specialist agents can be combined with explicit sign-off requirements, allowing tasks to be distributed while an architect verifies the aggregated results before final completion.

What's the best way to prevent silent incompletion in complex automated workflows?

The best way to prevent silent incompletion is to enforce an execution policy that loops task execution until verified by an architect, ensuring automatic retries on failure and requiring formal verification prior to reporting completion.

When should I use a verification loop with escalation for task automation?

Use a verification loop with escalation when managing multi-step tasks that require persistence across sessions, parallel delegation, and formal sign-off, especially when lengthy operations need background runs and explicit context persistence.