Ralph TUI PRD ジェネレーター
ralph-tui を介してAIエージェントが実行できるように最適化された詳細な製品要求ドキュメントを作成します。
ジョブ
- ユーザーから機能の説明を受け取る
- 3~5個の重要な明確化質問(選択肢付き)を1セットずつ尋ねる
- 品質ゲートについて必ず尋ねる(どのコマンドがパスする必要があるか)
- 各回答の後、必要に応じてフォローアップ質問をする(適応的な探索)
- 十分なコンテキストが得られたら構造化PRDを生成する
- TUIが解析できるように、PRDを
[PRD]...[/PRD]マーカーで囲んで出力する
重要: 実装を開始しないでください。PRDを作成するだけです。
ステップ 1: 明確化質問(反復的)
質問は1セットずつ行います。各回答は次の質問に情報を与えるようにします。以下に焦点を当てます:
- 問題/目標: この機能は何を解決するか?
- コア機能: 主要なアクションは何か?
- スコープ/境界: これがやってはいけないことは?
- 成功基準: 完了したことをどうやって知るか?
- 統合: 既存機能とどう適合するか?
- 品質ゲート: 各ストーリーでパスすべきコマンドは?(必須)
質問のフォーマット:
1. この機能の主な目標は何ですか?
A. ユーザーオンボーディング体験の向上
B. ユーザー維持率の向上
C. サポート負荷の軽減
D. その他: [指定してください]
2. ターゲットユーザーは誰ですか?
A. 新規ユーザーのみ
B. 既存ユーザーのみ
C. 全ユーザー
D. 管理者ユーザーのみ
これにより、ユーザーは「1A, 2C」のように迅速に回答できます。
品質ゲートの質問(必須)
常に品質ゲートについて尋ねます。これらはプロジェクト固有です:
各ユーザーストーリーでどの品質コマンドがパスする必要がありますか?
A. pnpm typecheck && pnpm lint
B. npm run typecheck && npm run lint
C. bun run typecheck && bun run lint
D. その他: [コマンドを指定]
UIストーリーの場合、ブラウザでの検証を含めるべきですか?
A. はい、dev-browserスキルを使って視覚的に検証する
B. いいえ、自動テストで十分です
適応的な質問
各回答の後、次のいずれかを決定します:
- フォローアップ質問をする(回答が複雑さを示す場合)
- 新しい側面について質問する(現在の領域が明確な場合)
- PRDを生成する(十分なコンテキストがある場合)
通常、2~4ラウンドの質問が必要です。
ステップ 2: PRD 構造
以下のセクションでPRDを生成します:
1. 導入/概要
機能とそれが解決する問題の簡単な説明。
2. 目標
具体的で測定可能な目的(箇条書き)。
3. 品質ゲート
重要: すべてのユーザーストーリーでパスしなければならないコマンドをリストします。
## 品質ゲート
これらのコマンドはすべてのユーザーストーリーでパスする必要があります:
- `pnpm typecheck` - 型チェック
- `pnpm lint` - リンター
UIストーリーの場合、以下も含めます:
- dev-browserスキルを使用したブラウザでの検証
このセクションは変換ツール(ralph-tui-create-json, ralph-tui-create-beads)によって抽出され、各ストーリーの受け入れ基準に追加されます。
4. ユーザーストーリー
各ストーリーには以下が必要です:
- タイトル: 短い説明的な名前
- 説明: 「[ユーザー]として、[機能]をしたい。なぜなら[利点]だからだ」
- 受け入れ基準: 「完了」を意味する検証可能なチェックリスト
各ストーリーは、1つの集中したAIエージェントセッションで実装できる程度に小さくする必要があります。
フォーマット:
### US-001: [タイトル]
**説明:** [ユーザー]として、[機能]をしたい。なぜなら[利点]だからだ。
**受け入れ基準:**
- [ ] 具体的で検証可能な基準
- [ ] 別の基準
注意: 個々のストーリーの基準に品質ゲートコマンドを含めないでください。それらは品質ゲートセクションで一度定義され、変換時に自動的に適用されます。
重要:
- 受け入れ基準は検証可能でなければならず、曖昧であってはなりません
- 「正しく動作する」は悪い例です
- 「ボタンは削除前に確認ダイアログを表示する」は良い例です
- 各ストーリーは独立して完了可能であるべきです
5. 機能要件
番号付きの具体的な機能リスト:
- 「FR-1: システムはユーザーが...できるようにしなければならない」
- 「FR-2: ユーザーがXをクリックしたとき、システムは...しなければならない」
明示的で曖昧さのないものにします。
6. 非目標(スコープ外)
この機能に含まれないもの。スコープ管理に重要です。
7. 技術的考慮事項(オプション)
- 既知の制約や依存関係
- 既存システムとの統合ポイント
- パフォーマンス要件
8. 成功指標
成功はどのように測定されますか?
9. 未解決の質問
残っている質問や明確化が必要な領域。
AIエージェント向けの作成
PRDはralph-tuiを介してAIコーディングエージェントによって実行されます。したがって:
- 明示的で曖昧さがないこと
- ユーザーストーリーは小さく(1セッションで完了可能)
- 受け入れ基準は可能な限り機械検証可能であること
- わかっている場合は具体的なファイルパスを含めること
- プロジェクト内の既存のコードパターンを参照すること
出力フォーマット
重要: TUIが解析できるように、最終PRDをマーカーで囲みます:
[PRD]
# PRD: 機能名
## 概要
...
## 品質ゲート
...
## ユーザーストーリー
...
[/PRD]
ファイル命名: TUIは ./tasks/prd-[機能名].md に保存します。
会話フローの例
ユーザー: TUIにダークモードを追加するPRDを作成して
アシスタント: ダークモードのPRD作成をお手伝いします。いくつか質問をさせてください:
-
主な目標は何ですか? A. 長時間のセッションでの目の疲れを軽減する B. システムのテーマ設定と一致させる C. 視覚的なカスタマイズを提供する D. その他
-
設定は永続化しますか? A. はい、設定ファイルに保存する B. いいえ、セッションのみ C. システム設定に従う
ユーザー: 1A, 2A
アシスタント: 良いです!あと数個質問があります:
-
どのコンポーネントがダークモードをサポートする必要がありますか? A. すべてのTUIコンポーネント B. メインの実行ビューのみ C. メインビュー + 設定 D. その他
-
各ストーリーでどの品質コマンドがパスする必要がありますか? A. pnpm typecheck && pnpm lint B. npm run typecheck && npm run lint C. bun run typecheck D. その他: [指定]
-
UIストーリーの場合、ブラウザでの検証を含めますか? A. はい、dev-browserスキルを使用する B. いいえ、自動テストで十分
ユーザー: 3A, 4A, 5A
アシスタント: 完璧です。PRDを生成するのに十分な情報が得られました。
[PRD]
PRD: Ralph TUI のダークモード
概要
長時間のオーケストレーションセッション中の目の疲れを軽減するために、ralph-tuiにダークモードサポートを追加します。この機能はすべてのTUIコンポーネントに適用され、ユーザーの設定を設定ファイルに永続化します。
目標
- 低照度環境での快適な表示体験を提供する
- テーマ設定をセッション間で永続化する
- すべてのTUIコンポーネントに一貫したスタイルを適用する
品質ゲート
これらのコマンドはすべてのユーザーストーリーでパスする必要があります:
pnpm typecheck- 型チェックpnpm lint- リンター
UIストーリーの場合、以下も含めます:
- dev-browserスキルを使用したブラウザでの検証
ユーザーストーリー
US-001: テーマ設定の追加
説明: ユーザーとして、好みのテーマ(ライト/ダーク)を設定し、セッション間で永続化したい。
受け入れ基準:
-
.ralph-tui.yamlスキーマにthemeフィールドを追加する - 値