← AI開発 資料アーカイブ
要件定義・課題分析

並列分析から抽出した要件定義の共通課題(10課題・改善成果物版)

元ファイル: システム要件定義の分析と汎用化方法/並列分析の生データから抽出した要件定義における共通課題.md

要約

競馬予想システム要件の10件並列分析の生データから、要件定義に共通する課題を10項目に整理したレポート。思想は強いが第三者が実装・検証・保守できる構造化が不足しているとし、属人性・フェーズ移行条件・要件ID・外部データ運用・データ品質などの課題を優先度付きで提示。要件ID台帳やExit Criteria表など追加すべき成果物8種も示す。

要点

要件定義課題分析並列分析要件IDExit Criteria競馬システム

並列分析の生データから抽出した要件定義における共通課題

対象データ: /home/ubuntu/keiba_requirements_wide_research.csv
分析件数: 10件の並列分析結果
作成者: Manus AI

1. 結論

並列分析の生データから抽出できる共通課題は、要件定義の思想や方向性が弱いことではない。むしろ、要件定義の思想は非常に強く、プロジェクトオーナーの意図、AIへの不信、実装ブレの排除、運用上の現実制約が濃く反映されている。その一方で、複数の分析軸で共通して指摘されたのは、強い原文を第三者が実装・検証・保守できる形式へ変換するための構造化が不足しているという課題である。

特に、共通課題は、判断基準の明文化、フェーズ移行条件、要件IDと受入基準、外部データ取得の障害対応、データ品質、UI図解、非機能要件、セキュリティ・監査、AI/MLの運用管理、正式文書化に集中している。

2. 共通課題一覧

優先度 共通課題 複数軸での出方 要件定義上の意味
1 属人性と意思決定基準の暗黙化 社長承認、採用判断、最終判断への依存が複数軸で指摘された。 人間判断を中核に置く設計は強みだが、判断基準が暗黙知のままだと再現性が落ちる。
2 フェーズ移行条件の不足 Phase 1〜3の構想は明確だが、次フェーズへ進む客観条件が不足している。 「壊れない状態」へ進む基準を数値・成果物・受入条件で定義する必要がある。
3 要件ID・検証方法・受入基準の不足 要件が詳細に書かれている一方、合否判定単位としてのIDや検証方法が不足している。 実装・レビュー・テスト・変更管理を追跡可能にするための形式化が必要である。
4 外部データ取得と規約制約の運用設計不足 JRDBの取得制限、契約、認証、利用範囲、禁止時間帯への懸念が複数軸で出ている。 外部データは機能ではなく制約そのものであり、失敗時処理まで要件化すべきである。
5 データ品質・欠損・異常値・未来データ混入への対策不足 データ品質保証、欠損、コメント数値化、バックテスト信頼性への懸念が指摘された。 AI/MLシステムでは、モデルより先にデータ品質ルールを要件化する必要がある。
6 AI/MLの評価・再学習・停止条件の不足 モデル運用、再学習、バックテスト、採用停止、リーク対策が不足要素として出ている。 「勝てるロジック」を継続的に扱うには、モデルライフサイクル管理が必要である。
7 UI/UXの図解・画面遷移・デザイン基準の不足 画面要素は詳細だが、ワイヤーフレーム、画面遷移図、デザインガイドラインが不足している。 実装者やAIが画面を勝手に解釈しないよう、視覚的な仕様化が必要である。
8 非機能要件の定量化不足 性能、可用性、保守性、復旧、運用品質が抽象的であるとの指摘がある。 「壊れない状態」を目指すなら、壊れないことを測る指標が必要である。
9 セキュリティ・権限・監査・バックアップの不足 管理者、メンバー、共有、認証情報、ログ、監査証跡への懸念が出ている。 社内システムでも、データ・収支・判断履歴を扱う以上、監査性が必要である。
10 文章構造・正式文書化・重複整理の不足 会話ログ的表現、誤変換、重複、正式要件への変換不足が指摘された。 原文の熱量を残しながら、実装用の正式要件へ変換する工程が必要である。

3. 課題の本質

これらの課題は、要件定義の弱さというより、原文型要件定義から実装管理型要件定義へ進化する際の課題である。現行文書は、プロジェクトオーナーの思想、現場判断、AIに勝手な解釈をさせないための制約が非常に濃い。そのため、初期の方向決め、プロダクト思想の共有、AIエージェントへの指示書としては極めて強い。

一方で、第三者が同じ品質で実装し、別担当者が検証し、将来の運用者が保守するには、文章を次の粒度へ分解する必要がある。具体的には、機能要件、画面要件、データ要件、AI要件、非機能要件、運用要件、検証要件、未決事項をそれぞれID付きで管理する必要がある。

4. 最優先で追加すべき成果物

追加成果物 目的 含めるべき内容
要件ID台帳 要件を追跡可能にする F-001、UI-001、D-001、ML-001、NFR-001、OPS-001のようなID、内容、優先度、検証方法。
フェーズ別Exit Criteria表 次フェーズ移行を客観化する Phaseごとの完了条件、受入条件、担当者、証跡、未達時対応。
ロジック採用・停止基準表 社長判断を再現可能にする 最低検証レース数、回収率、最大ドローダウン、採用期間、停止条件、例外承認。
JRDB運用制約表 外部データリスクを管理する 取得可能時間、禁止時間、認証方式、失敗時リトライ、通知、手動復旧、規約確認日。
データ品質チェックリスト AI/MLの信頼性を守る 欠損、重複、異常値、未来データ混入、取得漏れ、形式変更、監査ログ。
画面遷移図・ワイヤーフレーム UI解釈のズレを防ぐ 画面一覧、遷移、表示要素、空状態、エラー状態、権限別表示。
非機能・監査要件表 「壊れない状態」を測定可能にする 性能、可用性、RTO/RPO、バックアップ、権限、操作ログ、監査ログ。
正式要件版ドキュメント 原文を実装可能な仕様へ変換する 原文、決定事項、未決事項、正式要件、変更履歴を分離する。

5. 優先順位付きの改善提案

最初に着手すべきは、要件ID台帳フェーズ別Exit Criteria表である。この2つを作ると、要件定義が「強い文章」から「管理できる仕様」へ変わる。次に、社長判断の強みを残したまま、ロジック採用・停止基準を明文化するべきである。これにより、属人性を完全に排除するのではなく、最終判断者の思想を再現可能なルールとして扱える。

次に、JRDBの取得制約とデータ品質ルールを運用要件として独立させる必要がある。競馬システムの成否は、モデルそのものだけでなく、正しいデータを正しいタイミングで取得し、欠損や異常値を検知できるかに大きく左右される。最後に、UIについては、現在の詳細な表示項目をワイヤーフレームと画面遷移図へ落とし込むことで、AIや開発者による勝手な画面解釈を大幅に減らせる。

6. 一言でまとめた共通課題

並列分析の生データから見た最大の共通課題は、「世界観と判断思想は非常に強いが、それを第三者が検証可能なID付き要件、移行条件、採用基準、運用ルール、図解仕様へ変換する余地がある」という点である。

↑ トップへ戻る