@k2works/claude-code-booster 4.0.0 → 4.1.1

package/lib/assets/.claude/README.md

@@ -99,6 +99,12 @@ Claude Code をより効率的に使うための基本設定テンプレート
 | `creating-release-report` | リリース完了報告書を作成。release_plan・iteration_report・git log・CHANGELOG からデータ収集。 |
 | `creating-iteration-report` | イテレーション完了報告書を作成。iteration_plan・release_plan・テスト結果からデータ収集。 |
 
+#### 学習系
+
+| スキル | 説明 |
+| :--- | :--- |
+| `practicing-getting-start-tdd` | TDD プログラミング入門の対話式チュートリアル。FizzBuzz を題材に 14 言語で TDD を体験。 |
+
 #### 共通
 
 | スキル | 説明 |
@@ -210,7 +216,8 @@ Claude Code をより効率的に使うための基本設定テンプレート
 │   ├── orchestrating-development/SKILL.md
 │   ├── orchestrating-operation/SKILL.md
 │   ├── orchestrating-project/SKILL.md
-│   └── validating-iteration-plan/SKILL.md
+│   ├── validating-iteration-plan/SKILL.md
+│   └── practicing-getting-start-tdd/SKILL.md
 ├── README.md
 ├── settings.json                       # Claude Code 設定
 └── settings.local.json                 # ローカル環境用設定

package/lib/assets/.claude/skills/practicing-getting-start-tdd/SKILL.md

