prd-start

vfarcic/dot-ai の shared-prompts/prd-start.md から取り込まれたファイルです（MIT、Copyright (c) 2025 Viktor Farcic）。原著者：Viktor Farcic。

PRD Start - 実装作業の開始

手順

特定のプロダクト要件ドキュメント（PRD）に基づく実装作業の開始を支援します。このコマンドは実装コンテキストをセットアップし（準備状況の確認、ブランチの作成、環境の準備）、その後、タスクの特定を /prd-next に引き継ぎます。

Forge 非依存：以下の gh コマンドは GitHub の例です。git remote get-url origin から forge を判別し、各動詞を対応するコマンドに置き換えて、適切な CLI を使用してください。GitHub → gh、GitLab → glab（PR は マージリクエスト です。glab mr … を使用します）、Forgejo/Gitea → tea。必要な CLI がない場合は、ユーザーに伝えてインストールページへのリンクを示してください。

重要：回答に所要時間や作業量の見積もりを含めないでください。所要時間を推測せず、セットアップと準備状況に集中してください。

プロセスの概要

1. 対象の PRD を選択 - 実装する PRD を特定します
2. PRD の準備状況を検証 - PRD が実装に着手できる状態か確認します
3. 実装コンテキストをセットアップ - ブランチを作成し、環境を準備します
4. prd-next に引き継ぎ - タスクの特定を適切なプロンプトに委任します

ステップ 0：PRD 引数の確認

PRD 番号の引数（$ARGUMENTS）が指定されている場合：

• コンテキストの確認と自動検出をスキップします
• PRD #$ARGUMENTS を直接使用します
• ステップ 2（PRD の準備状況の検証）に進みます

prdNumber 引数が指定されていない場合：

• 以下のコンテキスト認識チェックに進みます

ステップ 0b：コンテキスト認識チェック

最近の会話から PRD のコンテキストがすでに明確か確認します：

最近の会話に次の内容がある場合は、検出をスキップします：

• 最近話し合った PRD 作業 - 「PRD 29 に取り組んだばかりです」「PRD の更新を完了しました」など
• 特定の PRD への言及 - 「PRD #X」「MCP プロンプトの PRD」など
• PRD 固有のコマンドの使用 - 最近 /prd-update-progress を使用した、または特定の PRD を指定して /prd-start を使用した場合
• 明確な作業コンテキスト - 既知の PRD に関する特定の機能、タスク、要件についての話し合い

コンテキストが明確な場合：

• 既知の PRD を使用して、ステップ 2（PRD の準備状況の検証）に進みます

コンテキストが不明確な場合：

• ステップ 1（PRD の検出）に進みます

ステップ 1：スマート PRD 検出（コンテキストが不明確な場合のみ）

次のコンテキスト上の手がかりを優先順に使用して、対象の PRD を自動検出します：

1. Git ブランチの分析 - 現在のブランチ名に PRD のパターンがあるか確認します：

   • feature/prd-12-* → PRD 12
   • prd-13-* → PRD 13
   • feature/prd-* → PRD 番号を抽出

2. 最近の Git コミット - 最近のコミットメッセージに PRD への言及があるか確認します：

   • "fix: PRD 12 documentation" → PRD 12
   • "feat: implement prd-13 features" → PRD 13

3. Git ステータスの分析 - 変更済みまたはステージ済みのファイルに PRD の手がかりがあるか確認します：

   • prds/12-*.md が変更されている → PRD 12
   • 機能固有のディレクトリに変更がある

4. 利用可能な PRD の検出 - prds/ ディレクトリ内のすべての PRD を一覧表示します

5. ユーザーに選択を依頼 - コンテキストの検出に失敗した場合に限り、ユーザーに指定を求めます

検出ロジック：

• 高い確度：ブランチ名が PRD のパターンに一致する（例：feature/prd-12-documentation-testing）
• 中程度の確度：Git ステータスに変更済みの PRD ファイルがある、または最近のコミットで PRD に言及している
• 低い確度：利用可能な PRD が複数ある場合、ヒューリスティクス（最も新しいもの、最も規模の大きいもの）を使用します
• コンテキストなし：利用可能な選択肢をユーザーに提示します

コンテキストの検出に失敗した場合は、ユーザーに尋ねます：

## Which PRD would you like to start implementing?

Please provide the PRD number (e.g., "12", "PRD 12", or "36").

**Not sure which PRD to work on?**
Run `/prds-get` to see all available PRDs organized by priority and readiness.

**Your choice**: [Wait for user input]

PRD が特定されたら：

• prds/[issue-id]-[feature-name].md から PRD ファイルを読み込みます

ステップ 2：PRD の準備状況の検証

実装を開始する前に、PRD の準備が整っているかを検証します：

要件の検証

