ralph

Manage task graphs and acceptance criteria for autonomous research loops.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/khides/research-boilerplate --skill ralph-khides
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/khides/research-boilerplate/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/khides/research-boilerplate --skill ralph-khides

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph automates autonomous iterative research loops by managing a task graph and acceptance criteria to drive end-to-end execution in self-contained projects and experiments.

Core Features & Use Cases

  • Plan-driven workflow: interactive planning via /ralph-plan and autonomous execution via /ralph.
  • Skip-plan workflow: directly run /ralph with a prompt to start the loop.
  • State management and hooks: uses per-session state files and Claude Code hooks to coordinate tasks and verify outcomes.

Quick Start

Start by running /ralph-plan with your task to generate a state and then run /ralph to execute the autonomous loop.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate iterative research loops with task graph management?

Automating iterative research loops is done by managing a task graph and acceptance criteria to drive end-to-end execution. You can use interactive planning commands to generate a state file before running the autonomous execution loop for long-running research tasks.

What is an autonomous research loop and how does it work?

An autonomous research loop executes long-running tasks across software, data analysis, and documentation workflows by continuously iterating. It enforces pre- and post-tool checks and uses session-based state files to coordinate task execution and verify outcomes.

How do I start an autonomous workflow directly without interactive planning?

To start an autonomous workflow without interactive planning, use the skip-plan workflow by directly running the execution command with your prompt. This immediately starts the iterative loop and manages the task graph without generating a separate plan first.

Does the autonomous research workflow enforce quality gates like linting and tests?

Yes, the autonomous research workflow enforces quality gates like linting and tests before completion. It integrates with Claude Code hooks to execute pre- and post-tool checks, guaranteeing that acceptance criteria are met throughout the task graph execution.

Can I use this autonomous task graph workflow for data analysis and documentation?

Yes, you can use this workflow for data analysis and documentation, as its scope explicitly covers these domains alongside software tasks. It drives end-to-end execution across self-contained projects and experiments using state management.

What are the limitations of skip-plan autonomous runs for long-running research tasks?

Skip-plan autonomous runs skip interactive planning, meaning you bypass generating a structured state file beforehand. For complex long-running research tasks, this lack of initial plan-driven coordination may reduce task graph visibility and outcome verification.