@k2works/claude-code-booster 6.1.0 → 6.3.0

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

@@ -1,257 +0,0 @@
----
-type: Article
-title: "第 3 章: 明白な実装とリファクタリング"
-description: "前章では、3・5・15 の各ケースを仮実装で通しました。"
-tags: [article, getting-start-tdd, php]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-24T05:22:28Z }
----
-
-# 第 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

@@ -1,150 +0,0 @@
----
-type: Article
-title: "第 4 章: バージョン管理と Conventional Commits"
-description: "前章までで、TDD の基本サイクルを通じて FizzBuzz プログラムを完成させました。"
-tags: [article, getting-start-tdd, php]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-24T05:22:28Z }
----
-
-# 第 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）の導入を行います。