ralph

Automates PRD-to-code execution via a four-step pipeline with TDD and Docker.

131|30|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/TheCraigHewitt/skills --skill ralph-thecraighewitt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/TheCraigHewitt/skills/tree/main/coding/ralph
Command: npx skills add https://github.com/TheCraigHewitt/skills --skill ralph-thecraighewitt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires claude, gh, docker.

What problem does it solve?

Automates end-to-end PRD-to-code execution by orchestrating a four-step coding workflow and enabling autonomous iteration driven by GitHub issues, tests, and code reviews.

Core Features & Use Cases

  • Orchestrates a four-step pipeline (grill-me → write-a-prd → prd-to-issues → ralph) to transform PRDs into actionable sub-issues and code.
  • TDD-driven iteration with a code review gate and Docker sandbox isolation to ensure quality and safe execution.
  • Works with GitHub Issues and PR workflows to accelerate delivery in team environments.

Quick Start

Start the RALPH loop by running the ralph-once.sh script with a PRD number to perform a single iteration.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate PRD-to-code execution with TDD?

Automated PRD-to-code execution with TDD uses a structured pipeline to transform product requirements into actionable GitHub issues, iterating through test-driven development and code reviews. It orchestrates the entire workflow from requirement refinement to containerized code implementation.

How does the PRD-to-issues workflow handle automated code generation?

The PRD-to-issues workflow handles automated code generation by breaking down product requirements into sub-issues, then executing TDD-driven iterations within a Docker sandbox. A code review gate ensures quality before changes are finalized in the repository.

Can I run autonomous coding loops using GitHub issues and Docker?

Yes, autonomous coding loops can run using GitHub issues and Docker. The workflow orchestrates iterations triggered by GitHub issues, executing code generation and tests in isolated Docker containers to ensure safe, automated delivery.

What is the best way to structure a TDD pipeline for automated code reviews?

Structuring a TDD pipeline for automated code reviews involves a four-step process: refining requirements, writing a PRD, converting it to issues, and executing TDD iterations. A code review gate validates tests before merging changes.

Do I need Claude and GitHub CLI to automate software engineering workflows?

Yes, automating software engineering workflows with this approach requires Claude and the GitHub CLI. These dependencies enable the orchestration of PRD-to-code pipelines, issue management, and automated TDD-driven iterations.

Why use Docker sandbox isolation for autonomous code generation?

Docker sandbox isolation is used for autonomous code generation to ensure safe execution. It provides a contained environment for running tests and code iterations, preventing unintended side effects on the host system during the automated TDD workflow.