Review 作成ガイド(ユーザーによる納品結果確認)
目的と位置づけ
- このガイドは、開発完了後にユーザーと納品結果を確認するために使います。
- 核心は、ユーザーフィードバックの収集と記録、実装結果と期待との差異分析、そしてユーザーが求める修正事項の記録です。
- Draft:業務目標とユーザーフロー
- Plan:技術受け入れチェックリストと実行範囲
- Code / Iteration:実際の実装内容とテスト結果
フロー
- ユーザーフィードバック
- Draft のユーザーフローを確認シナリオとして使い、ユーザーの口頭フィードバックを受け取ります。
- 記録項目:タイトル、内容、分類(Bug / Design / Copy / Performance / Accessibility / Suggestion)、優先度 / 重大度、ページ / モジュール、必要に応じて端末 / 言語 / テーマ、操作経路 / 再現手順、期待結果、実際結果、証跡。
- 差異分析
- 各フィードバックについて、期待と実際の差異を説明します。
- 記録項目:差異種別(乖離 / 欠落 / 誤解 / 体験)、参照(Draft / Plan)、根因分類(要件 / 実装 / 設計 / データ / 環境)、影響範囲、処理提案(修正 / 反復 / 保留)。
- 修正事項
- ユーザーが修正を希望したフィードバックについて、修正項目を登録します。
- 記録項目:修正要約、対象ファイル、契約 / 型同期(はい / いいえ + 注記)、UI / 文言変更(はい / いいえ + 注記)、検証記録(操作 / 断言)、状態(未着手 / 進行中 / 完了)。
記録要点(テンプレート対応)
- 記録するのは次の3種類のみです。
- ユーザーフィードバック(タイトル / 内容 / 分類 / 優先度または重大度)
- 差異分析(期待 vs 実際、理由の要約)
- 修正事項(修正要約、対象ファイル、必要なら契約 / 型同期)
完了定義(DoD)
- ユーザーフィードバック、差異分析、修正事項の3種類がすべて揃っていること。
- 修正事項がユーザー要求と一致していること。さらに修正が必要なら Iteration へ進むこと。
- Review 文書が出力され、後続の反復またはアーカイブの基準になること。
出力と保存