prd-implementation-precheck

PRD 実装前チェック

概要

短い PRD の事前チェックを行い、重大な問題を明らかにしてから実装します。選択肢の不足によって動作、アーキテクチャ、データ、または外部への副作用が大きく変わる場合に限り、ユーザーに質問します。

ワークフロー

1. PRD と参照ファイルを特定します。
2. PRD を事前チェックし、意図を 1～2 文で要約します。
3. 問題点と質問を、ブロッカーを先にして列挙します。重大なブロッカーがない場合は、前提を示して続行します。
4. ブロッカーがある場合は、実装の前にユーザーと解決します。
5. 検証（テストまたは手動の手順）を行うか、実行しなかった内容を明記します。

事前チェックリスト

基本チェック

• スコープ：過度に広い変更を特定し、より小さく対象を絞った方法を提案します。
• 整合性：既存のパターンやアーキテクチャとの競合を指摘し、代替案を提案します。
• 依存関係：不足しているフック、プロバイダー、データソース、または責任の所在が不明確な点を確認します。
• 動作：フローとエッジケースが定義されていることを確認し、不足があれば質問します。
• リスク：パフォーマンス、リグレッション、移行に関するリスクを挙げます。
• テスト：成功基準とテストカバレッジを確認し、曖昧な場合は詳細を求めます。

エッジケースの網羅性チェック

PRD で以下のエッジケースに対処していることを確認します（不足している場合は ⚠️ を付けます）。

データ境界

• Null／空の値の処理 - 入力が空の場合や値が null の場合、どうなりますか？
• 境界値 - 最小値／最大値は定義されていますか？境界ではどうなりますか？
• 重複データ - 重複はどのように検出、処理されますか？
• データ形式 - 入力形式は検証されますか？特殊文字はどう扱われますか？

状態の境界

• 状態遷移 - 有効な状態遷移はすべて定義されていますか？
• 無効な遷移 - 不正な状態変更が行われた場合、どうなりますか？
• 同時変更 - 同時に編集が行われた場合、どのように処理されますか？
• ロールバックのシナリオ - 操作を元に戻せますか？その方法は定義されていますか？

エラーの境界

• ネットワーク障害 - API 呼び出しに失敗した場合、どうなりますか？
• タイムアウトの動作 - タイムアウトは定義されていますか？リトライ戦略はどうなっていますか？
• 部分的な失敗 - 3 ステップ中 2 番目のステップが失敗した場合、1 番目のステップはどうなりますか？
• エラーメッセージ - ユーザーに表示するエラーメッセージは定義されていますか？

UX の境界

• 空の状態 - データがない場合、ユーザーには何が表示されますか？
• 読み込み中の状態 - 読み込み中であることはどのように示されますか？
• 成功時のフィードバック - 操作が成功したことをユーザーはどのように確認できますか？
• 権限の拒否 - ユーザーに権限がない場合、どうなりますか？

コードベースとの整合性チェック

コードベースを調査し、PRD が既存のパターンと整合していることを確認します。

# Check if PRD's proposed patterns match existing code
grep -r "pattern_from_prd" src/ --include="*.ts"

• 削除戦略 - PRD は既存の論理削除／物理削除のパターンに合っていますか？
• エラー処理 - PRD は既存と同じエラー表示の仕組みを使用していますか？
• コンポーネントの再利用 - PRD は既存のコンポーネントを活用していますか？
• API のパターン - PRD は既存の API 規約に従っていますか？

出力形式

事前チェックレポートのテンプレート

## PRD Precheck Report

### Summary
{1-2 sentence summary of what the PRD aims to achieve}

### ✅ Covered Edge Cases
- {List edge cases that are well-defined in the PRD}

### ⚠️ Missing Edge Cases
| Edge Case | Category | Suggested Default | Needs Confirmation |
|-----------|----------|-------------------|-------------------|
| Empty list display | UX | Use existing EmptyState | No |
| Concurrent edit | State | Last write wins | **Yes** |

### 🔴 Blockers
- {Critical issues that must be resolved before implementation}

### 🟡 Warnings
- {Non-critical issues that should be addressed}

### Questions for User
1. {Specific question about missing edge case}
2. {Specific question about ambiguous requirement}

---

**Proceed as-is, or update the PRD?**

出力に関する期待事項

• 質問とリスクを含む、簡潔な事前チェックレポートを提示します。
• 回答によって実装が大きく変わる場合に限り、「このまま進めますか、それとも PRD を更新しますか？」と尋ねます。
• ブロッカーがない場合は、前提を示して続行し、不要な確認を重ねません。