ralph-init

Generate a canonical PRD and initialize Ralph progress tracking.

3|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Tienching/oh-my-codebuddy --skill ralph-init-tienching
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-init
Source: https://github.com/Tienching/oh-my-codebuddy/tree/main/skills/ralph-init
Command: npx skills add https://github.com/Tienching/oh-my-codebuddy --skill ralph-init-tienching

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to define and initialize Ralph-loop planning by generating a canonical PRD and wiring up progress tracking, ensuring a single source of truth for goal-driven iterations.

Core Features & Use Cases

  • Generate a canonical PRD at .omb/plans/prd-{slug}.md detailing the problem, goals, non-goals, acceptance criteria, and constraints.
  • Initialize Ralph progress ledger at .omb/state/{scope}/ralph-progress.json to track milestones and progress across sessions.
  • Link the PRD to Ralph so that Ralph can consume the PRD as its completion criteria and guidance for iteration.

Quick Start

Provide a project or feature description to create a canonical PRD and initialize Ralph's progress ledger.

Frequently Asked Questions about ralph-init

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

FAQPage Schema
How do I initialize a PRD to drive iterative planning loops?

To initialize a PRD for iterative planning, provide a feature description to generate a canonical PRD at .omb/plans/prd-{slug}.md and link it to your execution loop as completion criteria.

What is a canonical PRD and when do I need one for iteration tracking?

A canonical PRD is a structured document defining goals, non-goals, acceptance criteria, and constraints. You need one when starting a new iteration to ensure a single source of truth for goal-driven execution.

How do I track progress across sessions for an active iteration?

You track iteration progress by initializing a progress ledger at .omb/state/{scope}/ralph-progress.json, which logs milestones and tracks execution status persistently across multiple sessions.

Can I use this to structure goals and constraints from a raw feature description?

Yes, you can use a raw feature description as input. The skill gathers requirements from your text and structures them into formal goals, constraints, and acceptance criteria within the canonical PRD artifact.

Do I need any specific dependencies to set up canonical planning artifacts?

No specific dependencies are required to set up canonical planning artifacts. The skill directly enforces the creation of the PRD and progress ledger files without external component prerequisites.

What limitations exist when linking a PRD to an execution loop?

The PRD linkage depends on the execution loop consuming the .omb/plans/prd-{slug}.md file as its guidance. If the execution loop cannot read this canonical artifact format, the iteration tracking will not function.