ralph

Generate specs, implementation plans, prompts, and loop scripts for iterative development.

15|1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/hmemcpy/ralph-wiggum --skill ralph-hmemcpy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/hmemcpy/ralph-wiggum/tree/main/agents/ralph
Command: npx skills add https://github.com/hmemcpy/ralph-wiggum --skill ralph-hmemcpy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Ralph Planning Skill reduces friction in AI-driven development by coordinating clarifying questions, plan generation, and artifact creation (specs, implementation plans, prompts, and loop scripts) in a single, repeatable flow.

Core Features & Use Cases

  • Clarifying-question interview flow with A/B/C/D options to define scope and validation
  • Automatic generation of specs, implementation plans, and loop infrastructure
  • Creation of planning/build prompts (PROMPT_plan.md, PROMPT_build.md) and loop script (loop.sh)
  • Optional Oracle review step to analyze architecture before planning
  • Compatible with multiple agents (e.g., Amp, Claude Code) to orchestrate iterative tasks

Quick Start

Use the skill to kick off an interactive planning session. Run /skill ralph [optional/path/to/plan.md] to base the plan on a provided plan file or the current conversation context. The skill will generate the necessary artifacts and a reusable loop for iterative development.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I generate an implementation plan and specs for AI agent development?

Ralph automates interactive planning by collecting requirements through clarifying questions, then generates specs, implementation plans, and build prompts in a single workflow. Run `/skill ralph` to start an interactive session that outputs structured artifacts for iterative AI development.

Can I use Ralph to orchestrate loop infrastructure for autonomous AI tasks?

Yes. Ralph creates repeatable loop scripts and infrastructure artifacts—including planning and build prompts—designed to coordinate multiple agents like Amp and Claude Code across iterative development cycles. The generated loop.sh enables autonomous iteration without manual intervention.

What's the fastest way to move from requirements to a ready-to-run development loop?

Ralph condenses requirements gathering, spec generation, and loop assembly into one flow. Provide optional context via a plan.md file or conversation, and Ralph delivers all artifacts—specs, implementation plans, prompts, and executable loop scripts—immediately.

Does Ralph work with existing AI agents, or only specific platforms?

Ralph is agent-agnostic and designed to work with multiple agents including Amp and Claude Code. It generates metadata-driven artifacts and loop infrastructure compatible with any agent, making it flexible across different iterative development setups.

What happens during the clarifying-question phase in Ralph's planning flow?

Ralph presents A/B/C/D option sets to interactively narrow scope, define validation criteria, and lock in requirements before artifact generation. This structured interview ensures the generated specs and plans align with your actual development constraints.

Can I review the architecture before Ralph generates plans and prompts?

Yes. Ralph includes an optional Oracle review step that analyzes your architecture before proceeding to plan and artifact generation, letting you validate the approach before committing to the full workflow.