mcpField

Ralph Story Executor

おすすめ手動実行
継続的インテグレーション最大 20 ラウンド

Ralph Story Executor について

手動で開始し、最大 20 ラウンド実行するループで、.ralph/prd.json に残っている未完了のストーリーを実装していきます。各ラウンドでは passes: false のストーリーを選んで実装し、テスト・lint・ビルドをまとめて実行して、通った場合のみ状態を更新します。

主な機能

  1. 01テスト・lint・ビルドを一つのチェックとして連結
  2. 02進捗を .ralph/prd.json の passes フィールドで管理
  3. 03手動トリガーで最大 20 ラウンド
  4. 04Cursor と Claude Code に対応

活用シーン

  1. 01PRD ファイルに書かれたストーリー一覧をまとめて実装する
  2. 02ビルド検証を挟みながらコーディングエージェントにタスクを進めさせる
  3. 03すべてのストーリーに完全なチェックを求めるプロジェクト
目標
.ralph/prd.json のすべてのストーリーが passes: true になっていること。
終了条件
passes: false のストーリーが残っていなければ終了し、"ALL STORIES ARE COMPLETE" と返答します。
各ラウンドの間に実行
npm test && npm run lint && npm run build

起動プロンプト

Cursor / Claude Code に貼り付けて実行すると、終了条件を満たすまでエージェントが以下の手順を繰り返します。

prompt.md
「Ralph Story Executor」ループを開始します。
目標：.ralph/prd.json のすべてのストーリーが passes: true になっていること。
最大ラウンド数：20。
ステップ 1：次のストーリーを選ぶ — .ralph/prd.json を読み、passes: false のストーリーを 1 件選んで今回の対象にします。該当するものがなければループを終了します。
ステップ 2：ストーリーを実装する — ストーリーの記述に沿ってコードを変更します。変更範囲はそのストーリーに必要な内容にとどめます。
ステップ 3：チェックを実行する — テスト、lint、ビルドを順に実行し、3 つすべて成功した場合のみ合格とします。失敗した場合は出力をもとに修正し、次のラウンドで再試行します。 `npm test && npm run lint && npm run build`
ステップ 4：状態を更新する — チェックに通ったら、そのストーリーの passes を true にして、今回の進捗として記録します。
各ラウンドの間に実行：`npm test && npm run lint && npm run build`
終了条件：passes: false のストーリーが残っていなければ終了し、"ALL STORIES ARE COMPLETE" と返答します。

手順

各ラウンドは順番に実行され、終了条件を満たさなければ次のラウンドへ進みます（最大 20 ラウンド）。

01
次のストーリーを選ぶ

.ralph/prd.json を読み、passes: false のストーリーを 1 件選んで今回の対象にします。該当するものがなければループを終了します。

02
ストーリーを実装する

ストーリーの記述に沿ってコードを変更します。変更範囲はそのストーリーに必要な内容にとどめます。

03
チェックを実行する

テスト、lint、ビルドを順に実行し、3 つすべて成功した場合のみ合格とします。失敗した場合は出力をもとに修正し、次のラウンドで再試行します。

$npm test && npm run lint && npm run build
04
状態を更新する

チェックに通ったら、そのストーリーの passes を true にして、今回の進捗として記録します。

未達 → 次のラウンド条件を満たせば終了

対応エージェント

この Loop をそのまま実行できるコーディングエージェントです。

Cursor
Claude Code
Codex

コメント

Markdown 対応