tzachbon/smart-ralph

何を解決するか

Smart Ralph は、AI コーディングエージェント（特に Claude Code と Codex）向けの仕様駆動開発フレームワークです。エージェントが計画なしに直ちにコーディングを開始することを防ぎ、実装を開始する前に、研究・要件収集・技術設計の構造化されたプロセスを強制します。これにより、複雑な機能が十分に検討され、複数のセッションにわたって再開または監査可能になります。

動作方法

このプロジェクトは、開発の異なる段階を担当する専門的なエージェントが連携するマルチエージェントワークフローを実装しています：

1. トライアージ：大きな目標を依存関係を考慮した小さな仕様（エピック）に分割します。
2. リサーチ：既存のコードベースを分析し、Web で実現可能性を調査します。
3. 要件定義：ユーザー・ストーリーと受入基準を定義します。
4. プロトタイプ：（オプション）特定の設計課題を一時的な環境でテストします。
5. 設計：アーキテクチャと技術的トレードオフを定義します。
6. タスク化：設計を実行可能なタスクのシーケンスに分解します。
7. 実行：各タスクを1つずつ実装し、それぞれに新しいコンテキストを適用し、品質ゲート（POC、リファクタリング、テスト、Lint）を適用します。

また、コードベースのインデキシング機能も含まれており、プロジェクトをスキャンして検索可能なコンポーネント仕様を作成し、リサーチエージェントが既存のコードをより効率的に見つけるのを支援します。

対象ユーザー

Claude Code や OpenAI Codex を使用し、単なるプロンプトベースのコード生成ではなく、より体系的でアーキテクチャ志向の AI 補助機能開発を望む開発者向けです。

特徴

• 仕様駆動ワークフロー：研究 → 要件 → 設計 → タスク → 実装の順序を強制します。
• 状態の永続化：進捗状況を .progress.md と tasks.md に記録し、セッション中断後に作業を再開可能にします。
• コードベースインデキシング：コントローラー、サービス、モデルを自動スキャンして、AI が検索可能なインデックスを作成します。
• マルチエージェントの専門性：各段階に異なる役割（例：triage-analyst、product-manager、architect-reviewer）を割り当てます。
• 柔軟な実行：承認チェックポイントを含む詳細な「通常」モードと、より迅速なイテレーションを可能にする「クイック」モードの両方をサポートします。