@k2works/claude-code-booster 2.7.1 → 3.1.0

package/lib/assets/docs/article/functional-desgin-ppp/scala/index.md

@@ -0,0 +1,199 @@
+# Scala で学ぶ関数型デザイン
+
+## はじめに
+
+本記事シリーズは、関数型プログラミングにおける設計原則とデザインパターンを Scala を使って実践的に学ぶためのガイドです。Scala のオブジェクト指向と関数型のハイブリッドな特性を活かし、従来のデザインパターンを関数型パラダイムでどのように表現し、活用できるかを探求します。
+
+## 記事構成
+
+### 第1部: 関数型プログラミングの基礎原則
+
+1. [不変性とデータ変換](./01-immutability-and-data-transformation.md)
+    - case class と不変データ構造
+    - データ変換パイプライン
+    - 副作用の分離
+
+2. [関数合成と高階関数](./02-function-composition.md)
+    - andThen と compose による関数合成
+    - カリー化と部分適用
+    - 高階関数の活用
+
+3. [多態性の実現方法](./03-polymorphism.md)
+    - sealed trait と代数的データ型
+    - トレイトとミックスイン
+    - 型クラスによる既存型の拡張
+
+### 第2部: 仕様とテスト
+
+4. [データ検証](./04-data-validation.md)
+    - 型によるバリデーション
+    - Either によるエラーハンドリング
+    - カスタムバリデータの作成
+
+5. [プロパティベーステスト](./05-property-based-testing.md)
+    - ScalaCheck の基本
+    - ジェネレータの作成
+    - プロパティの定義と検証
+
+6. [TDD と関数型プログラミング](./06-tdd-functional.md)
+    - ScalaTest によるテスト
+    - Red-Green-Refactor サイクル
+    - テストファーストの関数設計
+
+### 第3部: 構造パターン
+
+7. [Composite パターン](./07-composite-pattern.md)
+    - 再帰的なデータ構造
+    - ADT によるツリー構造
+    - fold による走査
+
+8. [Decorator パターン](./08-decorator-pattern.md)
+    - 関数合成によるデコレーション
+    - 高階関数でのラッピング
+    - 振る舞いの動的追加
+
+9. [Adapter パターン](./09-adapter-pattern.md)
+    - 関数アダプター
+    - プロトコル変換
+    - レガシーコードとの統合
+
+### 第4部: 振る舞いパターン
+
+10. [Strategy パターン](./10-strategy-pattern.md)
+    - 第一級関数としての戦略
+    - 動的な戦略切り替え
+    - 戦略の合成
+
+11. [Command パターン](./11-command-pattern.md)
+    - 不変コマンドオブジェクト
+    - コマンドの履歴と Undo
+    - マクロコマンド
+
+12. [Visitor パターン](./12-visitor-pattern.md)
+    - パターンマッチによる訪問
+    - fold ベースのビジター
+    - 拡張可能なビジター
+
+### 第5部: 生成パターン
+
+13. [Abstract Factory パターン](./13-abstract-factory-pattern.md)
+    - 関数ファクトリー
+    - 型クラスベースの生成
+    - 依存性注入
+
+14. [Abstract Server パターン](./14-abstract-server-pattern.md)
+    - トレイトによる抽象化
+    - 実装の差し替え
+    - テスタブルな設計
+
+### 第6部: ケーススタディ
+
+15. [ゴシップ好きなバスの運転手](./15-gossiping-bus-drivers.md)
+    - 不変状態の管理
+    - シミュレーションの実装
+    - 再帰的な処理
+
+16. [給与計算システム](./16-payroll-system.md)
+    - ドメインモデリング
+    - 多態的な計算
+    - レポート生成
+
+17. [レンタルビデオシステム](./17-video-rental-system.md)
+    - 状態遷移の管理
+    - イベントソーシング
+    - ビジネスルールの実装
+
+18. [並行処理システム](./18-concurrency-system.md)
+    - 状態マシン
+    - イベントバス
+    - AtomicReference による同期
+
+19. [Wa-Tor シミュレーション](./19-wator-simulation.md)
+    - セルオートマトン
+    - 不変グリッドの更新
+    - シミュレーションループ
+
+### 第7部: まとめと応用
+
+20. [パターン間の相互作用](./20-pattern-interactions.md)
+    - Composite + Decorator
+    - Command + Observer
+    - パターンの組み合わせ
+
+21. [ベストプラクティス](./21-best-practices.md)
+    - データ中心設計
+    - IO モナド
+    - 関数デコレーター
+    - テスタブルな設計
+
+22. [OO から FP への移行](./22-oo-to-fp-migration.md)
+    - 移行戦略（Strangler Fig、アダプター）
+    - イベントソーシング
+    - 段階的な関数抽出
+    - ADT による多態性
+
+---
+
+## 本シリーズの特徴
+
+### Scala の特性を活かした実装
+
+Scala 3 の新機能（enum、given/using、拡張メソッドなど）を活用し、モダンな関数型プログラミングを学びます。
+
+### 実践重視
+
+すべてのパターンは ScalaTest による実際に動作するテストコードを含みます。理論だけでなく、実装を通じて理解を深めることを重視しています。
+
+### 段階的な学習
+
+基礎から応用へと段階的に内容が進行します。各章は独立して読むこともできますが、順番に読むことでより深い理解が得られます。
+
+---
+
+## 対象読者
+
+- 関数型プログラミングに興味がある Scala 開発者
+- Scala を学習中の開発者
+- オブジェクト指向デザインパターンの知識があり、関数型での表現を学びたい開発者
+- Clojure 版と比較して学習したい開発者
+
+---
+
+## 前提知識
+
+- プログラミングの基礎知識
+- Scala の基本的な文法（case class、trait、パターンマッチングなど）
+- デザインパターンの基本概念（推奨）
+
+---
+
+## 開発環境
+
+本シリーズのコードは以下の環境で動作確認しています：
+
+- Scala 3.3.1
+- sbt 1.9.7
+- ScalaTest 3.2.17
+- Nix による環境管理
+
+### 環境構築
+
+```bash
+# Nix を使用した開発環境の起動
+nix develop .#scala
+
+# テストの実行
+cd apps/scala/part1
+sbt test
+```
+
+---
+
+## 参考書籍
+
+本シリーズは以下の書籍の内容を参考にしています：
+
+- 「Functional Design: Principles, Patterns, and Practices」Robert C. Martin
+- 「Functional Programming in Scala」Paul Chiusano, Rúnar Bjarnason
+- 「Programming in Scala」Martin Odersky, Lex Spoon, Bill Venners
+- 「Scala with Cats」Noel Welsh, Dave Gurnell

