Кураторская справочная библиотека производственно протестированной инфраструктуры Claude Code.

Созданная в результате 6 месяцев реального опыта управления сложным проектом микросервисов TypeScript, эта витрина предлагает шаблоны и системы, которые решили проблему «навыки не активируются автоматически» и масштабировали Claude Code для корпоративной разработки.

Это НЕ работающее приложение — это справочная библиотека. Копируйте то, что вам нужно, в свои собственные проекты.

Новичок в инфраструктуре Claude Code? Три термина охватывают 90% этого README:

• Skill — руководство по markdown (паттерны, конвенции, примеры), которое Клод загружает по мере необходимости
• Hook — скрипт, который Claude Code запускается автоматически в ключевые моменты (каждый запрос, до/после правок)
• skill-rules.json — конфигурация, которая указывает хукам, какие запросы/файлы должны запускать какие навыки

Полные объяснения в разделе «Ключевые понятия».

---

Что внутри

Производственно протестированная инфраструктура для:

• ✅ Автоматическая активация навыков с помощью крючков
• ✅ Модульный шаблон навыков (правило из 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