프로덕션 테스트된 Claude Code 인프라의 엄선된 참고 라이브러리.

복잡한 TypeScript 마이크로서비스 프로젝트를 6개월간 실제 환경에서 관리하며 탄생한 이 쇼케이스는 “스킬이 자동으로 활성화되지 않는다” 문제를 해결하고 기업 개발을 위한 확장형 Claude 코드를 제시합니다.

이것은 작동하는 애플리케이션이 아닙니다 - 참고 라이브러리입니다. 필요한 것을 자신의 프로젝트에 복사하세요.

Claude 코드 인프라가 처음이신가요? 세 가지 용어가 이 README의 90%를 포함합니다:

• Skill - Claude가 관련 시 로드하는 마크다운 가이드(패턴, 관습, 예제)
• 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