on-boarding
星标8
分支2
更新时间2026年7月31日 03:55
프로젝트 구조와 목적을 체계적으로 분석하여 종합적인 온보딩 정보 제공
安装
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
文件资源管理器
2 个文件SKILL.md
readonly
下载
相关职业SOC
基于 SOC 职业分类
菜单
프로젝트 구조와 목적을 체계적으로 분석하여 종합적인 온보딩 정보 제공
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
지정 디렉터리의 문서를 심층 분석하여 지식을 추출하고, 기존 문서 갱신 + 신규 문서 생성으로 프로젝트 지식 베이스에 반영합니다.
기술 의사결정 기록 (Architecture Decision Record). 중요한 기술적 결정의 맥락, 대안, 근거를 구조화하여 기록합니다.
현재 디렉터리의 내용을 분석하여 어떤 목적의 폴더인지 파악
슬랙/메일/메신저로 받은 업무 요청 메시지를 분석하여 의도, 핵심 내용, 판단, 액션 플랜, 대응 가이드를 정리합니다.
비즈니스 규칙, 도메인 규칙, 상태 전이 규칙을 하나의 문서로 관리합니다. 변경 이력이 누적됩니다.
열린 질문, 문제 해결, 기술 의사결정, 아이디어 발산을 구조화합니다. 회의록이나 메모 파일 경로를 인자로 전달하거나 직접 질문하세요.
| name | on-boarding |
| description | 프로젝트 구조와 목적을 체계적으로 분석하여 종합적인 온보딩 정보 제공 |
| when_to_use | 프로젝트 온보딩 분석, 처음 들어온 저장소 파악, 6산출물 생성. 환경 셋업 점검은 setup-guide. |
| argument-hint | [--depth shallow|deep] [--focus area] [--format summary|detailed] |
| disable-model-invocation | true |
| effort | max |
| context | fork |
| allowed-tools | Read, Grep, Glob, Write, AskUserQuestion, Bash(find *), Bash(wc *), Bash(head *), Bash(cat *), Bash(ls *), Bash(mkdir *), Bash(rm *), Bash(rmdir *) |
현재 프로젝트를 체계적으로 분석하여 신규 프로젝트 표준 산출물 (CLAUDE.md, bot/INDEX.md + bot/*.md, human/README.md, .local.claude/biz-rules.md, .local.claude/team.md) 을 생성합니다.
| 데이터 | 경로 | 필수/선택 | 부재 시 동작 |
|---|---|---|---|
| 프로젝트 컨텍스트 | CLAUDE.md | 선택 | 일반 SW 가정으로 진행, [프로젝트 규칙 미확인] 태그 |
| 봇 인덱스 | bot/INDEX.md 또는 .local.claude/ONBOARDING.md | 선택 | 디렉터리 Glob 으로 fallback |
| 비즈니스 규칙 | .local.claude/biz-rules.md | 선택 | Tier 1(도메인 무관) 점검만 수행 |
| 모듈 상세 | .local.claude/modules/{name}.md | 선택 | 코드 Grep 직접 fallback |
| 대상 프로젝트 | pwd 의 파일들 | 필수 | "빈 디렉터리" 안내 후 종료 |
| 기존 CLAUDE.md | 프로젝트 루트 | 선택 | 존재 시 덮어쓰기 전 사용자 확인 |
| 기술 스택 감지 파일 | package.json, pom.xml 등 | 선택 | 사용자 입력 요청 |
| 질문 | 담당 | 이 스킬에서 |
|---|---|---|
| "신규 프로젝트 6산출물 자동 생성" | 이 스킬 | ✓ 핵심 (CLAUDE.md, bot/, human/, biz-rules 와 team 스켈레톤, SETUP.md) |
| "이미 만든 SETUP.md 점검, 갱신, 암묵지식 누적" | /setup-guide | 다루지 않음 (생성은 이 스킬, 이후 유지는 setup-guide) |
| "디렉터리 구조만 스캔과 집계" | /analyze-dir | 다루지 않음 (이 스킬은 산출물 생성까지 수행) |
각 단계의 분석 결과를 .claude/tmp/onboarding/ 디렉터리에 마크다운 파일로 저장하고, 최종 단계에서 Read로 읽어 문서를 조립하세요.
준비: !mkdir -p .claude/tmp/onboarding
단계별 저장 파일:
각 단계 파일에는 해당 단계에서 발견한 사실만 구조화하여 기록하세요. 확인하지 않은 내용은 기록하지 마세요.
$ARGUMENTS를 파싱하여 다음 옵션을 인식하세요:
--depth가 없거나 --depth deep이면 심층 분석 수행 (기본값)--depth shallow이 명시된 경우에만 기본 구조와 설정만 분석 (1~3단계만 수행)--focus backend 는 서버 사이드 코드 및 API 중심 분석--focus frontend 는 클라이언트 사이드 및 UI 중심 분석--focus api 는 API 엔드포인트 및 통합 중심 분석--focus database 는 데이터 모델 및 스키마 중심 분석--focus testing 은 테스트 전략 및 커버리지 중심 분석--focus devops 는 배포 및 인프라 구성 중심 분석--format summary 는 간략한 요약만 제공--format detailed 는 상세 분석 제공 (기본값)아래 명령은 규모와 기술 스택을 빠르게 판별하기 위한 용도입니다. 상세 탐색은 분석 프로세스에서 Glob과 Read로 수행하세요.
find . -maxdepth 4 -not -path "*/.git/*" -not -path "*/node_modules/*" -not -path "*/.svn/*" -not -path "*/.idea/*" -not -path "*/target/*" -not -path "*/build/*" -not -path "*/dist/*" -not -path "*/__pycache__/*" -not -path "*/.next/*" -not -path "*/.nuxt/*" | wc -lfind . -maxdepth 3 -type d -not -path "*/.git/*" -not -path "*/node_modules/*" -not -path "*/.svn/*" -not -path "*/.idea/*" -not -path "*/target/*" -not -path "*/build/*" -not -path "*/dist/*" -not -path "*/__pycache__/*" -not -path "*/.next/*" -not -path "*/.nuxt/*" | head -80find . -maxdepth 2 -type f \( -name "pom.xml" -o -name "build.gradle" -o -name "build.gradle.kts" -o -name "package.json" -o -name "requirements.txt" -o -name "pyproject.toml" -o -name "Cargo.toml" -o -name "go.mod" -o -name "Gemfile" -o -name "composer.json" -o -name "*.csproj" -o -name "*.sln" -o -name "Makefile" \)find . -maxdepth 2 -type f \( -name "*.yml" -o -name "*.yaml" -o -name "*.toml" -o -name "*.ini" -o -name "*.cfg" \) -not -path "*/.git/*" -not -path "*/node_modules/*" -not -path "*/target/*" | head -30find . -maxdepth 2 -type f \( -name "README*" -o -name "*.md" -o -name "CONTRIBUTING*" -o -name "CHANGELOG*" -o -name "docker-compose*" -o -name "Dockerfile" \)find 명령이 실패하거나 권한 오류가 발생하면, 해당 항목은 건너뛰고 Glob으로 대체 탐색하세요.
자동 수집된 빌드/패키지 파일 목록을 보고 프로젝트 유형을 판별하세요.
판별 기준:
해당 빌드/패키지 파일을 Read로 열어 프레임워크, 언어 버전, 주요 의존성을 파악하세요. 멀티모듈 프로젝트인 경우 모듈별 역할을 파악하세요.
결과를 .claude/tmp/onboarding/01-detect.md에 저장하세요. 형식: 프로젝트 유형, 언어/버전, 프레임워크/버전, 빌드 도구, 주요 의존성 목록
결과를 .claude/tmp/onboarding/02-metadata.md에 저장하세요. 형식: 프로젝트 목적, 실행 명령어, 환경 구성, 인프라 설정
결과를 .claude/tmp/onboarding/03-structure.md에 저장하세요. 형식: 아키텍처, 디렉터리 트리(역할 주석 포함), 컨벤션, 에러 패턴, 공통 모듈
[1M 활용] 서브에이전트 분할 없이 메인에서 직접 다중 파일 동시 Read 후 교차 분석:
- 로드: 4개 영역(A 도메인과 데이터, B API 와 요청 흐름, C 외부 연동과 인프라, D 테스트와 품질) 의 핵심 파일을 동시에 Read: 엔티티 모델, 대표 컨트롤러/라우터, 외부 연동 설정, 테스트 샘플
- 교차 분석: {DB 스키마 vs ORM 모델 vs API 응답 DTO 일관성}, {인증 체계 vs 테스트 커버리지}, {외부 의존성 vs 배치 스케줄러 영향 범위}
- 규모가 큰 프로젝트(파일 10만+)는 영역별 서브에이전트 병렬 모드로 전환.
- 총 로드 추정 토큰 ~600K(1M 컨텍스트의 60%; 줄 수로 대략 가늠) 근접 시 영역별 단계 저장(append) 방식 유지.
--depth shallow이면 이 단계를 건너뛰고 최종 단계로 이동하세요.
아래 영역을 순서대로 분석하세요. 각 영역 분석 후 결과를 즉시 .claude/tmp/onboarding/04-deep-analysis.md에 누적 저장(append)하세요. 한 번에 모든 영역을 분석하지 말고, 영역별로 분석과 저장을 마친 뒤 다음 영역으로 넘어가는 순서를 따르세요.
영역 A: 도메인 모델 및 데이터
영역 B: API 및 요청 흐름
영역 C: 외부 연동 및 인프라
영역 D: 테스트 및 품질
먼저 덮어쓰기 가드:
이 단계에서는 새로운 파일 탐색을 하지 마세요. .claude/tmp/onboarding/ 디렉터리의 모든 파일을 Read로 읽고, 출력 형식은 ${CLAUDE_SKILL_DIR}/templates/output-format.md 를 참조하여 6개 산출물을 생성합니다:
CLAUDE.md (프로젝트 루트, 자동 로드, ≤200줄 엄수): AI 빠른 참조
@bot/INDEX.md, @human/README.md 참조 안내bot/INDEX.md + bot/*.md (프로젝트 루트의 bot/ 디렉터리): AI 사실 카탈로그
경로/파일:줄번호 완전 경로 (... 축약 금지)human/README.md (프로젝트 루트의 human/ 디렉터리): 사람 진입점
.local.claude/biz-rules.md 스켈레톤 (도메인 점검 카테고리 진입점): 빈 템플릿 자동 생성
/review, /srs, /qa, /briefing, /deploy-checklist 등이 4절 (도메인 점검 카테고리) 를 자동 활용/biz-rules 스킬 출력 형식 따름 (4개 섹션: 변경 이력, 1.상태 전이, 2.비즈니스, 3.도메인, 4.도메인 점검 카테고리).local.claude/team.md 스켈레톤 (조직 + 멤버 매핑): 빈 템플릿 자동 생성
/analyze-request, /draft, /briefing, /team-review, /cs, /memo 등이 자동 활용human/SETUP.md (개발 환경 셋업 가이드): 신규 합류자가 처음부터 따라하면 환경이 준비되는 가이드
.nvmrc, .python-version, .tool-versions, pom.xml (<java.version>), build.gradle, go.mod, package.json (engines), Dockerfile (FROM)package.json (npm/pnpm/yarn), pom.xml / build.gradle (Maven/Gradle), requirements.txt / pyproject.toml / Pipfile, Cargo.toml, go.moddocker-compose.yml, application.yml/properties, .env.example.vscode/extensions.json, .editorconfig, LSP 서버 (감지된 언어별 권장).mcp.json, .claude/settings.json (MCP 서버, hooks, 권장 skill)package.json scripts, Makefile, README 의 "Getting Started" 섹션[확인 필요] 태그로 비워둠, 사람이 채움):
# 프로젝트 셋업 가이드
## 빠른 시작 (역할별) # 개발자/디자이너/PM 등 역할별 진입
## 1. 사전 요구사항 # OS, 하드웨어 권장사양
## 2. 필수 설치 (자동 추출) # 런타임, 빌드, DB. 각 행에 [확인 명령] 포함
## 3. 환경 변수 # .env.example 기반
## 4. IDE 설정 # VS Code 권장 확장, LSP, IntelliJ 설정
## 5. Claude Code 설정 (선택) # MCP, hooks, 권장 skill (있을 시)
## 6. 첫 실행 # 의존성 설치, 빌드, 개발 서버, 검증 명령 순
## 7. 사람에게 들어야 할 것 [확인 필요] # 암묵 지식 placeholder
## 8. 트러블슈팅 # 셋업 중 발견한 문제 누적 (초기 비어있음)
## 9. 추정 소요 시간 # 사전 준비 / 의존성 / 첫 빌드 / 총 시간
node -v / mvn --version 같은 확인 명령 포함 (셋업 후 자가 검증 가능)/setup-guide 로 갱신하세요."핵심 원칙:
분량 임계, 산출물 분리 정책 (사용자 안내 포함):
| 산출물 | 임계 | 분리 시 패턴 |
|---|---|---|
CLAUDE.md (자동 로드) | 200줄 | optimize-claude-md 가 검사와 분리 (기존) |
biz-rules.md (자동 로드 후보) | 200/400줄 | biz-rules-detail.md 분리, /biz-rules 스킬 분량 임계 참조 |
human/SETUP.md | 300/500줄 | human/SETUP-TROUBLESHOOTING.md 분리, /setup-guide 스킬 분량 임계 참조 |
customers/{name}.md | 300/500줄 | customers/{name}/ 디렉터리 분리, /customer-profile 스킬 분량 임계 참조 |
team.md | 300줄 (대형 조직) | team.md 핵심 + team-orgchart.md 분리, 또는 people/{name}.md 로 깊이 위임 |
bot/*.md | 150줄/파일 | 처음부터 1~5개 분할 (이미 가이드 있음) |
산출 시점에는 작아서 분리 불필요. 안내 문구만 각 파일 상단 주석으로 포함:
<!-- 분량 임계: 200/400줄. 초과 시 /biz-rules 또는 /garden 이 분리 제안 -->
분리 검사 책임은 /garden Phase 3 + 각 스킬이 갱신 시 자체 검사.
문서 생성 완료 후 임시 디렉터리를 정리하세요:
rm -rf .claude/tmp/onboardingrmdir .claude/tmp 2>/dev/null || true/setup-guide 로 SETUP.md 환경 점검과 갱신/biz-rules (도메인 규칙 발견 시)/people (동료 프로필), /customer-profile (B2B 고객)/skill-check/skills-guide --new/garden[경로] 같은 플레이스홀더가 최종 문서에 남지 않게 정리 후 완료 보고.공통 3블록(빈 / 부분 / 풀 데이터)은 CONTRACT 6-1절 참조.
[환경과 규모] 프로젝트 파일 10만+ 또는 저장소 초대형
find . -type f | wc -l ≥ 100k 또는 분석 타임아웃[사용자 개입 필요] 기존 CLAUDE.md / domain-native 파일 존재