Skip to main content

Project Init 개요

Project Init는 Claude Code 프로젝트 구조 초기화, 문서 품질 스코어링, 자동 동기화 워크플로우를 제공하는 플러그인입니다. 9개의 슬래시 명령으로 프로젝트 설정부터 문서 관리까지 지원합니다.

구성 요소​

이 플러그인은 upstream(whchoi98/project-init)의 미러입니다 — 로컬 델타는 마켓플레이스 통일 version 하나뿐입니다. 이전에 여기 있던 pr-autofix(에이전트 2개 + 스킬 + 명령)와 decision-reconcile은 co-agent 플러그인으로 이전했습니다(둘 다 멀티-모델 패널을 사용).

에이전트 (1개)​

에이전트설명출력물
doc-sync-checker문서 동기화 분석, 품질 스코어링, 누락 문서 감지품질 점수 보고서

스킬 (1개)​

스킬설명
project-scaffolderClaude Code 프로젝트 구조 패턴 및 컨벤션

명령 (9개)​

명령설명
/init-projectClaude Code 프로젝트 구조 초기화
/sync-docs문서와 코드 동기화
/add-adrArchitecture Decision Record 생성
/add-module모듈 디렉토리 및 CLAUDE.md 추가
/add-runbook운영 런북 생성
/add-reference-doc레이어별 구현 참조 문서 스켈레톤 생성 (docs/reference/)
/generate-readme이중 언어 README.md 생성/업데이트
/generate-changelog이중 언어 CHANGELOG.md 생성/업데이트
/health-check프로젝트 설정 검증 (200점 척도)

워크플로우​

프로젝트 초기화​

문서 동기화​

생성되는 구조​

project/
├── CLAUDE.md                    # 프로젝트 지침 (자동 생성)
├── .claude/
│   ├── settings.json            # 훅 등록
│   ├── hooks/
│   │   ├── check-doc-sync.sh    # PostToolUse 문서 동기화
│   │   ├── secret-scan.sh       # PreToolUse 시크릿 스캔
│   │   ├── session-context.sh   # SessionStart 컨텍스트
│   │   └── notify.sh            # 알림 웹훅
│   ├── skills/                  # 4개 기본 스킬
│   ├── commands/                # 3개 기본 명령
│   └── agents/                  # 2개 기본 에이전트
├── docs/
│   ├── architecture.md          # 이중 언어 아키텍처 문서
│   ├── decisions/               # ADR 디렉토리
│   ├── runbooks/                # 운영 런북
│   └── onboarding.md            # 온보딩 가이드
├── tests/                       # 테스트 프레임워크
│   ├── run-all.sh               # TAP 스타일 테스트 러너
│   └── hooks/                   # 훅 테스트
├── scripts/
│   ├── setup.sh                 # 프로젝트 셋업
│   └── install-hooks.sh         # Git 훅 설치
├── README.md                    # 이중 언어 (EN/KR)
├── CHANGELOG.md                 # 이중 언어 (EN/KR)
└── .editorconfig                # 에디터 설정

Health Check 점수​

점수등급상태
160-200AHEALTHY — 프로젝트가 잘 설정됨
120-159BGOOD — 사소한 개선 필요
80-119CNEEDS ATTENTION — 여러 갭 해결 필요
40-79DPOOR — 중요한 설정 문제
0-39FCRITICAL — 프로젝트 초기화 필요