package/lib/assets/docs/article/getting-start-tdd/clojure/01-todo-list-and-first-test.md

@@ -0,0 +1,166 @@
+# 第 1 章: TODO リストと最初のテスト
+
+## 1.1 はじめに
+
+プログラムを作成するにあたって、まず何をすればよいでしょうか？私たちは、仕様を確認して **TODO リスト** を作るところから始めます。
+
+> TODO リスト
+>
+> 何をテストすべきだろうか——着手する前に、必要になりそうなテストをリストに書き出しておこう。
+>
+> — テスト駆動開発
+
+## 1.2 仕様の確認
+
+今回取り組む FizzBuzz 問題の仕様は以下の通りです。
+
+```
+1 から 100 までの数をプリントするプログラムを書け。
+ただし 3 の倍数のときは数の代わりに「Fizz」と、5 の倍数のときは「Buzz」とプリントし、
+3 と 5 両方の倍数の場合には「FizzBuzz」とプリントすること。
+```
+
+この仕様をそのままプログラムに落とし込むには少しサイズが大きいですね。最初の作業は仕様を **TODO リスト** に分解する作業から着手しましょう。
+
+## 1.3 TODO リストの作成
+
+仕様を分解して TODO リストを作成します。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+    - [ ] 1 を渡したら文字列 "1" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+まず「1 を渡したら文字列 "1" を返す」という、最も小さなタスクから取り掛かります。
+
+## 1.4 テスティングフレームワークの導入
+
+### テストファースト
+
+最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
+
+> テストファースト
+>
+> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
+>
+> — テスト駆動開発
+
+今回 Clojure のテスティングフレームワークには標準ライブラリの **clojure.test** を利用します。`deftest`、`testing`、`is` マクロを使ってテストを記述します。
+
+### 開発環境のセットアップ
+
+Leiningen でプロジェクトをセットアップします。
+
+```bash
+# Nix 環境に入る
+$ nix develop .#clojure
+
+# プロジェクトディレクトリに移動
+$ cd apps/clojure
+```
+
+Clojure のテストは `test/` ディレクトリ配下に、プロダクトコードと対応する名前空間で配置します。
+
+### 環境確認テスト
+
+環境が正しく設定されていることを確認するため、学習用テストを書きます。
+
+```clojure
+;; test/fizzbuzz/core_test.clj
+(ns fizzbuzz.core-test
+  (:require [clojure.test :refer :all]
+            [fizzbuzz.core :refer :all]))
+
+(deftest greeting-test
+  (testing "挨拶機能"
+    (is (= "hello world" (greeting)))))
+```
+
+プロダクトコードを作成します。
+
+```clojure
+;; src/fizzbuzz/core.clj
+(ns fizzbuzz.core)
+
+(defn greeting []
+  "hello world")
+```
+
+テストを実行します。
+
+```bash
+$ lein test
+
+lein test fizzbuzz.core-test
+
+Ran 1 tests containing 1 assertions.
+0 failures, 0 errors.
+```
+
+テスト環境が正しく動作することを確認できました。
+
+## 1.5 最初のテスト
+
+では、FizzBuzz の最初のテストを作成しましょう。「1 を渡したら文字列 "1" を返す」テストです。
+
+```clojure
+;; test/fizzbuzz/core_test.clj
+(ns fizzbuzz.core-test
+  (:require [clojure.test :refer :all]
+            [fizzbuzz.core :refer :all]))
+
+(deftest fizzbuzz-test
+  (testing "数を文字列にして返す"
+    (testing "1 を渡したら文字列 \"1\" を返す"
+      (is (= "1" (fizzbuzz 1))))))
+```
+
+プロダクトコードに空の実装を追加します。
+
+```clojure
+;; src/fizzbuzz/core.clj
+(ns fizzbuzz.core)
+
+(defn fizzbuzz [n]
+  nil)
+```
+
+テストを実行すると失敗します。
+
+```bash
+$ lein test
+
+FAIL in (fizzbuzz-test) (core_test.clj:7)
+数を文字列にして返す 1 を渡したら文字列 "1" を返す
+expected: (= "1" (fizzbuzz 1))
+  actual: (not (= "1" nil))
+
+Ran 1 tests containing 1 assertions.
+1 failures, 0 errors.
+```
+
+**RED** の状態です。テストが失敗していることを確認しました。
+
+## 1.6 まとめ
+
+この章では以下のことを学びました。
+
+- **TODO リスト** を作成して仕様を小さなタスクに分解する方法
+- **clojure.test** を使ったテストの書き方（`deftest`、`testing`、`is`）
+- **テストファースト** のアプローチで最初に失敗するテストを書くこと
+- Leiningen プロジェクトの基本構造
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+    - [x] 1 を渡したら文字列 "1" を返す ← RED
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする

