frankbria/ralph-claude-code

Autonomous AI development loop for Claude Code with intelligent exit detection

What it solves

Ralph は Claude Code に自律開発ループを提供し、手動での介入を常に必要とせずにプロジェクトを繰り返し改善し、完了させることができます。手動のプロンプト‑レスポンスサイクルという問題を、実行ループを自動化することで解決し、無限ループ、API の過剰使用、コストの暴走を防止する保護機構を実装しています。

How it works

Ralph は Claude Code を継続的なサイクルでラップします：PROMPT.md ファイルからプロジェクト目標を読み取り、AI を実行し、タスクリストで進捗を追跡し、プロジェクトが完了したかどうかを評価します。"デュアル条件退出ゲート" を使用し、ヒューリスティックな完了指標と AI からの明示的な EXIT_SIGNAL: true の両方が揃ったときに停止します。安定性を確保するため、エラー検出用のサーキットブレーカー、API 呼び出しのレートリミット、イテレーション間でコンテキストを保持するセッション管理を組み込んでいます。

Who it’s for

Claude Code を使用し、PRD、GitHub Issue、または技術仕様に基づく機能実装やバグ修正を手動でループの各ステップを駆動せずに自動化したい開発者向けです。

Highlights

  • Autonomous Loop: プロジェクト要件に基づき Claude Code を継続的に実行。
  • Intelligent Exit Detection: ヒューリスティック + 明示的シグナルのデュアル条件チェックで早期退出を防止。
  • Task Integration: PRD、GitHub Issue、またはインタラクティブな ralph-enable ウィザードから要件を直接インポート。
  • Safety Guards: レートリミット、スタックしたループ用のサーキットブレーカー、自動 git バックアップブランチを含む。
  • Sandbox Support: 分離された Docker または E2B クラウドサンドボックスで Claude Code を実行可能。
  • Session Management: --resume フラグと設定可能な有効期限タイムアウトでセッションの継続性をサポート。