レビュー・テスト・再リサーチループ 各テンプレート項目の詳細記入例・解説 拡充版

作成者: Manus AI
対象: 非エンジニア起点の開発、AI支援開発、要件定義、仕様策定、ハーネス設計、テスト計画、レビュー、再リサーチ、再提案

1. この文書の使い方

この文書は、レビュー・テスト・再リサーチループで使用する主要テンプレートについて、各項目に何を書けばよいかを具体的に示す記入ガイドである。単なる空欄テンプレートではなく、悪い記入例、良い記入例、解説、判定ポイント、次に接続すべきテンプレートを併記している。

非エンジニアは、すべての技術的判断を自分で行う必要はない。重要なのは、自分の希望、目的、優先順位、許容できるリスクを明確に伝えることである。技術的妥当性、規約、セキュリティ、CI、ハーネス、テスト網羅性は、このテンプレート体系とレビュー担当が検出する。

記入の原則は、曖昧な希望を、検証可能な要件と安全に試せる計画へ変換することである。

2. Intent Sheet 詳細記入例

Intent Sheetは、素人の希望をそのまま実装タスクにせず、目的、対象者、成功条件、不明点、制約へ分解するためのテンプレートである。ここでの品質が低いと、その後の要件、仕様、テスト、レビューがすべて曖昧になる。

3. Evidence Matrix 詳細記入例

Evidence Matrixは、要件の根拠を管理するためのテンプレートである。特にMust要件には、公式情報、規約、技術文書、論文、信頼できる事例などの根拠を接続する。

4. Requirement Register 詳細記入例

Requirement Registerは、希望を検証可能な要件へ変換する台帳である。要件は「作るもの」ではなく、「満たすべき条件」として書く。各要件には根拠、受入基準、テスト、リスクを接続する。

5. Acceptance Criteria 詳細記入例

Acceptance Criteriaは、Product Ownerや非エンジニアが「これなら受け入れられる」と判断する条件である。エンジニア向けの内部実装条件ではなく、ユーザー価値と観測可能な結果を書く。

6. Technical Requirements 詳細記入例

Technical Requirementsは、実装方式、制約、非機能要件、外部連携、データ設計、代替案をまとめるテンプレートである。ここでは「何を作るか」ではなく、「どの条件で安全に実現するか」を定義する。

7. Harness Plan 詳細記入例

Harness Planは、壊れないように作り、試し、戻せるようにするための安全設計である。AI支援開発や自動化では、ハーネスがない状態での本番接続はRedとする。

8. Test Plan 詳細記入例

Test Planは、要件、受入基準、ハーネス、リスクを検証へ接続するための計画である。テストは最後に作るものではなく、要件定義の時点から作る。

9. Codex Review Report 詳細記入例

Codexレビューは、実装、差分、テスト、CI、破壊的変更、セキュリティを確認するためのレビューである。事業判断ではなく、技術的破綻を検出する。

10. Opus Review Report 詳細記入例

Opusレビューは、要件、目的適合、採否、規約、運用、事業リスク、長期保守性を確認するためのレビューである。コードの細部よりも、プロジェクトとして進めるべきかを評価する。

11. Gate Log 詳細記入例

Gate Logは、各フェーズで進める、条件付きで進める、止めるを判断する記録である。YellowとRedには、必ず担当、期限、解除条件を付ける。

12. Re-Research Log 詳細記入例

Re-Research Logは、レビューやテストで見つかった不明点、根拠不足、矛盾、規約リスク、未知の破綻条件を再調査するための台帳である。

13. Re-Proposal 詳細記入例

Re-Proposalは、再リサーチやレビューで得た発見を、要件、仕様、ハーネス、テスト、計画へ戻すための提案書である。これがないと、調査だけして実装が安全にならない。

14. Progress & Task Management 詳細記入例

進捗管理テンプレートでは、単なる作業状況ではなく、要件、根拠、リスク、レビュー、テストとの接続を管理する。

15. Change Impact Log 詳細記入例

変更影響ログは、再提案や仕様変更がどこに影響するかを管理する。これがないと、要件だけ更新されてテストやハーネスが古いままになる。

16. Done 判定チェックリスト 詳細記入例

Doneは「実装が終わった」ではない。要件、根拠、テスト、レビュー、ハーネス、変更履歴が揃い、残リスクが許容されている状態である。

17. 記入品質を上げる共通ルール

すべてのテンプレートに共通する品質ルールは、曖昧語を避け、IDで接続し、判定と次アクションを書くことである。

18. 最終的な使い分け

テンプレートは数が多いため、状況に応じて使い分ける。初回は最小セット、本格運用では全体セット、問題発生時は再リサーチ・再提案セットを使う。

19. 結論

この詳細記入例を使うことで、非エンジニアはテンプレートの空欄を前にして迷わず、何をどの粒度で書けばよいかを判断できる。重要なのは、正しい専門用語を並べることではなく、目的、根拠、要件、テスト、リスク、レビュー、再リサーチ、再提案を切れ目なく接続することである。

この接続が成立していれば、素人が最初に伝えた「やりたいこと」は、世界最高基準の要件定義、仕様、技術要件、ハーネス設計、テスト計画、レビュー、改善ループへ変換される。逆に、この接続が切れている部分が、プロジェクト破綻、品質事故、本番破壊、運用不能の発生点になる。