package/lib/assets/docs/article/getting-start-tdd/clojure/02-fake-it-and-triangulation.md

@@ -0,0 +1,162 @@
+# 第 2 章: 仮実装と三角測量
+
+## 2.1 はじめに
+
+前章で最初の失敗するテストを書きました。この章では **仮実装** と **三角測量** というテクニックを使って、テストを通すための最小限の実装を進めていきます。
+
+## 2.2 仮実装（Fake It）
+
+### GREEN にする
+
+**仮実装** とは、テストを通すために最も簡単な実装を行うことです。
+
+> ベタ書きの答えを書け
+>
+> すばやくグリーンにするにはどうすればよいだろうか——ベタ書きの答えを返すのだ。
+>
+> — テスト駆動開発
+
+現在失敗しているテストをグリーンにするには、単に `"1"` を返せばよいですね。
+
+```clojure
+;; src/fizzbuzz/core.clj
+(ns fizzbuzz.core)
+
+(defn fizzbuzz [n]
+  "1")
+```
+
+テストを実行します。
+
+```bash
+$ lein test
+
+Ran 1 tests containing 1 assertions.
+0 failures, 0 errors.
+```
+
+テストが通りました。**GREEN** です。
+
+### REFACTOR
+
+リファクタリングの必要があるかコードを確認しましょう。ベタ書きの実装ですが、次のテストで通用しなくなるでしょう。今の段階ではリファクタリングは不要です。
+
+## 2.3 三角測量
+
+次のテストを追加して、実装を一般化（抽象化）していきます。
+
+> 三角測量
+>
+> どうやって抽象化を進めればよいだろうか——2 つ以上の例があるときのみ抽象化を行うのだ。
+>
+> — テスト駆動開発
+
+```clojure
+;; test/fizzbuzz/core_test.clj
+(deftest fizzbuzz-test
+  (testing "数を文字列にして返す"
+    (testing "1 を渡したら文字列 \"1\" を返す"
+      (is (= "1" (fizzbuzz 1))))
+    (testing "2 を渡したら文字列 \"2\" を返す"
+      (is (= "2" (fizzbuzz 2))))))
+```
+
+テストを実行すると失敗します。
+
+```bash
+$ lein test
+
+FAIL in (fizzbuzz-test) (core_test.clj:9)
+数を文字列にして返す 2 を渡したら文字列 "2" を返す
+expected: (= "2" (fizzbuzz 2))
+  actual: (not (= "2" "1"))
+```
+
+2 つ以上の例があるので抽象化しましょう。`str` 関数を使って数値を文字列に変換します。
+
+```clojure
+;; src/fizzbuzz/core.clj
+(ns fizzbuzz.core)
+
+(defn fizzbuzz [n]
+  (str n))
+```
+
+テストを実行します。
+
+```bash
+$ lein test
+
+Ran 1 tests containing 2 assertions.
+0 failures, 0 errors.
+```
+
+テストが通りました。
+
+## 2.4 3 の倍数のテスト
+
+次は「3 の倍数のときは数の代わりに Fizz と返す」を実装しましょう。
+
+```clojure
+(deftest fizzbuzz-test
+  (testing "数を文字列にして返す"
+    (testing "1 を渡したら文字列 \"1\" を返す"
+      (is (= "1" (fizzbuzz 1))))
+    (testing "2 を渡したら文字列 \"2\" を返す"
+      (is (= "2" (fizzbuzz 2)))))
+
+  (testing "3 の倍数のときは数の代わりに「Fizz」と返す"
+    (testing "3 を渡したら文字列 \"Fizz\" を返す"
+      (is (= "Fizz" (fizzbuzz 3))))))
+```
+
+テスト実行 → RED。Clojure の `cond` を使って条件分岐を追加します。
+
+```clojure
+(defn fizzbuzz [n]
+  (cond
+    (zero? (mod n 3)) "Fizz"
+    :else (str n)))
+```
+
+テスト実行 → GREEN。
+
+## 2.5 5 の倍数のテスト
+
+```clojure
+  (testing "5 の倍数のときは「Buzz」と返す"
+    (testing "5 を渡したら文字列 \"Buzz\" を返す"
+      (is (= "Buzz" (fizzbuzz 5)))))
+```
+
+テスト実行 → RED。条件を追加します。
+
+```clojure
+(defn fizzbuzz [n]
+  (cond
+    (zero? (mod n 3)) "Fizz"
+    (zero? (mod n 5)) "Buzz"
+    :else (str n)))
+```
+
+テスト実行 → GREEN。
+
+## 2.6 まとめ
+
+この章では以下のことを学びました。
+
+- **仮実装（Fake It）**: テストを通す最小限の実装（ベタ書き）
+- **三角測量**: 2 つ以上のテストケースから一般化を導く
+- Clojure の `cond` による条件分岐
+- `zero?` と `mod` による倍数判定
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+    - [x] 1 を渡したら文字列 "1" を返す
+    - [x] 2 を渡したら文字列 "2" を返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする

