LASSIC Media らしくメディア

2026.10.05 らしくコラム

クリーンアーキテクチャとは?依存の向きをそろえる層の分け方

監修・編集責任者:牛尾 昭昌(株式会社LASSIC 執行役員)

ホワイトボードに赤いマーカーで箱と矢印をつないだ階層型の構成図を、手で描き込んでいる場面を写した写真。

この記事の結論

  • クリーンアーキテクチャの核は、プログラムの依存を内側の業務の規則へだけ向けるルールです。
  • ヘキサゴナル・オニオンも同じ目的の設計で、違いは図の描き方と中心に置くものにあります。
  • 小さなアプリには重いため、使う範囲を絞り、ルールが守られているかを自動で確かめます。

※ 本記事は2026年10月時点の公式情報(省庁・公的機関、および製品やサービスを提供する事業者が公開している資料)に基づきます。

クリーンアーキテクチャは、システムの設計の考え方の一つです。開発会社の提案書に「クリーンアーキテクチャで作ります」と書かれていたり、同心円の図を見かけたりして、それが何を意味し、自社のシステムに合うのかを知りたくて調べる方が多いでしょう。

本記事では、提唱者Robert C. Martinの原文をもとに、クリーンアーキテクチャの考え方を初心者向けに図と表で整理します。似た設計との違い、向いているシステム、つまずきやすい点、開発を委託するときに確認しておきたい点も紹介します。

クリーンアーキテクチャとは

クリーンアーキテクチャは、業務の規則を、データベースや画面、フレームワーク(開発を楽にする土台のソフトウェア)から切り離して作る設計です。Robert C. Martinが2012年にブログで公開しました。*1 業務の規則とは、「注文の金額は0円より大きい」のような、画面やデータベースが何であっても変わらない決まりのことです。

Martinは、この設計で作ったシステムが持つ性質を挙げています。主なものは次のとおりです。*1

  • テストしやすい:業務の規則を、画面やデータベースなしで確かめられる
  • 画面を替えやすい:Webの画面を別の画面に替えても、業務の規則は変わらない
  • データベースを替えやすい:使っているデータベースの製品を別のものに替えられる
  • フレームワークに縛られない:フレームワークを道具として使い、その制約にシステムを押し込まない

業務の言葉とモデルをどう切り出すかは「ドメイン駆動設計とは」で扱っています。クリーンアーキテクチャが扱うのは、切り出した規則と外側の仕組みのつなぎ方です。

4つの円と依存のルール

クリーンアーキテクチャは、同心円の図で説明されます。内側ほど大事で変わりにくい規則、外側ほど具体的で変わりやすい仕組みです。

クリーンアーキテクチャの4つの円の図。外側から、フレームワークとドライバー(Web・データベース・画面・外部サービス)、インターフェースアダプター(コントローラー・プレゼンター等)、ユースケース、中心のエンティティ(業務の規則)が同心円で並び、ソースコードの依存を示す矢印はすべて内側へ向いている。右側に、内側の円は外側の円の名前を書かない、内側ほど抽象的で変わりにくい方針、外側ほど具体的で変わりやすい仕組み、円の数は4つに限らない、境界を越えるデータは単純な形にする、という要点を示す。Robert C. Martin「The Clean Architecture」(2012年)をもとに作成。

  • エンティティ(中心):会社全体で共通の業務の規則
  • ユースケース:そのアプリ固有の手順。「注文を受け付ける」など
  • インターフェースアダプター:内側と外側のデータの形を変換する部分。データベースへの命令もここに閉じる
  • フレームワークとドライバー(外側):データベースやWebの仕組みなどの道具

この設計を成り立たせるのが「依存のルール」です。Martinは、プログラムの依存は内側へだけ向けるとしています。*1 内側のプログラムは、外側にある部品の名前を一切書きません。そのため、データベースを替えても内側の業務の規則は書き直さずに済みます。

Martinは、Webもデータベースも「細部」だと書いています。円の数は4つと決まっておらず、必要なら増やしてよいとも書いています。*1 変えてはいけないのは、依存が常に内側を向くことです。内側が外側の部品を直接呼ばずに済ませる手段は「依存性注入(DI)とは」で扱っています。

ヘキサゴナル・オニオンとの違い

Martinは、それまでに提案されていたヘキサゴナルアーキテクチャやオニオンアーキテクチャなどを並べ、どれも関心の分離(役割ごとにプログラムを分けること)を目的にしていると書いています。*1 3つの違いは次のとおりです。

3つの設計の違い(提唱者の原文による)
観点 ヘキサゴナル オニオン クリーンアーキテクチャ
提唱者と時期 Alistair Cockburn(2005年) Jeffrey Palermo(2008年) Robert C. Martin(2012年)
図の描き方 アプリの内と外の2つに分ける 中心から外へ重なる同心円 4つを目安とする同心円
中心に置くもの アプリ全体 業務のモデル 会社全体の業務の規則
外とのつなぎ方 目的ごとの接続口に、技術ごとの変換部品をつなぐ 中心側が決めた接続の形を外側で作る 内側が決めた接続の形を外側で作り、単純なデータを渡す

ヘキサゴナルアーキテクチャは別名を「ポートとアダプター」といい、アプリを利用者、別のプログラム、自動テスト、バッチのどれからでも同じように動かせるようにする設計です。*2 オニオンアーキテクチャは、データベースを中心ではなく外側に置く設計です。*3 3つは対立するものではなく、同じ考え方を描き方を変えて説明したものと捉えると整理しやすくなります。

向いているシステムとつまずきやすい点

