@k2works/claude-code-booster 0.9.0 → 0.10.0

package/lib/assets/.claude/commands/plan-github.md

@@ -0,0 +1,212 @@
+## Plan GitHub
+
+リリース計画を GitHub Project・Issue・Milestone に反映し、プロジェクト管理を GitHub 上で一元化します。
+
+### 使い方
+
+```bash
+/plan-github [オプション]
+```
+
+### オプション
+
+- なし : 全体の同期を実行（Project作成、Issue作成、フィールド設定、Milestone作成）
+- `--project` : GitHub Project のみを作成
+- `--issues` : Issue のみを作成（Project が存在する前提）
+- `--fields` : Project フィールド値のみを設定
+- `--milestones` : Milestone のみを作成し Issue に割り当て
+- `--verify` : release_plan.md と GitHub の差異を確認
+- `--status` : 現在の GitHub Project 状態を表示
+
+### 基本例
+
+```bash
+# 初回の完全同期（Project、Issue、Milestone すべて作成）
+/plan-github
+「リリース計画を GitHub Project に反映して」
+
+# GitHub Project のみ作成
+/plan-github --project
+「GitHub Project を作成して」
+
+# 差異確認
+/plan-github --verify
+「release_plan.md と GitHub Issue の差異を確認して」
+
+# 現在の状態確認
+/plan-github --status
+「GitHub Project の現在の状態を表示して」
+```
+
+### 詳細機能
+
+#### GitHub Project の作成
+
+release_plan.md に基づいて GitHub Project を作成し、カスタムフィールドを設定します。
+
+**作成されるフィールド**:
+
+- **リリース**: 1.0 MVP / 2.0 機能拡張版 / 3.0 完成版
+- **イテレーション**: 1〜12
+- **優先度**: 必須 / 重要
+- **SP**: ストーリーポイント（数値）
+- **カテゴリ**: 認証・ユーザー管理 / マスタ管理 / 仕訳管理 / 元帳・残高管理 / 財務諸表 / システム管理
+
+```bash
+# GitHub Project の作成
+/plan-github --project
+「カスタムフィールド付きの GitHub Project を作成して」
+```
+
+#### Issue の作成
+
+ユーザーストーリーを GitHub Issue として作成し、Project に追加します。
+
+**Issue の構成**:
+
+- **タイトル**: `[ストーリーID] ストーリー名`
+- **本文**: ユーザーストーリー、受け入れ基準、見積もり情報
+- **Project 紐付け**: 作成した Project に自動追加
+
+```bash
+# Issue の作成と Project への追加
+/plan-github --issues
+「ユーザーストーリーを Issue として作成して Project に追加して」
+```
+
+#### フィールド値の設定
+
+各 Issue の Project フィールドに release_plan.md の値を反映します。
+
+**設定される情報**:
+
+- リリース（マイルストーン対応）
+- イテレーション番号
+- 優先度（必須/重要）
+- ストーリーポイント
+- カテゴリ
+
+```bash
+# フィールド値の一括設定
+/plan-github --fields
+「release_plan.md の内容で Project フィールドを更新して」
+```
+
+#### Milestone の作成
+
+リリースを GitHub Milestone として作成し、Issue に割り当てます。
+
+**作成される Milestone**:
+
+- **リリース 1.0 MVP**: 基本的な仕訳入力と元帳管理
+- **リリース 2.0 機能拡張版**: 承認ワークフローと財務諸表
+- **リリース 3.0 完成版**: 高度な分析機能とシステム管理
+
+```bash
+# Milestone の作成と Issue 割り当て
+/plan-github --milestones
+「リリースを Milestone として作成して Issue に割り当てて」
+```
+
+#### 差異確認
+
+release_plan.md と GitHub Issue/Project の整合性を確認します。
+
+**確認項目**:
+
+- ストーリー数の一致
+- ストーリーポイントの一致
+- リリース/Milestone 割り当ての一致
+- 優先度の一致
+
+```bash
+# 差異確認
+/plan-github --verify
+「release_plan.md と GitHub の差異がないか確認して」
+```
+
+### 出力例
+
+```
+📊 GitHub Project 同期結果
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🎯 Project: 会計システムのケーススタディ
+   URL: https://github.com/users/k2works/projects/8
+
+📋 Issue 作成状況
+├─ 認証・ユーザー管理: 6件（21SP）
+├─ マスタ管理: 8件（29SP）
+├─ 仕訳管理: 10件（45SP）
+├─ 元帳・残高管理: 5件（26SP）
+├─ 財務諸表: 3件（21SP）
+└─ システム管理: 2件（13SP）
+   合計: 34件（155SP）
+
+🏁 Milestone 割り当て
+├─ リリース 1.0 MVP: 14件（期日: 2026-02-27）
+├─ リリース 2.0 機能拡張版: 12件（期日: 2026-04-24）
+└─ リリース 3.0 完成版: 8件（期日: 2026-06-19）
+
+✅ 差異確認: release_plan.md と完全一致
+```
+
+### Claude との連携
+
+```bash
+# リリース計画から完全同期
+cat docs/development/release_plan.md
+/plan-github
+「このリリース計画を GitHub Project に完全同期して」
+
+# 計画更新後の差異確認と同期
+cat docs/development/release_plan.md
+/plan-github --verify
+「更新したリリース計画と GitHub の差異を確認して」
+
+# 既存 Project へのフィールド更新
+/plan-github --fields
+「release_plan.md の最新内容で Project フィールドを更新して」
+```
+
+### 注意事項
+
+- **前提条件**:
+  - `docs/development/release_plan.md` が存在すること
+  - `gh` CLI がインストールされ認証済みであること
+  - Project API スコープが有効であること（`gh auth refresh -s project,read:project`）
+- **制限事項**:
+  - 既存の Project/Issue がある場合は重複作成に注意
+  - フィールド値の更新は既存値を上書き
+- **推奨事項**:
+  - 初回は `--verify` で差異確認してから同期
+  - 大規模な変更前にはバックアップを推奨
+
+### ベストプラクティス
+
+1. **初回同期**: `/plan-github` で全体を一括作成
+2. **計画更新時**: `/plan-github --verify` で差異確認後、必要な部分のみ更新
+3. **定期確認**: `/plan-github --status` で進捗状況を定期的に確認
+4. **一貫性維持**: release_plan.md を Single Source of Truth として管理
+
+### 同期フロー
+
+```mermaid
+graph TD
+    A[release_plan.md] --> B{/plan-github}
+    B --> C[GitHub Project 作成]
+    C --> D[カスタムフィールド設定]
+    D --> E[Issue 作成]
+    E --> F[Project にItem追加]
+    F --> G[フィールド値設定]
+    G --> H[Milestone 作成]
+    H --> I[Issue に Milestone 割当]
+    I --> J[差異確認]
+    J --> K[同期完了]
+```
+
+### 関連コマンド
+
+- `/plan` : リリース計画とイテレーション計画の作成
+- `/progress` : 進捗状況の確認と更新
+- `/git-commit` : 変更のコミット

