@k2works/claude-code-booster 3.4.1 → 3.6.0

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

@@ -1,84 +1,84 @@
-# テスト駆動開発から始める PHP 入門
-
-## 概要
-
-FizzBuzz 問題を題材に、テスト駆動開発（TDD）の基本サイクルから、開発環境の整備、オブジェクト指向設計、関数型プログラミングの活用まで、PHP の特徴を活かしながら段階的に学びます。
-
-## 対象読者
-
-- PHP の基本文法を理解しているプログラミング学習者
-- TDD を体験してみたい開発者
-- オブジェクト指向設計や関数型プログラミングに興味がある方
-
-## 前提条件
-
-- PHP 8.1 以降がインストールされていること
-- Composer が利用可能であること（Nix 環境推奨: `nix develop .#php`）
-
-## PHP の特徴
-
-| 特徴 | 説明 |
-|------|------|
-| 動的型付け + 型宣言 | 型宣言（PHP 7.0+）で段階的に型安全性を向上 |
-| オブジェクト指向 | クラス、インターフェース、トレイト、抽象クラスを完備 |
-| readonly プロパティ | PHP 8.1+ で不変なプロパティ宣言をサポート |
-| enum 型 | PHP 8.1+ でネイティブな列挙型をサポート |
-| match 式 | PHP 8.0+ で型安全な条件分岐を提供 |
-| アロー関数 | `fn =>` 構文で簡潔な無名関数を記述 |
-| コンストラクタプロモーション | PHP 8.0+ でコンストラクタ引数をプロパティに自動昇格 |
-
-## 開発ツール
-
-| ツール | 用途 |
-|--------|------|
-| [PHPUnit](https://phpunit.de/) | テスティングフレームワーク |
-| [Composer](https://getcomposer.org/) | パッケージ管理 |
-| [PHP_CodeSniffer](https://github.com/squizlabs/PHP_CodeSniffer) | コーディング規約チェック |
-| [PHPStan](https://phpstan.org/) | 静的解析 |
-| Composer scripts | タスクランナー |
-
-## 目次
-
-### 第 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/php/` に実装されています。
-
-```bash
-# 開発環境に入る
-nix develop .#php
-
-# テスト実行
-cd apps/php
-composer test
-```
-
-## 参考文献
-
-- Kent Beck 著『テスト駆動開発』
-- Martin Fowler 著『リファクタリング: 既存のコードを安全に改善する』
-- Robert C. Martin 著『Clean Code: アジャイルソフトウェア達人の技』
-- [PHP: The Right Way](https://phptherightway.com/)
+# テスト駆動開発から始める PHP 入門
+
+## 概要
+
+FizzBuzz 問題を題材に、テスト駆動開発（TDD）の基本サイクルから、開発環境の整備、オブジェクト指向設計、関数型プログラミングの活用まで、PHP の特徴を活かしながら段階的に学びます。
+
+## 対象読者
+
+- PHP の基本文法を理解しているプログラミング学習者
+- TDD を体験してみたい開発者
+- オブジェクト指向設計や関数型プログラミングに興味がある方
+
+## 前提条件
+
+- PHP 8.1 以降がインストールされていること
+- Composer が利用可能であること（Nix 環境推奨: `nix develop .#php`）
+
+## PHP の特徴
+
+| 特徴 | 説明 |
+|------|------|
+| 動的型付け + 型宣言 | 型宣言（PHP 7.0+）で段階的に型安全性を向上 |
+| オブジェクト指向 | クラス、インターフェース、トレイト、抽象クラスを完備 |
+| readonly プロパティ | PHP 8.1+ で不変なプロパティ宣言をサポート |
+| enum 型 | PHP 8.1+ でネイティブな列挙型をサポート |
+| match 式 | PHP 8.0+ で型安全な条件分岐を提供 |
+| アロー関数 | `fn =>` 構文で簡潔な無名関数を記述 |
+| コンストラクタプロモーション | PHP 8.0+ でコンストラクタ引数をプロパティに自動昇格 |
+
+## 開発ツール
+
+| ツール | 用途 |
+|--------|------|
+| [PHPUnit](https://phpunit.de/) | テスティングフレームワーク |
+| [Composer](https://getcomposer.org/) | パッケージ管理 |
+| [PHP_CodeSniffer](https://github.com/squizlabs/PHP_CodeSniffer) | コーディング規約チェック |
+| [PHPStan](https://phpstan.org/) | 静的解析 |
+| Composer scripts | タスクランナー |
+
+## 目次
+
+### 第 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/php/` に実装されています。
+
+```bash
+# 開発環境に入る
+nix develop .#php
+
+# テスト実行
+cd apps/php
+composer test
+```
+
+## 参考文献
+
+- Kent Beck 著『テスト駆動開発』
+- Martin Fowler 著『リファクタリング: 既存のコードを安全に改善する』
+- Robert C. Martin 著『Clean Code: アジャイルソフトウェア達人の技』
+- [PHP: The Right Way](https://phptherightway.com/)

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

@@ -1,201 +1,201 @@
-# 第 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 テスティングフレームワークの導入
-
-### テストファースト
-
-最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
-
-> テストファースト
->
-> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
->
-> — テスト駆動開発
-
-今回 Python のテスティングフレームワークには [pytest](https://docs.pytest.org/) を利用します。
-
-### 開発環境のセットアップ
-
-uv プロジェクトに pytest を追加して、テスト環境をセットアップします。
-
-```toml
-# pyproject.toml
-[project]
-name = "fizzbuzz"
-version = "0.1.0"
-description = "FizzBuzz TDD project for Python"
-requires-python = ">=3.11"
-
-[tool.pytest.ini_options]
-testpaths = ["test"]
-pythonpath = ["."]
-
-[dependency-groups]
-dev = [
-    "pytest>=8.0",
-]
-```
-
-### 環境確認テスト
-
-環境が正しく設定されていることを確認するため、簡単なテストを書きます。
-
-```python
-# test/test_hello.py
-
-def test_greeting():
-    assert greeting() == "hello world"
-
-
-def greeting():
-    return "hello world"
-```
-
-テストを実行します。
-
-```bash
-$ uv run pytest -v
-```
-
-```
-test/test_hello.py::test_greeting PASSED
-
-1 passed
-```
-
-テストが成功すれば、開発環境のセットアップは完了です。
-
-## 1.5 最初のテストを書く
-
-### アサートファースト
-
-TODO リストの最初の項目「1 を渡したら文字列 "1" を返す」に取り掛かります。
-
-> アサートファースト
->
-> いつアサーションを書くべきだろうか——最初に書こう。
->
-> — テスト駆動開発
-
-テストコードを日本語で記述します。pytest では関数名にそのまま日本語を使えるため、ドキュメントとしての可読性が上がります。
-
-```python
-# test/test_fizzbuzz.py
-from lib.fizzbuzz import FizzBuzz
-
-
-class TestFizzBuzz:
-    def setup_method(self):
-        self.fizzbuzz = FizzBuzz()
-
-    def test_1を渡したら文字列1を返す(self):
-        assert self.fizzbuzz.generate(1) == "1"
-```
-
-### Red: テストを実行して失敗させる
-
-テストを実行します。
-
-```bash
-$ uv run pytest -v
-```
-
-```
-test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す FAILED
-
-E       ModuleNotFoundError: No module named 'lib.fizzbuzz'
-```
-
-`FizzBuzz` クラスが定義されていないというエラーが出ました。まだ作っていないのですから当然です。
-
-### Green: 仮実装でテストを通す
-
-最初のテストを通すために **仮実装** から始めましょう。
-
-> 仮実装を経て本実装へ
->
-> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
->
-> — テスト駆動開発
-
-`FizzBuzz` クラスを定義して、文字列リテラルを返す `generate` メソッドを作成します。
-
-```python
-# lib/fizzbuzz.py
-class FizzBuzz:
-    def generate(self, number: int) -> str:
-        return "1"
-```
-
-テストを実行します。
-
-```bash
-$ uv run pytest -v
-```
-
-```
-test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す PASSED
-
-1 passed
-```
-
-テストが通りました！「え？こんなベタ書きのプログラムでいいの？」と思われるかもしれませんが、この細かいステップに今しばらくお付き合いください。
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-  - [x] 1 を渡したら文字列 "1" を返す
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-## 1.6 まとめ
-
-この章では、TDD の最も基本的なステップを体験しました。
-
-1. **TODO リストの作成** — 仕様を小さなタスクに分解する
-2. **テストファースト** — テスト対象のコードを書く前にテストを書く
-3. **アサートファースト** — テストの終わりにパスすべきアサーションを最初に書く
-4. **仮実装** — 失敗するテストを通すために、ベタ書きの値を返す
-
-次の章では、三角測量によってプログラムを一般化していきます。
+# 第 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 テスティングフレームワークの導入
+
+### テストファースト
+
+最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
+
+> テストファースト
+>
+> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
+>
+> — テスト駆動開発
+
+今回 Python のテスティングフレームワークには [pytest](https://docs.pytest.org/) を利用します。
+
+### 開発環境のセットアップ
+
+uv プロジェクトに pytest を追加して、テスト環境をセットアップします。
+
+```toml
+# pyproject.toml
+[project]
+name = "fizzbuzz"
+version = "0.1.0"
+description = "FizzBuzz TDD project for Python"
+requires-python = ">=3.11"
+
+[tool.pytest.ini_options]
+testpaths = ["test"]
+pythonpath = ["."]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+]
+```
+
+### 環境確認テスト
+
+環境が正しく設定されていることを確認するため、簡単なテストを書きます。
+
+```python
+# test/test_hello.py
+
+def test_greeting():
+    assert greeting() == "hello world"
+
+
+def greeting():
+    return "hello world"
+```
+
+テストを実行します。
+
+```bash
+$ uv run pytest -v
+```
+
+```
+test/test_hello.py::test_greeting PASSED
+
+1 passed
+```
+
+テストが成功すれば、開発環境のセットアップは完了です。
+
+## 1.5 最初のテストを書く
+
+### アサートファースト
+
+TODO リストの最初の項目「1 を渡したら文字列 "1" を返す」に取り掛かります。
+
+> アサートファースト
+>
+> いつアサーションを書くべきだろうか——最初に書こう。
+>
+> — テスト駆動開発
+
+テストコードを日本語で記述します。pytest では関数名にそのまま日本語を使えるため、ドキュメントとしての可読性が上がります。
+
+```python
+# test/test_fizzbuzz.py
+from lib.fizzbuzz import FizzBuzz
+
+
+class TestFizzBuzz:
+    def setup_method(self):
+        self.fizzbuzz = FizzBuzz()
+
+    def test_1を渡したら文字列1を返す(self):
+        assert self.fizzbuzz.generate(1) == "1"
+```
+
+### Red: テストを実行して失敗させる
+
+テストを実行します。
+
+```bash
+$ uv run pytest -v
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す FAILED
+
+E       ModuleNotFoundError: No module named 'lib.fizzbuzz'
+```
+
+`FizzBuzz` クラスが定義されていないというエラーが出ました。まだ作っていないのですから当然です。
+
+### Green: 仮実装でテストを通す
+
+最初のテストを通すために **仮実装** から始めましょう。
+
+> 仮実装を経て本実装へ
+>
+> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
+>
+> — テスト駆動開発
+
+`FizzBuzz` クラスを定義して、文字列リテラルを返す `generate` メソッドを作成します。
+
+```python
+# lib/fizzbuzz.py
+class FizzBuzz:
+    def generate(self, number: int) -> str:
+        return "1"
+```
+
+テストを実行します。
+
+```bash
+$ uv run pytest -v
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す PASSED
+
+1 passed
+```
+
+テストが通りました！「え？こんなベタ書きのプログラムでいいの？」と思われるかもしれませんが、この細かいステップに今しばらくお付き合いください。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 1.6 まとめ
+
+この章では、TDD の最も基本的なステップを体験しました。
+
+1. **TODO リストの作成** — 仕様を小さなタスクに分解する
+2. **テストファースト** — テスト対象のコードを書く前にテストを書く
+3. **アサートファースト** — テストの終わりにパスすべきアサーションを最初に書く
+4. **仮実装** — 失敗するテストを通すために、ベタ書きの値を返す
+
+次の章では、三角測量によってプログラムを一般化していきます。