• 機能要件：主要な要件が明確かつ網羅的に定義されていますか？
• 成功基準：測定可能な成功基準が設定されていますか？
• 依存関係：すべての外部依存関係が特定され、利用可能になっていますか？
• リスク評価：主要なリスクが特定され、軽減計画が作成されていますか？

ドキュメントの分析

ドキュメントファーストの PRD について：

• 仕様の網羅性：ユーザーワークフローを含め、機能が完全に文書化されていますか？
• 統合ポイント：既存機能との連携が文書化されていますか？
• API／インターフェース定義：すべてのインターフェースとデータ構造が指定されていますか？
• 例と使用方法：具体的な使用例が提示されていますか？

実装準備チェックリスト

## PRD Readiness Check
- [ ] All functional requirements defined
- [ ] Success criteria measurable
- [ ] Dependencies available
- [ ] Documentation complete
- [ ] Integration points clear
- [ ] Implementation approach decided

PRD の準備ができていない場合： 不足している内容をユーザーに伝え、まず PRD の計画を完了するよう提案します。

スコープの確認（すべての PRD に対して、実装や作業の割り当てを行う前に）

PRD に記載された内容に対して、/prd-create のスコープゲート（ステップ 1.2）を適用します。

• 即時停止：未完成の PRD を必要とするマイルストーンがあります。その内容を報告し、マイルストーンを該当 PRD に移すか、境界を引き直すことを提案します。作業は開始しません。
• スコープレビューの警告：独立して価値のある成果が複数ある場合、または大規模な PR が予想される場合は、具体的な分割案（子となる成果、それらの順序、ブロッカー）を、はい／いいえで答えられる提案として提示します。独立して価値のある単位に分割できないと判断した場合（たとえば、密接に結び付いたセキュリティ作業を完全な形で取り込む必要がある場合）は、その理由を述べ、PRD の Decision Log に記録してから続行します。/prd-full では、提案する分割は一時停止しないルールの適用外となる唯一の場面です。実装せず、分割案を出力して停止します。
• マイルストーン内のライブ受け入れチェックボックス：完了のカウント対象を実装のみにするため、リンクされた acceptance issue に移すことを提案します。

ステップ 3：実装コンテキストのセットアップ

⚠️ 必須：ステップ 4 に進む前に、このステップを完了してください

Issue の割り当て

作業中であることを示すため、GitHub issue を自分に割り当てます。

gh issue edit [issue-id] --add-assignee @me

これにより、他の人が同じ PRD に着手し、並行して作業するのを防ぎます。

Git ブランチの管理

1. 現在のブランチを確認：git branch --show-current を実行します。
2. main または master の場合：機能ブランチを作成して切り替えます。

   git checkout -b feature/prd-[issue-id]-[feature-name]
   

3. すでに機能ブランチにいる場合：この PRD に適したブランチであることを確認します。

開発環境のセットアップ

• 依存関係：PRD で必要となる新しい依存関係をインストールします。
• 設定：開発に必要な設定を行います。
• テストデータ：テストデータまたはモックサービスを準備します。

ステップ 3 のチェックポイント（必須）

ステップ 4 に進む前に、必ずこの確認メッセージを表示してください。

## Environment Setup ✅
- **Assignee**: @[username] ✅
- **Branch**: `[current-branch-name]` ✅
- **Status**: [Created new branch / Already on correct branch / Staying on main (reason)]

ブランチのセットアップが確認されるまで、ステップ 4 に進まないでください。

ステップ 4：prd-next への引き継ぎ

実装コンテキストのセットアップが完了したら、次のメッセージをユーザーに提示します。

## Ready for Implementation 🚀

**PRD**: [PRD Name] (#[PRD Number])
**Assignee**: @[username]
**Branch**: `[branch-name]`
**Status**: Ready for development

---

To identify and start working on your first task, run `/prd-next`.

⚠️ ここで停止してください。次のことは行わないでください。

• 作業するタスクを特定または推奨する
• 実装の優先順位やクリティカルパスを分析する
• 実装作業を開始する
• 引き継ぎメッセージの提示後も続ける

タスクの特定と実装に関するガイダンスは、/prd-next がすべて担当します。

成功基準

このコマンドでは、次のことを行います。

• ✅ 実装対象の PRD を正常に特定する
• ✅ PRD が開発作業を開始できる状態か検証する
• ✅ 重複作業を防ぐため、GitHub issue を現在のユーザーに割り当てる
• ✅ 適切な実装コンテキスト（ブランチ、環境）をセットアップする
• ✅ タスクの特定のため、/prd-next に引き継ぐ
• ✅ PRD の計画から開発環境のセットアップまでをつなぐ

注記

• このコマンドはセットアップのみに重点を置いています。準備状況を検証し、ブランチを作成して、環境を準備します。
• セットアップの完了後は、タスクの特定、実装に関するガイダンス、進捗管理をすべて /prd-next が担当します。