mikeyobrien/ralph-orchestrator

An improved implementation of the Ralph Wiggum technique for autonomous AI agent orchestration

What it solves

Ralph Orchestrator は、AI エージェントを継続的な反復ループに保ち、目標が達成されるまで自律的にタスクを完了させるフレームワークを提供します。AI アシスタントが部分的または誤った回答を出したまま停止してしまう「シングルショット」失敗を防ぎ、タスクが完全に完了するまで反復と検証を行います。

How it works

Ralph は「Ralph Wiggum technique」を実装し、専門化されたペルソナ（research、debug、review など）を「帽子システム」でイベントを介して協調させ、マルチステップタスクを実行します。"バックプレッシャーゲート"（lint、型チェック、テストなどの自動チェック）を組み込み、未完成または破損した作業を拒否し、エージェントにループバックして修正させます。システムは Claude Code、Gemini CLI、Copilot CLI など複数の AI バックエンドをサポートし、MCP サーバーとして統合可能です。

Who it’s for

AI エージェントを使って複雑なソフトウェアエンジニアリングタスクを自動化したい開発者、常時手動で監視する必要がない方、そして Telegram を通じてヒューマン・イン・ザ・ループのガイダンスを組み込みたい方に最適です。

Highlights

  • Multi-Backend Support: Works with various AI coding assistants like Claude Code, Gemini CLI, and Codex.
  • Hat System: Uses specialized roles (e.g., code-assist, debug, review) to structure task execution.
  • Backpressure Gates: Ensures quality by rejecting work that fails tests or linting.
  • Human-in-the-Loop: Integration with Telegram allows humans to provide proactive guidance or answer agent questions mid-loop.
  • Web Dashboard: An alpha-stage dashboard for monitoring and managing orchestration loops.
  • MCP Server Mode: Can be run as a Model Context Protocol server for compatible clients.