prd-generator

PRD ジェネレーター

目的

的を絞った質問と構造化された出力を通じて、粗いプロダクトアイデアを、包括的で AI 対応のプロダクト要件定義書（PDF）に変換します。

---

実行ロジック

まず $ARGUMENTS を確認し、実行モードを判定します。

$ARGUMENTS が空、または指定されていない場合：

次のように応答します。 「prd-generator を読み込みました。プロダクトのアイデアを説明してください」

その後、次のメッセージでユーザーがプロダクトのコンセプトを伝えるまで待ちます。

$ARGUMENTS に内容が含まれている場合：

すぐにタスクの実行に進みます（「読み込みました」というメッセージは省略します）。

---

タスクの実行

1. 必須：最初に参照ファイルを読む

ブロッキング要件 — この手順を省略しないでください

ほかのことを始める前に、Read ツールを使って次のファイルを読みます。

• ./references/prd_template.md

このテンプレートでは、PRD が従うべき正確な構成を定義しています。このファイルを読むまで、手順 2 に進まないでください。

2. ビジネスコンテキストは参照しない

このスキルでは、意図的に FOUNDER_CONTEXT.md を読み込みません。 PRD は独立したドキュメントであり、必要なコンテキストをすべて含める必要があります。

3. 初期入力を分析する

ユーザーの最初の説明から、次の情報を抽出します。

• プロダクト名または仮称
• 解決する中心的な課題
• 対象ユーザー／対象者
• 言及されている主要機能
• 技術面の希望（あれば）
• 制約や要件（あれば）

4. 明確化のための質問をする

不足している情報を集めるため、AskUserQuestion ツールを使用します。質問は最大 7 件までにしますが、少ないほど望ましく、包括的な PRD を作成するのに十分な情報が得られた時点で質問を終了します。

質問バンク（優先順位順）：

#	質問	重要な理由	省略する条件
1	主なユーザーは誰ですか？役割と技術レベルを教えてください。	UX に関するすべての判断と機能の複雑さを左右します	ユーザーペルソナが明確に説明されている
2	解決する中心的な課題は何ですか？ユーザーがこれを使えない場合、何が起こりますか？	価値提案と成功指標を定義します	課題が明確に述べられている
3	リリース時に必須となる機能（P0）を 3～5 個挙げてください。	スコープの拡大を防ぎ、MVP に集中できます	機能が明確な優先順位とともにすでに列挙されている
4	技術面の希望や制約はありますか？（言語、フレームワーク、ホスティング）	技術アーキテクチャのセクションを決定します	技術スタックが指定されている
5	必要な連携はありますか？（認証プロバイダー、API、サードパーティサービス）	依存関係と連携の複雑さを特定します	外部サービスへの言及がない、またはユーザーが単独で動作すると述べている
6	成功とはどのような状態ですか？追跡する具体的な指標はありますか？	目標と成功指標のセクションを定義します	指標や目標がすでに示されている
7	デザインの希望や、従うべき既存のブランドガイドラインはありますか？	UI/UX 要件のセクションを形作ります	デザインの自由度が高い、またはすでに説明されている

質問の進め方：

• AskUserQuestion を使って、1 回につき 2～4 件の質問をします
• 最初の質問群への回答で十分な詳細が得られた場合は、質問を終了します
• 質問の合計が 7 件を超えないようにします
• 可能な場合は、関連する質問をまとめます

5. PRD を生成する

./references/prd_template.md のテンプレート構成に沿って、完全な PRD を作成します。

1. テンプレートの該当するセクションをすべて埋めます
2. 具体的に記述します。曖昧な要件からは、曖昧なコードが生まれます
3. すべての機能に受け入れ基準を記載し、テスト可能な内容にします
4. 優先順位を厳格に付けます。P0 は機能全体の 30～40％にします
5. 「AI 向け実装メモ」セクションは必須です。これにより AI 対応の PRD になります

6. PDF を保存して変換する

手順 6a：出力フォルダーを作成する

mkdir -p ./prd_outputs/[Project Name]/

スペースを含むプロダクト名を使います。例：./prd_outputs/Churn Prevention Tool/

手順 6b：Markdown ファイルを保存する PRD の内容を次の場所に書き込みます。

./prd_outputs/[Project Name]/[project_name]_PRD.md

ファイル名にはスネークケースを使います。例：churn_prevention_tool_PRD.md

手順 6c：PDF に変換する 次を実行します。

npx md-to-pdf "./prd_outputs/[Project Name]/[project_name]_PRD.md"

これにより、同じフォルダー内に [project_name]_PRD.pdf が作成されます。

7. 出力を確認する

ユーザーに次の内容を伝えます。

• PDF の保存先（フルパス）
• Markdown ソースの保存先
• PRD の内容の簡単な概要

---

執筆ルール

基本ルール

• すべての機能に、テスト可能な受け入れ基準を必ず設定します
• 曖昧な表現ではなく、具体的な数値を使います（「すばやく読み込む」ではなく「2 秒未満で読み込む」）
• P0 の機能は全機能の 30～40% にします。すべてが P0 なら、P0 の意味がありません
• データモデルにはフィールドの型と関係性を含めます
• API 仕様にはリクエスト／レスポンスの例を含めます

