コンテンツにスキップ

PRD(プロダクト要求仕様書)テンプレートと運用ルール

新規に機能開発や改修を提案する際は、このテンプレートを使用してPRDを作成してください。

📂 ステータス管理のルール

Zensical上でのPRDのステータスは、**「ファイルがどのフォルダに置かれているか」**で判断します。ステータスが変わった場合は、ファイルを適切なフォルダへ移動させてコミットしてください。

  • 🟡 検討中・レビュー中: docs/prds/drafts/
  • 🟢 承認済み・開発中: docs/prds/active/
  • ⚪️ 開発完了・見送り: docs/prds/archived/

📝 コピー&ペースト用 雛形

作成するステータス(保存先フォルダ)に合わせて、以下のコードをコピーして新しい .md ファイルを作成してください。

🟡 1. 検討中(Draft)の場合

docs/prds/drafts/ にファイルを作成し、以下の内容を貼り付けます。

---
icon: lucide/file-edit
tags:
  - PRD
  - Draft
---
# [機能・プロダクト名] のPRD

!!! warning "ステータス:検討中(ドラフト)"
    このドキュメントは現在**レビュー・議論中**です。仕様が大きく変わる、または開発が見送られる可能性があります。

## 1. メタデータ
- **作成者**: [あなたの名前]
- **作成日**: YYYY/MM/DD

## 2. 目的と背景 (Why)
- **なぜこれを作るのか?**: [解決したい課題や背景]
- **目指すゴール**: [リリース後の理想の状態]

## 3. ターゲットユーザー (Who)
- **誰のための機能か?**: [具体的なペルソナ]

## 4. ユーザーメリットと想定効果 (Value & ROI)
- **ユーザーが得られる価値**: [ユーザーのどんな痛みを解消するか]
- **想定効果**: [工数削減、コスト削減などのビジネスインパクト]

## 5. 機能要件 (What)
- **主要な機能 / ユーザーストーリー**: 
  - [ユーザー] は [目的] を達成するために [機能] ができる。

## 6. 非機能要件・やらないこと
- **システム要件**: [パフォーマンス、セキュリティ制約など]
- **今回のスコープ外**: [開発の肥大化を防ぐために, あえてやらないこと]

🟢 2. 承認済み(Active)に昇格させる場合

PRDが承認され、docs/prds/active/ にファイルを移動させる際は、**先頭の警告ブロック(!!! warning...)を削除**し、代わりに以下のような「承認済み」のコールアウトに変更(または削除)してください。

!!! success "ステータス:承認済み(開発中)"
    このPRDは承認され、現在開発が進められています。
    👉 関連する開発チケット: [GitHub Issue / PRのURL]

⚪️ 3. 見送り(Archived)にする場合

議論の結果、今回は開発を見送る(No Go)となった場合は、ファイルを docs/prds/archived/ に移動させ、先頭に以下のブロックを追記してください。

!!! failure "ステータス:見送り(Archived)"
    この提案は以下の理由により、現在の開発スコープからは見送られました。
    **見送りの理由:** [ROIが合わないため、〇〇の制約のため など]