@k2works/claude-code-booster 4.1.1 → 4.2.0

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

@@ -17,6 +17,27 @@ FizzBuzz 問題を題材に、TDD（テスト駆動開発）の手法を実践
 
 チュートリアルを始める前に、開発環境を準備する。環境構築は**ユーザーにインストラクションを提示し、合意を得てから**進める。勝手にコマンドを実行しない。
 
+#### コード配置ルール
+
+チュートリアルで作成するコードは `apps/` 配下に**言語ごとのディレクトリ**を切って配置する。言語環境・プロジェクト初期化・ソース・テストはすべてそのディレクトリ内で完結させ、他言語と干渉しないようにする。
+
+```text
+apps/
+├── java/         # Java プロジェクト（build.gradle, src/ など）
+├── python/       # Python プロジェクト（pyproject.toml, tests/ など）
+├── typescript/   # TypeScript プロジェクト（package.json, src/ など）
+├── go/           # Go プロジェクト（go.mod, *_test.go など）
+├── rust/         # Rust プロジェクト（Cargo.toml, src/ など）
+└── ...           # その他の言語も同様に `apps/{lang}/` を作成
+```
+
+**進め方**：
+
+1. 選択言語のディレクトリ `apps/{lang}/` が存在するか確認する
+2. なければ作成し、各言語標準のプロジェクト初期化コマンド（`cargo init`、`npm init`、`go mod init` 等）をユーザーの合意を得てから実行する
+3. 以降のテスト・実装コードはすべてこのディレクトリ配下に記述する
+
+
 #### 推奨環境: GitHub Codespaces
 
 最もスムーズに始められる環境。devcontainer に Nix が設定済みで、言語ごとの開発環境が即座に利用可能。
@@ -35,10 +56,31 @@ nix develop .#node    # JavaScript/TypeScript の場合
 
 | OS | パッケージマネージャ | 環境構築方法 |
 |----|--------------------|-------------|
