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.