Skip to content
TakoAPI
Back to skills

better-ralph

by runeweaverstudios

Coding Agents & IDEs
512Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Run one Better Ralph iteration: PRD-driven autonomous coding.

Description

What This Skill Does

Better Ralph runs one iteration of a PRD-driven coding loop. It reads prd.json, picks the next incomplete user story by priority, implements it, runs quality checks, commits the result, marks the story passed, and appends a progress entry. Each invocation handles exactly one story.

It enforces one-story-per-commit discipline and blocks commits on failing checks, so the branch stays in a working state throughout development.

When to Use It

  • Working through a user story backlog one commit at a time
  • Keeping prd.json in sync with actual implementation progress
  • Enforcing a consistent commit message format across a feature branch
  • Resuming incremental development across multiple sessions with a progress log
  • Catching lint or test failures before they land in a commit

Example Workflow

INPUT

User asks: run better ralph

AGENT
  1. 1

    Read prd.json and check progress.txt for codebase patterns

  2. 2

    Find the highest-priority story where passes is false

  3. 3

    Check out the branch named in prd.json.branchName if not already on it

  4. 4

    Implement code satisfying all acceptanceCriteria for the selected story

  5. 5

    Run project quality commands (test, lint, typecheck) and stop if any fail

  6. 6

    Stage all changes and commit with message 'feat: [ID] - [Title]'

  7. 7

    Set the story's passes to true in prd.json and write the file

  8. 8

    Append a dated progress block to progress.txt

OUTPUT

Story US-001 committed; prd.json updated with passes=true; progress.txt appended with files changed and learnings

Installation

clawhub install runeweaverstudios/better-ralph

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links