@k2works/claude-code-booster 4.9.0 → 4.11.0

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

@@ -1,87 +1,87 @@
-# 第 1 章: TODO リストと最初のテスト
-
-## 1.1 はじめに
-
-この章では、FizzBuzz 問題を小さな TODO リストに分解し、ExUnit で最初のテストを書きます。TDD の最初の一歩は、いきなり実装することではなく、失敗するテストから始めることです。
-
-## 1.2 FizzBuzz の仕様と TODO リスト
-
-対象の仕様は次のとおりです。
-
-```text
-1 から 100 までの数を出力する。
-3 の倍数は Fizz、5 の倍数は Buzz、3 と 5 の両方の倍数は FizzBuzz を出力する。
-```
-
-まずは仕様を TODO リストに分解します。
-
-- [ ] 数を文字列として返す
-- [ ] 3 の倍数で Fizz を返す
-- [ ] 5 の倍数で Buzz を返す
-- [ ] 15 の倍数で FizzBuzz を返す
-- [ ] 1 から 100 までの結果をリストで作る
-
-最初のタスクとして「1 を渡すと文字列 1 を返す」だけを扱います。
-
-## 1.3 ExUnit の基本
-
-Elixir では `mix new` で作成したプロジェクトに ExUnit が標準で含まれます。最小のテストは `test` マクロと `assert` マクロで書けます。
-
-```elixir
-# test/fizz_buzz_test.exs
-
-defmodule FizzBuzzTest do
-  use ExUnit.Case
-
-  test "1 を渡すと文字列 1 を返す" do
-    assert FizzBuzz.generate(1) == "1"
-  end
-end
-```
-
-- `test` はテストケースを定義します。
-- `assert` は期待値を検証します。
-
-## 1.4 mix test の使い方
-
-テスト実行は `mix test` を使います。
-
-```bash
-$ mix test
-```
-
-この時点では `FizzBuzz` モジュールが未実装なので、テストは失敗します。これが Red です。
-
-## 1.5 Red から Green へ
-
-### Red: 最初の失敗するテスト
-
-先ほどのテストを実行すると、例えば次のように失敗します。
-
-```text
-** (UndefinedFunctionError) function FizzBuzz.generate/1 is undefined
-```
-
-### Green: 仮実装で通す
-
-まずは最小限の仮実装でテストを通します。
-
-```elixir
-# lib/fizz_buzz.ex
-
-defmodule FizzBuzz do
-  def generate(1), do: "1"
-end
-```
-
-再度 `mix test` を実行します。
-
-```bash
-$ mix test
-```
-
-1 件のテストが成功すれば Green です。まだ汎用的ではありませんが、TDD ではこの小さな成功を積み重ねます。
-
-## 1.6 まとめ
-
-この章では、TODO リスト駆動で最小タスクを切り出し、ExUnit の `test` / `assert` と `mix test` の基本を確認しました。さらに、最初の失敗するテストを書いてから仮実装で成功させる Red → Green を体験しました。
+# 第 1 章: TODO リストと最初のテスト
+
+## 1.1 はじめに
+
+この章では、FizzBuzz 問題を小さな TODO リストに分解し、ExUnit で最初のテストを書きます。TDD の最初の一歩は、いきなり実装することではなく、失敗するテストから始めることです。
+
+## 1.2 FizzBuzz の仕様と TODO リスト
+
+対象の仕様は次のとおりです。
+
+```text
+1 から 100 までの数を出力する。
+3 の倍数は Fizz、5 の倍数は Buzz、3 と 5 の両方の倍数は FizzBuzz を出力する。
+```
+
+まずは仕様を TODO リストに分解します。
+
+- [ ] 数を文字列として返す
+- [ ] 3 の倍数で Fizz を返す
+- [ ] 5 の倍数で Buzz を返す
+- [ ] 15 の倍数で FizzBuzz を返す
+- [ ] 1 から 100 までの結果をリストで作る
+
+最初のタスクとして「1 を渡すと文字列 1 を返す」だけを扱います。
+
+## 1.3 ExUnit の基本
+
+Elixir では `mix new` で作成したプロジェクトに ExUnit が標準で含まれます。最小のテストは `test` マクロと `assert` マクロで書けます。
+
+```elixir
+# test/fizz_buzz_test.exs
+
+defmodule FizzBuzzTest do
+  use ExUnit.Case
+
+  test "1 を渡すと文字列 1 を返す" do
+    assert FizzBuzz.generate(1) == "1"
+  end
+end
+```
+
+- `test` はテストケースを定義します。
+- `assert` は期待値を検証します。
+
+## 1.4 mix test の使い方
+
+テスト実行は `mix test` を使います。
+
+```bash
+$ mix test
+```
+
+この時点では `FizzBuzz` モジュールが未実装なので、テストは失敗します。これが Red です。
+
+## 1.5 Red から Green へ
+
+### Red: 最初の失敗するテスト
+
+先ほどのテストを実行すると、例えば次のように失敗します。
+
+```text
+** (UndefinedFunctionError) function FizzBuzz.generate/1 is undefined
+```
+
+### Green: 仮実装で通す
+
+まずは最小限の仮実装でテストを通します。
+
+```elixir
+# lib/fizz_buzz.ex
+
+defmodule FizzBuzz do
+  def generate(1), do: "1"
+end
+```
+
+再度 `mix test` を実行します。
+
+```bash
+$ mix test
+```
+
+1 件のテストが成功すれば Green です。まだ汎用的ではありませんが、TDD ではこの小さな成功を積み重ねます。
+
+## 1.6 まとめ
+
+この章では、TODO リスト駆動で最小タスクを切り出し、ExUnit の `test` / `assert` と `mix test` の基本を確認しました。さらに、最初の失敗するテストを書いてから仮実装で成功させる Red → Green を体験しました。

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

