/init-project 상세 분석 — Deep Project Analysis for Claude Code

Comparison

/init vs /init-project

built-in command

/init

"프로젝트가 뭔지" 수준

기본 템플릿 기반 CLAUDE.md 생성
package.json, README에서 정보 추출
빌드/실행 명령만 파악
범용 체크리스트 삽입
코딩 패턴 미분석
기존 .claude/ 설정 덮어쓸 위험
산출물: CLAUDE.md 1개

custom skill

/init-project

"어떻게 코딩하는지" 수준

실제 소스 코드 심층 분석
네이밍, 레이어, 패턴 자동 추출
빌드/테스트 명령 실행 검증
프로젝트 고유 context 생성
backend/frontend/qa 패턴 분리
기존 .claude/ 보존 (append 모드)
산출물: 6개 파일 (.claude/ 트리)

Pipeline

9-Phase Analysis Pipeline

프로젝트 스캔

8개 파일 타입을 감지하여 기술 스택을 파악합니다. 존재 여부만으로 프레임워크와 언어를 확정합니다.

감지 파일	식별 스택
package.json	Node.js / NPM 생태계
pom.xml / build.gradle	Java / Kotlin (Spring Boot)
pubspec.yaml	Flutter / Dart
requirements.txt / pyproject.toml	Python / FastAPI
go.mod	Go
Cargo.toml	Rust
*.csproj	.NET / C#
Dockerfile / docker-compose.yml	컨테이너 환경

심층 구조 분석

디렉토리 트리 → 소스 파일 읽기 → 테스트 파일 읽기 → 설정 파일 읽기의 4단계 순서로 프로젝트 구조를 파악합니다.

디렉토리 트리 탐색

→

핵심 소스 파일 읽기

→

테스트 파일 읽기

→

설정 파일 읽기

CLAUDE.md 생성

프로젝트 전체 컨텍스트를 담는 메인 설정 파일. 기존 파일이 있으면 append 모드로 업데이트하여 기존 설정을 보존합니다.

프로젝트 기술 스택 (버전 포함) 빌드/실행/테스트 명령 (검증됨) 디렉토리 구조 및 주요 모듈 환경변수 목록 배포 방법

backend-patterns.md

백엔드 코드에서 추출한 7개 패턴 항목. 실제 코드를 분석하여 구체적인 예시를 포함합니다.

API 라우팅 구조 레이어 아키텍처 (Controller → Service → Repository) 네이밍 컨벤션 (camelCase, Entity 접미사 등) 에러 처리 패턴 인증/인가 방식 데이터베이스 접근 패턴 테스트 작성 방식

frontend-patterns.md

프론트엔드 코드에서 추출한 6개 분석 항목. 컴포넌트 구조와 상태 관리 방식을 구체적으로 기술합니다.

컴포넌트 구조 (파일명, props 패턴) 상태 관리 방식 (Context, Zustand, Redux 등) API 호출 패턴 (React Query, SWR 등) 스타일링 방식 (Tailwind, CSS Modules 등) 라우팅 구조 폼 처리 방식

qa-strategy.md

프로젝트의 테스트 전략 문서. 기존 테스트 파일을 분석하여 현재 커버리지와 부족한 영역을 파악합니다.

테스트 실행 명령 테스트 유형 (unit / integration / e2e) 커버리지 목표 모킹 전략

auto-issue.md

자동 이슈 생성 스킬 설정. 기술 부채, 버그, 개선 사항을 자동으로 감지하고 GitHub 이슈로 생성하는 규칙을 정의합니다.

이슈 분류 기준 우선순위 결정 로직 라벨 매핑 자동 assignee 설정

qa-scenarios.md

프로젝트 고유 QA 시나리오 모음. 핵심 비즈니스 로직과 사용자 플로우를 기반으로 자동 생성됩니다.

주요 사용자 플로우 엣지 케이스 목록 성능 테스트 기준 접근성 체크포인트

settings.json

Claude Code 동작 설정. 허용/금지 명령, 자동 승인 정책, 에이전트 권한 범위를 프로젝트 맞춤형으로 구성합니다.

allowedCommands 화이트리스트 deniedCommands 블랙리스트 auto-approve 정책 에이전트 권한 스코프

Artifacts

산출물 트리

.claude/

├── 📄 CLAUDE.md — 프로젝트 전체 컨텍스트. 기술 스택, 빌드 명령, 구조 설명

├── 📁 skills/ — 분석에서 추출한 커스텀 스킬 모음

│ ├── 📋 auto-issue.md — 자동 이슈 생성 규칙 및 분류 기준

│ ├── 🔧 backend-patterns.md — API 레이어, 네이밍, 에러 처리 패턴 (7개 항목)

│ ├── 🎨 frontend-patterns.md — 컴포넌트 구조, 상태 관리, 스타일링 패턴 (6개 항목)

│ ├── 🧪 qa-strategy.md — 테스트 전략, 커버리지 목표, 모킹 방식

│ └── 📝 qa-scenarios.md — 프로젝트 고유 QA 시나리오 및 엣지 케이스

└── ⚙️ settings.json — Claude Code 동작 설정 (명령 허용/금지, 권한 스코프)

Specificity

구체성 비교

          /init 결과
          generic
        
# 프로젝트 정보

기술 스택: Spring Boot

빌드:
  mvn clean package

실행:
  mvn spring-boot:run

테스트:
  mvn test

# 일반 가이드라인
- RESTful API 설계 원칙 준수
- 단위 테스트 작성 권장
- 코드 리뷰 필수

          /init-project 결과
          project-specific
        
# 기술 스택 (버전 확정)

Kotlin 1.9.25 + Spring Boot 3.5.5
QueryDSL 7.0 + JPA

레이어 구조:
  Controller → Service → Repository

네이밍:
  - camelCase (변수, 메서드)
  - Entity 접미사 (UserEntity)
  - Dto 접미사 (CreateUserDto)

테스트:
  mvn test -pl module-name

배포:
  ./gradlew bootJar → Docker build

Design

핵심 원칙

원칙 01

제네릭 템플릿 금지

실제 소스 코드를 읽지 않고 생성된 패턴은 무의미합니다. 모든 항목은 실제 파일에서 추출한 증거 기반이어야 합니다.

원칙 02

빌드/테스트 명령 검증

기술된 빌드 명령은 실제로 실행하여 검증합니다. mvn test가 실패하면 올바른 명령을 찾아 수정 후 기록합니다.

원칙 03

기존 .claude/ 보존

이미 설정된 스킬과 패턴을 덮어쓰지 않습니다. 새로운 분석 결과는 기존 설정에 append되거나 섹션별로 병합됩니다.

원칙 04

match-system 수준 구체성

"Spring Boot 사용"이 아닌 "Kotlin 1.9.25 + Spring Boot 3.5.5 + QueryDSL 7.0, Controller → Service → Repository 레이어" 수준으로 기술합니다.

Resources

autoresearch-builder

자율 실험 빌더. /init-project와 연계하여 새 프로젝트를 자동으로 분석하고 최적화 루프를 실행합니다.

github

/init-projectDeep Project Analysisfor Claude Code