ralph-loop

Ralph ループ

トリガー

ユーザーが Ralph ループの開始を希望しています。これは、各ターン後に同じプロンプトが再入力され、エージェントが反復ごとに自身の前回の作業を確認する反復型の開発ループです。

ワークフロー

1. ユーザーのタスクプロンプトと、任意のパラメーターを収集します。

   • max_iterations（数値。デフォルトは無制限を意味する 0）
   • completion_promise（テキスト。設定しない場合は "null"）

2. ディレクトリ .cursor/ralph/ が存在しない場合は作成し、次の正確な形式で状態ファイル .cursor/ralph/scratchpad.md を書き込みます。

   ---
   iteration: 1
   max_iterations: <N or 0>
   completion_promise: "<TEXT>" or null
   ---
   
   <the user's task prompt goes here>
   

   例：

   ---
   iteration: 1
   max_iterations: 20
   completion_promise: "COMPLETE"
   ---
   
   Build a REST API for todos with CRUD operations, input validation, and tests.
   

3. Ralph ループが有効になったことをユーザーに伝えてから、タスクに取りかかります。

4. 停止フックが各ターンの終了を自動的に検知し、フォローアップメッセージとして同じプロンプトを再入力します。プロンプトの先頭には [Ralph loop iteration N.] が付いています。

ガードレール

• 完了条件が設定されている場合、その内容が完全かつ確実に真であるときに限り、<promise>TEXT</promise> を出力できます。
• ループを抜けるために、偽の完了条件を出力しないでください。
• 安全策として max_iterations を設定することを、必ず推奨してください。
• completion_promise の値に特殊文字が含まれる場合は、YAML フロントマター内で引用符で囲んでください。

出力

ループが有効になったことを確認し（プロンプト、反復回数の上限、設定されている場合は完了条件を伝えます）、すぐにタスクに取りかかります。