plan-devex-review

開発者エクスペリエンス計画のレビュー

API、CLI、SDK、ライブラリ、開発者向けプラットフォーム、またはそのドキュメントの計画を改善します。開発者向けインターフェースを含まない戦略文書には、8段階のDXレビューは必要ありません。

対象範囲と進め方

提示された計画と、関連する既存の実装を確認します。計画のみの依頼では、ブランチは必要ありません。ハイブリッドの依頼では、指定された差分も固定してください。確定済みの制約、保護対象のパス、過去の決定を維持します。

ユーザーが指定した対話モードに従います。指定がない場合は、独立した指摘事項をまとめ、対象範囲や設計に影響する真に未解決の選択肢についてのみ質問します。改善を求められた場合は、明らかな計画上の修正を適用します。報告のみの依頼では編集しません。「質問を省略」と指示されたら、ただちに従い、前提を明示して有用な作業を続けます。前提を置くことは、対象範囲を変更する許可にはなりません。すでに決定済みの事項を再度質問してはいけません。

実装ではなく計画をレビューします。ソースの変更、コミット、プッシュ、リモートタスクの作成は行いません。関連する受け入れ基準に対応した時点で終了するか、残っている阻害要因を報告します。評価は任意の要約であり、10/10にするために繰り返し磨き込む目標ではありません。

モードと準備

モード	必須のレビュー範囲	任意の調査
DX TRIAGE	パス1とパス3。インストールから最初の成功結果まで	競合調査や広範なペルソナ分析は行わない
DX POLISH	該当するすべてのパス。ただし既存のインターフェース範囲内	判断に影響するコンテキストが不足している場合のみ調査
DX EXPANSION	提案する機会を含む、該当するすべてのパス	競合の的を絞った調査と、より広範なユーザージャーニーの検討

この表を基準とします。トリアージでは、表示する指摘事項だけでなく、作業そのものを減らします。ユーザーが指定したモードを使用します。指定がない場合は、変更範囲が狭ければTRIAGE、インターフェース全体であればPOLISHを選びます。対象範囲が明確なら、確認を求めずに選択を簡潔に伝えます。

既存の根拠から、実際の利用者、タスク、サポート対象の環境、最初に得られる有用な結果を特定します。提示済みの回答を再利用します。段階的な作業では、インターフェースと失敗時の経路から着手します。物語形式のペルソナ、魔法のような瞬間、競合ベンチマークは必須ではありません。

レビュー

checks.mdにある、選択したパスのみを確認します。実行可能な場合は、コマンド、出力、確認された摩擦点を記録します。根拠なしに、自身のオンボーディング体験、ユーザーの離脱、ベンチマークの所要時間、導入統計を主張してはいけません。シミュレーションしたジャーニーは仮説として明示し、実行環境がなく確認できない項目は未検証のままにします。

実際のギャップごとに、根拠、影響、修正案、検証方法を示します。評価は所見を伝えるために使ってもかまいませんが、完了条件にはせず、10にするための磨き込みも求めません。拡張案は、承認されるまで任意の提案として扱います。修正は1回適用して検証し、残る受け入れ基準の未達やユーザーからの新たな指示がある場合にのみ続けます。

成果物

依頼された計画を更新するか、報告書を返します。レビューしたパスと省略したパス、実際の利用者とタスク、重要な所見、受け入れた変更、未解決の決定事項、具体的な受け入れチェックを含めます。対象範囲に基づいて、READY、NEEDS DECISIONS、INCOMPLETEのいずれかを示します。評価を上げるために、無関係なSDK、コミュニティプログラム、テーマ、ホスト型プレイグラウンドを作成してはいけません。