@k2works/claude-code-booster 4.13.0 → 4.14.0

package/lib/assets/docs/article/getting-start-tdd/rust/index.md

@@ -1,83 +1,83 @@
-# テスト駆動開発から始める Rust 入門
-
-## 概要
-
-FizzBuzz 問題を題材に、テスト駆動開発（TDD）の基本サイクルから、開発環境の整備、オブジェクト指向設計、関数型プログラミングの活用まで、Rust の特徴を活かしながら段階的に学びます。
-
-## 対象読者
-
-- Rust の基本文法を理解しているプログラミング学習者
-- TDD を体験してみたい開発者
-- 所有権システムやトレイトベースの設計に興味がある方
-
-## 前提条件
-
-- Rust 1.70 以降がインストールされていること
-- Clippy、rustfmt が利用可能であること（Nix 環境推奨: `nix develop .#rust`）
-
-## Rust の特徴
-
-| 特徴 | 説明 |
-|------|------|
-| 所有権と借用 | メモリ安全性をコンパイル時に保証、GC 不要 |
-| 静的型付け + 型推論 | 強力な型システムと `let` による型推論 |
-| トレイト | インターフェースの明示的実装、ポリモーフィズムの基盤 |
-| enum + パターンマッチ | 代数的データ型と網羅的なパターンマッチング |
-| Result / Option | null や例外に頼らない安全なエラーハンドリング |
-| ゼロコスト抽象化 | 高レベルな抽象化がランタイムコストを伴わない |
-
-## 開発ツール
-
-| ツール | 用途 |
-|--------|------|
-| [cargo test](https://doc.rust-lang.org/cargo/commands/cargo-test.html) | 標準テストランナー |
-| [Cargo](https://doc.rust-lang.org/cargo/) | パッケージ管理・ビルドシステム |
-| [Clippy](https://github.com/rust-lang/rust-clippy) | Linter（コード品質チェック） |
-| [rustfmt](https://github.com/rust-lang/rustfmt) | 標準フォーマッター |
-| [just](https://github.com/casey/just) | タスクランナー |
-
-## 目次
-
-### 第 1 部: TDD の基本サイクル
-
-1. [第 1 章: TODO リストと最初のテスト](01-todo-list-and-first-test.md)
-2. [第 2 章: 仮実装と三角測量](02-fake-it-and-triangulation.md)
-3. [第 3 章: 明白な実装とリファクタリング](03-obvious-implementation-and-refactoring.md)
-
-### 第 2 部: 開発環境と自動化
-
-4. [第 4 章: バージョン管理と Conventional Commits](04-version-control-and-conventional-commits.md)
-5. [第 5 章: パッケージ管理と静的解析](05-package-management-and-static-analysis.md)
-6. [第 6 章: タスクランナーと CI/CD](06-task-runner-and-ci-cd.md)
-
-### 第 3 部: オブジェクト指向設計
-
-7. [第 7 章: カプセル化とポリモーフィズム](07-encapsulation-and-polymorphism.md)
-8. [第 8 章: デザインパターンの適用](08-design-patterns.md)
-9. [第 9 章: SOLID 原則とモジュール設計](09-solid-principles-and-module-design.md)
-
-### 第 4 部: 関数型プログラミングへの展開
-
-10. [第 10 章: 高階関数と関数合成](10-higher-order-functions-and-composition.md)
-11. [第 11 章: 不変データとパイプライン処理](11-immutable-data-and-pipeline.md)
-12. [第 12 章: エラーハンドリングと型安全性](12-error-handling-and-type-safety.md)
-
-## 実装コード
-
-本記事のすべてのコード例は `apps/rust/` に実装されています。
-
-```bash
-# 開発環境に入る
-nix develop .#rust
-
-# テスト実行
-cd apps/rust
-cargo test
-```
-
-## 参考文献
-
-- Kent Beck 著『テスト駆動開発』
-- Martin Fowler 著『リファクタリング: 既存のコードを安全に改善する』
-- Robert C. Martin 著『Clean Code: アジャイルソフトウェア達人の技』
-- Steve Klabnik, Carol Nichols 著『The Rust Programming Language』
+# テスト駆動開発から始める Rust 入門
+
+## 概要
+
+FizzBuzz 問題を題材に、テスト駆動開発（TDD）の基本サイクルから、開発環境の整備、オブジェクト指向設計、関数型プログラミングの活用まで、Rust の特徴を活かしながら段階的に学びます。
+
+## 対象読者
+
+- Rust の基本文法を理解しているプログラミング学習者
+- TDD を体験してみたい開発者
+- 所有権システムやトレイトベースの設計に興味がある方
+
+## 前提条件
+
+- Rust 1.70 以降がインストールされていること
+- Clippy、rustfmt が利用可能であること（Nix 環境推奨: `nix develop .#rust`）
+
+## Rust の特徴
+
+| 特徴 | 説明 |
+|------|------|
+| 所有権と借用 | メモリ安全性をコンパイル時に保証、GC 不要 |
+| 静的型付け + 型推論 | 強力な型システムと `let` による型推論 |
+| トレイト | インターフェースの明示的実装、ポリモーフィズムの基盤 |
+| enum + パターンマッチ | 代数的データ型と網羅的なパターンマッチング |
+| Result / Option | null や例外に頼らない安全なエラーハンドリング |
+| ゼロコスト抽象化 | 高レベルな抽象化がランタイムコストを伴わない |
+
+## 開発ツール
+
+| ツール | 用途 |
+|--------|------|
+| [cargo test](https://doc.rust-lang.org/cargo/commands/cargo-test.html) | 標準テストランナー |
+| [Cargo](https://doc.rust-lang.org/cargo/) | パッケージ管理・ビルドシステム |
+| [Clippy](https://github.com/rust-lang/rust-clippy) | Linter（コード品質チェック） |
+| [rustfmt](https://github.com/rust-lang/rustfmt) | 標準フォーマッター |
+| [just](https://github.com/casey/just) | タスクランナー |
+
+## 目次
+
+### 第 1 部: TDD の基本サイクル
+
+1. [第 1 章: TODO リストと最初のテスト](01-todo-list-and-first-test.md)
+2. [第 2 章: 仮実装と三角測量](02-fake-it-and-triangulation.md)
+3. [第 3 章: 明白な実装とリファクタリング](03-obvious-implementation-and-refactoring.md)
+
+### 第 2 部: 開発環境と自動化
+
+4. [第 4 章: バージョン管理と Conventional Commits](04-version-control-and-conventional-commits.md)
+5. [第 5 章: パッケージ管理と静的解析](05-package-management-and-static-analysis.md)
+6. [第 6 章: タスクランナーと CI/CD](06-task-runner-and-ci-cd.md)
+
+### 第 3 部: オブジェクト指向設計
+
+7. [第 7 章: カプセル化とポリモーフィズム](07-encapsulation-and-polymorphism.md)
+8. [第 8 章: デザインパターンの適用](08-design-patterns.md)
+9. [第 9 章: SOLID 原則とモジュール設計](09-solid-principles-and-module-design.md)
+
+### 第 4 部: 関数型プログラミングへの展開
+
+10. [第 10 章: 高階関数と関数合成](10-higher-order-functions-and-composition.md)
+11. [第 11 章: 不変データとパイプライン処理](11-immutable-data-and-pipeline.md)
+12. [第 12 章: エラーハンドリングと型安全性](12-error-handling-and-type-safety.md)
+
+## 実装コード
+
+本記事のすべてのコード例は `apps/rust/` に実装されています。
+
+```bash
+# 開発環境に入る
+nix develop .#rust
+
+# テスト実行
+cd apps/rust
+cargo test
+```
+
+## 参考文献
+
+- Kent Beck 著『テスト駆動開発』
+- Martin Fowler 著『リファクタリング: 既存のコードを安全に改善する』
+- Robert C. Martin 著『Clean Code: アジャイルソフトウェア達人の技』
+- Steve Klabnik, Carol Nichols 著『The Rust Programming Language』

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

@@ -1,111 +1,111 @@
-# 第 1 章: TODO リストと最初のテスト
-
-## 1.1 はじめに
-
-この章では、TDD の基本サイクルである Red-Green-Refactor を FizzBuzz 問題で体験します。
-
-- Red: まず失敗するテストを書きます。
-- Green: テストを通す最小限の実装を書きます。
-- Refactor: テストを壊さずに実装を整理します。
-
-題材の FizzBuzz 仕様は次の通りです。
-
-- 3 の倍数は `Fizz` を返します。
-- 5 の倍数は `Buzz` を返します。
-- 15 の倍数は `FizzBuzz` を返します。
-- それ以外は数値を文字列で返します。
-
-## 1.2 仕様の確認
-
-最初に仕様をテスト可能な単位で整理します。
-
-- 入力は `Int` 型です。
-- 出力は `String` 型です。
-- 1 は `"1"` を返します。
-- 3 は `"Fizz"` を返します。
-- 5 は `"Buzz"` を返します。
-- 15 は `"FizzBuzz"` を返します。
-
-この段階では、まだ実装方法を決めません。仕様だけを明確にします。
-
-## 1.3 TODO リストの作成
-
-仕様を小さく分解して TODO リストにします。
-
-- [ ] `FizzBuzz.generate(1)` が `"1"` を返す
-- [ ] `FizzBuzz.generate(2)` が `"2"` を返す
-- [ ] `FizzBuzz.generate(3)` が `"Fizz"` を返す
-- [ ] `FizzBuzz.generate(5)` が `"Buzz"` を返す
-- [ ] `FizzBuzz.generate(15)` が `"FizzBuzz"` を返す
-- [ ] `FizzBuzz.generateList(100)` が 100 件の結果を返す
-
-最初のタスクは、もっとも単純で失敗時の原因が明確なものを選びます。
-このため、最初は `1` のケースから始めます。
-
-## 1.4 テストファースト
-
-### プロジェクトのセットアップ
-
-Scala の sbt プロジェクトは、主に次の構成で進めます。
-
-- `build.sbt`: プロジェクト名、Scala バージョン、依存関係
-- `project/`: sbt 設定
-- `src/main/scala/`: 本番コード
-- `src/test/scala/`: テストコード
-
-`ScalaTest` を利用するため、`build.sbt` に test scope の依存関係を追加します。
-
-```scala
-libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.19" % Test
-```
-
-### 最初のテストを書く
-
-最初の失敗するテストを `FizzBuzzSpec.scala` に書きます。
-
-```scala
-package fizzbuzz
-
-import org.scalatest.funsuite.AnyFunSuite
-
-class FizzBuzzSpec extends AnyFunSuite:
-  test("1 を渡すと文字列 1 を返す") {
-    assert(FizzBuzz.generate(1) === "1")
-  }
-```
-
-### テストを実行して失敗を確認（Red）
-
-`sbt test` を実行すると、最初は `FizzBuzz` が未定義でコンパイルエラーになります。
-これは Red の成功です。失敗するテストから開発を開始できています。
-
-## 1.5 仮実装
-
-次に最小限の実装を追加して Green を目指します。
-
-```scala
-package fizzbuzz
-
-object FizzBuzz:
-  def generate(number: Int): String = "1"
-```
-
-この時点では `1` を固定で返す仮実装で十分です。
-再度 `sbt test` を実行し、最初のテストが通ることを確認します。
-
-## 1.6 まとめ
-
-この章では、TDD の最初の 1 サイクルを実行しました。
-
-- Red: 最初のテストを追加
-- Green: 最小実装でテストを通過
-- Refactor: 今回は対象なし（次章で一般化）
-
-TODO リストも更新して進捗を明確にします。
-
-- [x] `FizzBuzz.generate(1)` が `"1"` を返す
-- [ ] `FizzBuzz.generate(2)` が `"2"` を返す
-- [ ] `FizzBuzz.generate(3)` が `"Fizz"` を返す
-- [ ] `FizzBuzz.generate(5)` が `"Buzz"` を返す
-- [ ] `FizzBuzz.generate(15)` が `"FizzBuzz"` を返す
-- [ ] `FizzBuzz.generateList(100)` が 100 件の結果を返す
+# 第 1 章: TODO リストと最初のテスト
+
+## 1.1 はじめに
+
+この章では、TDD の基本サイクルである Red-Green-Refactor を FizzBuzz 問題で体験します。
+
+- Red: まず失敗するテストを書きます。
+- Green: テストを通す最小限の実装を書きます。
+- Refactor: テストを壊さずに実装を整理します。
+
+題材の FizzBuzz 仕様は次の通りです。
+
+- 3 の倍数は `Fizz` を返します。
+- 5 の倍数は `Buzz` を返します。
+- 15 の倍数は `FizzBuzz` を返します。
+- それ以外は数値を文字列で返します。
+
+## 1.2 仕様の確認
+
+最初に仕様をテスト可能な単位で整理します。
+
+- 入力は `Int` 型です。
+- 出力は `String` 型です。
+- 1 は `"1"` を返します。
+- 3 は `"Fizz"` を返します。
+- 5 は `"Buzz"` を返します。
+- 15 は `"FizzBuzz"` を返します。
+
+この段階では、まだ実装方法を決めません。仕様だけを明確にします。
+
+## 1.3 TODO リストの作成
+
+仕様を小さく分解して TODO リストにします。
+
+- [ ] `FizzBuzz.generate(1)` が `"1"` を返す
+- [ ] `FizzBuzz.generate(2)` が `"2"` を返す
+- [ ] `FizzBuzz.generate(3)` が `"Fizz"` を返す
+- [ ] `FizzBuzz.generate(5)` が `"Buzz"` を返す
+- [ ] `FizzBuzz.generate(15)` が `"FizzBuzz"` を返す
+- [ ] `FizzBuzz.generateList(100)` が 100 件の結果を返す
+
+最初のタスクは、もっとも単純で失敗時の原因が明確なものを選びます。
+このため、最初は `1` のケースから始めます。
+
+## 1.4 テストファースト
+
+### プロジェクトのセットアップ
+
+Scala の sbt プロジェクトは、主に次の構成で進めます。
+
+- `build.sbt`: プロジェクト名、Scala バージョン、依存関係
+- `project/`: sbt 設定
+- `src/main/scala/`: 本番コード
+- `src/test/scala/`: テストコード
+
+`ScalaTest` を利用するため、`build.sbt` に test scope の依存関係を追加します。
+
+```scala
+libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.19" % Test
+```
+
+### 最初のテストを書く
+
+最初の失敗するテストを `FizzBuzzSpec.scala` に書きます。
+
+```scala
+package fizzbuzz
+
+import org.scalatest.funsuite.AnyFunSuite
+
+class FizzBuzzSpec extends AnyFunSuite:
+  test("1 を渡すと文字列 1 を返す") {
+    assert(FizzBuzz.generate(1) === "1")
+  }
+```
+
+### テストを実行して失敗を確認（Red）
+
+`sbt test` を実行すると、最初は `FizzBuzz` が未定義でコンパイルエラーになります。
+これは Red の成功です。失敗するテストから開発を開始できています。
+
+## 1.5 仮実装
+
+次に最小限の実装を追加して Green を目指します。
+
+```scala
+package fizzbuzz
+
+object FizzBuzz:
+  def generate(number: Int): String = "1"
+```
+
+この時点では `1` を固定で返す仮実装で十分です。
+再度 `sbt test` を実行し、最初のテストが通ることを確認します。
+
+## 1.6 まとめ
+
+この章では、TDD の最初の 1 サイクルを実行しました。
+
+- Red: 最初のテストを追加
+- Green: 最小実装でテストを通過
+- Refactor: 今回は対象なし（次章で一般化）
+
+TODO リストも更新して進捗を明確にします。
+
+- [x] `FizzBuzz.generate(1)` が `"1"` を返す
+- [ ] `FizzBuzz.generate(2)` が `"2"` を返す
+- [ ] `FizzBuzz.generate(3)` が `"Fizz"` を返す
+- [ ] `FizzBuzz.generate(5)` が `"Buzz"` を返す
+- [ ] `FizzBuzz.generate(15)` が `"FizzBuzz"` を返す
+- [ ] `FizzBuzz.generateList(100)` が 100 件の結果を返す

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

@@ -1,107 +1,107 @@
-# 第 2 章: 仮実装と三角測量
-
-## 2.1 はじめに
-
-第 1 章では、最小の 1 ケースを Green にしました。
-この章では、次の 2 つのテクニックで実装を育てます。
-
-- Fake It: まず動く最小のコードを書く
-- Triangulation: 複数ケースから一般ルールを導く
-
-## 2.2 仮実装（Fake It）
-
-まず `2` のケースを追加して、仮実装の限界を明確にします。
-
-```scala
-test("2 を渡すと文字列 2 を返す") {
-  assert(FizzBuzz.generate(2) === "2")
-}
-```
-
-このテストは失敗します。
-現在の実装は常に `"1"` を返すためです。
-
-ここで実装を一段だけ一般化します。
-
-```scala
-object FizzBuzz:
-  def generate(number: Int): String = number.toString
-```
-
-`1` と `2` のテストがともに通れば Green です。
-
-## 2.3 三角測量（Triangulation）
-
-Triangulation は、1 つの具体例だけで一般化せず、2 つ以上の点で法則を確定する手法です。
-
-実践手順は次の通りです。
-
-1. 具体的な新テストを 1 つ追加して失敗を作る
-2. 最小変更でテストを通す
-3. 既存テストも含めて一貫するルールか確認する
-
-この繰り返しにより、偶然通る実装ではなく、仕様に沿う実装へ近づけます。
-
-## 2.4 Fizz のテスト
-
-次に 3 の倍数ケースを追加します。
-
-```scala
-test("3 の倍数を渡すと Fizz を返す") {
-  assert(FizzBuzz.generate(3) === "Fizz")
-}
-```
-
-テストを通す最小実装の例です。
-
-```scala
-object FizzBuzz:
-  def generate(number: Int): String =
-    if number % 3 == 0 then "Fizz"
-    else number.toString
-```
-
-`if` でも `match` でも構いません。
-この時点では、可読性よりも小さなステップを優先します。
-
-## 2.5 Buzz のテスト
-
-続いて 5 の倍数ケースを追加します。
-
-```scala
-test("5 の倍数を渡すと Buzz を返す") {
-  assert(FizzBuzz.generate(5) === "Buzz")
-}
-```
-
-最小実装の例です。
-
-```scala
-object FizzBuzz:
-  def generate(number: Int): String =
-    if number % 3 == 0 then "Fizz"
-    else if number % 5 == 0 then "Buzz"
-    else number.toString
-```
-
-まだ 15 のケースは未対応なので、次章で仕上げます。
-
-## 2.6 TODO リストの更新
-
-ここまでの完了状態を反映します。
-
-- [x] `FizzBuzz.generate(1)` が `"1"` を返す
-- [x] `FizzBuzz.generate(2)` が `"2"` を返す
-- [x] `FizzBuzz.generate(3)` が `"Fizz"` を返す
-- [x] `FizzBuzz.generate(5)` が `"Buzz"` を返す
-- [ ] `FizzBuzz.generate(15)` が `"FizzBuzz"` を返す
-- [ ] `FizzBuzz.generateList(100)` が 100 件の結果を返す
-
-## 2.7 まとめ
-
-この章のポイントは次の 2 点です。
-
-- Fake It で、まず動く最小実装を作る
-- Triangulation で、複数のテストケースから実装を一般化する
-
-次章では、`15` と `generateList` を追加して実装を完成させます。
+# 第 2 章: 仮実装と三角測量
+
+## 2.1 はじめに
+
+第 1 章では、最小の 1 ケースを Green にしました。
+この章では、次の 2 つのテクニックで実装を育てます。
+
+- Fake It: まず動く最小のコードを書く
+- Triangulation: 複数ケースから一般ルールを導く
+
+## 2.2 仮実装（Fake It）
+
+まず `2` のケースを追加して、仮実装の限界を明確にします。
+
+```scala
+test("2 を渡すと文字列 2 を返す") {
+  assert(FizzBuzz.generate(2) === "2")
+}
+```
+
+このテストは失敗します。
+現在の実装は常に `"1"` を返すためです。
+
+ここで実装を一段だけ一般化します。
+
+```scala
+object FizzBuzz:
+  def generate(number: Int): String = number.toString
+```
+
+`1` と `2` のテストがともに通れば Green です。
+
+## 2.3 三角測量（Triangulation）
+
+Triangulation は、1 つの具体例だけで一般化せず、2 つ以上の点で法則を確定する手法です。
+
+実践手順は次の通りです。
+
+1. 具体的な新テストを 1 つ追加して失敗を作る
+2. 最小変更でテストを通す
+3. 既存テストも含めて一貫するルールか確認する
+
+この繰り返しにより、偶然通る実装ではなく、仕様に沿う実装へ近づけます。
+
+## 2.4 Fizz のテスト
+
+次に 3 の倍数ケースを追加します。
+
+```scala
+test("3 の倍数を渡すと Fizz を返す") {
+  assert(FizzBuzz.generate(3) === "Fizz")
+}
+```
+
+テストを通す最小実装の例です。
+
+```scala
+object FizzBuzz:
+  def generate(number: Int): String =
+    if number % 3 == 0 then "Fizz"
+    else number.toString
+```
+
+`if` でも `match` でも構いません。
+この時点では、可読性よりも小さなステップを優先します。
+
+## 2.5 Buzz のテスト
+
+続いて 5 の倍数ケースを追加します。
+
+```scala
+test("5 の倍数を渡すと Buzz を返す") {
+  assert(FizzBuzz.generate(5) === "Buzz")
+}
+```
+
+最小実装の例です。
+
+```scala
+object FizzBuzz:
+  def generate(number: Int): String =
+    if number % 3 == 0 then "Fizz"
+    else if number % 5 == 0 then "Buzz"
+    else number.toString
+```
+
+まだ 15 のケースは未対応なので、次章で仕上げます。
+
+## 2.6 TODO リストの更新
+
+ここまでの完了状態を反映します。
+
+- [x] `FizzBuzz.generate(1)` が `"1"` を返す
+- [x] `FizzBuzz.generate(2)` が `"2"` を返す
+- [x] `FizzBuzz.generate(3)` が `"Fizz"` を返す
+- [x] `FizzBuzz.generate(5)` が `"Buzz"` を返す
+- [ ] `FizzBuzz.generate(15)` が `"FizzBuzz"` を返す
+- [ ] `FizzBuzz.generateList(100)` が 100 件の結果を返す
+
+## 2.7 まとめ
+
+この章のポイントは次の 2 点です。
+
+- Fake It で、まず動く最小実装を作る
+- Triangulation で、複数のテストケースから実装を一般化する
+
+次章では、`15` と `generateList` を追加して実装を完成させます。