Ralph TUI - ビーズ作成 は何をしますか?
PRDをralph-tui自律実行用のビーズ(エピック+子タスク)に変換します。
注記: このスキルはralph-tuiのBeadsトラッカープラグインにバンドルされています。今後のトラッカープラグイン(Linear、GitHub Issuesなど)には、それぞれ独自のタスク作成スキルがバンドルされる予定です。
ジョブ
PRD(Markdownファイルまたはテキスト)を取得し、.beads/beads.jsonlにビーズを作成します:
- PRDの「品質ゲート」セクションから品質ゲートを抽出
- 機能のエピックビーズを作成
- 各ユーザーストーリーごとに子ビーズを作成(品質ゲートを追加)
- ビーズ間の依存関係を設定(スキーマ → バックエンド → UI)
ralph-tui run --tracker beadsで実行可能な状態で出力
ステップ1:品質ゲートの抽出
PRD内の「品質ゲート」セクションを探します:
## 品質ゲート
すべてのユーザーストーリーで合格しなければならないコマンド:
- `pnpm typecheck` - 型チェック
- `pnpm lint` - リンティング
UIストーリーの場合、以下も含めます:
- dev-browserスキルを使用してブラウザで確認
抽出するもの:
- 共通ゲート: すべてのストーリーに適用されるコマンド(例:
pnpm typecheck) - UIゲート: UIストーリーのみに適用されるコマンド(例:ブラウザ確認)
品質ゲートセクションがない場合: ユーザーにどのコマンドを合格させるか尋ねるか、npm run typecheckなどの適切なデフォルトを使用します。
出力形式
ビーズはbd createコマンドとヒアドキュメント構文を使用して、特殊文字を安全に処理します:
# エピックを作成(ソースPRDへのリンク)
bd create --type=epic \
--title="[機能名]" \
--description="$(cat <<'EOF'
[PRDからの機能説明]
EOF
)" \
--external-ref="prd:./tasks/feature-name-prd.md"
# 子ビーズを作成(受け入れ基準に品質ゲートを含む)
bd create \
--parent=EPIC_ID \
--title="[ストーリータイトル]" \
--description="$(cat <<'EOF'
[受け入れ基準を含むストーリー説明(品質ゲートも含む)]
EOF
)" \
--priority=[1-4]
重要: ヒアドキュメントの区切り文字には常に
<<'EOF'(シングルクォート)を使用してください。これにより、説明内のバッククォート、$variables、()がシェルによって解釈されるのを防ぎます。
ストーリーサイズ:最も重要なルール
各ストーリーは、ralph-tuiの1回のイテレーション(約1エージェントコンテキストウィンドウ)で完了可能でなければなりません。
ralph-tuiはイテレーションごとに新しいエージェントインスタンスを生成し、以前の作業の記憶はありません。ストーリーが大きすぎると、エージェントはコンテキストが不足して完了できません。
適切なサイズのストーリー:
- データベースカラムとマイグレーションの追加
- 既存ページへのUIコンポーネントの追加
- 新しいロジックによるサーバーアクションの更新
- リストへのフィルタードロップダウンの追加
大きすぎる(分割が必要):
- 「ダッシュボード全体を構築」→ スキーマ、クエリ、UIコンポーネント、フィルターに分割
- 「認証を追加」→ スキーマ、ミドルウェア、ログインUI、セッション処理に分割
- 「APIをリファクタリング」→ エンドポイントまたはパターンごとに1ストーリーに分割
目安: 変更を2〜3文で説明できない場合、それは大きすぎます。
ストーリーの順序:依存関係を優先
ストーリーは依存関係の順序で実行されます。前のストーリーは後のストーリーに依存してはいけません。
正しい順序:
- スキーマ/データベースの変更(マイグレーション)
- サーバーアクション / バックエンドロジック
- バックエンドを使用するUIコンポーネント
- データを集約するダッシュボード/サマリービュー
間違った順序:
- ❌ UIコンポーネント(まだ存在しないスキーマに依存)
- ❌ スキーマ変更
bd dep addを使用した依存関係
bd dep addコマンドを使用して、最初に完了する必要があるビーズを指定します:
# 最初にビーズを作成
bd create --parent=epic-123 --title="US-001: スキーマ追加" ...
bd create --parent=epic-123 --title="US-002: API作成" ...
bd create --parent=epic-123 --title="US-003: UI構築" ...
# 次に依存関係を追加(issueはdepends-onに依存)
bd dep add ralph-tui-002 ralph-tui-001 # US-002はUS-001に依存
bd dep add ralph-tui-003 ralph-tui-002 # US-003はUS-002に依存
構文: bd dep add <issue> <depends-on> — issueはdepends-onに依存(ブロック)されます。
ralph-tuiは次のことを行います:
- 依存関係が完了するまでブロックされたビーズを「blocked」と表示
- 依存関係が開いている間は、ビーズを実行対象として選択しない
- ビーズに取り組む際に、プロンプトに依存関係のコンテキストを含める
正しい依存関係の順序:
- スキーマ/データベースの変更(依存関係なし)
- バックエンドロジック(スキーマに依存)
- UIコンポーネント(バックエンドに依存)
- 統合/ポリッシュ(UIに依存)
受け入れ基準:品質ゲート+ストーリー固有
各ビーズの説明には、次の受け入れ基準を含める必要があります:
- PRDからのストーリー固有の基準(このストーリーが達成すること)
- PRDの品質ゲートセクションからの品質ゲート(最後に追加)
良い基準(検証可能):
- 「investorテーブルにデフォルト'cold'の
investorTypeカラムを追加」 - 「フィルタードロップダウンにオプション:すべて、コールド、フレンド」
- 「トグルをクリックすると確認ダイアログが表示される」
悪い基準(曖昧):
- ❌ 「正しく動作する」
- ❌ 「ユーザーがXを簡単にできる」
- ❌ 「良いUX」
- ❌ 「エッジケースを処理する」
変換ルール
- PRDから品質ゲートを抽出する
- 各ユーザーストーリー→1つのビーズ
- 最初のストーリー: 依存関係なし(基盤を作成)
- 後続のストーリー: 先行ストーリーに依存(UIはバックエンドに依存するなど)
- 優先度: 依存関係の順序、次にドキュメントの順序に基づく(0=クリティカル、2=中、4=バックログ)
- すべてのストーリー:
status: "open" - 受け入れ基準: ストーリー基準+品質ゲートを追加
- UIストーリー: UI固有のゲートも追加(ブラウザ確認)
大きなPRDの分割
PRDに大きな機能がある場合は、分割します:
元のPRD:
「異なるメッセージングでフレンドアウトリーチトラックを追加」
分割後:
- US-001: データベースにinvestorTypeフィールドを追加
- US-002: 投資家リストUIにタイプトグルを追加
- US-003: フレンド固有のフェーズ進行ロジックを作成
- US-004: フレンドメッセージテンプレートを作成
- US-005: フレンドのタスク生成を配線
- US-006: タイプによるフィルターを追加
- US-007: 新規投資家フォームを更新
- US-008: ダッシュボードカウントを更新
それぞれが1つの焦点を絞った変更であり、独立して完了および検証できます。
例
入力PRD:
# PRD: フレンドアウトリーチ
投資家を「フレンド」としてマークし、温かいアウトリーチを行う機能を追加。
## 品質ゲート
すべてのユーザーストーリーで合格しなければならないコマンド:
- `pnpm typecheck` - 型チェック
- `pnpm lint` - リンティング
UIストーリーの場合、以下も含めます:
- dev-browserスキルを使用してブラウザで確認
## ユーザーストーリー
### US-001: investorテーブルにinvestorTypeフィールドを追加
**説明:** 開発者として、投資家を'cold'または'friend'に分類する必要があります。
**受け入れ基準:**
- [ ] investorTypeカラムを追加:'cold' | 'friend'(デフォルト'cold')
- [ ] マイグレーションを生成して実行
### US-002: 投資家リスト行にタイプトグルを追加
**説明:** Ryanとして、リストから直接投資家タイプを切り替えたい。
**受け入れ基準:**
- [ ] 各行にCold | Friendトグルがある
- [ ] 切り替えると確認ダイアログが表示される
- [ ] 確認時:データベースのタイプを更新
### US-003: 投資家をタイプでフィルター
**説明:** Ryanとして、フレンドまたはコールドだけを表示するようにリストをフィルターしたい。
**受け入れ基準:**
- [ ] フィルタードロップダウン:すべて | コールド | フレンド
- [ ] フィルターはURLパラメータに保持される
出力ビーズ:
# エピックを作成(ソースPRDへのリンク)
bd create --type=epic \
--title="フレンドアウトリーチトラック" \
--description="$(cat <<'EOF'
デッキフィードバックのための温かいアウトリーチ
EOF
)" \
--external-ref="prd:./tasks/friends-outreach-prd.md"
# US-001: 依存関係なし(最初 - スキーマを作成)
bd create --parent=ralph-tui-abc \
--title="US-001: investorテーブルにinvestorTypeフィールドを追加" \
--description="$(cat <<'EOF'
開発者として、投資家を'cold'または'friend'に分類する必要があります。
## 受け入れ基準
- [ ] investorTypeカラムを追加:'cold' | 'friend'(デフォルト'cold')
- [ ] マイグレーションを生成して実行
- [ ] pnpm typecheckがパスする
- [ ] pnpm lintがパスする
EOF
)" \
--priority=1
# US-002: UIストーリー(ブラウザ確認も追加)
bd create --parent=ralph-tui-abc \
--title="US-002: 投資家リスト行にタイプトグルを追加" \
--description="$(cat <<'EOF'
Ryanとして、リストから直接投資家タイプを切り替えたい。
## 受け入れ基準
- [ ] 各行にCold | Friendトグルがある
- [ ] 切り替えると確認ダイアログが表示される
- [ ] 確認時:データベースのタイプを更新
- [ ] pnpm typecheckがパスする
- [ ] pnpm lintがパスする
- [ ] dev-browserスキルを使用してブラウザで確認
EOF
)" \
--priority=2
# 依存関係を追加:US-002はUS-001に依存
bd dep add ralph-tui-002 ralph-tui-001
# US-003: UIストーリー
bd create --parent=ralph-tui-abc \
--title="US-003: 投資家をタイプでフィルター" \
--description="$(cat <<'EOF'
Ryanとして、フレンドまたはコールドだけを表示するようにリストをフィルターしたい。
## 受け入れ基準
- [ ] フィルタードロップダウン:すべて | コールド | フレンド
- [ ] フィルターはURLパラメータに保持される
- [ ] pnpm typecheckがパスする
- [ ] pnpm lintがパスする
- [ ] dev-browserスキルを使用してブラウザで確認
EOF
)" \
--priority=3
# 依存関係を追加:US-003はUS-002に依存
bd dep add ralph-tui-003 ralph-tui-002
出力場所
ビーズは.beads/beads.jsonlに書き込まれます。
作成後、ralph-tuiを実行します:
# 特定のエピックで作業
ralph-tui run --tracker beads --epic ralph-tui-abc
# または、自動的に最適なタスクを選択させる
ralph-tui run --tracker beads
ralph-tuiは次のことを行います:
- 指定されたエピック内のビーズで作業(または利用可能な最適なタスクを選択)
- 各ビーズが完了したら閉じる
- すべての子が完了したらエピックを閉じる
- エピックが完了したら
<promise>COMPLETE</promise>を出力
ビーズ作成前のチェックリスト
- PRDから品質ゲートを抽出した(または欠けている場合はユーザーに尋ねた)
- 各ストーリーが1回のイテレーションで完了可能(十分に小さい)
- ストーリーが依存関係の順序で並んでいる(スキーマ → バックエンド → UI)
- すべてのビーズの受け入れ基準に品質ゲートが追加されている
- UIストーリーにブラウザ確認が含まれている(品質ゲートで指定されている場合)
- 受け入れ基準が検証可能(曖昧でない)
- どのストーリーも後のストーリーに依存していない(前のストーリーのみ)
- ビーズ作成後に
bd dep addで依存関係が追加されている