ralph-plan

Generate a structured JSON state file from user goals for Ralph automation loops.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph planning sessions save time and reduce miscommunication by interactively gathering requirements, designing tasks, and producing a reproducible state file for Ralph's implementation loop.

Core Features & Use Cases

  • Interactive context gathering across phases, with explicit approvals at the end of each phase.
  • Automatic generation of a structured state descriptor that encodes tasks, acceptance criteria, and iteration controls for /ralph usage.
  • Guardrails to enforce phase boundaries and prevent implementation before plan completion.

Quick Start

Provide a task description to begin an interactive planning session that guides you through requirements, design, and a state file for Ralph.

Frequently Asked Questions about ralph-plan

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

FAQPage Schema
What is interactive task decomposition for software automation?▼

Interactive task decomposition breaks down software automation goals into structured phases with explicit approvals, generating a reproducible JSON state file that encodes tasks and acceptance criteria for implementation loops.

How do I generate a structured state file for automation planning?▼

You generate a structured state descriptor by providing a task description to start an interactive session that gathers context across phases and outputs a JSON file encoding tasks, acceptance criteria, and iteration controls.

Can I enforce phase boundaries and prevent implementation before plan completion?▼

Yes, you can enforce phase boundaries and prevent implementation before plan completion using built-in guardrails that require explicit approvals at the end of each planning phase before allowing downstream automation execution.

Does Claude Code support interactive context gathering for reproducible plans?▼

Claude Code supports interactive context gathering by guiding users through phase-gated design sessions, capturing requirements interactively to produce a reproducible JSON state descriptor for automation workflows.

What is the best way to automate upfront planning for AI workflow task decomposition?▼

The best way to automate upfront planning for AI workflows is to use a phase-structured approach that interactively gathers requirements, designs tasks, and outputs a JSON state file encoding iteration controls for automation loops.

Why does my automation loop fail without a reproducible state file?▼

Automation loops fail without a reproducible state file because they lack structured tasks, acceptance criteria, and iteration controls, causing miscommunication and preventing phase-gated execution of the implementation plan.