package/lib/assets/.claude/commands/plan.md

@@ -191,6 +191,23 @@ cat retrospective_notes.md
 - **前提条件**: 要件定義書またはユーザーストーリーが存在すること
 - **制限事項**: 初回ベロシティは推測値のため、3イテレーション後に再調整推奨
 - **推奨事項**: 各イテレーション終了時に計画を更新し、生きた文書として管理
+- 以下の記述ルールに従うこと
+  - タスク項目などは一行開けて記述する
+  - NG
+  ```markdown
+    **受入条件**:
+    - [ ] ログアウトボタンをクリックするとログアウトできる
+    - [ ] ログアウト後、ログイン画面に遷移する
+    - [ ] JWT トークンが無効化される
+  ```
+  - OK
+  ```markdown
+    **受入条件**:
+  
+    - [ ] ログアウトボタンをクリックするとログアウトできる
+    - [ ] ログアウト後、ログイン画面に遷移する
+    - [ ] JWT トークンが無効化される
+  ```
 
 ### ベストプラクティス
 

package/lib/assets/.claude/settings.json

@@ -1,164 +1,7 @@
 {
-  "cleanupPeriodDays": 30,
-  "env": {
-    "BASH_DEFAULT_TIMEOUT_MS": "600000",
-    "BASH_MAX_TIMEOUT_MS": "600000",
-    "CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR": "true",
-    "SHELL": "/opt/homebrew/bin/zsh"
-  },
-  "includeCoAuthoredBy": false,
   "permissions": {
-    "allow": [
-      "Bash(*)",
-      "Edit(**)",
-      "Glob(**)",
-      "GlobTool(**)",
-      "Grep(**)",
-      "GrepTool(**)",
-      "LS(**)",
-      "MultiEdit(**)",
-      "Read(**)",
-      "TodoRead()",
-      "TodoWrite(**)",
-      "WebFetch(domain:*)",
-      "WebSearch(**)",
-      "Write(**)"
-    ],
-    "deny": [
-      "Bash(* | bash)",
-      "Bash(* | sh)",
-      "Bash(:(){ :|:& };:)",
-      "Bash(> /dev/sda*)",
-      "Bash(apt-get install*)",
-      "Bash(brew install*)",
-      "Bash(bundle install*)",
-      "Bash(chmod -R 777*)",
-      "Bash(chmod 777*)",
-      "Bash(chown -R*)",
-      "Bash(dd*)",
-      "Bash(format*)",
-      "Bash(gem install*)",
-      "Bash(gh api --method DELETE*)",
-      "Bash(gh auth logout*)",
-      "Bash(gh auth refresh*)",
-      "Bash(gh gist create*)",
-      "Bash(gh gist delete*)",
-      "Bash(gh gpg-key add*)",
-      "Bash(gh gpg-key delete*)",
-      "Bash(gh release create*)",
-      "Bash(gh release delete*)",
-      "Bash(gh release upload*)",
-      "Bash(gh repo archive*)",
-      "Bash(gh repo clone*)",
-      "Bash(gh repo create*)",
-      "Bash(gh repo delete*)",
-      "Bash(gh repo deploy-key*)",
-      "Bash(gh repo edit*)",
-      "Bash(gh repo fork*)",
-      "Bash(gh repo rename*)",
-      "Bash(gh repo sync*)",
-      "Bash(gh repo unarchive*)",
-      "Bash(gh secret delete*)",
-      "Bash(gh secret set*)",
-      "Bash(gh ssh-key add*)",
-      "Bash(gh ssh-key delete*)",
-      "Bash(gh workflow disable*)",
-      "Bash(gh workflow enable*)",
-      "Bash(gh workflow run:*)",
-      "Bash(git checkout*)",
-      "Bash(git config*)",
-      "Bash(git rebase*)",
-      "Bash(git reset --hard*)",
-      "Bash(git restore*)",
-      "Bash(mkfs*)",
-      "Bash(npm install -g*)",
-      "Bash(pip install*)",
-      "Bash(rm -rf ../*)",
-      "Bash(rm -rf /)",
-      "Bash(rm -rf /*)",
-      "Bash(rm -rf ~/*)",
-      "Bash(sudo*)",
-      "Bash(yum install*)"
-    ]
-  },
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/scripts/deny-check.sh"
-          },
-          {
-            "type": "command",
-            "command": "~/.claude/scripts/check-ai-commit.sh"
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/scripts/preserve-file-permissions.sh"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/scripts/ja-space-format.sh"
-          },
-          {
-            "type": "command",
-            "command": "~/.claude/scripts/auto-comment.sh"
-          }
-        ]
-      },
-      {
-        "matcher": "Edit|Write|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/scripts/preserve-file-permissions.sh"
-          }
-        ]
-      }
-    ],
-    "Notification": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "osascript -e 'display notification \"Awaiting confirmation\" with title \"Claude Code\"' && afplay -v 0.3 ~/.claude/assets/confirm.mp3"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/scripts/check-continue.sh"
-          },
-          {
-            "type": "command",
-            "command": "osascript -e 'display notification \"Task completed\" with title \"Claude Code\"' && afplay -v 0.3 ~/.claude/assets/perfect.mp3"
-          }
-        ]
-      }
-    ]
-  },
-  "statusLine": {
-    "type": "command",
-    "command": "~/.claude/scripts/statusline.sh"
+    "allow": [],
+    "deny": [],
+    "ask": []
   }
 }

