ralph-loop プラグイン
プラグイン Claude Code 開発 Claude Code 拡張・ワークフロー以下の解説は生成 AI によるものです。出典と照らし合わせてご確認ください。
ralph-loop は、「Ralph Wiggum technique」を実装した Claude Code 用プラグインです。README によると、Stop hook が通常のセッション終了をブロックし、同じタスクプロンプトを繰り返し Claude に渡すことで、Claude はファイルに残る自身の過去の作業や git 履歴を参照しながら反復的にタスクを進め、指定した完了フレーズが出力されるか最大反復回数に達するまで継続します。起動は /ralph-loop コマンドで行い、/cancel-ralph で実行中のループを中止できます。README では、テストやリンターなど自動検証が可能な明確なタスクに向いており、人間の判断が必要な作業や一発勝負の作業、成功基準が不明確なタスクには適さないとされています。また Windows では WSL の bash が誤って使われることで Stop hook が失敗する場合があり、README に対処法が記載されています。
概要
独立した SaaS ではなく、Claude Code に Stop hook とスラッシュコマンドを追加するプラグインです。Claude が同じタスクを完了条件に達するまで繰り返し取り組む、自己参照的な開発ループを Claude Code 上で実現します。
ralph-loop でできること
- /ralph-loop "" --max-iterations --completion-promise "" でループを開始し、完了フレーズの出力または反復回数の上限まで Claude に同じタスクを繰り返させる
- /cancel-ralph で実行中のループをいつでも中止する
- ファイルや git 履歴に残る過去の作業をもとに、Claude が実装・テスト実行・失敗修正を繰り返しながら作業を改善していく
- 完了が見込めないタスクで無限ループに陥らないよう、--max-iterations を安全策として設定する
- README に記載されたプロンプト作成の指針（明確な完了条件、段階的な目標、自己修正ステップ）に沿ってループの結果を改善する
- Windows で WSL の bash が誤って解決されて Stop hook が失敗する場合、hooks/hooks.json を Git Bash を指すよう編集する対処法を適用する
出典
原文の説明（英語）
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.
ralph-loop の変更履歴
- プラグイン ralph-loop を追加