Share
Embed
Transcript
29 slides
-
ADRとは何か? Architectural Decision Record:アーキテクチャ決定記録は、 アーキテクチャにおける重要な意思決定とその背景、代替案、そしてその決定がもたらす結果(影響)を 記録するための簡潔なドキュメントです。 私なりの解釈は、「愚者は経験に学び、賢者は歴史に学ぶ」 というワード、これに集約される。 過去の出来事(歴史)から教訓を得て、同じ過ちを繰り返さないことの重要性を説くドキュメント。 学習しない組織は、自分たちの経験からすらも学ばないが、賢者=成⾧・学習する組織はADRという資産
を用いて、自分&自分たち以外の(過去の)経験からも学ぶことができる。 2025/8/2 -
ADRの構成要素 1. タイトル:決定の内容を簡潔に、かつ明確に表す。ADRの名前意図重要!! 2. ステータス: ADRの現在の状態(承認済み)を示す。決定のライフサイクルを追跡するために重要な項目。 3. コンテキスト:決定を行うに至った背景、状況、問題点、関連する制約、考慮すべき事項などを説明します。 なぜこの決定が必要になったのかを明確にする最も重要な部分
解決した結果、どんな状況になりたいのか?も定義推奨 4. 決定:どのような方針、手法、技術、ツールを選択したのかを明確にします。 各重み付けした評価軸での、検討した代替案とその⾧所・短所を述べ、なぜその決定を選んだのかの理由を説明 5. 予測結果/影響:決定を適用した後に予測される、または実際に発生したアーキテクチャやシステム、運用、開発 プロセスなどへの影響を演繹法を使って記述します。 ※決定がなされた日付や作成者/承認者などのログも残した方が後々良い。 2025/8/2 -
ADRが何のためにあるか? 意思決定の透明性と記録:意思決定プロセスが透明になり、後からその決定の妥当性を検証できる 知識の共有と継承:新規参画者がプロジェクトの設計思想を短期間で把握するため 同じ議論の繰り返し防止:ADRを参照することで迅速に回答し、無駄な繰り返し議論の時間を削減 技術的負債の管理と解消の支援:特定の技術制約やトレードオフを明記し、将来の改善計画の判断材料とします。 アーキテクチャの進化と整合性の確保:過去の決定が外部環境変化などで、現在の状況に合わなくなった場合に、 なぜ変える必要があるのか?というADRを作成する。 説明責任と合意形成の促進 ADRの承認フロー中のログを見て、承認フローのプロセス改善←地味に役立つ(ECRSしてみ? )
この威力を底上げするために、1つの武器であるDIKWを学びましょう 2025/8/2 -
DIKWの概念説明 • DIKWピラミッド • データ • 情報 • 知識 •
知恵 • DIKWのそれぞれの関係図 2025/8/2 -
データ Data 概要:未加工の事実、数値、記号の集まりで、これ単体では直接的な意味や文脈を持たない。 事例: Webサイトのアクセスログの1行「2025-07-24 23:25:10 /product/123」 あるセンサーが計測した「25.0℃
」という数値 データベースに記録された「山田太郎」 「30歳」、「東京都」という単なる意味をなさない文字列や数値 ADRの各構成要素である、タイトル名とか、ステータス単体のこと 2025/8/2 -
情報 Information 概要:データが処理、整理、構造化され、文脈を与えられたもの。 データとの違い:データが5W2H各問いに答えることで、人にとって理解 しやすい意味(ストーリー)、文脈を持っている。 事例: 「2025-07-24の23:25:10に、ユーザーID:1103の工藤が、商品ID:123の 製品ページにアクセスした」という、文脈が与えられたアクセスログ
「山田太郎さんは東京都に住む30歳の男性である」という、複数のデータが関連 付けられ、意味を持つペルソナ解説文として解釈されたもの ADRの構成要素全てに回答したもので、ADRドキュメントそのままの姿 2025/8/2 -
知識 Knowledge 概要:複数の情報が関連付けられパターン、傾向、規則性、因果関係などが発見され、どの ように?なぜ?といった問いに答えられるようになった状態 情報との違い:情報に推論思考(主に帰納法)を施したもの 事例:パターン、原則、ノウハウ、アンチパターン、デザインパターンなどが該当する 情報1: 「7月25日、東京の気温は30度だった。」
情報2: 「過去5年間、東京の7月下旬の平均気温は30度を超えてる。」 情報3: 「30度を超える日は、熱中症患者が増加する傾向にある。」 上記から「東京の7月下旬は⿁暑く、熱中症リスクが高い」という一般的な傾向や知識が導き出されます。 複数のADRから帰納法を使って導出したパターンとかが知識になる!! 2025/8/2 -
知恵 Wisdom 概要:知識をさらに広い文脈で理解し、価値観、倫理観、判断力、そして将来の洞察に基づいて活用。 なぜその知識を適用すべきか、その行動がどんな結果をもたらすか?を洞察を含む。 知識との違い:情報や知識は、単体では単なる事実の集積、パターン認識に過ぎない。 それらを状況に応じて適切に、倫理的に、⾧期的な視点を持って活用し、最適な結果を導き出すためには、 「知恵」が必要不可欠。なぜその原則をあえて破る必要があるのか?とか。 事例:顧客セグメントへの割引が短期的な売上増加に繋がるという知識がある。一方で、「⾧期的なブランドイメージへの 影響」や「他の顧客層への不公平感」といった自分たちの倫理側面を考慮し、割引の実施を見送るという判断
製造プロセスのボトルネックを解消するための知識がある一方で、「その改善が二酸化炭素増加など環境に与える影響」や 「従業員の働き方に与える⾧期的な負の影響」を考慮し、より持続可能な改善策を選択する判断 2025/8/2 -
ADRデータ利活用 のための テクニック • ADRを情報から知恵に昇華せよ • レーダーチャートで評価を可視化 • 予測結果は因果モデルで図解せよ •
実際と予測のズレから学びを得る • 進化的アーキテクチャの実現 2025/8/2 -
①利用時~プロセス品質までを推論した図を残す CXデータを握ったマーケティングの人とQA、データ 分析者と対話しながら、要因分析を図解する。 a. 重要な利用時品質明らかにする b. 外部品質明らかにする c. 内部品質明らかにする ※利用時品質の重みづけがないと、外部品質の
重みづけも定義できない。 このモデルは更新し続けないといけない。 2025/8/2 -
②レーダーチャートで評価を可視化する 事前条件:①が完了済であること ※複数ある評価軸は、すべてが同じ重みではない。 a. Geminiなどでトレードオフ関係の一般傾向を可視化 ※たまに変なの出してくるから、微調整必要 b. 以下のように期待値計算する 総合評価スコア=0.4×3+0.2×2.5+~ 0.4とかが全体に対するその品質評価軸の重みの割合。
完了条件:複数案のスコアリング レーダーチャートが可視化され期待値計算でスコアリングされてる 2025/8/2 -
③予測結果は因果モデルで図解せよ 前提知識:演繹法(三段論法) 概要:原因と結果の因果連鎖モデルで可視化 AsIs状態+行動→ToBe状態というモデルを軌跡で 描く(イベントソーシング式にモデル作成して) 安全にかつ予測精度高めるためちょっと先を予測する このモデルで、望ましい結果と副作用を必ず描く 理由は、すべてのアーキテクチャには副作用があるから 例:モノリスから分散化した結果、
望ましい結果:独立性上がる 副作用:複雑化や運用コストアップ 間違ってもいい。あとで振り返って後に生かせばいい 2025/8/2 -
データ駆動で進化的アーキテクチャの実現 2025/8/2 継続的な知識の創造と蓄積: 螺旋を回すことで、個人レベルの 経験や知見が組織全体の知識となり、さらに新しい知識へと発展し ていきます。 組織の成⾧と進化: 知識創造のサイクルが繰り返されることで、 組織は単に問題を解決するだけでなく、より高次元の知恵を獲得し、 持続的に成⾧・進化していきます。
「外部環境が似てる」「内部環境が似てる」といった、 過去のコンテキストと似たとこが出てきたら、歴史から学ぶチャンス! -
今日のまとめ ADRは、文章の情報だけでなく図解とセットで描きましょう。 その際、原因結果モデル、レーダーチャート評価図を推奨します。 ADRは、単に決定を記録するだけでなく、 1. その情報を知識に昇華させやすくするために構造化する 2. その構造化された情報からパターンと因果関係を推論して、知識を生成する 3. 最終的にその蓄積された知識を基に、より良い意思決定を行うための知恵へと繋げる
という継続的な学習と改善のサイクル=進化的アーキテクチャを組織にもたらす無形資産として運用する。 AIさんで、さらに超高速で実現できんじゃない?詳しい人は今日のを改善して共有してね 2025/8/2