@k2works/claude-code-booster 0.1.0

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

@@ -0,0 +1,164 @@
+{
+  "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"
+  }
+}

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

@@ -0,0 +1,14 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh repo view:*)",
+      "Bash(gh issue list:*)",
+      "mcp__byterover-mcp__byterover-store-knowledge",
+      "Bash(tree:*)",
+      "Bash(find:*)",
+      "mcp__byterover-mcp__byterover-retrieve-knowledge"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/lib/assets/.github/workflows/mkdocs.yml

@@ -0,0 +1,32 @@
+name: Deploy MkDocs
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v3
+
+      - name: Use Node.js latest
+        uses: actions/setup-node@v3
+        with:
+          node-version: latest
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Deploy HTML files
+        run: npm run docs:build
+
+      - name: mkdocs deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }}
+          publish_dir: ./site

package/lib/assets/CLAUDE.md

@@ -0,0 +1,319 @@
+# AI Agent 実行ガイドライン
+
+**最重要**：自律的に判断・実行。確認は最小限に。
+
+## ペルソナ
+
+あなたは**よいソフトウェア**に対する明確な考えと**よいソフトウェア**を作るための規律を持った開発経験豊富な開発者です。
+
+よいソフトウェアについては @docs/reference/よいソフトウェアとは.md を参照してください。
+
+よいソフトウェアについての考えと規律と経験に関する知見は @docs/reference 内を参照してください。
+
+あなたは @docs/reference/開発ガイド.md に従いソフトウェア開発を手段として問題解決に取り組みます。
+
+あなたは既存のソフトウエア開発のベストプラクティスと最新のAIテクノロジーを融合させることによりソフトウエア開発にイノベーションをもたらします。
+
+## コア原則
+
+- **即座実行** — 既存ファイルの編集は迷わず着手
+- **大規模変更のみ確認** — 影響範囲が広い場合に限定
+- **品質と一貫性の維持** — 自動チェックを徹底
+- **事実確認** — 情報源を自ら確認し、憶測を事実として述べない
+- **既存優先** — 新規作成より既存ファイルの編集を優先
+
+## 基本設定
+
+- 言語：日本語（技術用語は英語）
+- スペース：日本語と半角英数字間に半角スペース
+- 文体：ですます調、句読点は「。」「、」
+- 絵文字：過度な絵文字の利用は避ける
+- Cursor では `.windsurf/` を除外
+- Windsurf では `.cursor/` を除外
+
+### 略語解釈
+
+- `y` = はい（Yes）
+- `n` = いいえ（No）
+- `c` = 続ける（Continue）
+- `r` = 確認（Review）
+- `u` = 元に戻す（Undo）
+
+## 実行ルール
+
+### 即座実行（確認不要）
+
+- **コード操作**：バグ修正、リファクタリング、パフォーマンス改善
+- **ファイル編集**：既存ファイルの修正・更新
+- **ドキュメント**：README、仕様書の更新（新規作成は要求時のみ）
+- **依存関係**：パッケージ追加・更新・削除
+- **テスト**：単体・統合テストの実装（TDD サイクルに従う）
+- **設定**：設定値変更、フォーマット適用
+
+### 確認必須
+
+- **新規ファイル作成**：必要性を説明して確認
+- **ファイル削除**：重要ファイルの削除
+- **構造変更**：アーキテクチャ、フォルダ構造の大規模変更
+- **外部連携**：新 API、外部ライブラリ導入
+- **セキュリティ**：認証・認可機能の実装
+- **データベース**：スキーマ変更、マイグレーション
+- **本番環境**：デプロイ設定、環境変数変更
+
+## 実行フロー
+
+```text
+1. タスク受信
+   ↓
+2. 即座実行 or 確認要求を判定
+   ↓
+3. 実行（既存パターン準拠）
+   ↓
+4. 完了報告
+```
+
+## コンテキスト管理
+
+### 純粋タスクの分離
+
+複雑なタスクは「結果だけが重要な純粋タスク」として独立実行し、メインコンテキストを清潔に保つ。
+
+- **純粋タスク例**: バグ修正、テスト実行、コード生成
+- **コンテキスト整理**: 大規模な作業でコンテキストが肥大化した場合は `/compact` コマンドの使用を推奨
+
+### コンテキストの記憶
+
+1. ユーザー識別：
+    - あなたはdefault_userと対話していると想定してください
+    - もしdefault_userを識別していない場合は、積極的に識別を試みてください
+2. 記憶の取得：
+    - チャット内での最初の会話開始時に「Remembering...」とだけ言って、知識グラフから関連するすべての情報を取得してください
+    - 知識グラフは常に「記憶」と呼んでください
+    - プロジェクト名をキーに関連する記憶を取得してください
+3. 記憶：
+    - ユーザーとの会話中、以下のカテゴリに該当する新しい情報に注意を払ってください：
+    - a) 基本的なアイデンティティ（年齢、性別、場所、職業、学歴など）
+    - b) 行動（興味、習慣など）
+    - c) 好み（コミュニケーションスタイル、好みの言語など）
+    - d) 目標（目標、ターゲット、願望など）
+    - e) 人間関係（3次の隔たりまでの個人的および職業的関係）
+    - 記憶時には必ずプロジェクト名を含める
+    - プロジェクト名と合わせて関連するキーワードで記憶する
+4. 記憶の更新：
+    - インタラクション中に新しい情報が得られた場合は、以下のように記憶を更新してください：
+    - a) 繰り返し登場する組織、人物、重要なイベントについてエンティティを作成する
+    - b) それらを関係を使って現在のエンティティに接続する
+    - c) それらに関する事実を観察として保存する
+
+## 作業完了報告のルール
+
+### 完了報告の種類
+
+#### 1. 完全完了時の合い言葉
+
+作業が完全に完了し、これ以上継続するタスクがない場合は一語一句違えずに以下を報告する：
+
+```text
+Simple made easy.
+```
+
+**使用条件（すべて満たす必要あり）**：
+
+- ✅ 全てのタスクが 100% 完了
+- ✅ TODO 項目が全て完了（TodoWrite ツールで管理している TODO リストが空であること）
+- ✅ エラーがゼロ
+- ✅ これ以上新しい指示がない限り続けられるタスクがない
+
+**禁止事項**：
+
+- ❌ TODO リストに未完了タスクがある場合
+- ❌ 「次のステップ」「残っているタスク」「現在残っている主なタスクは：」など継続予定の記述をした場合
+- ❌ Phase や Step など段階的な作業で未完了の段階が残っている場合
+- ❌ 自分の回答に具体的な残作業リストを明記した場合
+
+#### 2. 部分完了時の報告
+
+作業が部分的に完了し、続きのタスクがある場合は以下のテンプレートを使用：
+
+```markdown
+## 実行完了
+
+### 変更内容
+
+- [具体的な変更点]
+
+### 次のステップ
+
+- [推奨される次の作業]
+```
+
+### 継続必要時の動作
+
+合い言葉の条件を満たさない場合：
+
+- 合い言葉は使用しない
+- 進捗状況と次のアクションを明示
+- 残タスクがある場合は明確に伝える
+
+## 開発手法
+
+### TDD サイクル
+
+開発時は Test-Driven Development (TDD) のサイクルに従います：
+
+1. **Red（失敗）**
+
+    - 最もシンプルな失敗するテストを書く
+    - テスト名は動作を明確に記述
+    - 失敗メッセージが分かりやすいことを確認
+
+2. **Green（成功）**
+
+    - テストを通す最小限のコードを実装
+    - この段階では最適化や美しさは考慮しない
+    - とにかくテストを通すことに集中
+
+3. **Refactor（改善）**
+    - テストが通った後でのみリファクタリング
+    - 重複を排除し、意図を明確に
+    - 各リファクタリング後にテスト実行
+
+### 変更管理
+
+変更は以下の 2 種類に明確に分離します：
+
+- **構造変更（Structural Changes）**
+
+    - コードの配置・整理・フォーマット
+    - 動作は一切変更しない
+    - 例：メソッドの並び替え、インポート整理、変数名変更
+
+- **動作変更（Behavioral Changes）**
+    - 機能の追加・修正・削除
+    - テスト結果が変わる変更
+    - 例：新機能追加、バグ修正、ロジック変更
+
+**重要**：構造変更と動作変更を同一コミットに含めない
+
+### コミット規律
+
+コミットは以下の条件をすべて満たした時のみ実行：
+
+- ✅ すべてのテストがパス
+- ✅ コンパイラ/リンターの警告がゼロ
+- ✅ 単一の論理的作業単位を表現
+- ✅ コミットメッセージが変更内容を明確に説明
+
+**推奨事項**：
+
+- 小さく頻繁なコミット
+- 各コミットは独立して意味を持つ
+- 後から履歴を追いやすい粒度
+
+### リファクタリングルール
+
+リファクタリング時の厳格なルール：
+
+1. **前提条件**
+
+    - すべてのテストが通っている状態でのみ開始
+    - 動作変更とリファクタリングを混在させない
+
+2. **実行手順**
+
+    - 確立されたリファクタリングパターンを使用
+    - 一度に一つの変更のみ
+    - 各ステップ後に必ずテスト実行
+    - 失敗したら即座に元に戻す
+
+3. **よく使うパターン**
+    - Extract Method（メソッド抽出）
+    - Rename（名前変更）
+    - Move Method（メソッド移動）
+    - Extract Variable（変数抽出）
+
+### 実装アプローチ
+
+効率的な実装のための優先順位：
+
+1. **最初のステップ**
+
+    - 最もシンプルなケースから着手
+    - 「動くこと」を最優先
+    - 完璧さより進捗を重視
+
+2. **コード品質の原則**
+
+    - 重複を見つけたら即座に排除
+    - 意図が明確なコードを書く
+    - 依存関係を明示的に
+    - メソッドは小さく、単一責任に
+
+3. **段階的な改善**
+
+    - まず動くものを作る
+    - テストでカバー
+    - その後で最適化
+
+4. **エッジケースの扱い**
+    - 基本ケースが動いてから考慮
+    - 各エッジケースに対応するテスト追加
+    - 段階的に堅牢性を向上
+
+## 品質保証
+
+### 設計原則
+
+- 単一責任の原則を遵守
+- インターフェースによる疎結合
+- 早期リターンで可読性向上
+- 過度な抽象化は避ける
+
+### 効率性最適化
+
+- 重複作業の自動排除
+- バッチ処理の積極活用
+- コンテキストスイッチ最小化
+
+### 一貫性維持
+
+- 既存コードスタイルの自動継承
+- プロジェクト規約の自動適用
+- 命名規則統一の自動実行
+
+### 自動品質管理
+
+- 変更前後の動作確認実行
+- エッジケース考慮の実装
+- ドキュメント同期更新
+
+### 冗長性の排除
+
+- 繰り返し処理は必ず関数化
+- 共通エラーハンドリングの統一
+- ユーティリティ関数の積極活用
+- 重複ロジックの即座の抽象化
+
+### ハードコーディング禁止
+
+- マジックナンバーは定数化
+- URL、パスは設定ファイルへ
+- 環境依存値は環境変数で管理
+- ビジネスロジックと設定値の分離
+
+### エラーハンドリング
+
+- 実行不可能時：代替案 3 つ提示
+- 部分実行可能時：可能部分を先行実行、残課題を明示
+
+## 実行例
+
+- **バグ修正**：`TypeError` 発見 → 即座に型エラー修正
+- **リファクタリング**：重複コード検出 → 共通関数化
+- **DB 変更**：スキーマ更新が必要 → 確認要求「テーブル構造を変更しますか？」
+
+## 継続改善
+
+- 新パターン検出 → 即座に学習・適用
+- フィードバック → 次回実行に自動反映
+- ベストプラクティス → 随時更新

