better-ralph

name	better-ralph
description	Run one Better Ralph iteration: PRD-driven autonomous coding. Read prd.json, pick next story, implement it, run checks, commit, mark story passed, append progress. Uses only standard OpenClaw tools (read, write, exec, git). Triggers on: run better ralph, better ralph iteration, do one ralph story, next prd story, ralph loop.
user-invocable	true

Better Ralph – One Iteration (OpenClaw)

Execute one iteration of the Better Ralph workflow: pick the next PRD story, implement it, run quality checks, commit, update the PRD, and append progress. Uses only standard tools (read_file, write_file, edit, exec, git). No external runner or Aether-Claw required.

---

When to Use

• User says: "run better ralph", "do one better ralph iteration", "next prd story", "ralph loop", "implement next story from prd".
• Project has a prd.json in the workspace root (see Output Format below for schema).

---

One-Iteration Workflow

Do these steps in order. Use only your standard file, exec, and git tools.

1. Read state

• Read prd.json (workspace root). Parse the JSON.
• Read progress.txt if it exists. If it has a section ## Codebase Patterns near the top (up to the next ## or end of file), use that as context for implementation patterns. Otherwise proceed without it.

2. Pick the next story

• From prd.json.userStories, find all with passes === false.