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.