Upgrade to Pro — share decks privately, control downloads, hide ads and more …

アーキテクチャを「測る」ためのヒント

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest. →
gyarasu
November 16, 2026
11

 アーキテクチャを「測る」ためのヒント

書籍『ソフトウェアアーキテクチャメトリクス』のエッセンスと個人開発「Decision Supply Chain」での実践。

gyarasu

November 16, 2026

Transcript

21 slides
  1. 紹介する書籍 ソフトウェア アーキテクチャメトリクス アーキテクチャ品質を改善する10のアドバイス Christian Ciceriほか 著/島田 浩二 訳 オライリー・ジャパン、2024年1月刊

    10人の実務家が、経験・ケーススタディと ともにメトリクスの選び方・使い方を紹介 今回:第 4章の3原則を軸に、第 2・8・9章を参照 書影:ユーザー提供。出典:O’Reilly Japan oreilly.co.jp/books/9784814400607/ 02
  2. メトリクスとは 対象の性質を、定義したルールで測定・評価する指標 定義すること 決める内容 対象 何の性質を測るか 測り方 どう数えるか 単位・範囲 何を1単位とし、どこまでを対象にするか

    例:最大循環グループのサイズ 循環グループ=importの矢印をたどって互いに戻れるまとまり 最大サイズ 注文 決済 定義の整理・図は説明用。書籍 はじめにp.v、第9章p.187、第10章p.212 通知 3モジュール 04
  3. 構造と変化を測る 構造:現在の状態 変化:Gitの変更履歴 依存や制御フローから、 絡み合い・複雑さを見る 一定期間の履歴から、 変更の集中や書き換えた量を見る HEAD main 注文

    決済 通知 a1b2c3 d4e5f6 a7b8c9 order.go payment.go order.go 箱はコード上のモジュール この図は循環なし。循環グループはない。 order.goの変更頻度: 2回 組み合わせると「複雑で、頻繁に変わる箇所」を探せる 構造・変化は発表用の分類。左はimport、右はGitの履歴。図・ハッシュ・変更例は説明用 05
  4. MMIの3原則:構造を評価する観点 モジュール性成熟度指数 Modularity Maturity Index(MMI) 原則 見ること モジュール性 責務を分け、公開境界を明確にする 階層性

    循環や、意図した依存方向への違反を調べる パターン一貫性 決めた設計パターンを一貫して適用する MMIは、ツールでの計測と人のレビューから3原則を評価し、総合点を算出する。 本発表では 3原則を観点として使う。 MMIの点数は算出しない。 出典:第4章p.59(正式名称)、pp.63–74、表4-1(pp.71–72) 06
  5. 紹介するメトリクスの一覧 番号 見るもの メトリクス 3原則との関係 M1 構造(今回) 最大循環グループのサイズ 階層性:相互依存の範囲 M2

    構造(今回) 相対的循環度 階層性:循環と全体規模 M3 構造(今回) 循環複雑度 モジュール性:関数の複雑さ M4 構造(今回) 最大インデントレベル モジュール性:ネストの深さ M5 変化(次回) 変更頻度(d) 変更が集中する場所 M6 変化(次回) コードチャーン(d) 追加・削除した行数 出典:第9章 pp.187–199。3原則との関係は発表用の整理。MMI算定項目とは一対一ではない 07
  6. M1 最大循環グループのサイズ “ システムの最大循環グループの要素数 ” importの矢印をたどり、どのモジュールからも他のすべてへ行ける 注文 注文 決済 通知

    循環なし 0 決済 通知 注文→通知は決済を経由 通知→決済は注文を経由 3 書籍の目安:コンポーネントは 5以下/名前空間・パッケージ間は 0 引用:第9章 p.187。循環なしの表記を0とする。説明用の業務モジュール。矢印は依存する側から参照先 08
  7. M2 相対的循環度 循環グループの大きさを、システム全体の規模に対して見る n:全要素数 sᵢ:i番目の循環グループの要素数 k:グループ数 比較する例 全要素数 n 循環グループ数

    k 各グループの 要素数 sᵢ M1 最大サイズ M2 相対的循環度 大きな循環 100 1 s₁ = 100 100 100% 小さな循環 100 50 s₁ = … = s₅₀ = 2 2 約14.14% 全体nは同じでも、循環グループ数 kと各サイズ sᵢによって値が変わる。 出典:第9章 pp.187–189。表は書籍の思考実験にn・k・sᵢを対応づけたもの。M2の固定閾値は未提示 09
  8. M3 循環複雑度 関数の制御フローの複雑さを測る 最小値の1から始めて、ループ文や条件文ごとに1を加える “ JavaScript(説明用) ” 循環複雑度 function handle(items,

    a, b) { for (const item of items) { if (a) doA(item); 1+1+2=4 if (b) doB(item); } } 基礎値1 + for1つ + if2つ 書籍の推奨閾値: 15 引用・基本の数え方:第9章 p.197。コードは説明用の例 10
  9. M4 最大インデントレベル “ 関数とメソッドにおけるコードの最大インデントレベル ” JavaScript(説明用) if (a) { doA();

    } if (b) { doB(); } JavaScript(説明用) if (a) { if (b) { doB(); } } 深さ1 深さ2 書籍の推奨上限: 4。この図は関数本体を 0として数える。 出典:第9章 p.198。説明用コード。関数本体を深さ0として制御構造を数える 11
  10. 適応度関数は、設計ルールを確かめる仕組み 守りたい性質を満たしているか、繰り返し確かめる 測る 判定する 結果を返す 最大循環グループ = 3 最大サイズが0か? 不合格

    測定値に設計ルールの判定を加える。テストも適応度関数の一つ。 “ アーキテクチャ特性に対する客観的な評価基準を提供するあらゆるメカニズムである 引用:第8章 p.156。ここでは自動テストとして具体化した例 ” 12
  11. Backend内部の構造と測定範囲 業務モジュール間の importを見る Backend:モジュラーモノリス M1 最大循環グループのサイズ 単一Goモジュール・単一APIプロセス Advisory AI提案 公開契約を参照

    Workspace 作業領域の管理 公開契約:module.go / contract/ 0モジュール Dependency グラフ・決定論的分析 Planning シナリオ・意思決定 戻る経路がないため、循環なし M2 相対的循環度 0% 内部実装:各モジュールのinternal/ Planningは設計上の責務を表示。通常ビルドのimportを対象(通信・DB制約・テストは除く) 14
  12. MMIの3原則・メトリクス・テストの対応 MMIの観点 見ること 値・評価 DSCでの確認 モジュール性 公開契約と内部実装の 境界 境界違反の有無 Goのinternal制限

    +テスト① 階層性 業務モジュール間 の循環 M1:0モジュール M2:0% 業務モジュール単位の 継続検査は未追加 パターン一貫性 Domainと 技術基盤の分離 指定の禁止依存の有無 Goでは許可される依存を テスト②で禁止 この例では、 Goの制約と独自テストの両方で設計ルールを確認している。 出典:第4章 表4-1、第2章、第9章。Goの制約と既存テストの対応づけは発表者による整理 15
  13. Goの制約と、テストで補う設計ルール “ Code in or below a directory named "internal"

    is importable only by code that shares the same import path above the internal directory. (日本語訳:internal内とその配下のコードをimportできるのは、 internal直前までのインポートパスを共有するコードだけです。) ” DSC:dependency/internal/... を使えるのは dependency配下からだけ 確認対象 Goの制約 DSCの確認方法 他モジュールのinternal 範囲外のimportを拒否 テスト①も点検(重複) Domain→HTTP・DB import可能 テスト②で指定先を禁止 循環依存 パッケージの循環は禁止 M1・M2は業務モジュール単位 internalはGoのimport制限。Domainの禁止依存は追加の設計ルール。 引用:Go公式 https://pkg.go.dev/cmd/go#hdr-Internal_packages 日本語訳は発表者訳 16
  14. 適応度関数の実例:公開境界と Domainを守る ① 公開境界を守る ② Domainの技術依存を防ぐ TestModulesDoNotImport OtherModuleInternals TestDomainPackagesDoNotImport AdaptersOrGeneratedDatabase

    別モジュールのinternalを禁止 Goのimport制限と重複する確認 Goだけでは禁止されない依存を検査 禁止:生成DB、pgx、pgtype、net/http Go:別モジュール判定後 strings.Contains(imported, "/internal/modules/"+ targetModule+"/internal/") Go:Domainのimportを比較 imported == forbidden シェルコマンド:二つのテストを実行 $ make architecture-test 実装:backend/tests/architecture/module_boundaries_test.go。コードは判定条件の抜粋 17
  15. 実際の指示ファイルと、開発エージェントの役割 指示をLLMへ渡し、要求されたツールを実行して結果を返す AGENTS.md プロジェクト共通の制約 開発エージェント(例: Codex) 他モジュールのinternal禁止 完了前は原則make check LLM

    判断・実行要求 SKILL.md 境界の設計・レビュー観点 シェル make check 終了コード・ログを返す DomainへのHTTP・DB依存を避ける 必要な作業で明示参照する例 出典:AGENTS.md、.codex/skills/modular-monolith-go-architecture/SKILL.md。実記述に基づく例 18
  16. 指示を読むものと、判定を実行するもの ファイル 読み手・実行主体 役割 AGENTS.md 開発エージェント → LLM 共通の制約と完了前の確認指示 SKILL.md

    必要な作業で明示参照 → LLM 境界の設計・レビュー観点 Makefile make テストの起動コマンドをまとめる module_boundaries_test.go go test 実際のimportに対して合否を判定 .github/workflows/ci.yaml GitHub Actions PR等でmake check-allを実行 文章はLLMへの指示。実コードに対する合否判定は Goテストが担う。 ここでの開発エージェントはCodexなど。アプリ側のAgent Serviceとは別 19
  17. 変更直後に修正し、 PRで実行漏れを拾う ローカル:変更直後に違反を見つけ、修正する 開発者/ 開発エージェント make architecture-test go test ./tests/architecture

    CI:PR等で再確認し、ローカルでの実行漏れを拾う PR → GitHub Actions make check-all → check → architecture-test go test ./tests/architecture 判定ルールは Goテストに一度定義。ローカルと CIで条件をそろえる。 実際の設定:Makefile、.github/workflows/ci.yaml。CIはlint・build・統合テスト等も実行 20
  18. 測定結果を、次の設計判断につなげる 何を良くしたいかから指標を選び、 結果を修正とレビューへ返す 役割 一般的な考え方 評価の観点 何を改善したいかを明確にする メトリクス 対象・数え方・範囲を定義し、状態を把握する 適応度関数

    守る条件を検証し、結果を修正とレビューへ返す 人が書くコードにも、 AIが生成するコードにも、同じ設計ルールを適用する。 次回:変更頻度・コードチャーンも使い、どこを優先して改善するかを考える 21