setup-claude-code

Claude Code 프로젝트 설정 생성

어떤 프로젝트, 어떤 언어에서든 Claude Code 설정을 자동으로 생성합니다.

지원 언어: TypeScript, JavaScript, Python, Go, Rust, Java, C#, Ruby, PHP 등

사용법

/setup-claude-code [옵션]

옵션:

• minimal: 최소 설정 (CLAUDE.md + 훅)
• standard: 표준 설정 (+ Commands, Agents)
• full: 전체 설정 (+ Skills, MCP, GitHub Action)
• 생략 시: 프로젝트 분석 후 자동 결정

왜 이 커맨드가 필요한가?

문제: Claude Code 설정이 없거나 부족한 프로젝트에서 처음부터 수동 설정은 번거로움
해결: 프로젝트 분석 → 언어/구조에 맞는 초기 설정 자동 생성
결과: CLAUDE.md, .claude/, hooks, permissions 등 한 번에 설정

수행 작업

1단계: 마스터 가이드 참조

반드시 다음 문서를 먼저 읽습니다:

.claude/docs/CLAUDE-CODE-MASTERY.md           # 목차 및 핵심 개념
.claude/docs/mastery/01-settings-guide.md     # 설정 요소별 상세 가이드
.claude/docs/mastery/02-language-templates.md # 언어별 설정 템플릿
.claude/docs/mastery/03-project-structures.md # 프로젝트 구조별 가이드

필요한 내용에 따라 해당 파일을 참조합니다.

2단계: 프로젝트 분석

# 분석 대상
1. package.json → 패키지 매니저, 스크립트 확인
2. 폴더 구조 → 모노레포 여부, 모듈 구조
3. 기존 .claude/ → 이미 설정된 항목 확인
4. tsconfig.json → TypeScript 설정
5. .eslintrc / biome.json → 린트 설정
6. .prettierrc → 포맷터 설정

3단계: 기술 스택 파악

항목	확인 방법
패키지 매니저	lockfile 확인 (pnpm-lock.yaml, package-lock.json, bun.lockb)
언어	tsconfig.json 유무, 파일 확장자
프레임워크	package.json dependencies
모노레포	pnpm-workspace.yaml, turbo.json, lerna.json
테스트 도구	vitest, jest, mocha 등

4단계: 설정 규모 결정

## 규모 결정 기준

### Minimal (소규모, 1-3명)
- 단일 패키지
- 간단한 프로젝트

### Standard (중규모, 4-10명)
- 모노레포 또는 복잡한 단일 패키지
- 여러 개발자 협업

### Full (대규모, 10명+)
- 대규모 모노레포
- 여러 도메인
- 외부 시스템 연동 필요

5단계: 파일 생성

5.1 CLAUDE.md 생성 (항상)

# Development Workflow

## 패키지 관리
- **항상 `{detected_package_manager}` 사용**

## 개발 순서
1. 변경 사항 작성
2. 타입체크: `{typecheck_command}`
3. 테스트: `{test_command}`
4. 린트: `{lint_command}`
5. 빌드: `{build_command}`

## 코딩 컨벤션
- `type` 선호, `interface` 자제
- **`enum` 절대 금지** → 문자열 리터럴 유니온 사용
- Zod 스키마로 타입 정의

## 프로젝트 구조
{detected_structure}

## 금지 사항
- ❌ console.log 대신 logger 사용
- ❌ any 타입 사용 금지