skills.rest
hg-pyun
hg-pyunCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

ralph

Execute PRD-defined tasks through TDD, verification, and cleanup loops.

2|Updated Feb 26, 2026
Search Tags:#task management#TDD#verification#cleanup#PRD-driven
One-click install
npx skills add https://github.com/hg-pyun/claude-code-marketplace --skill ralph-hg-pyun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/hg-pyun/claude-code-marketplace/tree/main/plugins/dev-tools/skills/ralph
Command: npx skills add https://github.com/hg-pyun/claude-code-marketplace --skill ralph-hg-pyun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users drive complex tasks to completion by structuring work into stories, enforcing TDD practices, and providing verification and cleanup at each step.

Core Features & Use Cases

  • PRD-Driven Persistence Loop: Manages tasks defined in PRD files, ensuring each story is verified and approved before moving on.
  • TDD Enforcement: Ensures tests are written before production code, improving code quality and reducing defects.
  • Verification and Cleanup: Provides verification by the verifier agent, code cleanup by the code-simplifier, and regression testing to ensure stability.
  • Use Case: Ideal for complex projects where multiple independently verifiable stories need to be completed according to a PRD.

Quick Start

To run the 'ralph' skill, simply say "ralph" or use the command "/ralph".

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate PRD-driven tasks using TDD and verification loops?▼

PRD-driven task automation uses a loop of TDD, verification, and cleanup to drive stories to completion. It requires a .dt-handoff/ directory containing prd.json and plan.md files to structure execution and ensure each story is verified before moving on.

What is the best way to enforce TDD practices for complex project stories?▼

Enforcing TDD practices for complex stories requires ensuring tests are written before production code. This is achieved by structuring work into independently verifiable stories and running regression testing to ensure stability at each step.

Do I need a PRD file to run task management and verification loops?▼

Yes, a PRD file is required to run task management and verification loops. You must create a .dt-handoff/ directory containing both prd.json and plan.md files to define the tasks before execution begins.

Does PRD-driven task execution automatically commit code or create pull requests?▼

PRD-driven task execution does not automatically commit code or create pull requests. It focuses purely on the loop of TDD, verification, and cleanup, leaving version control actions like commits and PRs to the user.

How does code cleanup and regression testing work during task verification?▼

Code cleanup and regression testing work by utilizing a code-simplifier agent to refactor code and a verifier agent to check stability. This ensures each story is approved and cleaned up before the next one begins.

Related Skills

Explore More Software Engineering Skills→
buihuulocbuihuuloc

ralph-plan

Guide interactive task planning for the Ralph CLI with structured questions.

Community
Intermediate
navidemadnavidemad

publish

Generate conventional commit messages and GitHub pull request descriptions.

Community
Intermediate
liamtran96liamtran96

test-driven-development

Enforce a red-green-refactor cycle by writing failing tests before production code.

Community
Basic
MikisbellMikisbell

sdd-apply

Implement code from specifications and design documents for development tasks.

Community
Advanced