package/lib/assets/README.md

@@ -156,7 +156,7 @@ GHCR からイメージを取得して実行するには：
 docker pull ghcr.io/k2works/{project_name}:latest
 
 # または特定バージョン
-docker pull ghcr.io/k2works/grokkingfp-excersice:0.0.1
+docker pull ghcr.io/k2works/{project_name}:0.0.1
 
 # コンテナを実行
 docker run -it -v $(pwd):/srv ghcr.io/k2works/{project_name}:latest

package/lib/assets/docker-compose.yml

@@ -2,7 +2,7 @@ services:
   mkdocs:
     build:
       context: .
-      dockerfile: ./docs/Dockerfile
+      dockerfile: ./ops/docker/mkdoc/Dockerfile
     environment:
         PLANTUML_SERVER_URL: http://plantuml:8080/plantuml
     volumes:
@@ -12,7 +12,7 @@ services:
       - ./site:/docs/site
     ports:
       - "8000:8000"
-    command: mkdocs serve --dev-addr=0.0.0.0:8000
+    command: mkdocs serve --dev-addr=0.0.0.0:8000 --livereload
     links:
       - plantuml
 

package/lib/assets/gulpfile.js

@@ -5,8 +5,8 @@
  */
 
 import gulp from 'gulp';
-import mkdocsTasks from './scripts/mkdocs.js';
-import journalTasks from './scripts/journal.js';
+import mkdocsTasks from './ops/scripts/mkdocs.js';
+import journalTasks from './ops/scripts/journal.js';
 
 // Load gulp tasks from script modules
 mkdocsTasks(gulp);

