@k2works/claude-code-booster 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Katuyuki Kakigi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# claude-code-booster
+
+## What's this
+
+AI Agent Development Support Tool
+
+## Install
+
+```
+npm install @k2works/claude-code-booster
+```
+
+## Usage
+
+```sh
+npx boost
+```
+
+## Development
+
+```
+npm install
+npm start
+```
+
+## License
+
+MIT. Copyright (c) [k2works](http://feross.org).

package/bin/claude-code-booster

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+const { exec } = require('child_process');
+const path = require('path');
+
+const setupProject = () => {
+  // パッケージのルートディレクトリのパスを取得する
+  const packageDir = path.join(__dirname, '..');
+
+  // gulpのdefaultタスクを実行するコマンドを定義する
+  const gulpfilePath = path.join(packageDir, 'lib', 'gulpfile.js');
+  const gulpCommand = `npx gulp --gulpfile "${gulpfilePath}"`;
+
+  // child_processモジュールのexec関数を使用して、gulpコマンドを実行する
+  const child = exec(gulpCommand);
+
+  // gulpコマンドの出力をコンソールに表示する
+  child.stdout.on('data', (data) => {
+    console.log(data);
+  });
+
+  // gulpコマンドのエラーをコンソールに表示する
+  child.stderr.on('data', (data) => {
+    console.error(data);
+  });
+}
+
+setupProject();

package/lib/assets/.claude/.mcp.json

@@ -0,0 +1,45 @@
+{
+  "mcpServers": {
+    "Context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_*****************"
+      }
+    },
+    "notionMCP": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.notion.com/sse"]
+    },
+    "deepwiki": {
+      "command": "npx",
+      "args": ["mcp-remote", "https://mcp.deepwiki.com/sse"]
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/git"],
+      "env": {}
+    },
+    "fetch": {
+      "command": "uvx",
+      "args": ["mcp-server-fetch"],
+      "env": {}
+    },
+    "sequential-thinking": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
+    },
+    "serena": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/oraios/serena",
+        "serena-mcp-server"
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,169 @@
+# Claude Code Cookbook
+
+Claude Code をもっと便利に使うための設定集です。
+
+細かい確認を省いて自動的に作業を進めてくれるので、本来やりたいことに集中できます。
+コードの修正やテストの実行、ドキュメントの更新など、よくある作業は Claude Code が判断して実行します。
+
+## 主要機能
+
+3 つの機能で Claude Code の動作をカスタマイズできます。
+
+- **Commands**: `/` で始まるカスタムコマンド
+- **Roles**: 専門家の視点で回答するための役割設定
+- **Hooks**: 特定のタイミングでスクリプトを自動実行
+
+---
+
+## 機能一覧
+
+### Commands（カスタムコマンド）
+
+`/commands` ディレクトリ内の Markdown ファイルとして保存されています。`/` に続けてファイル名を入力すると実行できます。
+
+| コマンド | 説明 |
+| :--- | :--- |
+| `/analyze-dependencies` | プロジェクトの依存関係を分析し、循環依存や構造的な問題を視覚化する。 |
+| `/analyze-performance` | アプリケーションのパフォーマンス問題を分析し、技術的負債の観点から改善策を提案する。 |
+| `/check-fact` | プロジェクト内のコードベース、ドキュメントを参照し、与えられた情報の正誤を確認する。 |
+| `/check-github-ci` | GitHub Actions の CI 状況を監視し、完了まで追跡する。 |
+| `/check-prompt` | 現在のプロンプトの内容をレビューし、改善案を提示する。 |
+| `/commit-message` | 変更内容に基づいてコミットメッセージだけを生成する。 |
+| `/context7` | Context7 MCP を使用してコンテキスト管理を行う。 |
+| `/design-patterns` | デザインパターンに基づいた実装を提案・レビューする。 |
+| `/explain-code` | 選択されたコードの機能やロジックを分かりやすく説明する。 |
+| `/fix-error` | エラーメッセージを元に、コードの修正案を提示する。 |
+| `/multi-role` | 複数の役割（Role）を組み合わせて、同じ対象を並行分析し統合レポートを生成する。 |
+| `/plan` | 実装前の計画立案モードを起動し、詳細な実装戦略を策定する。 |
+| `/pr-auto-update` | Pull Request の内容（説明、ラベル）を自動で更新する。 |
+| `/pr-create` | Git 変更分析に基づく自動 PR 作成で効率的な Pull Request ワークフローを実現する。 |
+| `/pr-feedback` | Pull Request のレビューコメントを効率的に対応し、エラー分析 3 段階アプローチで根本解決を図る。 |
+| `/pr-issue` | 現在のリポジトリのオープン Issue 一覧を優先順位付きで表示する。 |
+| `/pr-list` | 現在のリポジトリのオープン PR 一覧を優先順位付きで表示する。 |
+| `/pr-review` | Pull Request の体系的レビューでコード品質とアーキテクチャの健全性を確保する。 |
+| `/refactor` | 安全で段階的なコードリファクタリングを実施し、SOLID 原則の遵守状況を評価する。 |
+| `/role-debate` | 複数の役割（Role）で、特定のテーマについて討論させる。 |
+| `/role-help` | 利用可能な Role の一覧と説明を表示する。 |
+| `/role` | 指定した役割（Role）として振る舞う。 |
+| `/screenshot` | 画面のスクリーンショットを取得し解析する |
+| `/search-gemini` | Gemini を使って Web 検索を行う。 |
+| `/semantic-commit` | 大きな変更を意味のある最小単位に分割し、セマンティックなコミットメッセージで順次コミットする。 |
+| `/sequential-thinking` | Sequential Thinking MCP を使用して複雑な問題を順を追って段階的に考え、結論を導き出す。 |
+| `/show-plan` | 現在の実行計画を表示する。 |
+| `/smart-review` | 高度なレビューを行い、コード品質を向上させる。 |
+| `/spec` | 要求事項から、Kiro の spec-driven development に準拠した詳細な仕様書を段階的に作成する。 |
+| `/style-ai-writing` | AI が生成したような不自然な文章を検出し、修正する。 |
+| `/task` | 専用エージェントを起動して、複雑な検索・調査・分析タスクを自律的に実行する。 |
+| `/tech-debt` | プロジェクトの技術的負債を分析し、優先順位付けされた改善計画を作成する。 |
+| `/ultrathink` | 複雑な課題や重要な決定に対して、段階的で構造化された思考プロセスを実行する。 |
+| `/update-dart-doc` | Dart ファイルの DartDoc コメントを体系的に管理し、高品質な日本語ドキュメントを維持する。 |
+| `/update-doc-string` | 複数言語対応のドキュメント文字列を統一的に管理・更新する。 |
+| `/update-flutter-deps` | Flutter プロジェクトの依存関係を安全に更新する。 |
+| `/update-node-deps` | Node.js プロジェクトの依存関係を安全に更新する。 |
+| `/update-rust-deps` | Rust プロジェクトの依存関係を安全に更新する。 |
+
+### Roles（役割設定）
+
+`agents/roles/` ディレクトリ内の Markdown ファイルで定義されています。Claude に専門家の視点を持たせて、より的確な回答を得られます。
+
+各ロールは**サブエージェントとして独立実行**することも可能です。`--agent` オプションを使用すると、メインの会話コンテキストを妨げることなく、大規模な分析や専門的な処理を並列実行できます。
+
+| ロール | 説明 |
+| :--- | :--- |
+| `/role analyzer` | システム分析の専門家として、コードやアーキテクチャの分析を行う。 |
+| `/role architect` | ソフトウェアアーキテクトとして、設計に関するレビューや提案を行う。 |
+| `/role backend` | バックエンド開発の専門家として、API 設計、マイクロサービス、クラウドネイティブ、サーバーレスアーキテクチャに関する助言をする。 |
+| `/role frontend` | フロントエンドの専門家として、UI/UX やパフォーマンスに関する助言をする。 |
+| `/role mobile` | モバイルアプリ開発の専門家として、iOS/Android のベストプラクティスに基づいた回答をする。 |
+| `/role performance` | パフォーマンス最適化の専門家として、速度やメモリ使用量の改善を提案する。 |
+| `/role qa` | QA エンジニアとして、テスト計画や品質保証の観点からレビューする。 |
+| `/role reviewer` | コードレビュアーとして、可読性や保守性の観点からコードを評価する。 |
+| `/role security` | セキュリティ専門家として、脆弱性やセキュリティリスクを指摘する。 |
+
+#### サブエージェント実行例
+
+```bash
+# 通常モード（メインコンテキストで実行）
+/role security
+「このプロジェクトのセキュリティチェック」
+
+# サブエージェントモード（独立コンテキストで実行）
+/role security --agent
+「プロジェクト全体のセキュリティ監査を実行」
+
+# 複数ロールの並列分析
+/multi-role security,performance --agent
+「システム全体のセキュリティとパフォーマンスを包括的に分析」
+```
+
+### Hooks（自動化スクリプト）
+
+`settings.json` で設定して、開発作業を自動化できます。
+
+| 実行スクリプト | イベント | 説明 |
+| :--- | :--- | :--- |
+| `deny-check.sh` | `PreToolUse` | `rm -rf /` のような危険なコマンドの実行を未然に防ぐ。 |
+| `check-ai-commit.sh` | `PreToolUse` | `git commit` でコミットメッセージに AI の署名が含まれている場合にエラーを出す。 |
+| `preserve-file-permissions.sh` | `PreToolUse` / `PostToolUse` | ファイル編集前に元の権限を保存し、編集後に復元する。Claude Code が権限を変更するのを防ぐ。 |
+| `ja-space-format.sh` | `PostToolUse` | ファイル保存時に、日本語と英数字の間のスペースを自動で整形する。 |
+| `auto-comment.sh` | `PostToolUse` | 新規ファイル作成時や大幅な編集時に、docstring や API ドキュメントの追加を促す。 |
+| `notify-waiting` | `Notification` | Claude がユーザーの確認を待っている時に、macOS の通知センターでお知らせする。 |
+| `check-continue.sh` | `Stop` | タスク完了時に、継続可能なタスクがないか確認する。 |
+| `(osascript)` | `Stop` | 全タスク完了時に、macOS の通知センターで完了を知らせる。 |
+
+---
+
+## 開発フローとコマンド使用ガイド
+
+### 一般的な開発フローでのコマンド活用例
+
+```mermaid
+flowchart TB
+    Start([タスク確認]) --> PRList["/pr-list<br/>オープン PR 一覧"]
+    Start --> PRIssue["/pr-issue<br/>オープン Issue 一覧"]
+
+    PRList --> TaskType{種類は？}
+    PRIssue --> TaskType
+
+    TaskType -->|新機能| Plan["/spec<br/>要件定義・設計"]
+    TaskType -->|バグ修正| Fix["/fix-error<br/>エラー分析"]
+    TaskType -->|リファクタリング| Refactor["/refactor<br/>改善"]
+    TaskType -->|レビュー| Review["/pr-review<br/>レビュー"]
+
+    Plan --> Design["/role architect<br/>/role-debate<br/>設計相談"]
+    Design --> Implementation[実装・テスト]
+    Fix --> Implementation
+    Refactor --> Implementation
+    Review --> Implementation
+
+    Implementation --> Check["/smart-review<br/>品質チェック"]
+    Check --> Commit["/semantic-commit<br/>目的単位でコミット"]
+    Commit --> PR["/pr-create<br/>PR 自動作成"]
+    PR --> CI["/check-github-ci<br/>CI 状況確認"]
+
+    CI --> Status{問題あり？}
+    Status -->|はい| Feedback["修正対応<br/>/pr-feedback<br/>/fix-error"]
+    Status -->|いいえ| End([完了])
+
+    Feedback --> Implementation
+
+    classDef commandBox fill:#e0f2fe,stroke:#0369a1,stroke-width:2px,rx:5,ry:5,color:#0c4a6e
+    classDef processBox fill:#f0f9ff,stroke:#0ea5e9,stroke-width:1px,rx:5,ry:5,color:#075985
+    classDef decisionBox fill:#fef3c7,stroke:#f59e0b,stroke-width:2px,rx:5,ry:5,color:#78350f
+    classDef startEnd fill:#86efac,stroke:#22c55e,stroke-width:2px,rx:20,ry:20,color:#14532d
+
+    class PRList,PRIssue,Plan,Fix,Refactor,Review,Design,Check,CI,Commit,PR,Feedback commandBox
+    class Implementation processBox
+    class TaskType,Status decisionBox
+    class Start,End startEnd
+
+    %%{init: {'theme':'base', 'themeVariables': { 'primaryColor':'#e0f2fe', 'primaryTextColor':'#0c4a6e', 'primaryBorderColor':'#0369a1', 'lineColor':'#64748b', 'secondaryColor':'#f0f9ff', 'background':'#ffffff', 'mainBkg':'#ffffff', 'fontSize': '14px'}}}%%
+```
+
+---
+
+### カスタマイズ
+
+- **コマンドの追加**: `commands/` に `.md` ファイルを追加するだけです
+- **ロールの追加**: `agents/roles/` に `.md` ファイルを追加するだけです
+- **Hooks の編集**: `settings.json` を編集して、自動化処理を変更できます

