docs: add Ralph Loop tutorial for multi-model iterative development

[blackgirlbytes]

Summary

Adds a tutorial for the Ralph Loop pattern - an iterative development workflow with fresh context per iteration and cross-model review.

What is Ralph Loop?

Based on Geoffrey Huntley's Ralph Wiggum technique, this pattern:

• Runs goose in a loop until the task is complete
• Each iteration gets fresh context (no accumulated garbage from failed attempts)
• A different model reviews the work before shipping
• Uses file I/O as state rather than conversation history

Tutorial covers

• Why Ralph Loop (problem with accumulated context)
• How it works (work phase → review phase → SHIP or REVISE)
• Setup (3 files: bash wrapper + 2 recipes)
• Usage examples
• Environment variables for customization
• State files explanation
• Comparison with Lead/Worker mode

Files

• documentation/docs/tutorials/ralph-loop.md

[github-actions]

PR Preview Action v1.6.3
Preview removed because the pull request was closed.
2026-01-13 20:22 UTC

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 3

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)
✅ Recipe 3: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[Copilot]

Pull request overview

This PR adds a comprehensive tutorial for the Ralph Loop pattern, an iterative development workflow that uses fresh context per iteration and cross-model review. The tutorial is based on Geoffrey Huntley's Ralph Wiggum technique and includes a bash orchestration script, two YAML recipe files, and extensive documentation.

Changes:

• Adds bash wrapper script (ralph-loop.sh) that orchestrates work/review cycles
• Adds two YAML recipes defining worker and reviewer phases
• Adds comprehensive tutorial documentation with examples and setup instructions

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
documentation/src/pages/recipes/data/recipes/ralph-loop.sh	Bash orchestration script managing iteration cycles, model configuration, and state files
documentation/src/pages/recipes/data/recipes/ralph-work.yaml	YAML recipe defining the work phase with instructions for the worker model
documentation/src/pages/recipes/data/recipes/ralph-review.yaml	YAML recipe defining the review phase with instructions for the reviewer model
documentation/docs/tutorials/ralph-loop.md	Tutorial documentation covering setup, usage, and examples of the Ralph Loop pattern

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[github-actions]

🔍 Recipe Security Scan Results

✅ Status: APPROVED - All recipes passed security scan

📊 Scan Summary:

• Total recipes scanned: 2

📋 Individual Recipe Results:
✅ Recipe 1: APPROVED (LOW risk)
✅ Recipe 2: APPROVED (LOW risk)

🔗 View detailed scan results in the workflow artifacts.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.