환경 구축과 전체 사용법
기반 하나 + 프레임워크 하나 + 작은 파일 두 개, 이게 전부입니다. 순조로우면 30분이면 됩니다.
설치할 것, 딱 세 계층
「설치」에 겁먹지 마세요. 전체 시스템은 세 계층뿐, 이해하면 당황하지 않습니다.
독립 스킬
단일 파일, 복사하면 됩니다: competitor-watch（경쟁사 분석）· prd-generator（PRD 작성）
gstack 프레임워크
한 번에 70+ 스킬 설치: office-hours / design-shotgun / design-html / qa / make-pdf …
Claude Code 본체
기반 앱, 이것 없으면 아무것도 안 됩니다.
필수 스킬 목록
핵심 7개（필수, 5단계에 대응）
| 스킬 | 용도 | 출처 | 단계 |
|---|---|---|---|
/competitor-watch | 경쟁사 분석 | 독립 스킬 | 발견 |
/office-hours | 아이디어 다듬기, 요구사항 명확화 | gstack | 정의 |
/prd-generator | PRD 생성 | 독립 스킬 | 정의 |
/design-shotgun | 한 번에 여러 디자인 방안 출력 | gstack | 설계 |
/design-html | 디자인을 실행 가능한 프로토타입으로 | gstack | 개발 |
/qa | 자동 테스트로 버그 탐색 | gstack | 검증 |
/make-pdf | markdown을 정교한 PDF로 변환 | gstack | 전 과정 |
고급 6개（숙련 후 사용, 모두 gstack 출처）
| 스킬 | 용도 |
|---|---|
/design-consultation | 전체 디자인 시스템 정의（색상/폰트/스타일） |
/plan-ceo-review | 「대표 시각」으로 방안 검토 |
/plan-eng-review | 「기술 시각」으로 방안 검토 |
/investigate | 문제 근본 원인 체계적 파악 |
/context-save · /context-restore | 세션 간 작업 상태 저장/복구 |
/learn | 팀 경험 축적 및 검색 |
설치 단계
방식 A（권장）: 팀 리드가 이미 작동하는 설정을 복사
가장 편하고, 오류가 가장 적습니다. 리드가 자신의 .claude\skills\ 전체 디렉토리를 패키지로 배포합니다.
각 팀원:
| 1 | Claude Code 본체 설치（방식 B 1단계 참조） |
| 2 | 받은 skills를 C:\Users\<내 계정>\.claude\skills\에 압축 해제 |
| 3 | gstack 디렉토리에서 ./setup 실행 |
| 4 | 검증 실행（다음 섹션） |
방식 B: 각자 처음부터 설치
① Claude Code 본체 설치
npm install -g @anthropic-ai/claude-code
설치 후 계정 로그인（팀 통일 Pro/Team 구독 사용）. Node/npm 없으면 먼저 Node.js 설치.
② gstack 프레임워크 설치（한 줄: 클론 + 자동 초기화）
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack \ && cd ~/.claude/skills/gstack && ./setup
gstack은 자동 업데이트됩니다. 수동 업그레이드는 대화에서 /gstack-upgrade를 말하면 됩니다.
③ 독립 스킬 넣기
competitor-watch와 prd-generator 두 디렉토리를 ~/.claude/skills/에 복사하면 됩니다.
/browse 같은 스킬에서 오류가 나면, gstack 디렉토리에서 bun install && bun run build로 의존성 보완.검증: 설치가 됐는지 확인하는 법
설치 후 바로 작업 시작하지 말고, 먼저 2분 스모크 테스트를 해보세요.
본체 실행 확인
터미널에서 claude 입력, 대화 인터페이스 진입 = 1계층 OK.
claude
스킬 전체 확인
대화에서 / 입력, 긴 스킬 목록이 나오면 = 프레임워크와 스킬 OK.
/ （핵심 7개 모두 있는지 확인）
실제 스킬 실행
질문하기 시작하면 = 모두 준비됨, 작업 시작 가능.
/office-hours 팀 주간 보고 자동 집계 도구를 만들고 싶어
전체 사용법（엔드투엔드）
모든 스킬을 완전한 하나의 워크플로우로 연결합니다. 이 흐름을 기억하면 언제든지 어떤 스킬을 쓸지 알 수 있습니다.
watch
/prd-generator
shotgun
/design-html
표준 동작（그대로 따라하면 됩니다）
| Step | 방법 |
|---|---|
| 0 프로젝트 생성 | D:\PM\<프로젝트명>\에 폴더 생성, 진입, 「이 프로젝트 초기화해줘」 |
| 1 발견 | /competitor-watch [경쟁사 URL] 분석, 핵심은 [관심사] |
| 2 정의 | /office-hours 나는 [아이디어]를 하고 싶어 → /prd-generator 완전한 PRD 작성 |
| 3 설계 | /design-shotgun [특정 페이지] 3가지 스타일 방안 만들어 |
| 4 프로토타입 개발 | /design-html로 프로토타입, 그리고 기능 하나씩 추가, 대화로 반복（작게 빠르게） |
| 5 검증 | /qa 이 프로토타입 테스트하고 문제 목록 정리 |
/를 입력해 해당 스킬을 선택하면 됩니다. 문서 납품이 필요하면 /make-pdf.일상 유지 관리 & 신규 입사자 온보딩
일상 유지 관리（팀 리드 담당）
| 항목 | 방법 |
|---|---|
| 프레임워크 업그레이드 | 대화에서 /gstack-upgrade, 또는 자동 업데이트 설정 |
| 새 스킬 추가 | 스킬 디렉토리를 ~/.claude/skills/에 넣고, Claude Code 재시작 |
| 규범 통일 | 기본 제약을 공유해 각 프로젝트의 CLAUDE.md에 넣기 |
| 경험 축적 | 좋은 팁/함정 《표준 업무 가이드》에 보완 |
신규 입사자 가장 빠른 온보딩 경로
- 환경 설치（방식 A, 리드에게 패키지 받기）
- 스모크 테스트 통과
- 작은 요구사항 하나로 5단계 전 과정 실행
- 통과하면 완료