@@ -0,0 +1,195 @@
+---
+name: practicing-getting-start-tdd
+description: "テスト駆動開発から始めるプログラミング入門」の対話式チュートリアル。FizzBuzz を題材に TDD の Red-Green-Refactor サイクルを 14 言語で体験する。「TDD を練習したい」「FizzBuzz で TDD を学びたい」「テスト駆動開発の入門をしたい」「Java で TDD を体験したい」「Python で TDD を始めたい」「プログラミング入門チュートリアルをやりたい」「getting-start-tdd をやりたい」「TDD のハンズオンがしたい」「Red-Green-Refactor を体験したい」といった場面で発動する。TDD チュートリアルやプログラミング入門の要望があれば積極的に使用すること。"
+---
+
+# TDD プログラミング入門 - 対話式チュートリアル
+
+FizzBuzz 問題を題材に、TDD（テスト駆動開発）の手法を実践的に学ぶ対話式チュートリアル。ユーザーが自分の手でコードを書き、テストを通す体験を通じて TDD のサイクルと各言語の特徴を身につける。
+
+## 教材
+
+`docs/article/getting-start-tdd/` に 14 言語 x 12 章の完全な教材がある。チュートリアル進行時は該当する言語・章の教材を参照し、内容に沿って進行する。
+
+## チュートリアルの進め方
+
+### Step 0: 開発環境の準備
+
+チュートリアルを始める前に、開発環境を準備する。環境構築は**ユーザーにインストラクションを提示し、合意を得てから**進める。勝手にコマンドを実行しない。
+
+#### 推奨環境: GitHub Codespaces
+
+最もスムーズに始められる環境。devcontainer に Nix が設定済みで、言語ごとの開発環境が即座に利用可能。
+
+```bash
+# Codespace 起動後、選択した言語の開発環境に入る
+nix develop .#java    # Java の場合
+nix develop .#python  # Python の場合
+nix develop .#node    # JavaScript/TypeScript の場合
+# ... 各言語に対応した flake が用意されている
+```
+
+#### ローカル環境
+
+ローカルで進める場合は、OS に応じたパッケージマネージャで各言語の開発環境を構築する。
+
+| OS | パッケージマネージャ | 環境構築方法 |
+|----|--------------------|-------------|
+| Windows | [Scoop](https://scoop.sh/) | Scoop で各言語のランタイム・ビルドツールを直接インストール（Nix は非対応） |
+| macOS | [Homebrew](https://brew.sh/) + [Nix](https://nixos.org/download) | Nix で `nix develop .#{lang}` または Homebrew で個別インストール |
+| Linux | [Nix](https://nixos.org/download) | `nix develop .#{lang}` で開発環境に入る |
+
+##### Windows（Scoop）での環境構築例
+
+Windows では Nix が使えないため、Scoop で各言語のツールを個別にインストールする。
+
+```powershell
+# Scoop のインストール（未導入の場合）
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
+
+# Java の場合
+scoop bucket add java
+scoop install openjdk gradle
+
+# Python の場合
+scoop install python
+pip install pytest
+
+# Node.js（JavaScript/TypeScript）の場合
+scoop install nodejs
+npm install
+
+# Go の場合
+scoop install go
+
+# Rust の場合
+scoop install rustup
+rustup default stable
+
+# Ruby の場合
+scoop install ruby
+
+# PHP の場合
+scoop install php composer
+```
+
+各言語の詳細なセットアップ手順は、教材の各章（特に第 1 章・第 5 章）に記載されている。
+
+#### 環境構築の進め方
+
+1. ユーザーの現在の環境（OS、既存ツール）を確認する
+2. 推奨環境（GitHub Codespaces）を提案する
+3. ローカル環境を希望する場合は、OS に応じたインストール手順を**提示して確認を求める**
+4. ユーザーの合意を得てから、ステップごとにコマンドを実行する
+5. 環境が正しく構築できたことを確認してからチュートリアルに進む
+
+### Step 1: 言語選択
+
+ユーザーに学びたい言語を尋ねる。対応言語と特徴を簡潔に提示する。
+
+| 言語 | 特徴 |
+|------|------|
+| Java | 静的型付け、OOP、JUnit 5 |
+| JavaScript/TypeScript | 動的/静的型付け、Vitest |
+| Python | 動的型付け、pytest |
+| Ruby | 動的型付け、Minitest |
+| PHP | 動的型付け、PHPUnit |
+| Go | 静的型付け、標準 testing |
+| Rust | 所有権、標準テスト |
+| C# | 静的型付け、xUnit |
+| F# | 関数型、Expecto |
+| Clojure | LISP、clojure.test |
+| Scala | OOP+FP、ScalaTest |
+| Elixir | 関数型、ExUnit |
+| Haskell | 純粋関数型、Hspec |
+
+### Step 2: 章の選択
+
+全 12 章 4 部構成。ユーザーの経験レベルに応じて開始章を提案する。
+
+**第 1 部: TDD の基本サイクル**（初心者はここから）
+1. TODO リストと最初のテスト
+2. 仮実装と三角測量
+3. 明白な実装とリファクタリング
+
+**第 2 部: 開発環境と自動化**
+4. バージョン管理と Conventional Commits
+5. パッケージ管理と静的解析
+6. タスクランナーと CI/CD
+
+**第 3 部: オブジェクト指向設計**
+7. カプセル化とポリモーフィズム
+8. デザインパターンの適用
+9. SOLID 原則とモジュール設計
+
+**第 4 部: 関数型プログラミングへの展開**
+10. 高階関数と関数合成
+11. 不変データとパイプライン処理
+12. エラーハンドリングと型安全性
+
+### Step 3: 対話式チュートリアルの実施
+
+教材ファイルを読み込み、以下のルールで対話的に進行する。
+
+#### 教材ファイルの特定
+
+言語ごとにファイル名パターンが異なる。
+
+- 多くの言語: `docs/article/getting-start-tdd/{lang}/01-todo-list-and-first-test.md` 等
+- C#: `docs/article/getting-start-tdd/csharp/chapter01.md` 等
+- F#: `docs/article/getting-start-tdd/fsharp/chapter01.md` 等
+
+#### 進行ルール
+
+1. **章の導入**: その章で学ぶ概念と目標を簡潔に説明する
+2. **TODO リスト提示**: 章の TODO リストを提示し、全体像を共有する
+3. **段階的な課題提示**: 一度にすべてを見せず、1 ステップずつ課題を出す
+4. **考えさせる**: テストコードを見せる前に「どんなテストを書くべきか？」と問いかける
+5. **Red フェーズ**: 失敗するテストを書くよう促す。ユーザーが書いたテストにフィードバックを与える
+6. **Green フェーズ**: テストを通す最小限のコードを書くよう促す。正解を教えるのではなくヒントを与える
+7. **Refactor フェーズ**: コードの改善ポイントを一緒に考える
+8. **振り返り**: ステップ完了後に学んだ概念を簡潔にまとめる
+
+#### 対話のトーン
+
+- 励ましと好奇心を持って接する
+- 間違いを責めず、なぜそうなるかを一緒に考える
+- TDD の書籍からの引用を適宜挟み、理論的背景を伝える
+- ユーザーのペースに合わせる（速い人にはテンポよく、慎重な人にはじっくり）
+
+#### ヒントの段階
+
+ユーザーが詰まった場合、段階的にヒントを出す。
+
+1. **方向性のヒント**: 「3 の倍数を判定するには、どの演算子が使えそうですか？」
+2. **構造のヒント**: 「if 文と剰余演算子（%）を組み合わせてみましょう」
+3. **コード例の一部**: 「`number % 3 == 0` という条件式を使えます」
+4. **完全な解答**: 教材のコードを提示し、なぜそうなるかを解説する
+
+#### セッション管理
+
+- 各ステップ完了時に TODO リストを更新して進捗を可視化する
+- 長いセッションでは適度な区切り（章の終わり）で休憩を提案する
+- 次回再開時のために、現在の進捗状況を報告する
+
+### Step 4: 章のまとめ
+
+章の終わりに以下を実施する。
+
+1. 学んだ概念の要約
+2. TODO リストの最終状態確認
+3. 次章の予告と接続
+4. （希望があれば）追加の練習問題を提案
+
+## 応用: 複数言語での比較
+
+ユーザーが複数言語に興味がある場合、`docs/article/getting-start-tdd/integration/` の多言語統合解説を参照し、言語間の比較視点を提供する。
+
+## 注意事項
+
+- このスキルはユーザーに「教える」のではなく「一緒に学ぶ」姿勢で進行する
+- コードを書くのはユーザー自身。AI はガイド役に徹する
+- ユーザーが「答えを教えて」と言った場合は教材のコードを提示するが、なぜそうなるかの理解を促す
+- 環境構築は必ずユーザーの合意を得てから進める。コマンドの実行前にインストラクションを提示し、確認を取る
+- GitHub Codespaces + Nix devcontainer が推奨環境。ローカルの場合は OS に応じたパッケージマネージャを使う（Windows: Scoop で各言語を直接インストール、macOS: Homebrew + Nix、Linux: Nix）

package/lib/assets/CLAUDE.md

@@ -97,6 +97,12 @@
 | `creating-release-report` | リリース完了報告書作成 |
 | `creating-iteration-report` | イテレーション完了報告書作成 |
 
+### 学習
+
+| スキル | 用途 |
+| :--- | :--- |
+| `practicing-getting-start-tdd` | TDD プログラミング入門の対話式チュートリアル |
+
 ### 共通
 
 | スキル | 用途 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2works/claude-code-booster",
-  "version": "4.0.0",
+  "version": "4.1.1",
   "description": "AI Agent Development Support Tool",
   "main": "main.js",
   "bin": {

package/lib/assets/.claude/agent-memory/xp-programmer/MEMORY.md

@@ -1,6 +0,0 @@
-# Agent Memory Index
-
-## Project memories
-- [project_cargo_tracker.md](project_cargo_tracker.md) — cargo-tracker のプロジェクト構成と gradlew 実行場所、既存テスト失敗状況
-- [project_ddd_patterns.md](project_ddd_patterns.md) — cargo-tracker の DDD パターン（集約・値オブジェクト・ドメインイベントの実装規約）
-- [project_us07_route_assignment.md](project_us07_route_assignment.md) — US07 route assignment: H2-compatible Flyway migrations, insert/update switching in repository, WebMvcTest mock requirements

package/lib/assets/.claude/agent-memory/xp-programmer/project_cargo_tracker.md

@@ -1,11 +0,0 @@
----
-name: cargo-tracker-project-context
-description: case-study-cargo-tracker プロジェクトの基本構成と開発上の注意点
-type: project
----
-
-Spring Boot 3.4.x / Java 25 / Gradle プロジェクト。`apps/cargo-tracker/` 配下に gradlew.bat がある。
-
-**Why:** リポジトリルートではなく `apps/cargo-tracker/` でコマンドを実行する必要がある。また既存の統合テスト（BookingRepository 統合テスト、ShipperRepository 統合テスト、Spring コンテキストテスト）は現時点で失敗しており、これらは既存の事前失敗であることが確認済み。
-
-**How to apply:** テスト実行コマンドは `Set-Location "C:\Users\PC202411-1\IdeaProjects\case-study-cargo-tracker\apps\cargo-tracker"; & ".\gradlew.bat" "test"` を使う。全テスト実行時に既存失敗があっても quote コンテキストが Green ならば問題なし。

package/lib/assets/.claude/agent-memory/xp-programmer/project_ddd_patterns.md

@@ -1,27 +0,0 @@
----
-name: cargo-tracker-ddd-patterns
-description: case-study-cargo-tracker の DDD パターン（集約、値オブジェクト、ドメインイベント）の実装規約
-type: project
----
-
-## 集約ルート（Aggregate Root）パターン
-- `register()`/`issue()` ファクトリメソッドでドメインイベントを発行し集約を生成
-- `reconstitute()` ファクトリメソッドはドメインイベントを発行せず永続化ストアから再構成
-- 全フィールドは `final`（イミュータブル）
-- `domainEvents` は `List<DomainEvent>` で内部に持ち、`getDomainEvents()` で `unmodifiableList` を返す
-
-## 値オブジェクト（Value Object）パターン
-- コンストラクタで全バリデーション（null/blank チェック、正数チェック）
-- `equals()/hashCode()` を実装
-- `BigDecimal` の `equals` では精度差異が出るため `compareTo()==0` と `stripTrailingZeros()` を使う
-
-## ドメインイベント
-- `DomainEvent` はマーカーインターフェース
-- イベントは Java `record` で実装（例: `record QuoteIssuedEvent(QuoteId quoteId, QuoteNumber quoteNumber) implements DomainEvent`）
-
-## package-info.java
-- コンテキストルートに `@NonNullApi` アノテーション付きの package-info.java を作成
-
-**Why:** booking コンテキストが確立したパターン。quote コンテキスト実装時に同一パターンを踏襲した。
-
-**How to apply:** 新しいコンテキスト実装時に同様のパターンを使う。

package/lib/assets/.claude/agent-memory/xp-programmer/project_us07_route_assignment.md

@@ -1,19 +0,0 @@
----
-name: US07 route assignment implementation
-description: Implementation patterns and notes for US07 (route selection and booking assignment)
-type: project
----
-
-US07 implemented on 2026-04-02. All 253 tests pass with inside-out TDD.
-
-**Key patterns:**
-- Added AssignedRoute value object (record), BookingRouteAssignedEvent, Booking.assignRoute() to domain layer
-- Added AssignRouteCommand + AssignRouteCommandService to application layer
-- Flyway V006 adds 3 columns to bookings table; H2-compatible: one ALTER TABLE per column
-- BookingRecord record added 3 fields (after status, before createdAt)
-- BookingMapper.java: added update() method; BookingRepositoryImpl.save() switches insert/update via findById check
-- WebMvcTest: must add @MockitoBean for AssignRouteCommandService in BookingRestControllerTest and BookingWebControllerTest
-
-**Why:** H2 does not support ADD COLUMN c1, c2 in one statement. Must split into separate ALTER TABLE statements.
-
-**How to apply:** When creating Flyway migrations, use H2-compatible syntax. Split multi-column additions into separate ALTER TABLE statements.