@k2works/claude-code-booster 3.6.0 → 3.7.0

package/lib/assets/docs/article/getting-start-tdd/clojure/09-namespaces-and-module-design.md

@@ -1,127 +1,127 @@
-# 第 9 章: 名前空間とモジュール設計
-
-## 9.1 はじめに
-
-この章ではモノリシックなコードを名前空間に分割し、ドメインモデルに基づいたモジュール設計を行います。
-
-## 9.2 名前空間による分割
-
-### Before（モノリシック）
-
-```
-fizzbuzz/
-└── core.clj          (すべてのロジックが集中)
-```
-
-### After（モジュール分割）
-
-```
-fizzbuzz/
-├── core.clj                    (公開 API・エントリーポイント)
-├── domain/
-│   ├── model.clj               (値オブジェクト・コレクション)
-│   └── type.clj                (FizzBuzz タイプ — プロトコル実装)
-└── application/
-    └── command.clj             (コマンド関数)
-```
-
-## 9.3 名前空間の設計原則
-
-### 単一責任の原則
-
-各名前空間は 1 つの責務のみを持ちます。
-
-| 名前空間 | 責務 |
-|----------|------|
-| `fizzbuzz.core` | 公開 API とメインエントリーポイント |
-| `fizzbuzz.domain.model` | FizzBuzzValue と FizzBuzzList の定義 |
-| `fizzbuzz.domain.type` | タイプごとの文字列生成ロジック |
-| `fizzbuzz.application.command` | コマンドパターンの実装 |
-
-### 依存方向
-
-依存関係は常に上位レイヤーから下位レイヤーへ向かいます。
-
-```
-application/command → domain/type → domain/model
-                   ↗
-     core ────────
-```
-
-## 9.4 名前空間の require
-
-```clojure
-;; エイリアスを使った require
-(ns fizzbuzz.domain.type
-  (:require [fizzbuzz.domain.model :as model]))
-
-;; model/fizz? のようにエイリアス経由でアクセス
-(model/fizz? 3)  ;=> true
-```
-
-### require のベストプラクティス
-
-1. **`:as` エイリアス** を使う（名前の衝突を防ぐ）
-2. **`:refer :all`** は避ける（テストファイルでは許容）
-3. **循環依存** を作らない
-
-## 9.5 アクセス制御
-
-Clojure では `defn-` でプライベート関数を定義します。
-
-```clojure
-;; パブリック関数
-(defn fizzbuzz [n] ...)
-
-;; プライベート関数（同一名前空間内でのみアクセス可能）
-(defn- divisible-by? [n d]
-  (zero? (mod n d)))
-```
-
-## 9.6 レコードとプロトコルの配置
-
-### 推奨パターン
-
-- **プロトコルの定義**: 独立した名前空間に配置
-- **レコードの実装**: プロトコルを require して実装
-- **ファクトリ関数**: プロトコルと同じ名前空間に配置
-
-```clojure
-;; domain/type.clj にプロトコル定義とレコード実装を配置
-(defprotocol FizzBuzzType
-  (generate-string [this value]))
-
-(defrecord FizzBuzzType01 []
-  FizzBuzzType
-  (generate-string [_this value] ...))
-
-;; ファクトリ関数も同じ名前空間に
-(defn create-type [type-num] ...)
-```
-
-## 9.7 テスト名前空間の構成
-
-テストは対応するプロダクトコードと同じ構造で配置します。
-
-```
-test/
-└── fizzbuzz/
-    ├── core_test.clj
-    ├── domain/
-    │   └── type_test.clj
-    └── application/
-        └── command_test.clj
-```
-
-## 9.8 まとめ
-
-この章では以下のことを学びました。
-
-- **ns** マクロによる名前空間の定義と管理
-- **:require** と **:as** エイリアスによる依存関係の宣言
-- **単一責任の原則** に基づくモジュール設計
-- **defn-** によるアクセス制御
-- ドメインモデルに基づいた名前空間の分割パターン
-- テスト名前空間の構成
-
-第 3 部が完了しました。プロトコルとマルチメソッドによるポリモーフィズムと、名前空間によるモジュール設計を学びました。第 4 部では関数型プログラミングの本質を探ります。
+# 第 9 章: 名前空間とモジュール設計
+
+## 9.1 はじめに
+
+この章ではモノリシックなコードを名前空間に分割し、ドメインモデルに基づいたモジュール設計を行います。
+
+## 9.2 名前空間による分割
+
+### Before（モノリシック）
+
+```
+fizzbuzz/
+└── core.clj          (すべてのロジックが集中)
+```
+
+### After（モジュール分割）
+
+```
+fizzbuzz/
+├── core.clj                    (公開 API・エントリーポイント)
+├── domain/
+│   ├── model.clj               (値オブジェクト・コレクション)
+│   └── type.clj                (FizzBuzz タイプ — プロトコル実装)
+└── application/
+    └── command.clj             (コマンド関数)
+```
+
+## 9.3 名前空間の設計原則
+
+### 単一責任の原則
+
+各名前空間は 1 つの責務のみを持ちます。
+
+| 名前空間 | 責務 |
+|----------|------|
+| `fizzbuzz.core` | 公開 API とメインエントリーポイント |
+| `fizzbuzz.domain.model` | FizzBuzzValue と FizzBuzzList の定義 |
+| `fizzbuzz.domain.type` | タイプごとの文字列生成ロジック |
+| `fizzbuzz.application.command` | コマンドパターンの実装 |
+
+### 依存方向
+
+依存関係は常に上位レイヤーから下位レイヤーへ向かいます。
+
+```
+application/command → domain/type → domain/model
+                   ↗
+     core ────────
+```
+
+## 9.4 名前空間の require
+
+```clojure
+;; エイリアスを使った require
+(ns fizzbuzz.domain.type
+  (:require [fizzbuzz.domain.model :as model]))
+
+;; model/fizz? のようにエイリアス経由でアクセス
+(model/fizz? 3)  ;=> true
+```
+
+### require のベストプラクティス
+
+1. **`:as` エイリアス** を使う（名前の衝突を防ぐ）
+2. **`:refer :all`** は避ける（テストファイルでは許容）
+3. **循環依存** を作らない
+
+## 9.5 アクセス制御
+
+Clojure では `defn-` でプライベート関数を定義します。
+
+```clojure
+;; パブリック関数
+(defn fizzbuzz [n] ...)
+
+;; プライベート関数（同一名前空間内でのみアクセス可能）
+(defn- divisible-by? [n d]
+  (zero? (mod n d)))
+```
+
+## 9.6 レコードとプロトコルの配置
+
+### 推奨パターン
+
+- **プロトコルの定義**: 独立した名前空間に配置
+- **レコードの実装**: プロトコルを require して実装
+- **ファクトリ関数**: プロトコルと同じ名前空間に配置
+
+```clojure
+;; domain/type.clj にプロトコル定義とレコード実装を配置
+(defprotocol FizzBuzzType
+  (generate-string [this value]))
+
+(defrecord FizzBuzzType01 []
+  FizzBuzzType
+  (generate-string [_this value] ...))
+
+;; ファクトリ関数も同じ名前空間に
+(defn create-type [type-num] ...)
+```
+
+## 9.7 テスト名前空間の構成
+
+テストは対応するプロダクトコードと同じ構造で配置します。
+
+```
+test/
+└── fizzbuzz/
+    ├── core_test.clj
+    ├── domain/
+    │   └── type_test.clj
+    └── application/
+        └── command_test.clj
+```
+
+## 9.8 まとめ
+
+この章では以下のことを学びました。
+
+- **ns** マクロによる名前空間の定義と管理
+- **:require** と **:as** エイリアスによる依存関係の宣言
+- **単一責任の原則** に基づくモジュール設計
+- **defn-** によるアクセス制御
+- ドメインモデルに基づいた名前空間の分割パターン
+- テスト名前空間の構成
+
+第 3 部が完了しました。プロトコルとマルチメソッドによるポリモーフィズムと、名前空間によるモジュール設計を学びました。第 4 部では関数型プログラミングの本質を探ります。