-| Windows | [Scoop](https://scoop.sh/) | Scoop で各言語のランタイム・ビルドツールを直接インストール（Nix は非対応） |
+| Windows（**WSL 推奨**） | [WSL](https://learn.microsoft.com/windows/wsl/) + [Nix](https://nixos.org/download) | WSL2（Ubuntu 等）に Nix をインストールし `nix develop .#{lang}` で開発環境に入る |
+| 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 ユーザーにはまず **WSL（Windows Subsystem for Linux）** を推奨する。WSL 上では Linux と同じく Nix / devcontainer がそのまま使え、教材の動作例ともっとも齟齬が少ない。WSL を利用できない事情がある場合に限り、ネイティブ Windows + Scoop の構成を提案する。
+
+##### Windows（WSL）での環境構築例
+
+```powershell
+# PowerShell（管理者）で WSL2 と Ubuntu をインストール
+wsl --install -d Ubuntu
+# 再起動後、Ubuntu を起動し初期ユーザーを作成
+```
+
+```bash
+# WSL（Ubuntu）内で Nix をインストール
+sh <(curl -L https://nixos.org/nix/install) --daemon
+
+# 以降は Linux と同じ手順
+nix develop .#java    # 例: Java の場合
+```
+
+Windows 側のファイルシステム（`/mnt/c/...`）ではなく、WSL の Linux ファイルシステム（`~` 配下）にリポジトリを clone すると I/O 性能が大幅に向上する。
+
 ##### Windows（Scoop）での環境構築例
 
 Windows では Nix が使えないため、Scoop で各言語のツールを個別にインストールする。
@@ -145,11 +187,14 @@ scoop install php composer
 1. **章の導入**: その章で学ぶ概念と目標を簡潔に説明する
 2. **TODO リスト提示**: 章の TODO リストを提示し、全体像を共有する
 3. **段階的な課題提示**: 一度にすべてを見せず、1 ステップずつ課題を出す
-4. **考えさせる**: テストコードを見せる前に「どんなテストを書くべきか？」と問いかける
-5. **Red フェーズ**: 失敗するテストを書くよう促す。ユーザーが書いたテストにフィードバックを与える
-6. **Green フェーズ**: テストを通す最小限のコードを書くよう促す。正解を教えるのではなくヒントを与える
-7. **Refactor フェーズ**: コードの改善ポイントを一緒に考える
-8. **振り返り**: ステップ完了後に学んだ概念を簡潔にまとめる
+4. **実装コードの提示**: 各ステップで教材に記載された **テストコード・実装コードを必ず提示** する。コードブロックと併せて「どのファイルのどの位置に書くか」も明示する
+5. **記述方法の選択**: コード提示後、ユーザーに以下のどちらで進めるかを尋ねる
+   - **手動記述**: ユーザーが自分の手でエディタに書き写す（学習効果が高い。推奨）
+   - **自動記述**: AI が Write/Edit ツールで該当ファイルに自動で記述する（テンポ重視・確認用）
+6. **Red フェーズ**: 提示したテストコードを記述し、失敗することを一緒に確認する
+7. **Green フェーズ**: 提示した最小限の実装コードを記述し、テストが通ることを確認する
+8. **Refactor フェーズ**: 提示したリファクタ後のコードを記述し、テストが通り続けることを確認する。併せて改善ポイントの意図を解説する
+9. **ステップ振り返り**: ステップ完了後に学んだ概念を簡潔にまとめる
 
 #### 対話のトーン
 
@@ -173,14 +218,40 @@ scoop install php composer
 - 長いセッションでは適度な区切り（章の終わり）で休憩を提案する
 - 次回再開時のために、現在の進捗状況を報告する
 
-### Step 4: 章のまとめ
+### Step 4: 章のまとめと KPT 振り返り
 
 章の終わりに以下を実施する。
 
 1. 学んだ概念の要約
 2. TODO リストの最終状態確認
-3. 次章の予告と接続
-4. （希望があれば）追加の練習問題を提案
+3. **KPT 振り返りの実施**（必須）
+4. 次章の予告と接続
+5. （希望があれば）追加の練習問題を提案
+
+#### KPT 振り返りの進め方
+
+各章の最後に、KPT フレームワークで振り返りを行う。ユーザーに以下の 3 観点を順に問いかけ、回答を整理してまとめる。
+
+- **Keep（続けたいこと）**: この章でうまくいったこと、今後も続けたい学び方や習慣
+- **Problem（問題点）**: 詰まった箇所、理解が曖昧なまま進んだ点、学習上の課題
+- **Try（次に試すこと）**: 次章または次回の学習で試したい改善アクション
+
+KPT は以下のフォーマットでまとめ、セッションログとしてユーザーに提示する。
+
+```markdown
+## 第 N 章 KPT 振り返り
+
+### Keep
+- （続けたいこと）
+
+### Problem
+- （問題点）
+
+### Try
+- （次に試すこと）
+```
+
+Problem で挙がった項目は、Try で具体的なアクションに変換するよう促す。Try は次章の進め方に反映させる。
 
 ## 応用: 複数言語での比較
 
@@ -192,4 +263,4 @@ scoop install php composer
 - コードを書くのはユーザー自身。AI はガイド役に徹する
 - ユーザーが「答えを教えて」と言った場合は教材のコードを提示するが、なぜそうなるかの理解を促す
 - 環境構築は必ずユーザーの合意を得てから進める。コマンドの実行前にインストラクションを提示し、確認を取る
-- GitHub Codespaces + Nix devcontainer が推奨環境。ローカルの場合は OS に応じたパッケージマネージャを使う（Windows: Scoop で各言語を直接インストール、macOS: Homebrew + Nix、Linux: Nix）
+- GitHub Codespaces + Nix devcontainer が推奨環境。ローカルの場合は OS に応じたパッケージマネージャを使う（Windows: **WSL + Nix を第一推奨**、困難なら Scoop で各言語を直接インストール、macOS: Homebrew + Nix、Linux: Nix）

package/lib/assets/docs/index.md

@@ -23,8 +23,8 @@
 | [レビュー](./review/index.md) | 分析・開発レビュー結果の記録                      | `index.md` を整備済み |
 | [ADR](./adr/index.md) | Architecture Decision Records の管理   | `index.md` を整備済み |
 | [記事](./article/index.md) | 学習用の記事シリーズ一覧                        | `index.md` を整備済み |
-| [リファレンス](./reference/index.md) | 開発ガイドラインやベストプラクティス                  | 29 件のドキュメントを配置 |
-| [テンプレート](./template/index.md) | 各種ドキュメントの作成テンプレート                   | 17 件のテンプレートを配置 |
+| [リファレンス](./reference/index.md) | 開発ガイドラインやベストプラクティス                  | 30 件のドキュメントを配置 |
+| [テンプレート](./template/index.md) | 各種ドキュメントの作成テンプレート                   | 18 件のテンプレートを配置 |
 
 ## 補足
 

package/package.json

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