Implementation Approach

実装戦略選択フレームワーク（メタ認知的アプローチ）

メタ認知的戦略選択プロセス

Phase 1: 判断に十分な現状分析

中心となる問い: 「既存の実装はどうなっているのか？」

分析フレームワーク

アーキテクチャ分析: 責務分離、データフロー、依存関係、技術的負債
実装品質評価: コード品質、テストカバレッジ、パフォーマンス、セキュリティ
歴史的文脈理解: 現在の形の理由、過去判断の妥当性、制約の変化、要求の進化

メタ認知質問リスト

• この実装の真の責務は何か？
• どの部分がビジネス本質で、どの部分が技術的制約由来か？
• コードから明確でない依存関係や暗黙の前提条件は何か？
• 現在の設計がもたらしている利点と制約は？

現状に関する事実をこれ以上集めても、責務、再利用、選択肢の成立性、総合的な複雑性、契約、検証のいずれも変わらない時点で調査を止める。

完了条件: 確認したパス、観測したアーキテクチャ・データフローの事実、既知の制約、推測と明記した歴史的背景、不明点のうち戦略選択を変え得るもの。

移行条件: 戦略に関係するすべての主張が、観測済み、根拠付きの推測、または不明として明記されている場合に次へ進む。

Phase 2: Design Convergence

中心となる問い: 「現行の必要な成果を届ける最小の設計は何か。そこから先の追加は、どの根拠が要求しているのか？」

実装戦略の探索に入る前に、以下を順に完了させる：

1. 既存の責務を使う基準案: 既存の責務を通して現在の成果を届ける、最も単純なエンドツーエンドの経路を組み立てる。明示された要件と承認済みの判断は拘束力を持ち、提案された技術手段は候補に留める。
2. エビデンスチェック: その経路を、現行要件、検証済みの制約、スコープ内で観測された問題、根拠のある重大リスクに照らして検証する。選択する設計を変えうる未充足条件だけを残す。
3. 的を絞った比較: 未充足条件ごとに、設計要素を追加する前に、再利用、既存データからの導出、オンデマンド計算、現在の呼び出し側または境界での責務保持を検討する。成立する案について、ユーザーの判断・設定・モード・概念・出力、永続状態、実装経路、およびUX・実行時・実装・テスト・文書・保守のコストのうち、実際に異なる観点だけを比較する。その条件を満たす案のうち、総合的な複雑性が最も低いものを選ぶ。
4. 除去チェック: 提案した追加を1つずつ取り除き、その根拠となる条件を再検証する。確認済みの成果、必要な境界、または必要な証明が満たせなくなる場合に限って追加を残す。

候補となる経路と不採用の追加は設計時に比較し、長期的に残す出力には Selected Design だけを記載する。選択した経路全体に加えて、追加した設計要素ごとの根拠と、それを取り除くと満たせなくなる条件を記録する。選択肢を判断の履歴として残せるのは、承認済みADRが扱う場合だけである。実装時は別の成果物を作らず、同じ収束チェックを適用する。