package/lib/assets/docs/article/getting-start-tdd/clojure/10-higher-order-functions-and-composition.md

@@ -1,114 +1,114 @@
-# 第 10 章: 高階関数と関数合成
-
-## 10.1 はじめに
-
-この章では Clojure の **高階関数** と **関数合成** を使って、FizzBuzz プログラムをより関数型らしいスタイルに変換します。
-
-## 10.2 高階関数
-
-高階関数とは、関数を引数として受け取るか、関数を返す関数のことです。Clojure では関数がファーストクラスの値であり、変数に束縛したり、引数として渡したりできます。
-
-### map / filter / reduce
-
-```clojure
-;; map: 各要素に関数を適用
-(map fizzbuzz (range 1 16))
-;=> ("1" "2" "Fizz" "4" "Buzz" "Fizz" "7" "8" "Fizz" "Buzz"
-;    "11" "Fizz" "13" "14" "FizzBuzz")
-
-;; filter: 条件を満たす要素のみ抽出
-(filter #(not= "" %) (map #(type/generate-string (type/->FizzBuzzType03)
-                                                  (model/create-fizz-buzz-value %))
-                          (range 1 16)))
-;=> ("Fizz" "Buzz" "Fizz" "Fizz" "Buzz" "Fizz" "FizzBuzz")
-
-;; reduce: 累積処理
-(reduce str (map fizzbuzz (range 1 6)))
-;=> "12FizzBuzz4"
-```
-
-### 部分適用（partial）
-
-`partial` は関数の一部の引数を固定して新しい関数を作ります。
-
-```clojure
-(def fizzbuzz-type1
-  (partial type/generate-string (type/->FizzBuzzType01)))
-
-(fizzbuzz-type1 (model/create-fizz-buzz-value 15))
-;=> "FizzBuzz"
-```
-
-### 無名関数
-
-```clojure
-;; fn による無名関数
-(map (fn [n] (fizzbuzz n)) (range 1 6))
-
-;; #() リーダーマクロによる短縮形
-(map #(fizzbuzz %) (range 1 6))
-```
-
-## 10.3 関数合成
-
-### comp による関数合成
-
-`comp` は複数の関数を合成して新しい関数を作ります。右から左へ適用されます。
-
-```clojure
-(def fizzbuzz-with-prefix
-  (comp (partial str "=> ") fizzbuzz))
-
-(fizzbuzz-with-prefix 3)
-;=> "=> Fizz"
-
-(fizzbuzz-with-prefix 15)
-;=> "=> FizzBuzz"
-```
-
-### スレッディングマクロ
-
-`->` と `->>` はデータの変換パイプラインを記述します。
-
-```clojure
-;; ->> マクロ（最後の引数に挿入）
-(->> (range 1 101)
-     (map fizzbuzz)
-     (filter #(re-matches #"[A-Za-z]+" %))
-     (take 5))
-;=> ("Fizz" "Buzz" "Fizz" "Fizz" "Buzz")
-
-;; -> マクロ（最初の引数に挿入）
-(-> 15
-    fizzbuzz
-    clojure.string/upper-case)
-;=> "FIZZBUZZ"
-```
-
-## 10.4 関数ファクトリ
-
-関数を返す関数を使って、カスタマイズ可能な処理を作れます。
-
-```clojure
-(defn create-fizzbuzz-filter
-  "指定パターンにマッチする FizzBuzz 結果をフィルタリングする関数を返す"
-  [pattern]
-  (fn [results]
-    (filter #(clojure.string/includes? % pattern) results)))
-
-(def fizz-filter (create-fizzbuzz-filter "Fizz"))
-(def buzz-filter (create-fizzbuzz-filter "Buzz"))
-
-(fizz-filter ["1" "Fizz" "Buzz" "FizzBuzz"])
-;=> ("Fizz" "FizzBuzz")
-```
-
-## 10.5 まとめ
-
-この章では以下のことを学びました。
-
-- **map / filter / reduce** による高階関数の活用
-- **partial** による部分適用
-- **comp** による関数合成
-- **スレッディングマクロ**（`->`、`->>`）によるパイプライン処理
-- **関数ファクトリ**（関数を返す関数）パターン
+# 第 10 章: 高階関数と関数合成
+
+## 10.1 はじめに
+
+この章では Clojure の **高階関数** と **関数合成** を使って、FizzBuzz プログラムをより関数型らしいスタイルに変換します。
+
+## 10.2 高階関数
+
+高階関数とは、関数を引数として受け取るか、関数を返す関数のことです。Clojure では関数がファーストクラスの値であり、変数に束縛したり、引数として渡したりできます。
+
+### map / filter / reduce
+
+```clojure
+;; map: 各要素に関数を適用
+(map fizzbuzz (range 1 16))
+;=> ("1" "2" "Fizz" "4" "Buzz" "Fizz" "7" "8" "Fizz" "Buzz"
+;    "11" "Fizz" "13" "14" "FizzBuzz")
+
+;; filter: 条件を満たす要素のみ抽出
+(filter #(not= "" %) (map #(type/generate-string (type/->FizzBuzzType03)
+                                                  (model/create-fizz-buzz-value %))
+                          (range 1 16)))
+;=> ("Fizz" "Buzz" "Fizz" "Fizz" "Buzz" "Fizz" "FizzBuzz")
+
+;; reduce: 累積処理
+(reduce str (map fizzbuzz (range 1 6)))
+;=> "12FizzBuzz4"
+```
+
+### 部分適用（partial）
+
+`partial` は関数の一部の引数を固定して新しい関数を作ります。
+
+```clojure
+(def fizzbuzz-type1
+  (partial type/generate-string (type/->FizzBuzzType01)))
+
+(fizzbuzz-type1 (model/create-fizz-buzz-value 15))
+;=> "FizzBuzz"
+```
+
+### 無名関数
+
+```clojure
+;; fn による無名関数
+(map (fn [n] (fizzbuzz n)) (range 1 6))
+
+;; #() リーダーマクロによる短縮形
+(map #(fizzbuzz %) (range 1 6))
+```
+
+## 10.3 関数合成
+
+### comp による関数合成
+
+`comp` は複数の関数を合成して新しい関数を作ります。右から左へ適用されます。
+
+```clojure
+(def fizzbuzz-with-prefix
+  (comp (partial str "=> ") fizzbuzz))
+
+(fizzbuzz-with-prefix 3)
+;=> "=> Fizz"
+
+(fizzbuzz-with-prefix 15)
+;=> "=> FizzBuzz"
+```
+
+### スレッディングマクロ
+
+`->` と `->>` はデータの変換パイプラインを記述します。
+
+```clojure
+;; ->> マクロ（最後の引数に挿入）
+(->> (range 1 101)
+     (map fizzbuzz)
+     (filter #(re-matches #"[A-Za-z]+" %))
+     (take 5))
+;=> ("Fizz" "Buzz" "Fizz" "Fizz" "Buzz")
+
+;; -> マクロ（最初の引数に挿入）
+(-> 15
+    fizzbuzz
+    clojure.string/upper-case)
+;=> "FIZZBUZZ"
+```
+
+## 10.4 関数ファクトリ
+
+関数を返す関数を使って、カスタマイズ可能な処理を作れます。
+
+```clojure
+(defn create-fizzbuzz-filter
+  "指定パターンにマッチする FizzBuzz 結果をフィルタリングする関数を返す"
+  [pattern]
+  (fn [results]
+    (filter #(clojure.string/includes? % pattern) results)))
+
+(def fizz-filter (create-fizzbuzz-filter "Fizz"))
+(def buzz-filter (create-fizzbuzz-filter "Buzz"))
+
+(fizz-filter ["1" "Fizz" "Buzz" "FizzBuzz"])
+;=> ("Fizz" "FizzBuzz")
+```
+
+## 10.5 まとめ
+
+この章では以下のことを学びました。
+
+- **map / filter / reduce** による高階関数の活用
+- **partial** による部分適用
+- **comp** による関数合成
+- **スレッディングマクロ**（`->`、`->>`）によるパイプライン処理
+- **関数ファクトリ**（関数を返す関数）パターン