Repolode
ClaytonFarr

ClaytonFarr/ralph-playbook

Geoff HuntleyのRalph手法で自律型AIコーディングループを運用するためのガイド。計画、実装、仕様書、プロンプトテンプレートを解説します。

スター
1,037
フォーク
266
未解決の Issue
3
最終コミット
8 か月前

これは何?

Ralph Playbookは、AIコーディングエージェントを自律的なループで動かす手法「Ralph」の実践ガイドです。各イテレーションでは新しいコンテキストを開始し、プロンプトファイルとディスク上の共有実装計画を読み込んで、1つのタスクを完了し、コミットして終了します。これにより、手動でオーケストレーションしなくてもエージェントが作業を進められます。

このガイドでは、ワークフローを3つのフェーズに分けて解説します。トピックごとの仕様ファイルで要件を定義するフェーズ、仕様とコードの差分分析を行う計画ループ、そしてテストなどのバックプレッシャーをもとにタスクを実装するビルドループです。すぐに調整して使えるPROMPT_planとPROMPT_buildのテンプレート、ビルドやテストのコマンドに関するAGENTS.mdの規約、サンプルのloop.shスクリプト、権限チェックを省略して実行するエージェントをサンドボックス化するためのガイダンスも含まれています。

リポジトリでは、受け入れ条件からテスト要件を導き出す方法、主観的な品質を評価するLLM-as-judgeレビュー、既存のコードベースをリバースエンジニアリングして仕様書にする方法など、今後の拡張案も紹介しています。整形済みのWebガイドとMarkdownの両方で公開されています。

主な機能

  • 01要件定義から計画、実装までの3段階のワークフローを定義
  • 02Claude系コーディングエージェント向けのPLANNINGおよびBUILDINGプロンプトテンプレートを提供
  • 03モード選択と最大イテレーション数の制限に対応したサンプルloop.shを収録
  • 04イテレーション間で状態を共有するためのAGENTS.mdと実装計画の規約を解説
  • 05権限チェックを省略してエージェントを実行する際のサンドボックス化ガイダンスを掲載

ユースケース

  • 記述された仕様に基づいてプロジェクトを実装する自律型コーディングループのセットアップ
  • 多数の小さなタスクに取り組むAIエージェント向けのプロンプトや計画ファイルの構成
  • 広範な権限を与えてコーディングエージェントを実行する前に、安全な実行方法を確認

クイックスタート

  1. 1

    README の Ralph Playbook ガイドを読む

  2. 2

    自律実行に使う基本的なループスクリプトをセットアップする

    while :; do cat PROMPT.md | claude ; done

使う前に知っておきたいこと

  • このリポジトリは方法論のガイドであり、インストール可能なソフトウェアパッケージではありません。
  • サンプルのループは --dangerously-skip-permissions を指定して Claude を実行するため、安全のために隔離されたサンドボックスが必要です。
  • 結果はプロンプト、仕様、バックプレッシャーの慎重な調整に左右され、非決定的になる場合があります。

トピック

よくある質問

ralph-playbook とは?
Geoff HuntleyのRalph手法で自律型AIコーディングループを運用するためのガイド。計画、実装、仕様書、プロンプトテンプレートを解説します。 Ralph Playbookは、AIコーディングエージェントを自律的なループで動かす手法「Ralph」の実践ガイドです。各イテレーションでは新しいコンテキストを開始し、プロンプトファイルとディスク上の共有実装計画を読み込んで、1つのタスクを完了し、コミットして終了します。これにより、手動でオーケストレーションしなくてもエージェントが作業を進められます。
ralph-playbook は無料で使えますか?ライセンスは?
ralph-playbook は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
ralph-playbook は今もメンテナンスされていますか?
半年以上コミットなし。ralph-playbook の最終コミットは 2026年3月6日 です。
ralph-playbook は何に使えますか?
記述された仕様に基づいてプロジェクトを実装する自律型コーディングループのセットアップ 多数の小さなタスクに取り組むAIエージェント向けのプロンプトや計画ファイルの構成 広範な権限を与えてコーディングエージェントを実行する前に、安全な実行方法を確認
ralph-playbook のインストール方法は?
README の Ralph Playbook ガイドを読む 自律実行に使う基本的なループスクリプトをセットアップする: while :; do cat PROMPT.md | claude ; done
ralph-playbook はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/ClaytonFarr/ralph-playbook

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト