レビュー結果を基にしたCodex向け修正計画実行結果
対象: 競馬システム要件定義、および並列分析から抽出された共通課題レビュー結果
入力として扱ったレビュー結果: /home/ubuntu/common_requirements_issues_curated.md
関連参照: /home/ubuntu/requirements_improvement_world_class_template_action_plan.md
作成者: Manus AI
目的: 第三者レビューで抽出された課題を、実際に要件定義書へ反映できる修正計画へ変換する。
1. 実行結果の結論
今回のレビュー結果を基に修正計画へ変換すると、最優先で対応すべき対象は、要件ID台帳、フェーズ別Exit Criteria表、ロジック採用・停止基準表、データ品質チェックリスト、外部データ運用制約表、非機能・セキュリティ要件表の六つである。現行要件定義は、プロジェクト思想、競馬ドメインへの理解、AIへの制約、社長判断を中核に置く設計思想が非常に強い。一方で、レビュー結果から見ると、第三者が同じ品質で実装、検証、運用、保守できるようにするには、要件をID化、基準化、証跡化、図解化、運用化する必要がある。
修正計画の基本方針は、現行要件定義を作り直すことではなく、既存の強い思想を残したまま、実装・テスト・運用に接続できる管理形式へ変換することである。
| 優先度 | 最優先で作る成果物 | 解決する主な課題 | 期待される効果 |
|---|---|---|---|
| 1 | 要件ID台帳 | 要件の追跡不可、受入基準不足、検証方法不足 | 実装、レビュー、テスト、変更管理が要件単位で可能になる。 |
| 2 | フェーズ別Exit Criteria表 | フェーズ移行条件の曖昧さ | Phase 1、2、3の完了・移行判断を客観化できる。 |
| 3 | ロジック採用・停止基準表 | 社長判断・採用判断の属人化 | 人間の最終判断を残しながら、判断根拠を監査可能にできる。 |
| 4 | データ品質・外部データ運用表 | 欠損、異常値、取得失敗、規約制約の未整理 | AI/ML以前に、信頼できるデータ基盤を要件化できる。 |
| 5 | 非機能・セキュリティ・運用要件表 | 性能、可用性、権限、監査、障害対応の不足 | 「壊れない状態」を測定可能な基準に変換できる。 |
| 6 | UI図解・正式文書化 | 画面解釈のズレ、会話調文書の混在 | 開発者やAIが勝手に補完しない仕様にできる。 |
2. 修正優先順位
修正は、重要度が高いものから順に処理するだけではなく、後続成果物の前提になるものから進める必要がある。したがって、最初に要件ID台帳を作成し、そのIDをExit Criteria、受入基準、テスト観点、運用要件、ロジック採用基準へ紐づけるのが最も安定する。
| 順位 | 修正テーマ | 理由 | 先に終えるべき依存作業 |
|---|---|---|---|
| 1 | 要件ID体系の確定 | すべての修正・レビュー・テストの基準点になるため。 | 章構成と要件分類の確定。 |
| 2 | 要件ID台帳の作成 | 要件本文、理由、優先度、検証方法を一元管理するため。 | ID体系。 |
| 3 | 受入基準・検証方法の付与 | 要件が完了したかを判定できるようにするため。 | 要件ID台帳。 |
| 4 | フェーズ別Exit Criteriaの作成 | 開発フェーズの移行判断を客観化するため。 | 要件ID台帳、受入基準。 |
| 5 | ロジック採用・停止基準の作成 | 社長判断を再現可能かつ監査可能にするため。 | KPI、データ品質、バックテスト条件。 |
| 6 | 外部データ運用制約の定義 | JRDB等の外部依存がプロジェクトリスクになるため。 | データ要件、運用要件。 |
| 7 | データ品質・AI/ML運用基準の定義 | 未来データ混入、欠損、モデル劣化を防ぐため。 | 外部データ制約、ロジック基準。 |
| 8 | 非機能・セキュリティ・監査要件の定量化 | 本番運用に耐えるため。 | 権限、ログ、運用体制。 |
| 9 | UI/UX図解の作成 | 実装者による画面解釈のブレを防ぐため。 | 画面要件、権限要件。 |
| 10 | 正式要件定義書への統合 | 原文、決定事項、未決事項、正式要件を分離するため。 | 上記すべて。 |
3. 修正計画台帳
以下は、レビュー指摘を要件定義へ反映するための修正計画台帳である。Codexに実行させる場合は、この表をそのまま修正タスクとして扱い、各修正IDごとに対象ファイルを編集させるとよい。
| 修正ID | 対応する指摘ID | 修正対象 | 修正内容 | 反映先 | 影響範囲 | 優先度 | 作業時間目安 |
|---|---|---|---|---|---|---|---|
| REV-001 | ISSUE-03 | 要件全体 | F、UI、D、ML、OPS、NFR、SECのID体系を定義し、全要件へIDを付与する。 | requirements_id_table.md、正式要件定義書 |
全章、実装、テスト、変更管理 | Critical | 4〜6時間 |
| REV-002 | ISSUE-03 | 要件ID台帳 | 各要件に、要件本文、理由、優先度、担当候補、検証方法、受入基準、状態を追加する。 | requirements_id_table.md |
実装管理、QA、レビュー | Critical | 5〜7時間 |
| REV-003 | ISSUE-02 | フェーズ計画 | Phase 1〜3またはPhase 4までのExit Criteriaを、完了条件、証跡、未達時対応つきで定義する。 | exit_criteria.md、正式要件定義書 第4章 |
PM、開発計画、リリース判断 | Critical | 3〜5時間 |
| REV-004 | ISSUE-01 | 判断基準 | 社長承認、ロジック採用、停止、例外承認の判断基準を表にする。 | logic_governance.md、正式要件定義書 第10章 |
ロジック運用、AI/ML、監査 | Critical | 4〜6時間 |
| REV-005 | ISSUE-04 | 外部データ | JRDB等の外部データ取得可能時間、禁止時間、認証、失敗時リトライ、通知、手動復旧を定義する。 | external_data_operations.md、正式要件定義書 第8・12章 |
データ取得、運用、障害対応 | High | 3〜5時間 |
| REV-006 | ISSUE-05 | データ品質 | 欠損、重複、異常値、未来データ混入、形式変更、取得漏れの検知基準を作る。 | data_quality_checklist.md、正式要件定義書 第8章 |
AI/ML、バックテスト、QA | High | 4〜6時間 |
| REV-007 | ISSUE-06 | AI/ML運用 | バックテスト条件、再学習条件、停止条件、リーク防止、モデル監視を明文化する。 | ml_operations.md、正式要件定義書 第9章 |
モデル運用、評価、改善 | High | 4〜6時間 |
| REV-008 | ISSUE-08 | 非機能要件 | 性能、可用性、RTO、RPO、バックアップ、保守性、監視の目標値を定義する。 | non_functional_requirements.md、正式要件定義書 第13章 |
インフラ、運用、受入判断 | High | 3〜5時間 |
| REV-009 | ISSUE-09 | セキュリティ | 権限マトリクス、認証、認可、操作ログ、監査ログ、バックアップ方針を定義する。 | security_audit_requirements.md、正式要件定義書 第14章 |
管理画面、運用、監査 | High | 3〜5時間 |
| REV-010 | ISSUE-07 | UI/UX | 画面一覧、画面遷移、ワイヤーフレーム、空状態、エラー状態、権限別表示を作る。 | ui_specification.md、正式要件定義書 第7章 |
フロントエンド、受入テスト | Medium | 5〜8時間 |
| REV-011 | ISSUE-10 | 文書構造 | 原文メモ、正式要件、決定事項、未決事項、変更履歴を分離する。 | requirements.md、decision_log.md、open_issues.md |
全体、保守、引き継ぎ | Medium | 4〜6時間 |
| REV-012 | ISSUE-03/08 | テスト観点 | 要件IDごとに受入テスト、正常系、異常系、境界値、運用時検証を紐づける。 | acceptance_test_spec.md |
QA、リリース判定 | High | 4〜7時間 |
4. 具体的な修正文案
この章では、Codexに各ファイルへ反映させるための修正文案を示す。実際のファイル編集では、現行要件定義の章立てに合わせて挿入位置を調整する。
4.1 要件ID体系の追記案
本プロジェクトでは、すべての要件を実装、検証、運用、変更管理の単位として追跡できるよう、要件IDを付与する。機能要件はF、画面要件はUI、データ要件はD、AI/ML要件はML、運用要件はOPS、非機能要件はNFR、セキュリティ要件はSEC、外部制約はEXTの接頭辞を用いる。各要件は、要件本文、理由、優先度、検証方法、受入基準、関連画面、関連データ、状態を持つ。
| ID種別 | 対象 | 記入例 |
|---|---|---|
| F-xxx | 機能要件 | F-001: 外部データソースから対象データを取得できる。 |
| UI-xxx | 画面要件 | UI-001: ダッシュボードに本日の対象イベントを表示する。 |
| D-xxx | データ要件 | D-001: 取得データを指定スキーマで保存する。 |
| ML-xxx | AI/ML要件 | ML-001: バックテストでは未来データを使用しない。 |
| OPS-xxx | 運用要件 | OPS-001: 取得失敗時に管理者へ通知する。 |
| NFR-xxx | 非機能要件 | NFR-001: 主要画面は通常時3秒以内に表示する。 |
| SEC-xxx | セキュリティ要件 | SEC-001: 管理操作は管理者権限のみに限定する。 |
| EXT-xxx | 外部制約 | EXT-001: 外部データ提供元の規約を確認し、禁止事項を記録する。 |
4.2 要件ID台帳のテンプレート
| 要件ID | 分類 | 要件本文 | 理由 | 優先度 | 検証方法 | 受入基準 | 関連画面 | 関連データ | 状態 |
|---|---|---|---|---|---|---|---|---|---|
| F-001 | 機能 | 外部データソースから対象データを取得できる。 | 分析・判断の前提となるため。 | Must | 取得処理を実行し、ログと保存結果を確認する。 | 指定期間のデータが欠損なく保存され、失敗時ログが残る。 | 管理画面 | 対象データ | Draft |
| ML-001 | AI/ML | バックテストでは未来データを使用しない。 | 評価の信頼性を守るため。 | Must | 学習期間と評価期間を分離して検証する。 | 評価時点以降の情報が特徴量に含まれていないことを確認できる。 | ロジック検証画面 | 履歴データ | Draft |
| OPS-001 | 運用 | データ取得失敗時に管理者へ通知する。 | 放置による判断ミスを防ぐため。 | Must | 失敗を疑似発生させ通知を確認する。 | 失敗後、指定時間内に通知され、再実行手順が確認できる。 | 運用画面 | 取得ログ | Draft |
4.3 フェーズ別Exit Criteriaの追記案
各フェーズは、作業完了の感覚ではなく、成果物、証跡、受入基準によって完了判定する。Exit Criteriaを満たさない場合、次フェーズへ進まず、未達項目を課題台帳に登録する。例外的に次フェーズへ進む場合は、承認者、理由、リスク、暫定対応期限を記録する。
| フェーズ | 目的 | Exit Criteria | 証跡 | 未達時対応 | 承認者 |
|---|---|---|---|---|---|
| Phase 1 | データ取得と基礎検証 | 外部データ取得が再現可能であり、基本データ品質チェックが通過している。 | 取得ログ、品質チェック結果、再実行手順 | 欠損・失敗原因を課題化し、再取得または手動復旧を実施する。 | PM/責任者 |
| Phase 2 | ロジック候補の比較 | 複数ロジックを同一条件で比較でき、採用候補と保留候補を分類できる。 | ロジック台帳、バックテスト結果、比較表 | 検証条件不足の場合、対象期間や検証件数を追加する。 | PM/最終承認者 |
| Phase 3 | Web UI運用化 | 非エンジニアがUI上で取得、確認、採用判断、結果確認を実行できる。 | 操作デモ、受入テスト結果、運用手順書 | 操作不能箇所をUI課題として登録する。 | PM/運用責任者 |
| Phase 4 | 安定運用・改善 | 監視、障害対応、バックアップ、監査ログ、改善サイクルが定着している。 | 監視ログ、障害訓練記録、バックアップ確認 | 運用手順を改訂し、再訓練を実施する。 | 運用責任者 |
4.4 ロジック採用・停止基準の追記案
ロジックの採用、停止、保留、例外承認は、最終承認者の判断を尊重しつつ、判断根拠を記録できる形式で運用する。採用判断では、回収率、的中率、最大ドローダウン、検証件数、直近成績、説明可能性、データ品質、例外条件を確認する。停止判断では、成績悪化、データ品質違反、想定外の挙動、説明不能な推奨、運用リスクの増大を確認する。
| 項目 | 採用基準 | 停止基準 | 例外承認条件 | 証跡 |
|---|---|---|---|---|
| 検証件数 | 最低検証件数を満たす。 | 検証件数不足が判明した場合は保留または停止する。 | 承認者が理由を記録した場合のみ暫定採用可。 | 検証レポート |
| 回収率・成果KPI | 目標値または採用検討ラインを満たす。 | 継続的に停止ラインを下回る。 | 短期的な外部要因が説明できる場合のみ継続可。 | 成績表 |
| 最大ドローダウン | 許容損失幅内である。 | 許容損失幅を超える。 | リスク許容範囲の再承認が必要。 | リスクレポート |
| 説明可能性 | 推奨理由を説明できる。 | 推奨理由が説明不能、または業務常識に反する。 | 研究目的として隔離運用する場合のみ可。 | 判断理由ログ |
| データ品質 | 欠損・異常値・未来データ混入がない。 | 品質違反が検出された。 | 原因特定後、影響範囲を限定できる場合のみ可。 | 品質チェックログ |
4.5 データ品質チェックリストの追記案
| チェック項目 | 内容 | 合格条件 | 失敗時対応 | 証跡 |
|---|---|---|---|---|
| 欠損 | 必須項目に空値がないか確認する。 | 必須項目の欠損が許容範囲内である。 | 再取得、補完不可なら対象外にする。 | 品質ログ |
| 重複 | 同一キーの重複がないか確認する。 | 主キー重複がない。 | 重複削除または原因調査。 | 重複検出ログ |
| 異常値 | 数値範囲が業務上妥当か確認する。 | 定義済み範囲内である。 | 対象レコードを保留し、手動確認する。 | 異常値ログ |
| 未来データ混入 | 評価時点以降の情報が含まれないか確認する。 | 学習・評価期間が分離されている。 | 該当検証結果を無効化する。 | 期間チェック結果 |
| 形式変更 | 外部データのカラムや形式が変わっていないか確認する。 | 定義済みスキーマと一致する。 | パーサー修正まで処理を停止する。 | スキーマ検証ログ |
4.6 非機能・セキュリティ要件の追記案
| 分類 | 要件 | 目標値・基準 | 検証方法 | 証跡 |
|---|---|---|---|---|
| 性能 | 主要画面の表示速度 | 通常時3秒以内を目標とする。 | 性能テスト、実測ログ | 性能測定結果 |
| 可用性 | 業務時間内の利用可能性 | 重要な運用時間帯に利用可能であること。 | 監視ログ、障害記録 | 稼働ログ |
| 復旧 | 障害時復旧 | 障害発生時の一次対応手順が定義されていること。 | 障害訓練、手順レビュー | 訓練記録 |
| バックアップ | データ保全 | 重要データのバックアップと復元手順があること。 | 復元テスト | 復元記録 |
| 権限 | 管理操作制限 | 管理操作は管理者のみ実行可能であること。 | 権限テスト | 権限確認結果 |
| 監査 | 操作ログ | 誰が、いつ、何を変更したか追跡できること。 | ログ確認 | 監査ログ |
5. 影響を受ける要件ID案
現時点では要件ID台帳が未整備であるため、以下は新規に付与すべき要件ID案である。Codexで編集する際は、このID体系を起点として既存文書へ反映する。
| 新規要件ID | 要件名 | 関連修正ID | 関連成果物 |
|---|---|---|---|
| F-001 | 外部データ取得機能 | REV-001、REV-005 | 要件ID台帳、外部データ運用表 |
| F-002 | ロジック成績比較機能 | REV-004、REV-007 | ロジック採用・停止基準表 |
| UI-001 | ダッシュボード表示 | REV-010 | UI仕様書 |
| UI-002 | ロジック管理画面 | REV-004、REV-010 | UI仕様書、ロジック基準表 |
| D-001 | 外部データ保存スキーマ | REV-005、REV-006 | データ要件、品質チェックリスト |
| D-002 | 取得ログ・監査ログ保存 | REV-005、REV-009 | 監査ログ仕様 |
| ML-001 | バックテスト条件 | REV-004、REV-007 | AI/ML運用設計書 |
| ML-002 | 未来データ混入防止 | REV-006、REV-007 | データ品質チェックリスト |
| OPS-001 | データ取得失敗時対応 | REV-005、REV-008 | 運用手順書 |
| OPS-002 | 障害対応・問い合わせ対応 | REV-008、REV-009 | 運用要件表 |
| NFR-001 | 画面性能 | REV-008 | 非機能要件表 |
| NFR-002 | バックアップ・復旧 | REV-008、REV-009 | 非機能・セキュリティ要件表 |
| SEC-001 | 権限管理 | REV-009 | 権限マトリクス |
| SEC-002 | 操作ログ・監査ログ | REV-009 | 監査ログ仕様 |
| EXT-001 | 外部データ規約確認 | REV-005 | 外部規約・契約制約表 |
6. 追加すべき受入基準
受入基準は、各要件が「実装されたように見える」状態ではなく、第三者が合否判定できる状態にするための基準である。
| 要件ID | 受入基準 | 検証方法 | 合否証跡 |
|---|---|---|---|
| F-001 | 指定した対象期間の外部データを取得し、保存件数とログが確認できる。 | 取得処理を実行し、DBまたは保存ファイルとログを照合する。 | 取得ログ、保存件数一覧 |
| D-001 | 保存データが定義済みスキーマと一致する。 | スキーマ検証を実行する。 | スキーマ検証結果 |
| D-002 | 取得、変更、削除、採用判断の操作履歴が追跡できる。 | 操作後にログを確認する。 | 操作ログ、監査ログ |
| ML-001 | バックテスト条件が固定され、同じ条件で再実行できる。 | 同一条件で複数回実行し結果を比較する。 | バックテストレポート |
| ML-002 | 評価時点以降のデータが特徴量に含まれていない。 | 学習期間、評価期間、特徴量生成日時を確認する。 | 期間分離チェックログ |
| OPS-001 | データ取得失敗時に通知され、再実行または手動復旧手順が確認できる。 | 失敗ケースを疑似発生させる。 | 通知履歴、復旧記録 |
| NFR-001 | 主要画面が通常条件で3秒以内に表示される。 | 性能テストを行う。 | 性能測定結果 |
| SEC-001 | 管理者以外が管理操作を実行できない。 | 権限別操作テストを行う。 | 権限テスト結果 |
| SEC-002 | 誰が、いつ、何を変更したかをログで追跡できる。 | 変更操作後に監査ログを確認する。 | 監査ログ出力 |
7. 追加すべきExit Criteria
| フェーズ | 追加すべきExit Criteria | 関連要件ID | 証跡 |
|---|---|---|---|
| Phase 1 | 外部データ取得が再現可能であり、欠損・重複・異常値チェックが実行できる。 | F-001、D-001、D-002 | 取得ログ、品質チェック結果 |
| Phase 1 | 取得失敗時の通知・再実行・手動復旧手順が確認できる。 | OPS-001 | 障害再現記録、通知履歴 |
| Phase 2 | ロジック候補を同一条件で比較でき、採用・保留・停止の分類ができる。 | F-002、ML-001 | ロジック比較表、採用判断ログ |
| Phase 2 | 未来データ混入防止チェックが通過している。 | ML-002 | リークチェック結果 |
| Phase 3 | 非エンジニアがUIから主要操作を実行できる。 | UI-001、UI-002 | 操作デモ、受入テスト結果 |
| Phase 3 | 管理者権限と監査ログが動作している。 | SEC-001、SEC-002 | 権限テスト結果、監査ログ |
| Phase 4 | 監視、障害対応、バックアップ、問い合わせ対応の運用手順が整備されている。 | OPS-002、NFR-002 | 運用手順書、復旧テスト結果 |
8. 追加すべきテスト観点
| 分類 | テスト観点 | 対象要件ID | 具体例 |
|---|---|---|---|
| 正常系 | 想定どおりにデータ取得できるか。 | F-001、D-001 | 指定期間のデータ取得、保存、ログ出力。 |
| 異常系 | 外部データ取得に失敗した場合に通知・再実行できるか。 | OPS-001 | 認証エラー、通信エラー、形式変更。 |
| 境界値 | 対象期間、データ件数、表示件数の上限・下限を扱えるか。 | F-001、UI-001 | 0件、大量件数、最終日データ。 |
| データ品質 | 欠損、重複、異常値、未来データ混入を検出できるか。 | D-001、ML-002 | 欠損レコード投入、未来値混入テスト。 |
| 権限 | 権限外操作を拒否できるか。 | SEC-001 | 一般ユーザーによる管理操作拒否。 |
| 監査 | 重要操作が監査ログに残るか。 | SEC-002、D-002 | 採用、停止、削除、再取得のログ確認。 |
| 性能 | 主要画面が目標時間内に表示されるか。 | NFR-001 | ダッシュボード、ロジック一覧。 |
| 運用 | 障害時に手順どおり復旧できるか。 | OPS-002、NFR-002 | バックアップ復元、通知確認。 |
9. 修正後の再レビュー観点
修正後の再レビューでは、レビュー担当AIまたはCodexに「新たな指摘を増やす」だけでなく、今回の修正が実際にレビュー指摘を解消しているかを確認させる必要がある。
| 再レビュー観点 | 確認内容 | 合格条件 |
|---|---|---|
| 追跡可能性 | すべての主要要件にIDがあるか。 | 要件、設計、テスト、変更履歴がIDでつながる。 |
| 検証可能性 | 各要件に受入基準と検証方法があるか。 | 合否を第三者が判断できる。 |
| フェーズ判定 | Phaseごとの完了条件が客観的か。 | 証跡に基づいて移行可否を判断できる。 |
| 判断基準 | ロジック採用・停止・例外承認が説明可能か。 | 判断理由と承認者が記録される。 |
| データ信頼性 | 欠損、異常値、未来データ混入を防げるか。 | データ品質チェックが要件化されている。 |
| 運用可能性 | 障害、通知、復旧、問い合わせ対応が定義されているか。 | 担当者が迷わず対応できる。 |
| セキュリティ | 権限、監査、ログ、バックアップが定義されているか。 | 重要操作を追跡・制御できる。 |
| 文書品質 | 原文、正式要件、未決事項、変更履歴が分離されているか。 | 読み手が実装対象を誤解しない。 |
10. 1日・3日・7日の修正ロードマップ
10.1 1日で対応する場合
1日で対応する場合は、完全版を目指すのではなく、最も効果が高い管理骨格を作る。具体的には、要件ID体系、主要要件のID化、フェーズ別Exit Criteria初版、ロジック採用・停止基準初版までを作る。
| 時間帯 | 作業 | 成果物 |
|---|---|---|
| 0.5時間 | 章構成と要件分類を確認する。 | 分類メモ |
| 1.5時間 | 要件ID体系を決め、主要要件へIDを付ける。 | 要件ID台帳初版 |
| 1.0時間 | 主要要件に受入基準を付ける。 | 受入基準初版 |
| 1.0時間 | Phase 1〜3のExit Criteriaを作る。 | Exit Criteria初版 |
| 1.0時間 | ロジック採用・停止基準を作る。 | 判断基準表初版 |
| 1.0時間 | Critical/Highの未対応リスクを整理する。 | 未対応リスク表 |
10.2 3日で対応する場合
3日で対応する場合は、世界最高基準化に必要な中核成果物を一通り作成できる。Day 1で管理骨格、Day 2でデータ・AI・運用、Day 3で非機能・セキュリティ・再レビューを行う。
| 日 | 作業 | 成果物 |
|---|---|---|
| Day 1 | 要件ID台帳、受入基準、Exit Criteriaを作成する。 | 要件ID台帳、受入基準表、Exit Criteria表 |
| Day 2 | ロジック採用・停止基準、外部データ運用制約、データ品質基準を作成する。 | ロジック基準表、外部データ運用表、データ品質チェックリスト |
| Day 3 | 非機能、セキュリティ、運用、UI図解の最低限を補強し、再レビューする。 | 非機能・セキュリティ要件表、レビュー指摘表、修正版要件定義 |
10.3 7日で対応する場合
7日で対応する場合は、正式要件定義書、関連台帳、受入テスト仕様、再レビュー、テンプレート化まで完了できる。
| 日 | 作業 | 成果物 |
|---|---|---|
| Day 1 | 原文を保存し、正式要件の章構成と分類を確定する。 | 原文版、章構成、分類表 |
| Day 2 | 要件ID台帳を作成し、主要要件に理由・優先度・担当候補を付ける。 | 要件ID台帳 |
| Day 3 | 受入基準、検証方法、テスト観点を各要件に紐づける。 | 受入基準表、テスト観点表 |
| Day 4 | フェーズ別Exit Criteriaとマイルストーン判定表を作成する。 | Exit Criteria表、マイルストーン表 |
| Day 5 | ロジック採用・停止基準、データ品質、AI/ML運用基準を作成する。 | 判断基準表、データ品質表、AI/ML運用表 |
| Day 6 | UI図解、非機能、セキュリティ、監査、運用要件を補強する。 | UI仕様、非機能要件表、権限・監査表 |
| Day 7 | 第三者レビュー、修正反映、正式版確定、汎用テンプレート化を行う。 | 確定版要件定義書、レビュー指摘表、汎用テンプレート |
11. Codexに次に実行させるための実務用プロンプト
以下は、Claude Code上でCodexプラグインにそのまま渡せる実行プロンプトである。
あなたは、世界最高水準の要件定義改善を行うシニアPM兼システムアーキテクトです。
以下のレビュー結果と現行要件定義を基に、要件定義書を実装・テスト・運用可能な形式へ改善してください。
入力ファイル:
- 現行要件定義書: ./requirements.md
- レビュー指摘台帳: ./review_findings.md
- 既存の改善方針: ./requirements_improvement_plan.md
最優先で作成・更新する成果物:
1. requirements_id_table.md
2. exit_criteria.md
3. logic_governance.md
4. external_data_operations.md
5. data_quality_checklist.md
6. ml_operations.md
7. non_functional_requirements.md
8. security_audit_requirements.md
9. acceptance_test_spec.md
10. open_issues.md
実行ルール:
- 要件を削除せず、原文の思想を保持すること。
- 会話調・構想調の記述は、正式要件、背景、未決事項に分離すること。
- すべての主要要件に要件IDを付与すること。
- 各要件に、理由、優先度、検証方法、受入基準、状態を付与すること。
- PhaseごとにExit Criteria、証跡、未達時対応、承認者を定義すること。
- ロジック採用・停止・例外承認の判断基準を表にすること。
- 外部データ取得、データ品質、AI/ML運用、非機能、セキュリティ、監査を独立章として補強すること。
- 最後に、変更内容のサマリーと残課題を出力すること。
出力形式:
1. 作成・更新したファイル一覧
2. 各ファイルの主要変更点
3. 解消したレビュー指摘ID
4. 未解消の指摘IDと理由
5. 人間が確認すべき意思決定事項
6. 修正後の再レビュー観点
12. 人間が最終判断すべき事項
Codexに修正計画を作らせても、以下は人間が決める必要がある。ここをAI任せにすると、プロジェクトの責任所在や事業判断が曖昧になる。
| 判断事項 | 人間が判断すべき理由 |
|---|---|
| ロジック採用ライン | 成果KPIとリスク許容度は事業判断であるため。 |
| 停止ライン | 損失許容、信頼性、運用リスクを含むため。 |
| Phase移行可否 | 未達項目を抱えて進むかは責任者判断であるため。 |
| 外部データ規約の解釈 | 契約・法務・利用範囲の判断が必要なため。 |
| セキュリティ水準 | 組織のリスク許容度と運用体制に依存するため。 |
| 本番リリース可否 | 技術品質だけでなく、業務・運用・責任体制の判断が必要なため。 |
13. 最終まとめ
レビュー結果を基にCodexへ修正計画を作らせる場合、単に「修正案を出して」と依頼するのではなく、指摘ID、修正ID、対象ファイル、影響要件ID、受入基準、Exit Criteria、テスト観点、再レビュー観点まで出力させることが重要である。今回の修正計画では、現行要件定義の強みであるプロジェクト思想と判断基準を残しながら、第三者が実装・検証・運用できる形式へ変換するための具体的な作業単位に分解した。
最優先の実行順序は、要件ID台帳、受入基準、Exit Criteria、ロジック採用・停止基準、データ品質、非機能・セキュリティ、UI図解、正式文書化である。この順序で進めれば、要件定義は構想書ではなく、開発・検証・運用・改善に使える世界最高基準の管理文書へ進化する。