Stats
Actions
Tags
From project-init
프로젝트 초기화 스킬 — 새 프로젝트를 시작할 때 docs/ 폴더 구조 생성, CLAUDE.md 작성, 개발 원칙 세팅을 한 번에 처리한다. "/project-init", "프로젝트 초기화", "프로젝트 시작", "init project", "프로젝트 세팅해줘", "개발 환경 초기화", "프로젝트 구조 잡아줘" 등의 요청에 반드시 이 스킬을 사용한다. 단순한 파일 생성 요청이더라도 프로젝트 시작 맥락이라면 이 스킬을 사용한다.
How this skill is triggered — by the user, by Claude, or both
Slash command
/project-init:project-initThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
새 프로젝트를 시작할 때 필요한 문서 구조와 개발 원칙을 한 번에 세팅한다.
assets/templates/CLAUDE.mdassets/templates/README.mdassets/templates/agents/backend.mdassets/templates/agents/deeplearning.mdassets/templates/agents/frontend.mdassets/templates/agents/verifier.mdassets/templates/checklist.mdassets/templates/context_note.mdassets/templates/docs/completion_report.mdassets/templates/docs/constraints.yamlassets/templates/docs/decisions.mdassets/templates/docs/deployment_guide.mdassets/templates/docs/glossary.yamlassets/templates/docs/plan.mdassets/templates/docs/retrospective.mdassets/templates/docs/technical_doc.mdassets/templates/scripts/validate_arch.pyassets/templates/tasks/todo.md새 프로젝트를 시작할 때 필요한 문서 구조와 개발 원칙을 한 번에 세팅한다.
가장 먼저 아래 명령을 실행한다. 이 명령 하나만 사용자가 승인하면 이후 모든 파일 생성·Bash 명령은 자동 승인된다.
touch /tmp/.claude_init_in_progress
이 파일이 존재하는 동안 PermissionRequest 훅이 Write/Edit/Bash 작업을 자동 승인한다.
현재 디렉토리를 탐색해서 프로젝트 성격을 파악한다.
package.json, requirements.txt, go.mod, Cargo.toml 등)docs/ 또는 CLAUDE.md 가 이미 있는지기존 코드가 있는 경우: 파악한 내용을 한 줄로 요약한다. 그 다음 기존 문서 선별 단계를 진행한다:
아래 파일이 존재하면 전부 읽는다:
CLAUDE.mddocs/ 내 모든 .md 파일tasks/ 내 파일 (있으면)읽은 내용을 3범주로 분류한다:
| 범주 | 기준 | 처리 |
|---|---|---|
| keep | 우리 규칙에 맞는 내용, 프로젝트 고유 정보 (버그·제약·결정 배경 등) | 새 템플릿의 올바른 섹션에 삽입 |
| transform | 내용은 유효하나 형식·위치가 다른 것 | 우리 규칙에 맞게 재작성 후 삽입 |
| discard | 중복·자명한 원칙·코드로 파악 가능한 내용 | 제거 |
분류 결과를 사용자에게 반드시 명시적으로 보고한다:
## 기존 문서 선별 결과
### ✅ 유지 (keep)
- [내용 요약] → [이동할 섹션]
### 🔄 변환 (transform)
- [기존 내용] → [변환 방향]
### 🗑️ 제거 (discard)
- [내용] — 제거 이유: [이유]
AskUserQuestion 툴로 확인한다:
["이대로 진행합니다 (Recommended)", "유지/제거 목록을 조정하겠습니다"]승인 후 새 템플릿에 선별된 내용을 반영해 파일을 생성한다.
빈 프로젝트인 경우: AskUserQuestion 툴로 최대 4개씩 나눠 묻는다.
첫 번째 호출 (기술 스택 + 명령어):
["Python / FastAPI", "TypeScript / Next.js", "Go", "기타 (직접 입력)"]["알고 있습니다 (직접 입력)", "모름 — TBD로 남겨주세요"]["없습니다", "있습니다 (직접 입력)"]프로젝트 이름·목적 등 순수 텍스트 정보는 AskUserQuestion 응답 후 추가로 물어보거나, 첫 대화에서 이미 언급된 경우 그대로 사용한다.
사용자 답변을 받은 후 다음 단계로 진행한다. 빌드/테스트 명령어를 모른다고 하면 해당 항목을 # TBD 로 채워둔다.
아래 파일들을 생성한다. 이미 파일이 존재하면 AskUserQuestion 툴로 덮어쓰기 여부를 확인한다:
README.md ← 프로젝트 소개 (기능 완료 시 업데이트)
CLAUDE.md ← AI 협업 규칙 (100줄 이내)
.claude/
├── settings.json ← design-precheck + PostCompact hook 등록
├── rules/
│ └── code-style.md ← 코드 스타일 규칙 (코드 파일 편집 시 자동 로드)
├── memory/
│ ├── lessons.md ← 행동 교정 패턴 누적 (사용자 교정 발생 시 업데이트)
│ └── workflow.md ← TDD·Phase gate·위임 규칙 (읽기 전용)
├── hooks/
│ ├── time_context.py ← 시간 키워드 감지 → 현재 KST 시각 자동 주입
│ ├── design-precheck.py ← 설계 키워드 감지 → 체크리스트 출력
│ ├── post-compact.py ← /compact 후 CLAUDE.md 핵심 섹션 재주입
│ └── cleanup_suggest.py ← 세션 종료 시 임시 파일 감지 → 정리 제안
└── skills/ ← 재사용 절차 보관 디렉토리
└── .gitkeep
.githooks/
├── pre-commit ← CLAUDE.md 린트 자동 실행 + decisions.md 보호 + 임시 파일 커밋 차단
├── pre-push ← scripts/validate_arch.py 실행
└── post-checkout ← clone 후 core.hooksPath 자동 설정
docs/
├── plan.md ← 개발 계획 (Phase/Sprint 로드맵)
├── decisions.md ← 설계 결정 로그 (D-번호 append-only)
├── constraints.yaml ← 의존성·아키텍처 제약 SSOT
├── glossary.yaml ← 용어 규범 SSOT
├── context_note.md ← 맥락 노트 (개발 전 작성)
├── checklist.md ← 체크리스트 (verifier가 소단위마다 업데이트)
├── technical_doc.md ← 기술 문서 (verifier가 소단위마다 누적)
├── completion_report.md ← 완료 보고서 (verifier가 소단위마다 누적)
├── deployment_guide.md ← 배포 가이드 (개발 중 누적 → 완료 후 정리)
├── specs/ ← 상세 명세 디렉토리
│ └── .gitkeep
└── debug/ ← 디버깅 패치 노트
└── .gitkeep
tasks/
└── todo.md ← 세션별 작업 계획 (복잡한 작업 시작 시 작성)
scripts/
└── validate_arch.py ← pre-push 아키텍처 제약 검증
.claude/agents/
└── verifier.md ← 기능 검증 전담 서브에이전트
.claude/
└── plan_gate_enabled ← plan-gate 활성화 플래그 (반드시 마지막에 생성)
각 문서 파일 내용은 아래 템플릿 섹션을 참고한다. 프로젝트 이름, 날짜(KST 기준), 기술 스택을 템플릿에 채워 넣는다.
verifier.md는 모든 문서 파일 생성이 완료된 후 assets/templates/agents/verifier.md 템플릿을 읽어 .claude/agents/verifier.md로 생성한다.
.claude/plan_gate_enabled 파일은 모든 파일 생성이 완료된 가장 마지막 단계에 생성한다. 이 파일 존재 여부가 plan-gate 활성화 트리거이므로, 반드시 가장 마지막에 생성해야 project-init 실행 중 plan-gate가 조기 발동되지 않는다.
파일 생성은 아래 순서를 지킨다. 순서를 어기면 중간에 plan-gate가 발동되거나 훅이 settings.json 없이 등록될 수 있다.
.claude/ 디렉토리 구조 생성 (mkdir).claude/settings.json — 훅 등록 파일. 훅 스크립트보다 먼저 생성하지 않으면 Claude가 훅 없이 실행될 수 있음.claude/rules/code-style.md — 코드 스타일 규칙.claude/memory/lessons.md, .claude/memory/workflow.md — 메모리 파일.claude/hooks/time_context.py, design-precheck.py, post-compact.py, cleanup_suggest.py — 훅 스크립트 (settings.json 등록 대상).claude/agents/verifier.md — 모든 hook 스크립트 생성 후 마지막으로 생성docs/, tasks/, scripts/, .githooks/, README.md, CLAUDE.md — 문서·스크립트 계층 (순서 무관).claude/plan_gate_enabled — 반드시 마지막. 이 파일이 생성된 순간부터 plan-gate가 활성화된다CLAUDE.md는 100줄 이내로 유지한다. Anthropic 공식 권장 원칙을 따른다:
포함할 것 (코드를 읽어도 알 수 없는 것만):
제외할 것:
.claude/rules/code-style.md에 이미 있는 내용 (매직넘버 금지, 하드코딩 금지, 파일 크기 제한 등) — 중복 금지각 줄 작성 기준: "이게 없으면 Claude가 실수할까?" — 아니라면 삭제한다.
템플릿(assets/templates/CLAUDE.md)을 기반으로 아래 항목을 실제 값으로 채워 생성한다:
{{PROJECT_NAME}} — 프로젝트명{{TECH_STACK}} — 기술 스택 (언어, 프레임워크, DB 등){{PROJECT_DESCRIPTION}} — 프로젝트 목적 한 줄 요약{{PROJECT_STRUCTURE}} — 핵심 디렉토리 구조 (3~5줄 이내){{BUILD_COMMAND}} — 빌드 명령어 (없으면 해당 줄 제거){{TEST_COMMAND}} — 전체 테스트 실행 명령어{{TEST_SINGLE_COMMAND}} — 단일 테스트 실행 명령어{{LINT_COMMAND}} — 린트 명령어 (없으면 해당 줄 제거)이미 CLAUDE.md가 있으면:
["덮어쓰기 (Recommended)", "건드리지 않고 넘어가기"]모든 파일 생성이 끝나면 신호 파일을 삭제해 정상 모드로 복귀한다:
rm /tmp/.claude_init_in_progress
먼저 Prompt Log 수집 동의 요청을 진행한다 (prompt-log 플러그인이 설치된 경우):
AskUserQuestion 툴로 동의를 받는다:
["동의합니다 (Recommended)", "동의하지 않습니다"]사용자 응답 처리:
.claude/prompt-log-consent 파일 생성 (내용: 현재 시각 ISO8601, 1줄)~/.claude/prompt-log/projects-allowed.json 에 항목 추가 — 파일이 없으면 새로 생성:
[
{
"abs_path": "<프로젝트 절대경로>",
"project_name": "<basename>",
"consent_at": "<ISO8601 KST>"
}
]
이 동의 요청은 prompt-log 플러그인이 추가한 통합 단계이며, 플러그인 제거 시 본
SKILL.md 의 <!-- >>> [prompt-log] --> 마커로 감싸진 부분만 제거하면 된다.
⚠️ verifier 인식 — 세션 재시작 필요
.claude/agents/verifier.md는 Claude Code 세션 시작 시 한 번만 스캔된다. project-init으로 막 생성된 verifier는 현재 세션에서 @verifier로 호출되지 않는다. 다음 중 하나로 적용한다:
- (권장) Claude Code 재시작 —
claude --continue로 대화를 유지하며 재시작- 재시작이 어려우면
.claude/memory/workflow.md의 'verifier fallback' 절차 사용
생성된 파일 목록을 보여주고, 사용자에게 다음을 안내한다:
docs/plan.md 에서 개발 계획(Phase/Sprint 로드맵)을 채워달라고docs/context_note.md 에서 프로젝트 배경/맥락을 기록해달라고docs/checklist.md 를 함께 작성하자고docs/decisions.md 에 D-번호로 기록해달라고 (D-001은 초기화 시 자동 생성)docs/glossary.yaml 에 추가해달라고문서 업데이트 자동화 흐름도 안내한다:
technical_doc.md, completion_report.md, checklist.md 는 @verifier가 소단위 완료마다 자동 업데이트deployment_guide.md 는 개발 중 환경 관련 내용을 수시로 기록, 완료 후 정리README.md 는 기능 완료 시 직접 업데이트 (새 기능·API 변경·사용법 변경 시)retrospective.md 는 초기화 시 생성하지 않는다 — 사용자 완료 사인 후 assets/templates/retrospective.md 템플릿으로 생성한다Git hook 설정 안내 (git 저장소인 경우):
git config core.hooksPath .githooks
chmod +x .githooks/pre-commit .githooks/pre-push
pre-commit: CLAUDE.md 린트 명령어 자동 실행pre-push: docs/constraints.yaml 기반 아키텍처 위반 검사4계층 규칙 분산 구조 안내:
CLAUDE.md — 프로젝트 특화 규칙 (100줄 이내).claude/rules/code-style.md — 상세 코드 규칙 (코드 파일 편집 시 자동 로드).claude/memory/lessons.md — 교정 패턴 누적 (세션 시작 시 복습)docs/constraints.yaml — 의존성·아키텍처 제약 + 임시 파일 네이밍 규칙 SSOT임시 파일 네이밍 규칙 (docs/constraints.yaml > temp_patterns):
tmp_, scratch_, debug_, exp_ (예: tmp_analysis.py, debug_output.csv)_tmp, _scratch, _debug (예: result_tmp.csv, weights_debug.pt)tmp/, scratch/, .experiments/그리고 아래 개발 워크플로우를 사용자에게 명시적으로 안내한다:
검증 워크플로우 소단위 작업이 완료될 때마다 구현자가 직접 검증하지 않는다. 반드시
@verifier서브에이전트에게 검증을 위임한다.흐름: 구현 완료 →
@verifier호출 → 검증 보고서 확인 →docs/checklist.md업데이트verifier는 독립적인 시각으로 기능을 검증하고 문제를 보고하는 역할이며, 수정은 하지 않는다. 수정은 메인 에이전트(구현자)의 몫이다.
plan-gate — 슬래시 커맨드 가이드
plan-gate는 큰 변경이 검토 없이 진행되는 것을 막는 자동 게이트다.
Edit/Write/MultiEdit 3회,영향 파일 3개,MultiEdit 5항목중 하나라도 초과하면 PreToolUse 훅이 차단하고 git tag + git stash로 체크포인트를 자동 생성한다.[공식 Plan Mode 사용 시] 자동 승인 플로우:
Plan Mode로 계획 → tasks/todo.md 작성 → 사용자 Accept → 첫 Edit 시 plan-gate가 tasks/todo.md 감지 → 자동 승인 (무중단) (/approve-plan 불필요)[권장] 작업 시작 전 선승인 플로우:
tasks/todo.md 계획 작성 → /approve-plan → 작업 시작 (무중단)[자동 차단됐을 때] 플로우:
차단됨 → Claude가 tasks/todo.md 계획 작성 → 사용자 검토 → /approve-plan 계획 승인, 작업 재개 → /replan 계획 수정 후 다시 /approve-plan → /rollback 체크포인트로 전체 되돌리기[scope creep 차단됐을 때] 플로우 (승인 후 편집 횟수 초과):
→ /done 현재까지 완료로 마감 → /replan 계획 갱신 후 /approve-plan으로 계속 → /rollback 전체 되돌리기[verifier 검증 후] 플로우:
✅ → /done 체크포인트 정리, gate 종료 ❌ → /retry 같은 체크포인트에서 재구현 (카운터 누적) → /rollback 이번 시도 전체 폐기커맨드 한눈에 보기:
커맨드 언제 효과 /plan-gate-onplan-gate 켜기 .claude/plan_gate_enabled생성/plan-gate-offplan-gate 끄기 .claude/plan_gate_enabled삭제/approve-plan계획 확정 후 (시작 전 or 차단 후) gate → approved /replan계획 재작성 필요 시 카운터 리셋, 체크포인트 유지 /done작업 완료 시 체크포인트 삭제, gate 종료 /retryverifier ❌ 후 재구현 approved 복귀, 카운터 누적 /rollback전체 되돌릴 때 git reset → checkpoint
assets/templates/CLAUDE.md 파일을 읽어 사용한다.
assets/templates/README.md 파일을 읽어 사용한다.
assets/templates/.claude/settings.json 파일을 읽어 .claude/settings.json으로 생성한다.
assets/templates/agents/verifier.md 파일을 읽어 사용한다.
assets/templates/.claude/rules/code-style.md 파일을 읽어 .claude/rules/code-style.md로 생성한다.
assets/templates/.claude/memory/lessons.md 파일을 읽어 .claude/memory/lessons.md로 생성한다.
assets/templates/.claude/memory/workflow.md 파일을 읽어 .claude/memory/workflow.md로 생성한다.
assets/templates/.claude/hooks/time_context.py 파일을 읽어 .claude/hooks/time_context.py로 생성한다.
assets/templates/.claude/hooks/design-precheck.py 파일을 읽어 .claude/hooks/design-precheck.py로 생성한다.
assets/templates/.claude/hooks/post-compact.py 파일을 읽어 .claude/hooks/post-compact.py로 생성한다.
assets/templates/.claude/hooks/cleanup_suggest.py 파일을 읽어 .claude/hooks/cleanup_suggest.py로 생성한다.
assets/templates/.githooks/pre-commit 파일을 읽어 .githooks/pre-commit으로 생성한다.
assets/templates/.githooks/pre-push 파일을 읽어 .githooks/pre-push로 생성한다.
assets/templates/.githooks/post-checkout 파일을 읽어 .githooks/post-checkout으로 생성한다.
chmod +x를 실행해 실행 권한을 부여한다.
assets/templates/docs/plan.md 파일을 읽어 사용한다.
assets/templates/docs/decisions.md 파일을 읽어 사용한다.
assets/templates/docs/constraints.yaml 파일을 읽어 사용한다.
assets/templates/docs/glossary.yaml 파일을 읽어 사용한다.
assets/templates/context_note.md 파일을 읽어 docs/context_note.md로 생성한다.
assets/templates/checklist.md 파일을 읽어 docs/checklist.md로 생성한다.
assets/templates/docs/technical_doc.md 파일을 읽어 사용한다.
assets/templates/docs/completion_report.md 파일을 읽어 사용한다.
assets/templates/docs/deployment_guide.md 파일을 읽어 사용한다.
assets/templates/docs/retrospective.md 파일을 읽어 사용한다.
assets/templates/scripts/validate_arch.py 파일을 읽어 scripts/validate_arch.py로 생성한다.
assets/templates/tasks/todo.md 파일을 읽어 사용한다.
{{PROJECT_NAME}}, {{DATE}}, {{TECH_STACK}} 등의 자리표시자는 실제 값으로 교체한다npx claudepluginhub hunminkim/claude --plugin project-initFetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Applies a firm's KYC/AML rules grid to parsed onboarding records: assigns risk rating, checks required documents, outputs rule outcomes with citations, and routes for escalation.
Generates daily or weekly digests of activity from connected sources (chat, email, docs, tasks, CRM), highlighting action items, decisions, mentions, and project updates.