Ralph Wiggum Loop

ralph-wiggum-loop

マルチモデル反復開発エージェントプラグイン — クロスモデルのワーカー／レビュアー構成、仕様駆動開発スキル、Stop フック、SHIP／REVISE 判定エンジンを備えた Ralph Loop です。

概要

Ralph Loop は、ワーカーモデルが作業を行い、レビュアーモデルがモデルをまたいだレビューを実施する2段階の反復ワークフローです。レビュアーが 「SHIP」 と判断するまで反復します。

このプロジェクトは、以下のネイティブ実装を備えたクロスプラットフォームのエージェントプラグイン（plugin.json、mcp.json、.agents/skills/ralph-wiggum-loop/、skills/ralph-wiggum-loop/）です。

• Linux / macOS（Bash）： bin/ralph-wiggum-loop.sh（bin/mcp-sdk.sh を使用）
• Windows（PowerShell）： bin/ralph-wiggum-loop.ps1（bin/mcp-sdk.psm1 を使用）
• ポリグロットランナー： bin/script-runner.sh / bin/script-runner.ps1（POSIX の sh／bash と PowerShell の両方で実行）

スキルのインストール（.agents/skills/）

Agent Skills Specification に従い、スキルを .agents/skills/ にインストールします。

# Project-level (.agents/skills/ralph-wiggum-loop) or User-level (~/.agents/skills/ralph-wiggum-loop)
mkdir -p .agents/skills
cp -R skills/ralph-wiggum-loop .agents/skills/ralph-wiggum-loop

New-Item -ItemType Directory -Path .agents/skills -Force | Out-Null
Copy-Item -Recurse -Force skills/ralph-wiggum-loop .agents/skills/ralph-wiggum-loop

OS 固有の MCP サーバー（mcp.json）

MCP サーバー名	OS／ランタイム	トランスポート	コマンド／エンドポイント
ralph-wiggum-loop	Linux / macOS（Bash）	stdio	./bin/script-runner.sh ralph-wiggum-loop --stdio
ralph-wiggum-loop-pwsh	Windows（PowerShell 7+）	stdio	pwsh -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio
ralph-wiggum-loop-powershell	Windows（PowerShell 5.1）	stdio	powershell.exe -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio
ralph-wiggum-loop-http	クロスプラットフォーム	streamable-http	http://127.0.0.1:8080/mcp

クイックスタート

1. CLI モード

• Linux / macOS（Bash）：

  ./bin/ralph-wiggum-loop.sh "Implement user authentication with JWT tokens" --profile pro
  

• Windows（PowerShell）：

  pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\ralph-wiggum-loop.ps1 "Implement user authentication with JWT tokens" --profile pro
  

2. MCP サーバー（stdio モード）

• Linux / macOS（Bash）：

  ./bin/ralph-wiggum-loop.sh --stdio
  

• Windows（PowerShell）：

  pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\ralph-wiggum-loop.ps1 --stdio
  

3. MCP サーバー（streamable-http サービスモード）

• Linux / macOS（Bash）：

  ./bin/script-runner.sh start-http-server start --host 127.0.0.1 --port 8080
  

• Windows（PowerShell）：

  pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\script-runner.ps1 start-http-server start --host 127.0.0.1 --port 8080
  

ドキュメント

• スキルとエージェントの手順 — OS の選択ルール、ループの実行モード、Streamable HTTP のセットアップ
• 完全なドキュメント — API リファレンス、ツール、状態管理
• デプロイガイド — インストールと設定

リポジトリ

• ソース： https://github.com/sheldonrobinson/ralph-wiggum-loop
• エージェントプラグイン仕様： https://agent-plugins.org
• MCP 仕様： https://modelcontextprotocol.io

ライセンス

MIT