package/lib/assets/mkdocs.yml

@@ -55,5 +55,8 @@ extra:
 plugins:
   - search
 
+exclude_docs: |
+  wiki
+
 nav:
   - Home: index.md

package/lib/assets/{scripts → ops/scripts}/mkdocs.js

@@ -26,8 +26,14 @@ export default function (gulp) {
         try {
             console.log('Starting MkDocs server using Docker Compose...');
 
+            // Normalize DOCKER_HOST on Windows if it's incorrect
+            const env = { ...process.env };
+            if (isWindows && env.DOCKER_HOST === 'npipe://./pipe/docker_engine') {
+                env.DOCKER_HOST = 'npipe:////./pipe/docker_engine';
+            }
+
             // Execute docker-compose up command to start mkdocs service
-            execSync('docker compose up -d mkdocs', {stdio: 'inherit'});
+            execSync('docker compose up -d mkdocs', {stdio: 'inherit', env});
 
             console.log('\nMkDocs server started successfully!');
             console.log('Documentation is now available at http://localhost:8000');
@@ -45,11 +51,17 @@ export default function (gulp) {
         try {
             console.log('Building MkDocs documentation...');
 
+            // Normalize DOCKER_HOST on Windows if it's incorrect
+            const env = { ...process.env };
+            if (isWindows && env.DOCKER_HOST === 'npipe://./pipe/docker_engine') {
+                env.DOCKER_HOST = 'npipe:////./pipe/docker_engine';
+            }
+
             // Remove existing site directory before building
             removeSiteDirectory();
 
             // Execute docker-compose run command to build mkdocs documentation
-            execSync('docker compose run --rm mkdocs mkdocs build', {stdio: 'inherit'});
+            execSync('docker compose run --rm mkdocs mkdocs build', {stdio: 'inherit', env});
 
             console.log('\nMkDocs documentation built successfully!');
 
@@ -65,8 +77,14 @@ export default function (gulp) {
         try {
             console.log('Stopping MkDocs server...');
 
+            // Normalize DOCKER_HOST on Windows if it's incorrect
+            const env = { ...process.env };
+            if (isWindows && env.DOCKER_HOST === 'npipe://./pipe/docker_engine') {
+                env.DOCKER_HOST = 'npipe:////./pipe/docker_engine';
+            }
+
             // Execute docker-compose down command to stop mkdocs service
-            execSync('docker compose down', {stdio: 'inherit'});
+            execSync('docker compose down', {stdio: 'inherit', env});
 
             console.log('MkDocs server stopped successfully!');
 

package/package.json

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