Oh-my-codex ralph-init

Initialize a PRD (Product Requirements Document) for structured ralph-loop execution

install

source · Clone the upstream repo

git clone https://github.com/Yeachan-Heo/oh-my-codex

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/Yeachan-Heo/oh-my-codex "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ralph-init" ~/.claude/skills/yeachan-heo-oh-my-codex-ralph-init && rm -rf "$T"

manifest: skills/ralph-init/SKILL.md

source content

Ralph Init

Initialize a PRD (Product Requirements Document) for structured ralph-loop execution. Creates a structured requirements document that Ralph can use for goal-driven iteration.

Usage

/ralph-init "project or feature description"

Behavior

Gather requirements via interactive interview or from the provided description
Create PRD at
```
.omx/plans/prd-{slug}.md
```
with:
- Problem statement
- Goals and non-goals
- Acceptance criteria (testable)
- Technical constraints
- Implementation phases
Link to Ralph so that
```
/ralph
```
can use the PRD as its completion criteria
Initialize/ensure canonical progress ledger at
```
.omx/state/{scope}/ralph-progress.json
```
(session scope if active session exists)

Canonical source contract

Canonical PRD source of truth is
```
.omx/plans/prd-{slug}.md
```
.
Ralph progress source of truth is
```
.omx/state/{scope}/ralph-progress.json
```
(session scope when available).
During the current compatibility window, Ralph
```
--prd
```
startup still validates machine-readable story state from
```
.omx/prd.json
```
.
Legacy
```
.omx/prd.json
```
/
```
.omx/progress.txt
```
inputs migrate one-way into canonical artifacts, but canonical PRD markdown is not yet the startup validation source for
```
omx ralph --prd ...
```
.

Output

A structured PRD file saved to

.omx/plans/

that serves as the definition of done for Ralph execution.

Next Steps

After creating the PRD, start execution with:

/ralph "implement the PRD"

Ralph will iterate until all acceptance criteria in the PRD are met and architect-verified.