diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index ddd1b8b..3da9e35 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -328,15 +328,15 @@ "homepage": "https://github.com/anthropics/claude-plugins-public/tree/main/plugins/frontend-design" }, { - "name": "ralph-wiggum", - "description": "Interactive self-referential AI loops for iterative development. Claude works on the same task repeatedly, seeing its previous work, until completion.", + "name": "ralph-loop", + "description": "Interactive self-referential AI loops for iterative development, implementing the Ralph Wiggum technique. Claude works on the same task repeatedly, seeing its previous work, until completion.", "author": { "name": "Anthropic", "email": "support@anthropic.com" }, - "source": "./plugins/ralph-wiggum", + "source": "./plugins/ralph-loop", "category": "development", - "homepage": "https://github.com/anthropics/claude-plugins-public/tree/main/plugins/ralph-wiggum" + "homepage": "https://github.com/anthropics/claude-plugins-public/tree/main/plugins/ralph-loop" }, { "name": "hookify", diff --git a/plugins/plugin-dev/README.md b/plugins/plugin-dev/README.md index 7b70063..31994d2 100644 --- a/plugins/plugin-dev/README.md +++ b/plugins/plugin-dev/README.md @@ -120,7 +120,7 @@ Use this workflow for structured, high-quality plugin development from concept t - YAML frontmatter + markdown body structure - Parsing techniques for bash scripts (sed, awk, grep patterns) - Temporarily active hooks (flag files and quick-exit) -- Real-world examples from multi-agent-swarm and ralph-wiggum plugins +- Real-world examples from multi-agent-swarm and ralph-loop plugins - Atomic file updates and validation - Gitignore and lifecycle management diff --git a/plugins/plugin-dev/skills/plugin-settings/SKILL.md b/plugins/plugin-dev/skills/plugin-settings/SKILL.md index 912a06e..a3366cb 100644 --- a/plugins/plugin-dev/skills/plugin-settings/SKILL.md +++ b/plugins/plugin-dev/skills/plugin-settings/SKILL.md @@ -449,7 +449,7 @@ Coordinate with auth-agent on shared types. - Sends notifications to coordinator if enabled - Allows quick activation/deactivation via `enabled: true/false` -### ralph-wiggum Plugin +### ralph-loop Plugin **.claude/ralph-loop.local.md:** ```markdown @@ -512,7 +512,7 @@ fi For detailed implementation patterns: - **`references/parsing-techniques.md`** - Complete guide to parsing YAML frontmatter and markdown bodies -- **`references/real-world-examples.md`** - Deep dive into multi-agent-swarm and ralph-wiggum implementations +- **`references/real-world-examples.md`** - Deep dive into multi-agent-swarm and ralph-loop implementations ### Example Files diff --git a/plugins/plugin-dev/skills/plugin-settings/references/real-world-examples.md b/plugins/plugin-dev/skills/plugin-settings/references/real-world-examples.md index b62a910..73b6446 100644 --- a/plugins/plugin-dev/skills/plugin-settings/references/real-world-examples.md +++ b/plugins/plugin-dev/skills/plugin-settings/references/real-world-examples.md @@ -126,7 +126,7 @@ sed "s/^pr_number: .*/pr_number: $PR_NUM/" \ mv temp.md ".claude/multi-agent-swarm.local.md" ``` -## ralph-wiggum Plugin +## ralph-loop Plugin ### Settings File Structure @@ -253,7 +253,7 @@ echo "Ralph loop initialized: .claude/ralph-loop.local.md" ## Pattern Comparison -| Feature | multi-agent-swarm | ralph-wiggum | +| Feature | multi-agent-swarm | ralph-loop | |---------|-------------------|--------------| | **File** | `.claude/multi-agent-swarm.local.md` | `.claude/ralph-loop.local.md` | | **Purpose** | Agent coordination state | Loop iteration state | diff --git a/plugins/plugin-dev/skills/skill-development/SKILL.md b/plugins/plugin-dev/skills/skill-development/SKILL.md index ac75eed..09b87af 100644 --- a/plugins/plugin-dev/skills/skill-development/SKILL.md +++ b/plugins/plugin-dev/skills/skill-development/SKILL.md @@ -310,7 +310,7 @@ Study the skills in this plugin as examples of best practices: **plugin-settings skill:** - Specific triggers: "plugin settings", ".local.md files", "YAML frontmatter" -- References show real implementations (multi-agent-swarm, ralph-wiggum) +- References show real implementations (multi-agent-swarm, ralph-loop) - Working parsing scripts Each demonstrates progressive disclosure and strong triggering. diff --git a/plugins/ralph-loop/.claude-plugin/plugin.json b/plugins/ralph-loop/.claude-plugin/plugin.json new file mode 100644 index 0000000..bac0a0b --- /dev/null +++ b/plugins/ralph-loop/.claude-plugin/plugin.json @@ -0,0 +1,8 @@ +{ + "name": "ralph-loop", + "description": "Continuous self-referential AI loops for interactive iterative development, implementing the Ralph Wiggum technique. Run Claude in a while-true loop with the same prompt until task completion.", + "author": { + "name": "Anthropic", + "email": "support@anthropic.com" + } +} diff --git a/plugins/ralph-wiggum/README.md b/plugins/ralph-loop/README.md similarity index 90% rename from plugins/ralph-wiggum/README.md rename to plugins/ralph-loop/README.md index a65f010..531c31e 100644 --- a/plugins/ralph-wiggum/README.md +++ b/plugins/ralph-loop/README.md @@ -1,12 +1,12 @@ -# Ralph Wiggum Plugin +# Ralph Loop Plugin Implementation of the Ralph Wiggum technique for iterative, self-referential AI development loops in Claude Code. -## What is Ralph? +## What is Ralph Loop? -Ralph is a development methodology based on continuous AI agent loops. As Geoffrey Huntley describes it: **"Ralph is a Bash loop"** - a simple `while true` that repeatedly feeds an AI agent a prompt file, allowing it to iteratively improve its work until completion. +Ralph Loop is a development methodology based on continuous AI agent loops. As Geoffrey Huntley describes it: **"Ralph is a Bash loop"** - a simple `while true` that repeatedly feeds an AI agent a prompt file, allowing it to iteratively improve its work until completion. -The technique is named after Ralph Wiggum from The Simpsons, embodying the philosophy of persistent iteration despite setbacks. +This technique is inspired by the Ralph Wiggum coding technique (named after the character from The Simpsons), embodying the philosophy of persistent iteration despite setbacks. ### Core Concept diff --git a/plugins/ralph-wiggum/commands/cancel-ralph.md b/plugins/ralph-loop/commands/cancel-ralph.md similarity index 93% rename from plugins/ralph-wiggum/commands/cancel-ralph.md rename to plugins/ralph-loop/commands/cancel-ralph.md index a85c428..89bddc2 100644 --- a/plugins/ralph-wiggum/commands/cancel-ralph.md +++ b/plugins/ralph-loop/commands/cancel-ralph.md @@ -1,5 +1,5 @@ --- -description: "Cancel active Ralph Wiggum loop" +description: "Cancel active Ralph Loop" allowed-tools: ["Bash(test -f .claude/ralph-loop.local.md:*)", "Bash(rm .claude/ralph-loop.local.md)", "Read(.claude/ralph-loop.local.md)"] hide-from-slash-command-tool: "true" --- diff --git a/plugins/ralph-wiggum/commands/help.md b/plugins/ralph-loop/commands/help.md similarity index 91% rename from plugins/ralph-wiggum/commands/help.md rename to plugins/ralph-loop/commands/help.md index 78a5045..b239119 100644 --- a/plugins/ralph-wiggum/commands/help.md +++ b/plugins/ralph-loop/commands/help.md @@ -1,14 +1,14 @@ --- -description: "Explain Ralph Wiggum technique and available commands" +description: "Explain Ralph Loop plugin and available commands" --- -# Ralph Wiggum Plugin Help +# Ralph Loop Plugin Help Please explain the following to the user: -## What is the Ralph Wiggum Technique? +## What is Ralph Loop? -The Ralph Wiggum technique is an iterative development methodology based on continuous AI loops, pioneered by Geoffrey Huntley. +Ralph Loop implements the Ralph Wiggum technique - an iterative development methodology based on continuous AI loops, pioneered by Geoffrey Huntley. **Core concept:** ```bash diff --git a/plugins/ralph-wiggum/commands/ralph-loop.md b/plugins/ralph-loop/commands/ralph-loop.md similarity index 93% rename from plugins/ralph-wiggum/commands/ralph-loop.md rename to plugins/ralph-loop/commands/ralph-loop.md index 3b4dbcb..9441df9 100644 --- a/plugins/ralph-wiggum/commands/ralph-loop.md +++ b/plugins/ralph-loop/commands/ralph-loop.md @@ -1,5 +1,5 @@ --- -description: "Start Ralph Wiggum loop in current session" +description: "Start Ralph Loop in current session" argument-hint: "PROMPT [--max-iterations N] [--completion-promise TEXT]" allowed-tools: ["Bash(${CLAUDE_PLUGIN_ROOT}/scripts/setup-ralph-loop.sh:*)"] hide-from-slash-command-tool: "true" diff --git a/plugins/ralph-wiggum/hooks/hooks.json b/plugins/ralph-loop/hooks/hooks.json similarity index 72% rename from plugins/ralph-wiggum/hooks/hooks.json rename to plugins/ralph-loop/hooks/hooks.json index 2e5f697..b4ad7be 100644 --- a/plugins/ralph-wiggum/hooks/hooks.json +++ b/plugins/ralph-loop/hooks/hooks.json @@ -1,5 +1,5 @@ { - "description": "Ralph Wiggum plugin stop hook for self-referential loops", + "description": "Ralph Loop plugin stop hook for self-referential loops", "hooks": { "Stop": [ { diff --git a/plugins/ralph-wiggum/hooks/stop-hook.sh b/plugins/ralph-loop/hooks/stop-hook.sh similarity index 99% rename from plugins/ralph-wiggum/hooks/stop-hook.sh rename to plugins/ralph-loop/hooks/stop-hook.sh index 9aa611c..955a664 100755 --- a/plugins/ralph-wiggum/hooks/stop-hook.sh +++ b/plugins/ralph-loop/hooks/stop-hook.sh @@ -1,6 +1,6 @@ #!/bin/bash -# Ralph Wiggum Stop Hook +# Ralph Loop Stop Hook # Prevents session exit when a ralph-loop is active # Feeds Claude's output back as input to continue the loop diff --git a/plugins/ralph-wiggum/scripts/setup-ralph-loop.sh b/plugins/ralph-loop/scripts/setup-ralph-loop.sh similarity index 98% rename from plugins/ralph-wiggum/scripts/setup-ralph-loop.sh rename to plugins/ralph-loop/scripts/setup-ralph-loop.sh index ac5491f..3d41db4 100755 --- a/plugins/ralph-wiggum/scripts/setup-ralph-loop.sh +++ b/plugins/ralph-loop/scripts/setup-ralph-loop.sh @@ -29,7 +29,7 @@ OPTIONS: -h, --help Show this help message DESCRIPTION: - Starts a Ralph Wiggum loop in your CURRENT session. The stop hook prevents + Starts a Ralph Loop in your CURRENT session. The stop hook prevents exit and feeds your output back as input until completion or iteration limit. To signal completion, you must output: YOUR_PHRASE diff --git a/plugins/ralph-wiggum/.claude-plugin/plugin.json b/plugins/ralph-wiggum/.claude-plugin/plugin.json deleted file mode 100644 index 06d0d39..0000000 --- a/plugins/ralph-wiggum/.claude-plugin/plugin.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "name": "ralph-wiggum", - "description": "Implementation of the Ralph Wiggum technique - continuous self-referential AI loops for interactive iterative development. Run Claude in a while-true loop with the same prompt until task completion.", - "author": { - "name": "Anthropic", - "email": "support@anthropic.com" - } -}