効果が出やすいのは、長く使い続け、途中でデータベースや画面が替わる見込みのあるシステムです。Palermoも、小さなWebサイトには向かず、長く使う業務アプリや複雑なアプリに向くと書いています。*3

  • 業務の規則が多いシステム:受発注や料金計算など、規則を単独でテストしたい
  • 入口が複数あるシステム:同じ処理を画面、API(ほかのシステムから呼ぶ窓口)、バッチから呼ぶ
  • 古いシステムの改修:画面やデータベースに埋もれた規則を、少しずつ内側へ移す

反対に、入力をそのまま保存するだけの管理画面や作り捨ての試作では、変換のプログラムが増えるだけになりがちです。導入でつまずきやすいのは次の点です。

  • フォルダ名だけまねる:円の名前のフォルダを作っても、中身が外側の部品を直接使っていれば意味がない
  • 何でも分けすぎる:替える予定のない部品まで切り離すと、変換のプログラムが本体より長くなる
  • ルールが崩れても気づけない:Cockburnは、約束が破られたことを検知する手段がなければ、数年後には層が散らかると書いている*2

3つめの対策として、内側のプログラムが外側の部品を使っていないかを、変更のたびに自動で確かめる仕組みを入れておきます。

外部に委託するときに確認しておきたい点

「クリーンアーキテクチャで作ります」と言われても、その中身は会社やチームによって違います。設計書や途中の成果物で、次の点を確かめておきます。

  • 使う範囲:どの部分に適用し、どこはフレームワークの標準の作りで済ませるか
  • 円の数と中身:何層に分け、それぞれに何を置くかが決まっているか
  • ルールの検査:依存の向きを自動で確かめる仕組みがあるか
  • テスト:業務の規則のテストが、データベースなしで短い時間で終わるか
  • 記録:どの判断でどの層に置いたかを、引き継ぐ人が読める形で残すか

設計の妥当性を第三者の目で点検する進め方は「技術選定・アーキテクチャレビューを外注で補強」で、外側の部品の代わりを使ったテストは「テストダブルとは」で扱っています。

まとめ:クリーンアーキテクチャで確かめておきたい3つの点

クリーンアーキテクチャで確かめておきたい点は3つです。第一に、核は依存を内側の業務の規則へだけ向けるルールで、円の数やフォルダの名前ではないこと。第二に、ヘキサゴナル・オニオンも同じ目的の設計で、違いは図の描き方と中心に置くものにあること。第三に、小さなアプリには重いため使う範囲を絞り、ルールが守られているかを自動で確かめる仕組みまで含めて設計することです。

LASSICに相談するメリット

LASSICは2006年の創業以来、システムの運用・保守に特化したプライム(一次請け)のシステムインテグレーターとして、企業のシステム開発と保守・運用を受託してきました。Rubyアソシエーション認定システムインテグレータ、日本ニアショア開発推進機構の認定ベンダーとして、全国のリモート人材による開発・運用の体制を整えています。

実装では、FastAPIとSQLAlchemy、Spring BootとSpring Data JPAを外側の円に置き、依存の向きの検査にPythonのimport-linterやJavaのArchUnitを使います。設計では、適用する範囲、円の数、データベースの表の形と業務の規則を分けるかを最初に決めます。検証では、業務の規則をデータベースなしのテストで、外側の部品をTestcontainersを使ったテストで確かめ、GitHub Actionsで変更ごとに依存の検査とテストを回します。

よくある質問

クリーンアーキテクチャでは、4つの層に分けなければなりませんか

分ける必要はありません。Robert C. Martinは原文で、4つの円は模式的なもので、必要ならもっと多くてもよいと書いています。規模が小さければ、業務の規則とそれ以外の2つに分ける形から始める方法もあります。

クリーンアーキテクチャとドメイン駆動設計は同じものですか

別のものです。ドメイン駆動設計は、業務の言葉とモデルをどう切り出すかを扱う進め方です。クリーンアーキテクチャは、切り出した規則をデータベースや画面とどうつなぐかを扱います。組み合わせて使われることがよくあります。

既存のシステムにも取り入れられますか

取り入れられます。新しく足す機能や、改修の多い業務の規則から始め、画面やデータベースの処理に埋もれている規則を少しずつ内側へ移します。移した部分にはテストを先に用意しておくと進めやすくなります。

保守しやすい設計でのシステム開発のご相談

元請(プライムベンダー)として、アーキテクチャの設計とテストの自動化を含めたシステム開発から、保守・運用までご提案します。

2006年の創業以来、一次請けのシステムインテグレーターとして、企業のシステム開発と保守・運用を受託してきました。

無料相談はこちら

出典

  1. *1 参考:Robert C. Martin「The Clean Architecture」(Clean Coder Blog、2012年8月13日)(https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)。出典:先行する設計の列挙、システムが持つ性質、The Dependency Rule、4つの円の役割、Only Four Circles? を参照(2026年10月確認)
  2. *2 参考:Alistair Cockburn「The Hexagonal (Ports & Adapters) Architecture」(HaT Technical Report 2005.02、2005年9月4日)(https://alistair.cockburn.us/hexagonal-architecture/)。出典:Intent(利用者・プログラム・自動テスト・バッチから同じように動かす)、Motivation(約束が破られたことを検知する手段の問題)、別名 Ports and Adapters を参照(2026年10月確認)
  3. *3 参考:Jeffrey Palermo「The Onion Architecture : part 1」(Programming with Palermo、2008年7月29日)(https://jeffreypalermo.com/2008/07/the-onion-architecture-part-1/)。出典:データベースを中心に置かないこと、適用範囲(小さなWebサイトには向かない)を参照(2026年10月確認)




View