本番環境でテストされたClaudeコードのインフラを厳選したリファレンスライブラリ。

複雑なTypeScriptマイクロサービスプロジェクトを6か月間実務で管理してきたこのショーケースは、「スキルは自動的に起動しない」問題を解決したパターンとシステム、そしてエンタープライズ開発のためのスケールアップされたClaude Codeを提供します。

これは動作するアプリケーションではありません これは参考ライブラリです。必要なものを自分のプロジェクトにコピーしてください。

Claude Codeのインフラは初めてですか?このREADMEの90%を3つの用語でカバーしています:

• Skill - Claudeが関連する時に読み込むマークダウンガイド(パターン、慣例、例)です
• Hook - 重要な瞬間(すべてのプロンプト、編集前後)で自動的に実行されるスクリプト Claude Code
• skill-rules.json - どのプロンプトやファイルがどのスキルをトリガーするかをフックに伝える設定

詳細は「Key Concepts」にあります。

---

中身は何だ

本番環境でテスト済みのインフラストラクチャ:

• ✅ フックによる自動発動スキル
• ✅ モジュラースキルパターン(500行ルールと漸進的開示)
• ✅ 複雑なタスクのための専門エージェント
• ✅ コンテキストリセットを経ても生き残る開発ドキュメントシステム
• ✅ 一般的なブログドメインを用いた包括的な例

Claude Code Infrastructure Showcase

A curated reference library of production-tested Claude Code infrastructure.

Born from 6 months of real-world use managing a complex TypeScript microservices project, this showcase provides the patterns and systems that solved the “skills don’t activate automatically” problem and scaled Claude Code for enterprise development.

This is NOT a working application - it’s a reference library. Copy what you need into your own projects.

New to Claude Code infrastructure? Three terms cover 90% of this README:

• Skill - a markdown guide (patterns, conventions, examples) that Claude loads when relevant
• Hook - a script Claude Code runs automatically at key moments (every prompt, before/after edits)
• skill-rules.json - the config that tells hooks which prompts/files should trigger which skills

Full explanations in Key Concepts.

---

What’s Inside

Production-tested infrastructure for:

• ✅ Auto-activating skills via hooks
• ✅ Modular skill pattern (500-line rule with progressive disclosure)
• ✅ Specialized agents for complex tasks
• ✅ Dev docs system that survives context resets
• ✅ Comprehensive examples using generic blog domain

Time investment to build: 6 months of iteration Time to integrate into your project: 15-30 minutes

---

Quick Start

Requirements

• Node.js 18+ (20+ recommended) and npm
• macOS, Linux, or WSL2 - the hooks are bash scripts and won’t run in plain cmd/PowerShell (Windows users: use WSL2)
• jq - only needed if you enable the optional Stop hooks

Note: the first npx tsx run may ask to install tsx - say yes.

Option A: Setup Wizard (Recommended)

The wizard copies everything, installs dependencies, and configures your mode:

# 1. Clone this repo
git clone https://github.com/diet103/claude-code-infrastructure-showcase.git

# 2. Run the setup wizard, pointing to YOUR project
cd claude-code-infrastructure-showcase
npx tsx setup.ts ~/my-project

The wizard will:

• Copy .claude/ (hooks, skills, agents, commands) into your project
• Detect your tech stack (React, Express, Prisma, etc.)
• Ask: Classic (regex-only) or AI-Enhanced mode?
• If AI: which provider? Validates API key availability
• Install hook dependencies and make scripts executable
• Verify its own work - 8 health checks before it declares success

Scripting it, or letting Claude Code run it? Add --yes: npx tsx setup.ts ~/my-project --yes (see --help for all flags)

Option B: Manual (3 Commands)

# 1. Clone this repo
git clone https://github.com/diet103/claude-code-infrastructure-showcase.git

# 2. Copy .claude/ into YOUR project
cp -r claude-code-infrastructure-showcase/.claude ~/my-project/.claude

# 3. Install hook dependencies
cd ~/my-project/.claude/hooks && npm install && chmod +x *.sh