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

blackgirlbytes · 2026-01-12T23:01:21Z

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 · 2026-01-12T23:06:11Z

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

github-actions · 2026-01-13T03:39:19Z

🔍 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 · 2026-01-13T04:55:17Z

🔍 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 · 2026-01-13T11:18:17Z

🔍 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 · 2026-01-13T11:41:54Z

🔍 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 · 2026-01-13T12:43:07Z

🔍 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 · 2026-01-13T16:41:25Z

🔍 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 · 2026-01-13T17:13:30Z

🔍 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 · 2026-01-13T17:16:15Z

🔍 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 · 2026-01-13T17:20:23Z

🔍 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 · 2026-01-13T17:51:38Z

🔍 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.

- Remove confusing 'keep task but reset progress' section - Change heading from 'Restarting and Resuming' to 'Resetting' - Add description to Recipe Files section - Rename 'Ralph Wiggum Loop' to 'Ralph Loop' throughout

github-actions · 2026-01-13T18:27:02Z

🔍 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 · 2026-01-13T18:37:20Z

🔍 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 · 2026-01-13T19:09:02Z

🔍 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 · 2026-01-13T19:11:52Z

🔍 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.

* main: (41 commits) Allow customizing the new line keybinding in the CLI (#5956) Ask for permission in the CLI (#6475) docs: add Ralph Loop tutorial for multi-model iterative development (#6455) Remove gitignore fallback from gooseignore docs (#6480) fix: clean up result recording for code mode (#6343) fix(code_execution): handle model quirks with tool calls (#6352) feat(ui): support prefersBorder option for MCP Apps (#6465) fixed line breaks (#6459) Use Intl.NumberFormat for token formatting in SessionsInsights (#6466) feat(ui): format large and small token counts for readability (#6449) fix: apply subrecipes when using slash commands (#6460) Fix: exclude platform_schedule_tool in CLI (#6442) Fix: Small update in how ML-based prompt injection determines final result (#6439) docs: remove SSE transport and rename to Streamable HTTP (#6319) fix: correct Cloudinary extension command and env variable (#6453) fix: add gap between buttons in MacDesktopInstallButtons.js (#6452) refactor: include hidden dotfiles folders in file picker search (#6315) upgraded safe npm packages (#6450) chore(deps): bump react-router and react-router-dom in /ui/desktop (#6408) chore(deps): bump lru from 0.12.5 to 0.16.3 (#6379) ...

* main: fix: require auth when running goose on non loopback address (#6478) chore(deps): bump hono from 4.11.3 to 4.11.4 in /ui/desktop (#6485) feat(cli): graceful fallback for keyring failures (#5808) fix: support global .gooseignore and negation patterns (#6157) docs: manual config for jetbrains (#6490) fix: Recipe slash command doesn't work with single optional parameter (#6235) fix(openrouter): Handle Gemini thoughtSignature for tool calls (#6370) docs: fix extensions page (#6484) Allow customizing the new line keybinding in the CLI (#5956) Ask for permission in the CLI (#6475) docs: add Ralph Loop tutorial for multi-model iterative development (#6455) Remove gitignore fallback from gooseignore docs (#6480) fix: clean up result recording for code mode (#6343) fix(code_execution): handle model quirks with tool calls (#6352) feat(ui): support prefersBorder option for MCP Apps (#6465) fixed line breaks (#6459) Use Intl.NumberFormat for token formatting in SessionsInsights (#6466) feat(ui): format large and small token counts for readability (#6449) fix: apply subrecipes when using slash commands (#6460)

…lock#6455) Signed-off-by: ThanhNguyxn <[email protected]>

…ased * 'main' of github.com:block/goose: fix(code_execution): serialize record_result output as JSON (#6495) perf(google): avoid accumulating thoughtSignatures across conversation history (#6462) fix(openai): make tool_call arguments optional and fix silent stream termination (#6309) fix: Improve error messages for invalid tool calls (#6483) fix: require auth when running goose on non loopback address (#6478) chore(deps): bump hono from 4.11.3 to 4.11.4 in /ui/desktop (#6485) feat(cli): graceful fallback for keyring failures (#5808) fix: support global .gooseignore and negation patterns (#6157) docs: manual config for jetbrains (#6490) fix: Recipe slash command doesn't work with single optional parameter (#6235) fix(openrouter): Handle Gemini thoughtSignature for tool calls (#6370) docs: fix extensions page (#6484) Allow customizing the new line keybinding in the CLI (#5956) Ask for permission in the CLI (#6475) docs: add Ralph Loop tutorial for multi-model iterative development (#6455) Remove gitignore fallback from gooseignore docs (#6480) fix: clean up result recording for code mode (#6343) fix(code_execution): handle model quirks with tool calls (#6352) feat(ui): support prefersBorder option for MCP Apps (#6465) fixed line breaks (#6459)

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

a67e194

docs: add ralph loop recipe files and simplify setup with curl

0b76772

docs: restore full file contents in collapsible sections

7cd1351

fix: correct model name in Ralph Loop tutorial

68d4535

blackgirlbytes added 2 commits January 13, 2026 06:37

docs: add CLI requirement note

543101d

docs: replace note with Prerequisites section

6dde9a9

blackgirlbytes added 2 commits January 13, 2026 07:27

docs: remove Lead/Worker comparison section from Ralph Loop tutorial

2e6fb5b

docs: restructure Ralph Loop tutorial with walkthrough section

c9a2b4a

docs: rewrite Ralph Loop intro for clarity

20d1a7d

fix intro

d41f883

blackgirlbytes force-pushed the rizel/ralph-loop-tutorial branch from 1ebaf41 to d41f883 Compare January 13, 2026 17:13

docs: move Geoffrey Huntley attribution to intro sentence

15e3137

docs: improve Ralph Loop tutorial walkthrough

b49567d

blackgirlbytes added 2 commits January 13, 2026 13:11

docs: update Ralph Loop tutorial and recipes

55e23d7

- Remove confusing 'keep task but reset progress' section - Change heading from 'Restarting and Resuming' to 'Resetting' - Add description to Recipe Files section - Rename 'Ralph Wiggum Loop' to 'Ralph Loop' throughout

docs: add context to Resetting section

c20a785

docs: clarify Ralph Loop as extension of Geoffrey Huntley's technique

f783f73

blackgirlbytes marked this pull request as ready for review January 13, 2026 19:03

blackgirlbytes requested a review from a team as a code owner January 13, 2026 19:03

Copilot AI review requested due to automatic review settings January 13, 2026 19:03

Copilot started reviewing on behalf of blackgirlbytes January 13, 2026 19:04 View session

Copilot AI reviewed Jan 13, 2026

View reviewed changes

chore: trigger deploy preview

b977544

chore: trigger docs preview

5feb6d5

Copilot AI review requested due to automatic review settings January 13, 2026 19:09

Copilot started reviewing on behalf of blackgirlbytes January 13, 2026 19:10 View session

Copilot AI reviewed Jan 13, 2026

View reviewed changes

The-Best-Codes approved these changes Jan 13, 2026

View reviewed changes

emma-squared approved these changes Jan 13, 2026

View reviewed changes

blackgirlbytes merged commit 1c0895e into main Jan 13, 2026
28 checks passed

blackgirlbytes deleted the rizel/ralph-loop-tutorial branch January 13, 2026 20:21

ThanhNguyxn pushed a commit to ThanhNguyxn/goose that referenced this pull request Jan 14, 2026

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

3edca0a

…lock#6455) Signed-off-by: ThanhNguyxn <[email protected]>

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

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

Conversation

blackgirlbytes commented Jan 12, 2026

Summary

What is Ralph Loop?

Tutorial covers

Files

Uh oh!

github-actions bot commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions bot commented Jan 12, 2026 •

edited

Loading