Claude Code GitHub Template

Claude Code の上級者向け設定テンプレート。Hooks、MCP、マルチエージェントを活用した本格的な開発環境を即座にセットアップできます。

Quick Start

# 1. テンプレートをクローン
git clone https://github.com/YOUR_USERNAME/claude-code-github-template.git my-project
cd my-project

# 2. セットアップスクリプトを実行
./scripts/setup.sh

# 3. MCP サーバーをインストール（オプション）
./scripts/install-mcp.sh

Structure

.claude/                    # 汎用ベース設定
├── CLAUDE.md              # プロジェクトルール
├── settings.json          # 権限・Hooks 設定
├── commands/              # カスタム slash commands
└── hooks/                 # 自動化スクリプト

docs/                       # 凝縮ドキュメント
├── quick-reference.md     # ショートカット一覧
├── workflow-patterns.md   # ワークフローパターン
├── mcp-setup.md          # MCP 設定ガイド
└── resources.md          # コミュニティリソース

examples/                   # ドメイン別設定
├── saas-development/      # SaaS 開発向け
├── kaggle-ml/            # Kaggle/ML 向け
└── academic-research/    # 学術研究向け

Features

Slash Commands

Command	Description
/plan	Explore → Plan → Code → Commit ワークフロー
/review	コードレビュー実行
/test	テスト実行・修正ループ
/security-scan	OWASP ベースセキュリティ監査

Hooks

• PreToolUse: コミット前の lint/test 検証
• PostToolUse: Write/Edit 後の自動フォーマット

MCP Integration

Server	Purpose
Context7	最新ライブラリドキュメント取得
Sequential Thinking	複雑な計画立案
GitHub MCP	PR/Issues 管理

Domain Examples

SaaS Development

TDD、API 設計、デプロイ自動化に特化。

cp -r examples/saas-development/.claude/* .claude/

Kaggle/ML

CV 戦略、アンサンブル、実験管理に特化（PyTorch Lightning 対応）。

cp -r examples/kaggle-ml/.claude/* .claude/

Academic Research

LaTeX、再現性、論文投稿に特化。

cp -r examples/academic-research/.claude/* .claude/

Sync to Existing Projects

既存プロジェクトへの設定同期には sync-claude-config.sh を使用：

# インタラクティブモード
./scripts/sync-claude-config.sh

# Kaggle 設定を現在のプロジェクトに同期
./scripts/sync-claude-config.sh -d kaggle-ml -t /path/to/your-project

# dry-run で変更内容を確認
./scripts/sync-claude-config.sh -d saas-development -n

# commands のみ同期
./scripts/sync-claude-config.sh -d kaggle-ml -c

オプション

Option	Description
-d, --domain	使用するドメイン (kaggle-ml, saas-development, academic-research)
-t, --target	対象ディレクトリ（デフォルト: カレント）
-c, --commands	commands/ のみ同期
-a, --agents	agents/ のみ同期
-k, --hooks	hooks/ のみ同期
-m, --claude-md	CLAUDE.md も同期（カスタマイズを上書き）
-n, --dry-run	変更せず確認のみ

環境変数

# テンプレートの場所を指定
export CLAUDE_TEMPLATE_DIR="$HOME/claude-code-tips/claude-code-github-template"

Customization

CLAUDE.md

プロジェクト固有のルールを追加：

## Operational Instructions
- Build: `npm run build`
- Test: `npm run test`

## Architectural Invariants
- Database imports NOT in /src/ui/*

settings.json

権限とフックをカスタマイズ：

{
  "permissions": {
    "allow": ["Bash(npm:*)"],
    "deny": ["Bash(rm -rf:*)"]
  }
}

References

• Claude Code 公式ドキュメント
• Best Practices (Anthropic)
• awesome-claude-code

License

MIT