PRD 固有のルール

• エグゼクティブサマリーは最大 3～5 文にします
• 問題の説明には、現状、課題、ビジネスへの影響を含める必要があります
• ユーザーペルソナは主要なものを最大 3 つにします。増やしすぎると混乱を招きます
• 技術アーキテクチャでは、データフローを平易な言葉で説明します。AI ツールは複雑な図よりも、この形式を適切に解釈できます
• AI 向け実装メモのセクションは必須です。省略しないでください

フォーマットルール

• Markdown の見出しを一貫して使用します（タイトルには #、セクションには ##、サブセクションには ###）
• 構造化データ（指標、データモデル、API 仕様）には表を使用します
• JSON の例と技術仕様にはコードブロックを使用します
• 受け入れ基準にはチェックボックスを使用します

---

出力形式

PRD は ./references/prd_template.md の構成に従います。以下は簡略化した例です。

# TaskFlow — Product Requirements Document

**Version:** 1.0
**Date:** 2024-01-15
**Author:** PRD Generator
**Status:** Draft

## Executive Summary
TaskFlow is a task management tool for remote engineering teams...

## Problem Statement
**Current state:** Teams use disconnected tools...
**Pain points:**
1. Context switching between tools
2. No visibility into team workload
3. Async communication gaps

**Impact:** 5+ hours/week lost per engineer...

## Goals & Success Metrics
| Goal | Metric | Target | Measurement |
|------|--------|--------|-------------|
| Reduce context switching | Tool switches/day | < 10 | Analytics |

## User Personas
### Engineering Manager
- **Role:** Manages 5-10 engineers
- **Goals:** Visibility into sprint progress...

## Functional Requirements

### FR-001: Task Creation
**Description:** Users can create tasks with title, description, assignee, and due date.

**User story:** As an engineer, I want to create tasks quickly so that I capture work items without friction.

**Acceptance criteria:**
- [ ] Task creation completes in < 500ms
- [ ] Title field is required, minimum 3 characters
- [ ] Due date defaults to end of current sprint

**Priority:** P0

...

## Implementation Notes for AI

### Build Order
1. Database schema (PostgreSQL)
2. API endpoints (Express.js)
3. Frontend components (React)
4. Auth integration (Clerk)

### Libraries to Use
- Prisma for ORM — type-safe, great DX
- TanStack Query for data fetching — handles caching
- Tailwind CSS for styling — utility-first, fast iteration

### Critical Implementation Details
- All dates stored as UTC, converted to user timezone on display
- Use optimistic updates for task status changes
- Implement soft deletes for all user-generated content

---

参考資料

タスクの実行前に、このファイルを必ず Read ツールで読み込んでください（ステップ 1 を参照）。

ファイル	目的
./references/prd_template.md	15 の全セクション、フォーマット例、使用上の注意を含む PRD の完全な構成

重要な理由： テンプレートを使うことで、すべての PRD の構成が一貫し、包括的になり、AI コーディングツールが解析して実装できるようになります。テンプレートを省略すると、重要なセクションが抜けた不完全な PRD になります。

---

品質チェックリスト（自己検証）

実行前の確認

• 開始前に ./references/prd_template.md を読みました
• テンプレートの構成を把握しています

質問の確認

• 質問したのは合計 7 件以下です
• 情報が実際に不足している場合にのみ質問しました
• 質問はまとめて行いました（AskUserQuestion の呼び出し 1 回につき 2～4 件）

PRD の内容確認

• エグゼクティブサマリーは 3～5 文です
• すべての機能に受け入れ基準（チェックボックス）があります
• P0 の機能は全体の約 30～40% です（すべてではありません）
• データモデルにフィールドの型が含まれています
• API 仕様にリクエスト／レスポンスの例が含まれています
• 「AI 向け実装メモ」セクションが完成しています

出力の確認

• Markdown ファイルを ./prd_outputs/[Project Name]/ に保存しました
• npx md-to-pdf で PDF を生成しました
• ファイルの保存場所をユーザーに伝えました

いずれか 1 つでも未達の場合 → 完了前に修正してください。

---

デフォルトと前提

ユーザーから指定がない場合は、次の内容を使用します。

• ドキュメントのバージョン： 1.0
• ステータス： Draft
• 作成者： PRD Generator
• 技術スタック： 指定がなければ、モダンなウェブ技術（React + Node.js + PostgreSQL）
• ホスティング： 指定がなければ、クラウドネイティブ（Vercel/Railway/AWS）
• 認証： 独自に構築する場合を除き、サードパーティ（Clerk/Auth0）
• 優先度の割合： P0 約 35%、P1 約 40%、P2 約 25%
• ユーザーペルソナ： 複雑さから追加が必要な場合を除き、最大 3 つ
• API スタイル： GraphQL の指定がなければ REST

採用した前提は、PRD の出力に記載してください。