ralph

Ralph

Ralph は、すべてのユーザーストーリーが passes: true になり、レビュアーによる検証が完了するまで、タスクに取り組み続ける PRD 主導の永続化ループです。

使用する場面

• 検証を伴う確実な完了が求められるタスク
• 複数回の反復にわたる可能性があり、永続的な取り組みが必要な作業
• 構造化された PRD 主導の実行が有効なタスク

使用しない場面

• 完全自律型のパイプライン → /omg-autopilot を使用
• コミット前に調査または計画する → /plan を使用
• すぐに完了する単発の修正 → @executor に委任

フラグ

• --no-prd：PRD の生成をスキップし、従来モードで作業します（簡単な修正向け）
• --no-deslop：必須のレビュー後クリーンアップパスをスキップします

手順

1. PRD のセットアップ（初回の反復）

• omg_read_prd を使って .omc/prd.json が存在するか確認します
• 存在しない場合は、タスク固有の受け入れ基準を含む PRD のひな形を生成します
• 重要：一般的な基準を、具体的でテスト可能な基準に置き換えます
• 進捗の追跡を開始します

2. 次のストーリーを選択

• omg_read_prd で PRD を読み取ります
• passes: false のストーリーから優先度が最も高いものを選択します

3. 現在のストーリーを実装

• 適切な複雑度レベルで @executor に委任します
• サブタスクが見つかった場合は、新しいストーリーとして PRD に追加します

4. 受け入れ基準を検証

• 各基準について、新しい証拠を用いて検証します
• 関連するチェック（テスト、ビルド、lint、型チェック）を実行します
• 基準を満たしていない場合は、作業を続けます

5. ストーリーを完了としてマーク

• omg_update_story で passes: true に設定します
• progress.txt に進捗を記録します

6. PRD の完了状況を確認

• omg_check_completion を呼び出します
• すべて完了していない場合は、ステップ 2 に戻ります
• すべて完了している場合は、検証に進みます

7. レビュアーによる検証

• @verifier が PRD の具体的な受け入れ基準に照らして確認します
• @architect がアーキテクチャの妥当性をレビューします

7.5 必須のクリーンアップパス

• --no-deslop が指定されていない限り、変更したファイルのみを対象に /ai-slop-cleaner を実行します

7.6 リグレッションの再検証

• クリーンアップパスの後、すべてのテストを再実行します
• リグレッションテストに合格してから次に進みます

8. 完了

• 承認された場合：正常に終了するため /cancel を実行します
• 却下された場合：問題を修正して再検証し、ループに戻ります

実行ポリシー

• 独立したタスクは同時に実行します
• ビルド／テストはバックグラウンドで実行します
• 実装を完全に仕上げます：スコープを縮小せず、部分的な完了にしません

チェックリスト

• すべての PRD ストーリーが passes: true になっている
• 受け入れ基準がタスク固有である（一般的な基準ではない）
• すべての要件を満たしている（スコープを縮小していない）
• 最新のテスト出力ですべてのテストの合格が確認できる
• レビュアーによる検証に合格している
• クリーンアップパスが完了している（または --no-deslop が指定されている）
• クリーンアップ後のリグレッションテストに合格している