@@ -1,95 +1,95 @@
-# 第 2 章: 仮実装と三角測量
-
-## 2.1 はじめに
-
-前章では「1 を渡すと文字列 1 を返す」を仮実装で通しました。この章では、仮実装から三角測量へ進み、実装を一般化します。
-
-## 2.2 仮実装の限界
-
-前章の実装は次のようなハードコードでした。
-
-```elixir
-defmodule FizzBuzz do
-  def generate(1), do: "1"
-end
-```
-
-この実装は `1` 以外に対応できません。ここで新しいテストを追加して、一般化の必要性を明確にします。
-
-## 2.3 三角測量: 2 を追加する
-
-ExUnit の `describe` ブロックで関心ごとをまとめます。
-
-```elixir
-# test/fizz_buzz_test.exs
-
-defmodule FizzBuzzTest do
-  use ExUnit.Case
-
-  describe "generate/1" do
-    test "1 を渡すと文字列 1 を返す" do
-      assert FizzBuzz.generate(1) == "1"
-    end
-
-    test "2 を渡すと文字列 2 を返す" do
-      assert FizzBuzz.generate(2) == "2"
-    end
-  end
-end
-```
-
-`mix test` を実行すると失敗します。Green にするため、仮実装から一段進めます。
-
-```elixir
-# lib/fizz_buzz.ex
-
-defmodule FizzBuzz do
-  def generate(n), do: Integer.to_string(n)
-end
-```
-
-この変更で、`1` と `2` の両方が通ります。複数の具体例から実装を引き出すのが三角測量です。
-
-## 2.4 3 の倍数で Fizz
-
-次に、FizzBuzz の本題を追加します。
-
-```elixir
-# test/fizz_buzz_test.exs
-
-defmodule FizzBuzzTest do
-  use ExUnit.Case
-
-  describe "generate/1" do
-    test "1 を渡すと文字列 1 を返す" do
-      assert FizzBuzz.generate(1) == "1"
-    end
-
-    test "2 を渡すと文字列 2 を返す" do
-      assert FizzBuzz.generate(2) == "2"
-    end
-
-    test "3 の倍数を渡すと Fizz を返す" do
-      assert FizzBuzz.generate(3) == "Fizz"
-      assert FizzBuzz.generate(6) == "Fizz"
-    end
-  end
-end
-```
-
-これを通す最小実装は次のように書けます。
-
-```elixir
-# lib/fizz_buzz.ex
-
-defmodule FizzBuzz do
-  def generate(n) when rem(n, 3) == 0, do: "Fizz"
-  def generate(n), do: Integer.to_string(n)
-end
-```
-
-`mix test` が成功すれば Green です。
-
-## 2.5 まとめ
-
-この章では、ハードコードの仮実装から、複数ケースによる三角測量で一般化する流れを学びました。また、`describe` でテストを整理し、「2 を渡すと文字列 2」「3 の倍数で Fizz」を ExUnit で表現しました。
+# 第 2 章: 仮実装と三角測量
+
+## 2.1 はじめに
+
+前章では「1 を渡すと文字列 1 を返す」を仮実装で通しました。この章では、仮実装から三角測量へ進み、実装を一般化します。
+
+## 2.2 仮実装の限界
+
+前章の実装は次のようなハードコードでした。
+
+```elixir
+defmodule FizzBuzz do
+  def generate(1), do: "1"
+end
+```
+
+この実装は `1` 以外に対応できません。ここで新しいテストを追加して、一般化の必要性を明確にします。
+
+## 2.3 三角測量: 2 を追加する
+
+ExUnit の `describe` ブロックで関心ごとをまとめます。
+
+```elixir
+# test/fizz_buzz_test.exs
+
+defmodule FizzBuzzTest do
+  use ExUnit.Case
+
+  describe "generate/1" do
+    test "1 を渡すと文字列 1 を返す" do
+      assert FizzBuzz.generate(1) == "1"
+    end
+
+    test "2 を渡すと文字列 2 を返す" do
+      assert FizzBuzz.generate(2) == "2"
+    end
+  end
+end
+```
+
+`mix test` を実行すると失敗します。Green にするため、仮実装から一段進めます。
+
+```elixir
+# lib/fizz_buzz.ex
+
+defmodule FizzBuzz do
+  def generate(n), do: Integer.to_string(n)
+end
+```
+
+この変更で、`1` と `2` の両方が通ります。複数の具体例から実装を引き出すのが三角測量です。
+
+## 2.4 3 の倍数で Fizz
+
+次に、FizzBuzz の本題を追加します。
+
+```elixir
+# test/fizz_buzz_test.exs
+
+defmodule FizzBuzzTest do
+  use ExUnit.Case
+
+  describe "generate/1" do
+    test "1 を渡すと文字列 1 を返す" do
+      assert FizzBuzz.generate(1) == "1"
+    end
+
+    test "2 を渡すと文字列 2 を返す" do
+      assert FizzBuzz.generate(2) == "2"
+    end
+
+    test "3 の倍数を渡すと Fizz を返す" do
+      assert FizzBuzz.generate(3) == "Fizz"
+      assert FizzBuzz.generate(6) == "Fizz"
+    end
+  end
+end
+```
+
+これを通す最小実装は次のように書けます。
+
+```elixir
+# lib/fizz_buzz.ex
+
+defmodule FizzBuzz do
+  def generate(n) when rem(n, 3) == 0, do: "Fizz"
+  def generate(n), do: Integer.to_string(n)
+end
+```
+
+`mix test` が成功すれば Green です。
+
+## 2.5 まとめ
+
+この章では、ハードコードの仮実装から、複数ケースによる三角測量で一般化する流れを学びました。また、`describe` でテストを整理し、「2 を渡すと文字列 2」「3 の倍数で Fizz」を ExUnit で表現しました。

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

