ralph-claude-code: インテリジェントな終了検知とレートリミットを備えた Claude Code 用自律開発ループ

解決する課題

Ralph は Claude Code 用の自律開発ループを提供し、プロジェクトが完了するまで手動介入なしで反復的に改善できるようにします。手動のプロンプト‑レスポンスサイクルの問題を、実行ループを自動化しつつ、無限ループ、API の過剰使用、コストの暴走を防止する保護策を実装することで解決します。

仕組み

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

対象ユーザー

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

ハイライト

• 自律ループ: プロジェクト要件に基づき Claude Code を継続的に実行。
• インテリジェントな終了検知: ヒューリスティックと明示的シグナルのデュアル条件チェックで早期終了を防止。
• タスク統合: PRD、GitHub Issue、または対話型 ralph-enable ウィザードから要件を直接インポート。
• 安全ガード: レートリミット、スタックしたループ用サーキットブレーカー、そして自動 git バックアップブランチを含む。
• サンドボックスサポート: 分離された Docker または E2B クラウドサンドボックスで Claude Code を実行可能。
• セッション管理: --resume フラグと設定可能な有効期限タイムアウトでセッションの継続性をサポート。

Summary

Claude Code 用の自律開発ループで、プロジェクト要件を反復的に実装し、無限ループや API の過剰使用に対する組み込みの保護策を備えています。

Title

ralph-claude-code: インテリジェントな終了検知とレートリミットを備えた Claude Code 用自律開発ループ