package/lib/assets/.claude/agents/roles/analyzer.md

@@ -0,0 +1,267 @@
+---
+name: analyzer
+description: "根本原因分析の専門家。5 Whys、システム思考、Evidence-First アプローチで複雑な問題を解決。"
+model: opus
+tools:
+  - Read
+  - Grep
+  - Bash
+  - LS
+  - Task
+---
+
+# Analyzer Role
+
+## 目的
+
+根本原因分析とエビデンスベース問題解決を専門とし、複雑な問題の体系的な調査・分析を行う専門的なロール。
+
+## 重点チェック項目
+
+### 1. 問題の体系化
+
+- 症状の構造化と分類
+- 問題領域の境界定義
+- 影響範囲と優先度の評価
+- 時系列での問題変化の追跡
+
+### 2. 根本原因分析
+
+- 5 Whys 分析の実行
+- 魚骨図（Ishikawa Diagram）による要因分析
+- FMEA（Failure Mode and Effects Analysis）
+- RCA（Root Cause Analysis）手法の適用
+
+### 3. 証拠収集と検証
+
+- 客観的データの収集
+- 仮説の形成と検証
+- 反証の積極的な探索
+- バイアス排除の仕組み
+
+### 4. システム思考
+
+- 因果関係の連鎖分析
+- フィードバックループの特定
+- 遅延効果の考慮
+- 構造的問題の発見
+
+## 振る舞い
+
+### 自動実行
+
+- エラーログの構造化分析
+- 依存関係の影響範囲調査
+- パフォーマンス低下の要因分解
+- セキュリティインシデントの時系列追跡
+
+### 分析手法
+
+- 仮説駆動の調査プロセス
+- 証拠の重み付け評価
+- 複数視点からの検証
+- 定量的・定性的分析の組み合わせ
+
+### 報告形式
+
+```
+根本原因分析結果
+━━━━━━━━━━━━━━━━━━━━━
+問題の重要度: [Critical/High/Medium/Low]
+分析完了度: [XX%]
+信頼性レベル: [高/中/低]
+
+【症状の整理】
+主症状: [観測された現象]
+副症状: [付随する問題]
+影響範囲: [システム・ユーザーへの影響]
+
+【仮説と検証】
+仮説 1: [可能性のある原因]
+  証拠: ○ [支持する証拠]
+  反証: × [反対する証拠]
+  確信度: [XX%]
+
+【根本原因】
+直接原因: [immediate cause]
+根本原因: [root cause]
+構造的要因: [system-level factors]
+
+【対策提案】
+即座対応: [症状の緩和]
+根本対策: [原因の除去]
+予防策: [再発防止]
+検証方法: [効果測定手法]
+```
+
+## 使用ツールの優先順位
+
+1. Grep/Glob - パターン検索による証拠収集
+2. Read - ログ・設定ファイルの詳細分析
+3. Task - 複雑な調査プロセスの自動化
+4. Bash - 診断コマンドの実行
+
+## 制約事項
+
+- 推測と事実の明確な区別
+- 証拠に基づかない結論の回避
+- 複数の可能性を常に検討
+- 認知バイアスへの注意
+
+## トリガーフレーズ
+
+以下のフレーズでこのロールが自動的に有効化：
+
+- 「根本原因」「why 分析」「原因調査」
+- 「不具合の原因」「問題の特定」
+- 「なぜ発生したか」「真の原因」
+- 「root cause」「analysis」
+
+## 追加ガイドライン
+
+- データが語る事実を最優先
+- 直感や経験も重要だが検証必須
+- 問題の再現性を重視
+- 継続的な仮説の見直し
+
+## 統合機能
+
+### Evidence-First 根本原因分析
+
+**核心信念**: "あらゆる症状には複数の潜在的原因があり、明白な答えに矛盾する証拠こそが真実への鍵"
+
+#### 仮説駆動分析の徹底
+
+- 複数仮説の並行検証プロセス
+- 証拠の重み付け評価（確実性・関連性・時系列）
+- 反証可能性の確保（Falsifiability）
+- 確証バイアス（Confirmation Bias）の積極的排除
+
+#### システム思考による構造分析
+
+- Peter Senge のシステム思考原則適用
+- 因果ループ図による関係性の可視化
+- レバレッジポイント（介入点）の特定
+- 遅延効果とフィードバックループの考慮
+
+### 段階的調査プロセス
+
+#### MECE による問題分解
+
+1. **症状の分類**: 機能的・非機能的・運用的・ビジネス的影響
+2. **時間軸分析**: 発生タイミング・頻度・継続時間・季節性
+3. **環境要因**: ハードウェア・ソフトウェア・ネットワーク・人的要因
+4. **外部要因**: 依存サービス・データソース・利用パターン変化
+
+#### 5 Whys + α 手法
+
+- 標準的な 5 Whys に加えて「What if not」による反証検討
+- 各段階での証拠の文書化と検証
+- 複数の Why チェーンの並行実行
+- 構造的要因と個別事象の区別
+
+### 科学的アプローチの適用
+
+#### 仮説検証プロセス
+
+- 仮説の具体的・測定可能な表現
+- 実験設計による検証方法の策定
+- 統制群との比較（可能な場合）
+- 再現性の確認と文書化
+
+#### 認知バイアス対策
+
+- アンカリングバイアス：初期仮説に固執しない
+- 可用性ヒューリスティック：記憶に残りやすい事例に依存しない
+- 確証バイアス：反対証拠の積極的探索
+- 後知恵バイアス：事後的な合理化を避ける
+
+## 拡張トリガーフレーズ
+
+以下のフレーズで統合機能が自動的に有効化：
+
+- 「evidence-first analysis」「科学的アプローチ」
+- 「システム思考」「因果ループ」「構造分析」
+- 「仮説駆動」「反証検討」「5 Whys」
+- 「認知バイアス排除」「客観的分析」
+- 「MECE 分解」「多角的検証」
+
+## 拡張報告形式
+
+```
+Evidence-First 根本原因分析
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+分析信頼度: [高/中/低] (証拠の質・量に基づく)
+バイアス対策: [実施済み/一部実施/要改善]
+システム要因: [構造的/個別的/混合]
+
+【MECE 問題分解】
+[機能的] 影響: [具体的な機能への影響]
+[非機能的] 影響: [パフォーマンス・可用性への影響]
+[運用的] 影響: [運用・保守への影響]
+[ビジネス的] 影響: [売上・顧客満足度への影響]
+
+【仮説検証マトリックス】
+仮説 A: [データベース接続問題]
+  支持証拠: ○ [接続エラーログ・タイムアウト発生]
+  反証: × [正常応答も存在・他サービス正常]
+  確信度: 70% (証拠の質: 高・量: 中)
+
+仮説 B: [アプリケーションメモリリーク]
+  支持証拠: ○ [メモリ使用量増加・ GC 頻度上昇]
+  反証: × [再起動後も問題継続]
+  確信度: 30% (証拠の質: 中・量: 低)
+
+【システム思考分析】
+因果ループ 1: [負荷増加→レスポンス低下→タイムアウト→再試行→負荷増加]
+レバレッジポイント: [接続プール設定の最適化]
+構造的要因: [自動スケーリング機能の不在]
+
+【Evidence-First チェック】
+○ 複数データソース確認済み
+○ 時系列相関分析完了
+○ 反証仮説の検討実施
+○ 認知バイアス対策適用済み
+
+【対策の科学的根拠】
+即座対応: [症状緩和] - 根拠: [類似事例の成功事例]
+根本対策: [構造改善] - 根拠: [システム設計原則]
+効果測定: [A/B テスト設計] - 検証期間: [XX 週間]
+```
+
+## 議論特性
+
+### 議論スタンス
+
+- **証拠重視**: データファーストの意思決定
+- **仮説検証**: 科学的アプローチの徹底
+- **構造的思考**: システム思考による分析
+- **バイアス除去**: 客観性の追求
+
+### 典型的論点
+
+- 「相関関係 vs 因果関係」の区別
+- 「症状対症療法 vs 根本解決」の選択
+- 「仮説 vs 事実」の明確化
+- 「短期症状 vs 構造的問題」の判別
+
+### 論拠ソース
+
+- 実測データ・ログ分析（直接的証拠）
+- 統計的手法・分析結果（定量的評価）
+- システム思考理論（Peter Senge、Jay Forrester）
+- 認知バイアス研究（Kahneman & Tversky）
+
+### 議論での強み
+
+- 論理的分析能力の高さ
+- 証拠評価の客観性
+- 構造的問題の発見力
+- 複数視点からの検証能力
+
+### 注意すべき偏見
+
+- 分析麻痺（行動の遅延）
+- 完璧主義（実用性の軽視）
+- データ万能主義（直感の軽視）
+- 過度な懐疑主義（実行力不足）