@@ -1,109 +1,109 @@
-# 第 3 章: 明白な実装とリファクタリング
-
-## 3.1 はじめに
-
-この章では FizzBuzz の仕様を `cond` で明白に実装し、1 から 100 までのリスト生成まで完成させます。最後に、読みやすさを高めるリファクタリングの観点を確認します。
-
-## 3.2 cond による明白な実装
-
-まずは必要なテストを追加します。
-
-```elixir
-# test/fizz_buzz_test.exs
-
-defmodule FizzBuzzTest do
-  use ExUnit.Case
-
-  describe "generate/1" do
-    test "5 の倍数を渡すと Buzz を返す" do
-      assert FizzBuzz.generate(5) == "Buzz"
-    end
-
-    test "15 の倍数を渡すと FizzBuzz を返す" do
-      assert FizzBuzz.generate(15) == "FizzBuzz"
-    end
-  end
-end
-```
-
-このテストを通す明白な実装は次のとおりです。
-
-```elixir
-# lib/fizz_buzz.ex
-
-defmodule FizzBuzz do
-  def generate(n) do
-    cond do
-      rem(n, 15) == 0 -> "FizzBuzz"
-      rem(n, 3) == 0 -> "Fizz"
-      rem(n, 5) == 0 -> "Buzz"
-      true -> Integer.to_string(n)
-    end
-  end
-end
-```
-
-15 を先に判定することがポイントです。
-
-## 3.3 1 から 100 までのリスト生成
-
-続いて、結果一覧を作る関数のテストを書きます。
-
-```elixir
-# test/fizz_buzz_test.exs
-
-defmodule FizzBuzzTest do
-  use ExUnit.Case
-
-  describe "generate_list/0" do
-    test "1 から 100 までの FizzBuzz リストを返す" do
-      result = FizzBuzz.generate_list()
-
-      assert length(result) == 100
-      assert Enum.at(result, 0) == "1"
-      assert Enum.at(result, 2) == "Fizz"
-      assert Enum.at(result, 4) == "Buzz"
-      assert Enum.at(result, 14) == "FizzBuzz"
-    end
-  end
-end
-```
-
-実装はパイプライン演算子 `|>` を使うと読みやすくなります。
-
-```elixir
-# lib/fizz_buzz.ex
-
-defmodule FizzBuzz do
-  def generate(n) do
-    cond do
-      rem(n, 15) == 0 -> "FizzBuzz"
-      rem(n, 3) == 0 -> "Fizz"
-      rem(n, 5) == 0 -> "Buzz"
-      true -> Integer.to_string(n)
-    end
-  end
-
-  def generate_list do
-    1..100
-    |> Enum.map(&generate/1)
-  end
-end
-```
-
-`|>` は「左の結果を右の関数に渡す」演算子です。データの流れを上から下に読めるため、処理の意図が明確になります。
-
-## 3.4 リファクタリングのポイント
-
-テストがすべて通る状態を保ちながら、次を確認します。
-
-- 判定順が明確か（`15` → `3` → `5`）
-- 重複した変換処理がないか
-- 関数名が役割を正しく表しているか
-- テストの責務が分離されているか（`describe` ごとに関心を分ける）
-
-必要なら、テストデータを増やして安全に整理します。TDD では「動くこと」と「読みやすいこと」を両立させます。
-
-## 3.5 まとめ
-
-この章では、`cond` を使った明白な実装で `Buzz` と `FizzBuzz` を追加し、`1..100` のリスト生成を完成させました。さらに `|>` の基本と、テストを守りながら進めるリファクタリングの観点を確認しました。
+# 第 3 章: 明白な実装とリファクタリング
+
+## 3.1 はじめに
+
+この章では FizzBuzz の仕様を `cond` で明白に実装し、1 から 100 までのリスト生成まで完成させます。最後に、読みやすさを高めるリファクタリングの観点を確認します。
+
+## 3.2 cond による明白な実装
+
+まずは必要なテストを追加します。
+
+```elixir
+# test/fizz_buzz_test.exs
+
+defmodule FizzBuzzTest do
+  use ExUnit.Case
+
+  describe "generate/1" do
+    test "5 の倍数を渡すと Buzz を返す" do
+      assert FizzBuzz.generate(5) == "Buzz"
+    end
+
+    test "15 の倍数を渡すと FizzBuzz を返す" do
+      assert FizzBuzz.generate(15) == "FizzBuzz"
+    end
+  end
+end
+```
+
+このテストを通す明白な実装は次のとおりです。
+
+```elixir
+# lib/fizz_buzz.ex
+
+defmodule FizzBuzz do
+  def generate(n) do
+    cond do
+      rem(n, 15) == 0 -> "FizzBuzz"
+      rem(n, 3) == 0 -> "Fizz"
+      rem(n, 5) == 0 -> "Buzz"
+      true -> Integer.to_string(n)
+    end
+  end
+end
+```
+
+15 を先に判定することがポイントです。
+
+## 3.3 1 から 100 までのリスト生成
+
+続いて、結果一覧を作る関数のテストを書きます。
+
+```elixir
+# test/fizz_buzz_test.exs
+
+defmodule FizzBuzzTest do
+  use ExUnit.Case
+
+  describe "generate_list/0" do
+    test "1 から 100 までの FizzBuzz リストを返す" do
+      result = FizzBuzz.generate_list()
+
+      assert length(result) == 100
+      assert Enum.at(result, 0) == "1"
+      assert Enum.at(result, 2) == "Fizz"
+      assert Enum.at(result, 4) == "Buzz"
+      assert Enum.at(result, 14) == "FizzBuzz"
+    end
+  end
+end
+```
+
+実装はパイプライン演算子 `|>` を使うと読みやすくなります。
+
+```elixir
+# lib/fizz_buzz.ex
+
+defmodule FizzBuzz do
+  def generate(n) do
+    cond do
+      rem(n, 15) == 0 -> "FizzBuzz"
+      rem(n, 3) == 0 -> "Fizz"
+      rem(n, 5) == 0 -> "Buzz"
+      true -> Integer.to_string(n)
+    end
+  end
+
+  def generate_list do
+    1..100
+    |> Enum.map(&generate/1)
+  end
+end
+```
+
+`|>` は「左の結果を右の関数に渡す」演算子です。データの流れを上から下に読めるため、処理の意図が明確になります。
+
+## 3.4 リファクタリングのポイント
+
+テストがすべて通る状態を保ちながら、次を確認します。
+
+- 判定順が明確か（`15` → `3` → `5`）
+- 重複した変換処理がないか
+- 関数名が役割を正しく表しているか
+- テストの責務が分離されているか（`describe` ごとに関心を分ける）
+
+必要なら、テストデータを増やして安全に整理します。TDD では「動くこと」と「読みやすいこと」を両立させます。
+
+## 3.5 まとめ
+
+この章では、`cond` を使った明白な実装で `Buzz` と `FizzBuzz` を追加し、`1..100` のリスト生成を完成させました。さらに `|>` の基本と、テストを守りながら進めるリファクタリングの観点を確認しました。