ホームAI Agentssnarktank/ralph
// archived 2026-04-14
snarktank

ralph

AI#AI Agents#Automation#LLM#Software Development
GitHub で見る →
155

// 概要

Ralph は Amp や Claude Code などのツールを活用し、プロジェクトの要件が満たされるまでコーディングタスクを繰り返し実行する自律型 AI エージェントループです。各イテレーションはクリーンなコンテキストで動作し、git の履歴や進捗ログ、構造化された JSON タスクリストを通じてプロジェクトの状態を維持します。システムは大規模な機能を管理可能なユーザーストーリーに分割し、自動化された品質チェックを通じて検証することで継続的な進捗を保証します。

// 技術解説

Ralph は、Amp や Claude Code といった AI ツールを繰り返し呼び出すことで、プロジェクトの要件が完全に満たされるまでコーディングタスクを実行するように設計された自律型 AI エージェントループです。その中心的な哲学は、各イテレーションでクリーンなコンテキストを維持することにあり、永続的なメモリを git の履歴、進捗ログ、および構造化された JSON タスクリストにオフロードすることで、コンテキストウィンドウの劣化を防ぎます。このアプローチにより、AI エージェントが大規模なプロジェクトで焦点を失うという問題を解決し、複雑な機能を管理可能で検証可能な単位に分割して、体系的に実装およびテストできるようにします。

// 主要ハイライト

01
各タスクに対して新しい AI インスタンスを生成する自律ループを実装し、クリーンなコンテキストを確保してパフォーマンスの低下を防ぎます。
02
構造化された prd.json ファイルを使用してユーザーのストーリーとその完了ステータスを追跡し、エージェントがタスクを順次優先順位付けして実行できるようにします。
03
git の履歴、progress.txt ファイル、および AGENTS.md の更新を通じてイテレーション全体で永続的なメモリを維持し、プロジェクト固有の学習内容を記録します。
04
Amp または Claude Code とのモジュール式統合をサポートし、開発者が好みの AI コーディングツールを選択できるようにします。
05
変更をコミットしてタスクを完了とマークする前に、型チェックやテストなどの品質チェックの合格を必須とすることで、厳格なフィードバックループを強制します。
06
以前の実行の自動アーカイブを提供し、新しい機能を開始する際にプロジェクトの履歴が保持されるようにします。

// ユースケース

01
反復的な AI コーディングサイクルを通じた PRD ベースのユーザーストーリーの自動実行。
02
自律的な処理に向けた製品要件の生成および構造化 JSON 形式への変換。
03
進捗ログや AGENTS.md ファイルの自動更新による継続的なプロジェクトドキュメントの管理と学習の永続化。

// クイックスタート

開始するには、Amp CLI または Claude Code をインストールし、システムで 'jq' が利用可能であることを確認してください。Ralph のスクリプトと関連するプロンプトテンプレートをプロジェクトディレクトリにコピーし、PRD を生成して必要な prd.json 形式に変換します。最後に、ralph.sh スクリプトを使用してループを実行し、自律的な開発プロセスを開始します。