ralph-init

Structure product requirements into user stories with acceptance criteria and priority ordering.

28|5|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/MeroZemory/oh-my-droid --skill ralph-init-merozemory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-init
Source: https://github.com/MeroZemory/oh-my-droid/tree/main/skills/ralph-init
Command: npx skills add https://github.com/MeroZemory/oh-my-droid --skill ralph-init-merozemory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill replaces ad-hoc planning with a formal PRD and progress log so ralph-loop tasks start with clear goals, acceptance criteria, and verifiable progress records.

Core Features & Use Cases

  • PRD scaffolding: Guides creation of .omd/prd.json that captures project, branch naming, descriptive summary, and user stories with acceptance criteria such as "Typecheck passes" and "Tests pass".
  • Story discipline: Enforces right-sized, independent stories ordered by priority so each can be completed and validated during a focused Ralph session.
  • Progress tracking: Writes .omd/progress.txt with start timestamps, pattern notes, and status markers, then prompts agents to begin /ralph-loop.
  • Use Case: Before kicking off an autonomous build request, product leads ask ralph-init to capably break a task into user stories and log the baseline progress expectations.

Quick Start

Use ralph-init to translate the active task into .omd/prd.json and .omd/progress.txt before launching the loop.

Frequently Asked Questions about ralph-init

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

FAQPage Schema
How do I structure product requirements into right-sized user stories for autonomous build runs?

Structuring product requirements into right-sized stories involves creating a formal PRD with acceptance criteria and priority ordering so autonomous build runs start with clear, verifiable goals. This skill scaffolds that process by generating the required project files.

What is the best way to track progress and log baseline expectations before launching a ralph-loop workflow?

Tracking progress before launching a ralph-loop workflow requires writing a progress log with start timestamps, pattern notes, and status markers. This establishes verifiable progress records that replace ad-hoc planning and track story completion.

How do I scaffold a PRD with acceptance criteria for a ralph-loop execution?

Scaffolding a PRD for ralph-loop execution involves creating a JSON file that captures the project, branch naming, summary, and user stories with acceptance criteria like passing typechecks and tests. This enforces story discipline and independent validation.

Can I use ralph-init to break down tasks for product leads preparing autonomous build requests?

Yes, product leads can use this tool to break down active tasks into ordered user stories and log baseline progress expectations before kicking off an autonomous build request. It ensures each story is right-sized and independent for focused sessions.

Do I need specific file formats to start product planning with ralph-init?

Product planning with this tool requires emitting specific JSON and TXT files in an .omd directory to store the PRD and progress log. These files capture user stories, acceptance criteria, and timestamps needed to begin the loop.