@k2works/claude-code-booster 2.7.1 → 3.1.0

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

@@ -0,0 +1,200 @@
+# 第 2 章: 仮実装と三角測量
+
+## 2.1 はじめに
+
+前章では、最初のテストを仮実装で通しました。この章では、2 つ目のテストケースを追加して **三角測量** を行い、プログラムを一般化します。さらに、3 の倍数・5 の倍数・15 の倍数のケースにも取り組みます。
+
+## 2.2 三角測量
+
+> 三角測量
+>
+> テストから最も慎重に一般化を引き出すやり方はどのようなものだろうか——2 つ以上の例があるときだけ、一般化を行うようにしよう。
+>
+> — テスト駆動開発
+
+### Red: 2 つ目のテスト
+
+2 を渡したら文字列 "2" を返すテストを追加します。
+
+```php
+public function test_2を渡したら文字列2を返す(): void
+{
+    $fizzbuzz = new FizzBuzz();
+    $this->assertSame('2', $fizzbuzz->generate(2));
+}
+```
+
+テストを実行すると失敗します。
+
+```bash
+$ vendor/bin/phpunit
+FizzBuzz
+ ✔ 1を渡したら文字列1を返す
+ ✘ 2を渡したら文字列2を返す
+   Failed asserting that two strings are identical.
+   Expected: '2'
+   Actual  : '1'
+```
+
+### Green: 一般化
+
+仮実装を一般化して、数値を文字列に変換するようにします。
+
+```php
+public function generate(int $number): string
+{
+    return (string) $number;
+}
+```
+
+PHP では `(string)` キャストで整数を文字列に変換できます。Go の `strconv.Itoa()` や Python の `str()` に相当します。
+
+```bash
+$ vendor/bin/phpunit
+FizzBuzz
+ ✔ 1を渡したら文字列1を返す
+ ✔ 2を渡したら文字列2を返す
+
+OK (2 tests, 2 assertions)
+```
+
+2 つのテストが通りました。三角測量により、仮実装が一般的な実装に変わりました。
+
+## 2.3 Fizz のテスト
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [ ] **3 の倍数のときは数の代わりに「Fizz」と返す**
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+### Red: 3 の倍数のテスト
+
+```php
+public function test_3を渡したら文字列Fizzを返す(): void
+{
+    $fizzbuzz = new FizzBuzz();
+    $this->assertSame('Fizz', $fizzbuzz->generate(3));
+}
+```
+
+テストを実行すると失敗します（期待値は "Fizz"、実際は "3"）。
+
+### Green: 仮実装
+
+まずは仮実装でテストを通します。
+
+```php
+public function generate(int $number): string
+{
+    if ($number === 3) {
+        return 'Fizz';
+    }
+    return (string) $number;
+}
+```
+
+```bash
+$ vendor/bin/phpunit
+OK (3 tests, 3 assertions)
+```
+
+## 2.4 Buzz のテスト
+
+### Red: 5 の倍数のテスト
+
+```php
+public function test_5を渡したら文字列Buzzを返す(): void
+{
+    $fizzbuzz = new FizzBuzz();
+    $this->assertSame('Buzz', $fizzbuzz->generate(5));
+}
+```
+
+### Green: 仮実装
+
+```php
+public function generate(int $number): string
+{
+    if ($number === 3) {
+        return 'Fizz';
+    }
+    if ($number === 5) {
+        return 'Buzz';
+    }
+    return (string) $number;
+}
+```
+
+```bash
+$ vendor/bin/phpunit
+OK (4 tests, 4 assertions)
+```
+
+## 2.5 FizzBuzz のテスト
+
+### Red: 15 の倍数のテスト
+
+```php
+public function test_15を渡したら文字列FizzBuzzを返す(): void
+{
+    $fizzbuzz = new FizzBuzz();
+    $this->assertSame('FizzBuzz', $fizzbuzz->generate(15));
+}
+```
+
+### Green: 仮実装
+
+15 の場合を最初にチェックする必要があります（3 の倍数かつ 5 の倍数のため）。
+
+```php
+public function generate(int $number): string
+{
+    if ($number === 15) {
+        return 'FizzBuzz';
+    }
+    if ($number === 3) {
+        return 'Fizz';
+    }
+    if ($number === 5) {
+        return 'Buzz';
+    }
+    return (string) $number;
+}
+```
+
+```bash
+$ vendor/bin/phpunit
+OK (5 tests, 5 assertions)
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す（仮実装: 3 のみ）
+- [ ] 5 の倍数のときは「Buzz」と返す（仮実装: 5 のみ）
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す（仮実装: 15 のみ）
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+ここまでの作業をコミットしておきましょう。
+
+```bash
+$ git add .
+$ git commit -m 'test: FizzBuzz の仮実装を完了'
+```
+
+## 2.6 まとめ
+
+この章では以下のことを学びました。
+
+- **三角測量** で 2 つ以上の例から実装を一般化する手法
+- **仮実装** で特定の値に対してのみ正しく動作するコードを書く手法
+- PHP の `(string)` キャストによる型変換
+- PHP の `===` による厳密な比較（型と値の両方を比較）
+- 条件分岐の順序が結果に影響すること（15 の倍数を先にチェック）
+
+次章では、仮実装を **明白な実装** にリファクタリングし、さらに配列を返す機能とプリント機能を追加します。

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

@@ -0,0 +1,248 @@
+# 第 3 章: 明白な実装とリファクタリング
+
+## 3.1 はじめに
+
+前章では、3・5・15 の各ケースを仮実装で通しました。この章では、仮実装を汎用的なロジックに **リファクタリング** し、「明白な実装」に変換します。さらに、1 から 100 までの配列を返す機能とプリント機能を追加して、FizzBuzz プログラムを完成させます。
+
+## 3.2 明白な実装
+
+> 明白な実装
+>
+> シンプルな操作をどうやって実装すればよいか——そのまま実装しよう。
+>
+> — テスト駆動開発
+
+### Red: 一般化のためのテスト
+
+6（3 の倍数だが 3 ではない）を渡すテストを追加して、仮実装の限界を明らかにします。
+
+```php
+public function test_6を渡したら文字列Fizzを返す(): void
+{
+    $fizzbuzz = new FizzBuzz();
+    $this->assertSame('Fizz', $fizzbuzz->generate(6));
+}
+```
+
+テストを実行すると失敗します（期待値は "Fizz"、実際は "6"）。
+
+### Refactor: 倍数チェックの一般化
+
+特定の数値へのハードコーディングを、倍数チェックのルールに変更します。
+
+```php
+public function generate(int $number): string
+{
+    if ($number % 15 === 0) {
+        return 'FizzBuzz';
+    }
+    if ($number % 3 === 0) {
+        return 'Fizz';
+    }
+    if ($number % 5 === 0) {
+        return 'Buzz';
+    }
+    return (string) $number;
+}
+```
+
+PHP の `%` 演算子（剰余演算子）は Go や Java と同じ挙動です。
+
+```bash
+$ vendor/bin/phpunit
+OK (6 tests, 6 assertions)
+```
+
+さらにテストを追加して確認します。
+
+```php
+public function test_10を渡したら文字列Buzzを返す(): void
+{
+    $fizzbuzz = new FizzBuzz();
+    $this->assertSame('Buzz', $fizzbuzz->generate(10));
+}
+
+public function test_30を渡したら文字列FizzBuzzを返す(): void
+{
+    $fizzbuzz = new FizzBuzz();
+    $this->assertSame('FizzBuzz', $fizzbuzz->generate(30));
+}
+```
+
+```bash
+$ vendor/bin/phpunit
+OK (8 tests, 8 assertions)
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 3.3 配列を返す機能
+
+### Red: generateList のテスト
+
+1 から 100 までの FizzBuzz 結果を配列で返す `generateList` メソッドのテストを書きます。
+
+```php
+public function test_1から100までのFizzBuzz配列を返す(): void
+{
+    $fizzbuzz = new FizzBuzz();
+    $result = $fizzbuzz->generateList();
+
+    $this->assertSame('1', $result[0]);
+    $this->assertSame('Fizz', $result[2]);
+    $this->assertSame('Buzz', $result[4]);
+    $this->assertSame('FizzBuzz', $result[14]);
+    $this->assertSame('100', $result[99]);
+    $this->assertCount(100, $result);
+}
+```
+
+### Green: generateList の実装
+
+```php
+/**
+ * @return string[]
+ */
+public function generateList(): array
+{
+    $result = [];
+    for ($i = 1; $i <= 100; $i++) {
+        $result[] = $this->generate($i);
+    }
+    return $result;
+}
+```
+
+PHP の `$result[]` は配列の末尾に要素を追加する構文です。Go の `append(results, ...)` に相当します。PHPDoc の `@return string[]` アノテーションで戻り値の型をドキュメント化しています。
+
+```bash
+$ vendor/bin/phpunit
+OK (9 tests, 7 assertions)
+```
+
+## 3.4 プリント機能
+
+### Red: printFizzBuzz のテスト
+
+```php
+public function test_FizzBuzzをプリントする(): void
+{
+    $fizzbuzz = new FizzBuzz();
+
+    ob_start();
+    $fizzbuzz->printFizzBuzz();
+    $output = ob_get_clean();
+
+    $lines = explode("\n", trim($output));
+    $this->assertSame('1', $lines[0]);
+    $this->assertSame('Fizz', $lines[2]);
+    $this->assertSame('Buzz', $lines[4]);
+    $this->assertSame('FizzBuzz', $lines[14]);
+    $this->assertCount(100, $lines);
+}
+```
+
+PHP の `ob_start()` / `ob_get_clean()` はアウトプットバッファリング機能で、標準出力をキャプチャできます。Go のテストで `bytes.Buffer` を使うパターンに相当します。
+
+### Green: printFizzBuzz の実装
+
+```php
+public function printFizzBuzz(): void
+{
+    $list = $this->generateList();
+    foreach ($list as $item) {
+        echo $item . "\n";
+    }
+}
+```
+
+```bash
+$ vendor/bin/phpunit
+OK (10 tests, 12 assertions)
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [x] 1 から 100 までの数
+- [x] プリントする
+
+すべての TODO が完了しました！
+
+```bash
+$ git add .
+$ git commit -m 'feat: FizzBuzz の基本実装を完了'
+```
+
+## 3.5 完成したコード
+
+<details>
+<summary>src/FizzBuzz.php</summary>
+
+```php
+<?php
+
+namespace App;
+
+class FizzBuzz
+{
+    public function generate(int $number): string
+    {
+        if ($number % 15 === 0) {
+            return 'FizzBuzz';
+        }
+        if ($number % 3 === 0) {
+            return 'Fizz';
+        }
+        if ($number % 5 === 0) {
+            return 'Buzz';
+        }
+        return (string) $number;
+    }
+
+    /**
+     * @return string[]
+     */
+    public function generateList(): array
+    {
+        $result = [];
+        for ($i = 1; $i <= 100; $i++) {
+            $result[] = $this->generate($i);
+        }
+        return $result;
+    }
+
+    public function printFizzBuzz(): void
+    {
+        $list = $this->generateList();
+        foreach ($list as $item) {
+            echo $item . "\n";
+        }
+    }
+}
+```
+
+</details>
+
+## 3.6 まとめ
+
+この章では以下のことを学びました。
+
+- **明白な実装** でシンプルな操作を直接実装する手法
+- **リファクタリング** で仮実装を汎用的なロジックに変換する方法
+- PHP の `%` 演算子による倍数チェック
+- PHP の配列操作（`$result[]` による要素追加）
+- PHP のアウトプットバッファリング（`ob_start()` / `ob_get_clean()`）による標準出力のテスト
+- PHPDoc の `@return string[]` アノテーション
+
+第 1 部では TDD の基本サイクル（Red → Green → Refactor）を体験しました。次の第 2 部では、開発環境の整備と自動化について学びます。

package/lib/assets/docs/article/getting-start-tdd/php/04-version-control-and-conventional-commits.md

@@ -0,0 +1,141 @@
+# 第 4 章: バージョン管理と Conventional Commits
+
+## 4.1 はじめに
+
+前章までで、TDD の基本サイクルを通じて FizzBuzz プログラムを完成させました。この章からは「動作するきれいなコード」を書き続けるために必要な **ソフトウェア開発の三種の神器** を整備していきます。
+
+> 今日のソフトウェア開発の世界において絶対になければならない 3 つの技術的な柱があります。三本柱と言ったり、三種の神器と言ったりしていますが、それらは
+>
+> - バージョン管理
+> - テスティング
+> - 自動化
+>
+> の 3 つです。
+>
+> — 和田卓人
+
+**バージョン管理** と **テスティング** に関しては第 1 部で触れました。本章ではバージョン管理をさらに深掘りし、**コミットメッセージの規約** について解説します。
+
+## 4.2 コミットメッセージの重要性
+
+これまでの作業では、区切りごとにリポジトリにコミットしてきました。しかし、コミットメッセージの書き方に一貫性がないと、後からプロジェクトの履歴を追うのが難しくなります。
+
+チーム開発では特に、誰がいつ何のためにコードを変更したのかを明確にすることが重要です。そこで役立つのが **Conventional Commits** です。
+
+## 4.3 Conventional Commits
+
+本プロジェクトでは [Angular ルール](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#type) に基づいた **Conventional Commits** の書式を採用します。
+
+### コミットメッセージのフォーマット
+
+```
+<タイプ>(<スコープ>): <タイトル>
+<空行>
+<ボディ>
+<空行>
+<フッタ>
+```
+
+- **ヘッダ** は必須です
+- **スコープ** は任意です
+- タイトルは **50 文字以内** にしてください（GitHub 上で読みやすくなります）
+
+### コミットのタイプ
+
+| タイプ | 説明 | 使用場面 |
+|--------|------|---------|
+| `feat` | A new feature（新しい機能） | 新機能の追加 |
+| `fix` | A bug fix（バグ修正） | バグの修正 |
+| `docs` | Documentation only changes（ドキュメント変更のみ） | README やコメントの更新 |
+| `style` | Changes that do not affect the meaning of the code（コードに影響を与えない変更） | フォーマット、セミコロンの追加など |
+| `refactor` | A code change that neither fixes a bug nor adds a feature（リファクタリング） | コード構造の改善 |
+| `perf` | A code change that improves performance（パフォーマンス改善） | 処理速度の向上 |
+| `test` | Adding missing or correcting existing tests（テストの追加・修正） | テストコードの変更 |
+| `chore` | Changes to the build process or auxiliary tools（ビルドプロセスや補助ツールの変更） | 設定ファイルの更新 |
+
+### コミットメッセージの例
+
+```bash
+# 新機能の追加
+$ git commit -m 'feat: FizzBuzz のリスト生成機能を追加'
+
+# バグ修正
+$ git commit -m 'fix: 15 の倍数の判定ロジックを修正'
+
+# リファクタリング
+$ git commit -m 'refactor: generate メソッドの条件分岐を整理'
+
+# テストの追加
+$ git commit -m 'test: FizzBuzz の境界値テストを追加'
+
+# ビルド設定の変更
+$ git commit -m 'chore: PHP_CodeSniffer の設定ファイルを追加'
+```
+
+## 4.4 TDD とコミットのタイミング
+
+TDD の Red-Green-Refactor サイクルにおいて、コミットする適切なタイミングは以下の通りです。
+
+```
+Red（テスト作成）→ Green（テスト成功）→ コミット → Refactor（リファクタリング）→ コミット
+```
+
+```plantuml
+@startuml
+title TDD サイクルとコミットポイント
+
+[*] --> Red
+Red : テストを書く（失敗）
+Red --> Green : 最小限の実装
+
+Green : テストが通る
+Green --> Commit1 : テスト成功
+
+Commit1 : git commit
+Commit1 --> Refactor
+
+Refactor : コード改善
+Refactor --> Commit2 : リファクタリング完了
+
+Commit2 : git commit
+Commit2 --> Red : 次のテスト
+Commit2 --> [*] : 完了
+
+@enduml
+```
+
+### コミット単位のベストプラクティス
+
+- **1 コミット = 1 論理的変更** — 複数の変更を 1 つのコミットに混ぜない
+- **ビルドが通る状態でコミット** — テストが失敗する状態ではコミットしない
+- **Red-Green-Refactor サイクル完了時にコミット** — TDD のサイクルに合わせる
+- **TODO リストの項目単位でコミット** — 作業の区切りを明確にする
+
+## 4.5 これまでのコミットを振り返る
+
+第 1 部で行ったコミットを Conventional Commits の観点で振り返ってみましょう。
+
+```bash
+# 第 1 章のコミット例
+$ git log --oneline
+abc1234 test: 最初の FizzBuzz テストを追加
+def5678 feat: FizzBuzz の generate メソッドを仮実装
+ghi9012 feat: Fizz 判定を追加
+jkl3456 feat: Buzz 判定を追加
+mno7890 feat: FizzBuzz 判定を追加
+pqr1234 refactor: generate メソッドを modulo 演算でリファクタリング
+stu5678 feat: generateList メソッドを追加
+vwx9012 feat: printFizzBuzz メソッドを追加
+```
+
+各コミットが 1 つの論理的変更に対応し、コミットメッセージから変更内容が明確に読み取れます。
+
+## 4.6 まとめ
+
+この章では以下を学びました。
+
+- **Conventional Commits** のフォーマットとタイプ
+- **TDD サイクルとコミットのタイミング** の関係
+- **コミット単位** のベストプラクティス
+
+次章では、Composer によるパッケージ管理と、静的解析ツール（PHP_CodeSniffer、PHPStan）の導入を行います。