package/lib/assets/docs/article/getting-start-tdd/clojure/03-obvious-implementation-and-refactoring.md

@@ -0,0 +1,135 @@
+# 第 3 章: 明白な実装とリファクタリング
+
+## 3.1 はじめに
+
+前章で三角測量による実装を学びました。この章では **明白な実装** で残りの FizzBuzz ロジックを完成させ、**リファクタリング** によってコードを整理します。
+
+## 3.2 3 と 5 両方の倍数
+
+### RED
+
+```clojure
+  (testing "3 と 5 両方の倍数の場合には「FizzBuzz」と返す"
+    (testing "15 を渡したら文字列 \"FizzBuzz\" を返す"
+      (is (= "FizzBuzz" (fizzbuzz 15)))))
+```
+
+テスト実行 → RED。15 は 3 の倍数でもあるため "Fizz" が返されます。
+
+### GREEN
+
+3 と 5 両方の倍数の条件を最初に配置します。Clojure の `and` で複合条件を表現します。
+
+```clojure
+(defn fizzbuzz [n]
+  (cond
+    (and (zero? (mod n 3)) (zero? (mod n 5))) "FizzBuzz"
+    (zero? (mod n 3)) "Fizz"
+    (zero? (mod n 5)) "Buzz"
+    :else (str n)))
+```
+
+テスト実行 → GREEN。
+
+### REFACTOR
+
+> 明白な実装
+>
+> すばやくグリーンにするにはどうすればよいだろうか——そのまま実装するのだ。
+>
+> — テスト駆動開発
+
+現在のコードは明快で読みやすいですが、`(zero? (mod n 3))` という条件が重複しています。Clojure ではヘルパー関数を使って条件を抽出できます。
+
+```clojure
+(defn- divisible-by?
+  "n が d で割り切れるかどうかを判定する"
+  [n d]
+  (zero? (mod n d)))
+
+(defn fizzbuzz [n]
+  (cond
+    (and (divisible-by? n 3) (divisible-by? n 5)) "FizzBuzz"
+    (divisible-by? n 3) "Fizz"
+    (divisible-by? n 5) "Buzz"
+    :else (str n)))
+```
+
+テスト実行 → GREEN。リファクタリング後もテストが通ることを確認しました。
+
+## 3.3 1 から 100 までのリスト
+
+1 から 100 までの FizzBuzz リストを生成する機能を追加します。
+
+### RED
+
+```clojure
+(deftest fizzbuzz-list-test
+  (testing "1 から 100 までの FizzBuzz リストを生成する"
+    (let [result (fizzbuzz-list 1 100)]
+      (is (= 100 (count result)))
+      (is (= "1" (first result)))
+      (is (= "Buzz" (nth result 99))))))
+```
+
+### GREEN
+
+Clojure の `map` と `range` を使って実装します。
+
+```clojure
+(defn fizzbuzz-list [start end]
+  (mapv fizzbuzz (range start (inc end))))
+```
+
+`mapv` はベクタ（永続配列）を返す `map` のバリアントです。テスト実行 → GREEN。
+
+## 3.4 プリント機能
+
+```clojure
+(defn print-fizzbuzz [start end]
+  (doseq [item (fizzbuzz-list start end)]
+    (println item)))
+
+(defn -main [& _args]
+  (print-fizzbuzz 1 100))
+```
+
+`doseq` は副作用を伴うシーケンス処理に使います。`-main` 関数はエントリーポイントです。
+
+## 3.5 スレッディングマクロ
+
+Clojure には **スレッディングマクロ**（`->` と `->>`）があります。これにより、データの変換パイプラインを読みやすく記述できます。
+
+```clojure
+;; 通常の書き方
+(println (first (mapv fizzbuzz (range 1 101))))
+
+;; ->> マクロを使った書き方
+(->> (range 1 101)
+     (mapv fizzbuzz)
+     first
+     println)
+```
+
+`->>` マクロは、前の式の結果を次の式の **最後の引数** に挿入します。パイプラインのように左から右へデータが流れるイメージで読めます。
+
+## 3.6 まとめ
+
+この章では以下のことを学びました。
+
+- **明白な実装**: 自明な場合はそのまま実装する
+- **リファクタリング**: `defn-` によるプライベート関数の抽出
+- `mapv` と `range` によるリスト生成
+- `doseq` による副作用を伴うシーケンス処理
+- `->>` スレッディングマクロによるパイプライン処理
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [x] 1 から 100 までの数
+- [x] プリントする
+
+第 1 部の FizzBuzz 基本実装が完成しました。第 2 部では開発環境と自動化について学びます。