@k2works/claude-code-booster 6.2.0 → 6.3.1

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

@@ -1,69 +0,0 @@
-# 多言語統合解説
-
-本章では、12 言語（Java, Python, TypeScript, Ruby, Go, PHP, Rust, C#, F#, Clojure, Scala, Elixir, Haskell）による FizzBuzz TDD 実装を横断的に比較し、言語の設計思想、テストフレームワーク、TDD パターン、型システム、開発環境を統合的に解説します。
-
-## 本章の目的
-
-各言語の個別解説では、その言語固有の文法や開発フローに焦点を当てました。本章では視点を上げて、以下の問いに答えます。
-
-- パラダイムの違いは TDD にどのような影響を与えるか
-- テストフレームワークの設計は言語の哲学をどう反映しているか
-- 型システムの強さはエラーハンドリングにどう影響するか
-- Nix による統一開発環境は多言語プロジェクトにどう貢献するか
-
-## 対象言語一覧
-
-| 言語 | テスト FW | ビルドツール | リンター | パラダイム |
-|------|----------|-------------|---------|-----------|
-| Java | JUnit 5 | Gradle | Checkstyle, PMD | OOP |
-| Python | pytest | pip/venv | Ruff | マルチ |
-| TypeScript | Vitest | npm | ESLint, Prettier | マルチ |
-| Ruby | Minitest | Bundler | RuboCop | OOP/FP |
-| Go | testing | go mod | golangci-lint | 構造化 |
-| PHP | PHPUnit | Composer | PHP_CodeSniffer, PHPStan, PHPMD | OOP |
-| Rust | cargo test | Cargo | Clippy, rustfmt | マルチ |
-| C# | xUnit | .NET SDK | dotnet format | OOP |
-| F# | xUnit | .NET SDK | FSharpLint | FP/OOP |
-| Clojure | clojure.test | Leiningen | Eastwood, Kibit | FP |
-| Scala | ScalaTest | sbt | scalafmt, WartRemover | OOP/FP |
-| Elixir | ExUnit | Mix | Credo | FP |
-| Haskell | HSpec | Stack | HLint | 純粋 FP |
-
-> **Note**: C# と F# は dotnet 環境として 1 つのイテレーションにまとめています。
-
-## 章構成
-
-| 章 | タイトル | 内容 |
-|----|---------|------|
-| 1 | [12 言語の概要と分類](01-language-overview.md) | パラダイム分類、型システム、ランタイム、FizzBuzz コア実装比較 |
-| 2 | [テストフレームワーク比較](02-test-framework-comparison.md) | テスト構造、アサーション、実行コマンドの比較 |
-| 3 | [パラダイム別 TDD パターン比較](03-tdd-pattern-comparison.md) | OOP/FP の TDD、ポリモーフィズム、コマンドパターン比較 |
-| 4 | [型システムとエラーハンドリング比較](04-type-system-comparison.md) | 静的/動的型付け、Option/Result パターン、型安全性 |
-| 5 | [開発環境と CI/CD 比較](05-dev-environment-comparison.md) | Nix 統一環境、ビルド/リンター比較、CI/CD パターン |
-| 6 | [学習ロードマップ](06-learning-roadmap.md) | 推奨学習順序、概念マップ、次のステップ |
-
-## 読み方のガイド
-
-本章は以下の 3 通りの読み方を想定しています。
-
-### 通読
-
-第 1 章から順に読み進めることで、12 言語の全体像を俯瞰できます。
-
-### リファレンス
-
-特定のトピック（テストフレームワーク、型システムなど）に興味がある場合は、該当する章を直接参照してください。
-
-### 言語選択の参考
-
-新しい言語を学ぶ際のガイドとして、第 6 章の学習ロードマップから始めることをお勧めします。
-
-## 前提知識
-
-- 少なくとも 1 つの言語の個別解説を読了済み（推奨: Java または Python）
-- TDD の基本サイクル（Red-Green-Refactor）の理解
-- FizzBuzz 問題の仕様を把握済み
-
-## 凡例
-
-本章のコード例は、各言語の `apps/` ディレクトリにある実装から抽出しています。すべての開発環境は Nix（`nix develop .#{lang}`）で統一されています。

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