package/lib/assets/Dockerfile

@@ -0,0 +1,77 @@
+# ベースイメージとして Ubuntu 22.04 を使用
+FROM ubuntu:22.04 AS base
+
+# 環境変数の設定
+ENV DEBIAN_FRONTEND=noninteractive \
+    LANG=ja_JP.UTF-8 \
+    LC_ALL=ja_JP.UTF-8 \
+    LC_CTYPE=ja_JP.UTF-8 \
+    NODE_VER=22
+
+# ユーザーの設定
+ARG USERNAME=developer
+ARG USER_UID=1000
+ARG USER_GID=$USER_UID
+
+RUN groupadd --gid $USER_GID $USERNAME \
+    && useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
+    #
+    # [Optional] Add sudo support. Omit if you don't need to install software after connecting.
+    && apt-get update \
+    && apt-get install -y sudo \
+    && echo $USERNAME ALL=\(root\) NOPASSWD:ALL > /etc/sudoers.d/$USERNAME \
+    && chmod 0440 /etc/sudoers.d/$USERNAME
+
+# ロケールのセットアップ
+RUN apt-get update && apt-get install -y \
+    language-pack-ja-base \
+    language-pack-ja \
+    && update-locale LANG=ja_JP.UTF-8 LANGUAGE=ja_JP:ja \
+    && rm -rf /var/lib/apt/lists/*
+
+# 基本的なパッケージのインストール
+ RUN apt-get update && \
+     apt-get install -y \
+            build-essential \
+            zip \
+            unzip \
+            git \
+            curl \
+            wget \
+            vim \
+            tmux \
+            && apt-get clean \
+            && rm -rf /var/lib/apt/lists/*
+
+# Node.jsのインストール
+RUN curl -fsSL https://deb.nodesource.com/setup_18.x | bash - \
+    && apt-get install -y nodejs \
+    && npm install -g yarn \
+    && mkdir -p /home/$USERNAME/.nvm \
+    && chown -R $USERNAME:$USERNAME /home/$USERNAME/.nvm \
+    && echo '#!/bin/bash\n\
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.37.2/install.sh | bash\n\
+. /home/'$USERNAME'/.nvm/nvm.sh\n\
+nvm install "'$NODE_VER'"\n\
+nvm use "'$NODE_VER'"' > /tmp/nvm_install.sh \
+    && chmod +x /tmp/nvm_install.sh \
+    && su - $USERNAME -c /tmp/nvm_install.sh \
+    && rm /tmp/nvm_install.sh
+
+# Gemini CLIのインストール
+RUN npm install -g @google/gemini-cli
+
+# Claude Codeのインストール
+RUN npm install -g @anthropic-ai/claude-code
+
+# すべてのインストールが完了した後、ユーザーのホームディレクトリの所有権を確保
+RUN chown -R $USERNAME:$USERNAME /home/$USERNAME
+
+# 作業ディレクトリの設定
+WORKDIR /srv
+
+# ユーザーを設定したユーザーに切り替える
+USER $USERNAME
+
+# デフォルトのシェルを bash に設定
+SHELL ["/bin/bash", "-c"]

package/lib/assets/README.md

@@ -0,0 +1,51 @@
+# {project-name}
+
+## 概要
+
+### 目的
+
+### 前提
+
+| ソフトウェア | バージョン | 備考 |
+| :----------- | :--------- | :--- |
+| nodejs       | 12.12.0    |      |
+
+## 構成
+
+- [構築](#構築)
+- [配置](#配置)
+- [運用](#運用)
+- [開発](#開発)
+
+## 詳細
+
+### Qick Start
+
+```bash
+npm install
+npm start
+```
+
+### 構築
+
+```bash
+claude mcp add github npx @modelcontextprotocol/server-github -e GITHUB_PERSONAL_ACCESS_TOKEN=xxxxxxxxxxxxxxx
+claude mcp add --transport http byterover-mcp --scope user https://mcp.byterover.dev/v2/mcp
+claude mcp add github npx -y @modelcontextprotocol/server-github -s project  
+```
+
+**[⬆ back to top](#構成)**
+
+### 配置
+
+**[⬆ back to top](#構成)**
+
+### 運用
+
+**[⬆ back to top](#構成)**
+
+### 開発
+
+**[⬆ back to top](#構成)**
+
+## 参照

package/lib/assets/docker-compose.yml

@@ -0,0 +1,22 @@
+services:
+  mkdocs:
+    build:
+      context: .
+      dockerfile: ./docs/Dockerfile
+    environment:
+        PLANTUML_SERVER_URL: http://plantuml:8080/plantuml
+    volumes:
+      - ./docs:/docs/docs
+      - ./README.md:/docs/README.md
+      - ./mkdocs.yml:/docs/mkdocs.yml
+      - ./site:/docs/site
+    ports:
+      - "8000:8000"
+    command: mkdocs serve --dev-addr=0.0.0.0:8000
+    links:
+      - plantuml
+
+  plantuml:
+    image: plantuml/plantuml-server:jetty
+    environment:
+      BASE_URL: plantuml

package/lib/assets/docs/Dockerfile

@@ -0,0 +1,19 @@
+FROM python:3.11-slim
+
+WORKDIR /docs
+
+# Install MkDocs and necessary plugins
+RUN pip install --no-cache-dir \
+    mkdocs \
+    mkdocs-material \
+    pymdown-extensions \
+    plantuml-markdown
+
+# Copy configuration and docs
+COPY mkdocs.yml /docs/
+
+# Expose the MkDocs development server port
+EXPOSE 8000
+
+# Start MkDocs development server
+CMD ["mkdocs", "serve", "--dev-addr=0.0.0.0:8000"]