@@ -1,243 +0,0 @@
----
-type: Article
-title: "第 1 章: TODO リストと最初のテスト"
-description: "プログラムを作成するにあたって、まず何をすればよいでしょうか？私たちは、仕様を確認して TODO リスト を作るところから始めます。"
-tags: [article, getting-start-tdd, java]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-24T05:22:28Z }
----
-
-# 第 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 テスティングフレームワークの導入
-
-### テストファースト
-
-最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
-
-> テストファースト
->
-> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
->
-> — テスト駆動開発
-
-今回 Java のテスティングフレームワークには [JUnit 5](https://junit.org/junit5/) を利用します。
-
-### 開発環境のセットアップ
-
-Gradle プロジェクトに JUnit 5 を追加して、テスト環境をセットアップします。
-
-```groovy
-// build.gradle
-plugins {
-    id 'java'
-    id 'jacoco'
-}
-
-java {
-    toolchain {
-        languageVersion = JavaLanguageVersion.of(21)
-    }
-}
-
-repositories {
-    mavenCentral()
-}
-
-dependencies {
-    testImplementation 'org.junit.jupiter:junit-jupiter:5.10.2'
-    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
-}
-
-test {
-    useJUnitPlatform()
-
-    testLogging {
-        events("passed", "skipped", "failed")
-    }
-}
-```
-
-### 環境確認テスト
-
-環境が正しく設定されていることを確認するため、簡単なテストを書きます。
-
-```java
-package tdd.fizzbuzz;
-
-import org.junit.jupiter.api.Test;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
-class HelloTest {
-    @Test
-    void test_greeting() {
-        assertEquals("hello world", greeting());
-    }
-
-    private String greeting() {
-        return "hello world";
-    }
-}
-```
-
-テストを実行します。
-
-```bash
-$ ./gradlew test
-```
-
-```
-HelloTest > test_greeting() PASSED
-
-BUILD SUCCESSFUL
-```
-
-テストが成功すれば、開発環境のセットアップは完了です。
-
-## 1.5 最初のテストを書く
-
-### アサートファースト
-
-TODO リストの最初の項目「1 を渡したら文字列 "1" を返す」に取り掛かります。
-
-> アサートファースト
->
-> いつアサーションを書くべきだろうか——最初に書こう。
->
-> — テスト駆動開発
-
-テストコードを日本語で記述します。開発体制にもよりますが、日本人が開発するのであればドキュメントとしての可読性が上がるため、テストコードであれば日本語のメソッド名も有効です。
-
-```java
-package tdd.fizzbuzz;
-
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
-class FizzBuzzTest {
-
-    private FizzBuzz fizzbuzz;
-
-    @BeforeEach
-    void setUp() {
-        fizzbuzz = new FizzBuzz();
-    }
-
-    @Test
-    void test_1を渡したら文字列1を返す() {
-        assertEquals("1", fizzbuzz.generate(1));
-    }
-}
-```
-
-### Red: テストを実行して失敗させる
-
-テストを実行します。
-
-```bash
-$ ./gradlew test
-```
-
-```
-FizzBuzzTest > test_1を渡したら文字列1を返す() FAILED
-    java.lang.NoClassDefFoundError: tdd/fizzbuzz/FizzBuzz
-```
-
-`FizzBuzz` クラスが定義されていないというエラーが出ました。まだ作っていないのですから当然です。
-
-### Green: 仮実装でテストを通す
-
-最初のテストを通すために **仮実装** から始めましょう。
-
-> 仮実装を経て本実装へ
->
-> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
->
-> — テスト駆動開発
-
-`FizzBuzz` クラスを定義して、文字列リテラルを返す `generate` メソッドを作成します。
-
-```java
-package tdd.fizzbuzz;
-
-public class FizzBuzz {
-
-    public String generate(int number) {
-        return "1";
-    }
-}
-```
-
-テストを実行します。
-
-```bash
-$ ./gradlew test
-```
-
-```
-FizzBuzzTest > test_1を渡したら文字列1を返す() PASSED
-
-BUILD SUCCESSFUL
-```
-
-テストが通りました！「え？こんなベタ書きのプログラムでいいの？」と思われるかもしれませんが、この細かいステップに今しばらくお付き合いください。
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-  - [x] 1 を渡したら文字列 "1" を返す
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-## 1.6 まとめ
-
-この章では、TDD の最も基本的なステップを体験しました。
-
-1. **TODO リストの作成** — 仕様を小さなタスクに分解する
-2. **テストファースト** — テスト対象のコードを書く前にテストを書く
-3. **アサートファースト** — テストの終わりにパスすべきアサーションを最初に書く
-4. **仮実装** — 失敗するテストを通すために、ベタ書きの値を返す
-
-次の章では、三角測量によってプログラムを一般化していきます。

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

@@ -1,270 +0,0 @@
----
-type: Article
-title: "第 2 章: 仮実装と三角測量"
-description: "前章では、FizzBuzz の仕様を TODO リストに分解し、最初のテストを仮実装で通しました。"
-tags: [article, getting-start-tdd, java]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-24T05:22:28Z }
----
-
-# 第 2 章: 仮実装と三角測量
-
-## 2.1 はじめに
-
-前章では、FizzBuzz の仕様を TODO リストに分解し、最初のテストを仮実装で通しました。この章では、**三角測量** によってプログラムを一般化し、さらに **明白な実装** で FizzBuzz のコアロジックを完成させます。
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-  - [x] 1 を渡したら文字列 "1" を返す
-  - [ ] 2 を渡したら文字列 "2" を返す
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-## 2.2 三角測量
-
-1 を渡したら文字列 "1" を返すようにできました。では、2 を渡したらどうなるでしょうか？
-
-### Red: 2 つ目のテストを書く
-
-```java
-@Test
-void test_2を渡したら文字列2を返す() {
-    assertEquals("2", fizzbuzz.generate(2));
-}
-```
-
-テストを実行します。
-
-```bash
-$ ./gradlew test
-```
-
-```
-FizzBuzzTest > test_2を渡したら文字列2を返す() FAILED
-    expected: <2> but was: <1>
-```
-
-テストが失敗しました。文字列 "1" しか返さないプログラムなのですから当然です。
-
-### Green: 一般化する
-
-数値を文字列に変換して返すように修正します。
-
-```java
-package tdd.fizzbuzz;
-
-public class FizzBuzz {
-
-    public String generate(int number) {
-        return String.valueOf(number);
-    }
-}
-```
-
-テストを実行します。
-
-```bash
-$ ./gradlew test
-```
-
-```
-FizzBuzzTest > test_1を渡したら文字列1を返す() PASSED
-FizzBuzzTest > test_2を渡したら文字列2を返す() PASSED
-```
-
-テストが通りました！2 つ目のテストによって `generate` メソッドの一般化を実現できました。このようなアプローチを **三角測量** と言います。
-
-> 三角測量
->
-> テストから最も慎重に一般化を引き出すやり方はどのようなものだろうか——2 つ以上の例があるときだけ、一般化を行うようにしよう。
->
-> — テスト駆動開発
-
-**TODO リスト**:
-
-- [x] 数を文字列にして返す
-  - [x] 1 を渡したら文字列 "1" を返す
-  - [x] 2 を渡したら文字列 "2" を返す
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-## 2.3 3 の倍数 — Fizz
-
-次は「3 の倍数のときは数の代わりに Fizz と返す」に取り掛かります。
-
-### Red: 3 の倍数のテスト
-
-```java
-@Test
-void test_3を渡したら文字列Fizzを返す() {
-    assertEquals("Fizz", fizzbuzz.generate(3));
-}
-```
-
-```
-FizzBuzzTest > test_3を渡したら文字列Fizzを返す() FAILED
-    expected: <Fizz> but was: <3>
-```
-
-### Green: 明白な実装
-
-3 の倍数の判定は明白なので、直接的に実装します。
-
-> 明白な実装
->
-> シンプルな操作を実現するにはどうすればよいだろうか——そのまま実装しよう。
->
-> — テスト駆動開発
-
-```java
-package tdd.fizzbuzz;
-
-public class FizzBuzz {
-
-    public String generate(int number) {
-        if (number % 3 == 0) {
-            return "Fizz";
-        }
-        return String.valueOf(number);
-    }
-}
-```
-
-```
-FizzBuzzTest > test_1を渡したら文字列1を返す() PASSED
-FizzBuzzTest > test_2を渡したら文字列2を返す() PASSED
-FizzBuzzTest > test_3を渡したら文字列Fizzを返す() PASSED
-```
-
-**TODO リスト**:
-
-- [x] 数を文字列にして返す
-- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-## 2.4 5 の倍数 — Buzz
-
-### Red
-
-```java
-@Test
-void test_5を渡したら文字列Buzzを返す() {
-    assertEquals("Buzz", fizzbuzz.generate(5));
-}
-```
-
-```
-FizzBuzzTest > test_5を渡したら文字列Buzzを返す() FAILED
-    expected: <Buzz> but was: <5>
-```
-
-### Green
-
-```java
-package tdd.fizzbuzz;
-
-public class FizzBuzz {
-
-    public String generate(int number) {
-        if (number % 3 == 0) {
-            return "Fizz";
-        } else if (number % 5 == 0) {
-            return "Buzz";
-        }
-        return String.valueOf(number);
-    }
-}
-```
-
-```
-FizzBuzzTest > test_1を渡したら文字列1を返す() PASSED
-FizzBuzzTest > test_2を渡したら文字列2を返す() PASSED
-FizzBuzzTest > test_3を渡したら文字列Fizzを返す() PASSED
-FizzBuzzTest > test_5を渡したら文字列Buzzを返す() PASSED
-```
-
-**TODO リスト**:
-
-- [x] 数を文字列にして返す
-- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [x] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-## 2.5 3 と 5 の倍数 — FizzBuzz
-
-### Red
-
-```java
-@Test
-void test_15を渡したら文字列FizzBuzzを返す() {
-    assertEquals("FizzBuzz", fizzbuzz.generate(15));
-}
-```
-
-```
-FizzBuzzTest > test_15を渡したら文字列FizzBuzzを返す() FAILED
-    expected: <FizzBuzz> but was: <Fizz>
-```
-
-現在の実装では 3 の倍数の条件が先に評価されるため、15 を渡すと "Fizz" が返ってきています。
-
-### Green
-
-3 と 5 の両方の倍数を先に判定するように修正します。
-
-```java
-package tdd.fizzbuzz;
-
-public class FizzBuzz {
-
-    public String generate(int number) {
-        if (number % 3 == 0 && number % 5 == 0) {
-            return "FizzBuzz";
-        } else if (number % 3 == 0) {
-            return "Fizz";
-        } else if (number % 5 == 0) {
-            return "Buzz";
-        }
-        return String.valueOf(number);
-    }
-}
-```
-
-```
-FizzBuzzTest > test_1を渡したら文字列1を返す() PASSED
-FizzBuzzTest > test_2を渡したら文字列2を返す() PASSED
-FizzBuzzTest > test_3を渡したら文字列Fizzを返す() PASSED
-FizzBuzzTest > test_5を渡したら文字列Buzzを返す() PASSED
-FizzBuzzTest > test_15を渡したら文字列FizzBuzzを返す() PASSED
-```
-
-**TODO リスト**:
-
-- [x] 数を文字列にして返す
-- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [x] 5 の倍数のときは「Buzz」と返す
-- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-## 2.6 まとめ
-
-この章では、以下の TDD テクニックを実践しました。
-
-1. **三角測量** — 2 つ以上のテストケースから一般化を導き出す
-2. **明白な実装** — ロジックが明確な場合は直接的に実装する
-3. **Red-Green サイクル** — テスト失敗（Red）→ 最小限の実装（Green）を繰り返す
-
-FizzBuzz のコアロジック（generate メソッド）が完成しました。次の章では、残りの TODO（リスト生成とプリント）を完成させ、リファクタリングを行います。