gstack 완전 초보자 가이드

gstack은 Claude Code를 위한 오픈소스 스킬 패키지입니다. Garry Tan(Y Combinator 대표)이 만들었습니다.

일반적으로 Claude Code는 범용 AI 어시스턴트입니다. "이거 해줘"라고 하면 그냥 해줍니다. 하지만 gstack을 설치하면 Claude Code에 20개의 전문가 역할과 8개의 강력한 도구가 추가됩니다. 마치 CEO, 수석 엔지니어, 디자이너, QA 리드, 보안 책임자가 한 팀으로 일하는 것처럼요.

핵심 개념: "도구 모음"이 아니라 "프로세스"

gstack의 가장 중요한 특징은 각 스킬이 순서대로 연결된다는 점입니다:

/office-hours에서 작성한 디자인 문서를 /plan-ceo-review가 읽고, /plan-eng-review에서 작성한 테스트 계획을 /qa가 자동으로 가져갑니다. 어떤 단계도 빠지지 않습니다.

왜 gstack인가?

필요한 것들

• Claude Code 설치 완료
• Git 설치 완료
• Bun v1.0 이상
• Node.js (Windows 사용자는 반드시 필요)

1단계: 내 컴퓨터에 설치

Claude Code를 열고 아래 문장을 그대로 붙여넣으세요:

Install gstack: run git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup

Claude가 알아서 설치를 진행합니다. 약 30초면 끝납니다.

2단계: CLAUDE.md에 gstack 등록

프로젝트 루트의 CLAUDE.md 파일에 다음 내용을 추가합니다:

## gstack

Use the /browse skill from gstack for all web browsing.
Never use mcp__claude-in-chrome__* tools.

Available skills: /office-hours, /plan-ceo-review,
/plan-eng-review, /plan-design-review, /design-consultation,
/review, /ship, /land-and-deploy, /canary, /benchmark,
/browse, /qa, /qa-only, /design-review,
/setup-browser-cookies, /setup-deploy, /retro,
/investigate, /document-release, /codex, /cso,
/autoplan, /careful, /freeze, /guard,
/unfreeze, /gstack-upgrade.

3단계: 확인

Claude Code에서 /office-hours를 입력해보세요. "무엇을 만들고 싶으세요?"라고 물어보면 설치 성공입니다.

(선택) 팀원과 공유하기

프로젝트 저장소에 gstack을 포함시켜서 git clone만 하면 팀원도 바로 사용할 수 있게 합니다:

cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
cd .claude/skills/gstack && ./setup

gstack은 실제 소프트웨어 개발팀의 스프린트(Sprint) 과정을 그대로 따릅니다. 각 단계에 해당하는 슬래시 명령어가 있습니다:

gstack을 처음 사용한다면 이 실습을 따라해보세요. 코딩 경험이 없어도 됩니다.

0~5분: 설치 확인

Claude Code를 열고 /office-hours를 입력합니다. 대화가 시작되면 설치 성공입니다.

5~20분: 아이디어 다듬기

/office-hours

"무엇을 만들고 싶은지" 물어봅니다. 간단한 것도 좋습니다. 예를 들어: "우리 동네 반려동물 돌봄 매칭 서비스를 만들고 싶어요"

AI가 6가지 핵심 질문을 통해 여러분의 아이디어를 다듬어줍니다:

1. 수요 현실 — 이 문제가 실제로 존재하는가?
2. 현재 상태 — 사람들이 지금은 어떻게 해결하고 있는가?
3. 구체적 절실함 — 이걸 절실히 원하는 특정 사람이 있는가?
4. 가장 좁은 쐐기 — 가장 작게 만들어서 배울 수 있는 것은?
5. 관찰과 놀라움 — 다른 사람들이 놓친 것을 발견했는가?
6. 시대 적합성 — 왜 지금이 적기인가?

대화가 끝나면 디자인 문서가 자동 생성됩니다. 이 문서가 다음 단계의 입력이 됩니다.

20~35분: 계획 검토

/plan-ceo-review

방금 만든 디자인 문서를 CEO 관점에서 검토합니다. 4가지 모드 중 하나를 선택하라고 물어봅니다:

• 범위 확장(Expansion) — 더 야심차게 만들기
• 선택적 확장(Selective) — 기본 범위는 유지, 추가 기회 탐색
• 범위 유지(Hold) — 현재 계획에 최대한 집중
• 범위 축소(Reduction) — MVP(최소 기능 제품) 찾기

35~50분: 브라우저 체험

/browse

그런 다음 아래 명령어를 순서대로 입력해보세요:

# 웹페이지로 이동
$B goto https://example.com

# 페이지의 인터랙티브 요소 확인
$B snapshot -i

# 스크린샷 찍기
$B screenshot /tmp/test.png

# 콘솔 에러 확인
$B console

AI가 진짜 브라우저에서 웹페이지를 열고 조작하는 것을 볼 수 있습니다. 이것이 gstack의 핵심 기능입니다.

50~60분: SKILL.md 파일 읽어보기

각 스킬의 작동 원리를 이해하려면 SKILL.md 파일을 열어보세요:

~/.claude/skills/gstack/office-hours/SKILL.md
~/.claude/skills/gstack/review/SKILL.md
~/.claude/skills/gstack/qa/SKILL.md

이 파일들이 Claude Code에게 "어떻게 행동해야 하는지" 알려주는 지침서입니다. 잘 작성된 프롬프트의 교과서라고 생각하면 됩니다.

워크플로 스킬 (20개)

파워 도구 (8개)

협동조합, 상호부조 네트워크, 사회적 기업, 비영리 기술 프로젝트 등 사회연대경제(SSE) 조직은 보통 제한된 개발 자원으로 운영됩니다. 개발자 1명이나 소수의 자원봉사자가 기술 전체를 담당하는 경우가 많습니다.

gstack은 이런 조직의 경제학을 바꿔놓습니다:

SSE 조직 추천 워크플로

1단계: 미션 기반 제품 정의

/office-hours로 시작하세요. SSE 조직은 커뮤니티 니즈를 위해 기술을 만듭니다. 이 스킬이 "커뮤니티가 실제로 필요한 것"과 "우리가 만들고 싶은 것"의 차이를 드러내줍니다.

2단계: 범위 축소 모드 사용

/plan-ceo-review에서 Scope Reduction 모드를 선택하세요. 가장 작은 버전을 먼저 만들고, 실제 사용 데이터를 기반으로 확장하는 것이 자원이 제한된 조직에게 가장 좋은 전략입니다.

3단계: 안전 장치 활성화

SSE 조직은 운영 지원이 제한적입니다. /careful로 위험한 명령어를 경고하고, 프로덕션 작업 시 /guard를 사용하세요.

4단계: 보안 감사 필수 실행

/cso를 매 릴리즈 전에 실행하세요. 커뮤니티 데이터는 소중합니다. OWASP + STRIDE 감사가 취약점을 사전에 잡아줍니다.

5단계: 문서화와 회고

자원봉사자가 순환하는 조직에서는 문서가 곧 연속성입니다. /document-release로 모든 출시 후 문서를 업데이트하고, /retro로 기여자별 분석을 남겨 공헌을 인정하세요.

/office-hours
  "우리 협동조합 네트워크를 위한 지역 교환 플랫폼을 만들고 싶습니다"
  → 리프레이밍: "가격보다 신뢰가 중요한 신뢰 기반 마켓플레이스"

/plan-ceo-review (범위 축소)
  → MVP: 조합원 디렉토리 + 간단한 물품 등록

/plan-eng-review
  → 멀티 테넌트 협동조합 데이터 격리 아키텍처

/cso
  → 조합원 개인정보 보호, GDPR 준수 감사

/qa
  → 모바일 접근성 테스트 (조합원 대부분이 모바일 사용)

/ship
  → 전체 테스트 커버리지 포함 PR 생성

/retro
  → 이번 주 어떤 자원봉사자가 무엇을 기여했는지 추적

gstack은 Garry Tan이 직접 사용하는 도구입니다. YC를 풀타임으로 운영하면서 파트타임으로 60일간 60만 줄 이상의 프로덕션 코드를 작성한 방법이 바로 이것입니다.

창업자 워크플로

1단계: 아이디어 검증 (30분)

/office-hours의 6가지 핵심 질문이 YC 파트너들이 스타트업을 평가하는 방식에서 나왔습니다:

• 수요 현실 — 실제 문제인가, 가설인가?
• 현재 상태 — 지금은 어떻게 해결하는가?
• 구체적 절실함 — 이걸 간절히 원하는 사람의 이름을 댈 수 있는가?
• 가장 좁은 쐐기 — 가장 작게 만들어서 배울 수 있는 것은?
• 관찰과 놀라움 — 남들이 모르는 것을 발견했는가?
• 시대 적합성 — 왜 지금인가?

2단계: 제품 리뷰 (20분)

/plan-ceo-review에서 4가지 모드 중 선택합니다. 대부분의 스타트업은 범위 축소부터 시작하는 것을 추천합니다.

3단계: 기술 계획 (30분)

/plan-eng-review가 아키텍처 다이어그램, 상태 머신, 실패 모드, 테스트 매트릭스를 생성합니다. 이 문서가 첫 번째 엔지니어(또는 AI)의 실행 기준이 됩니다.

4~5단계: 구현 + 출시

[구현] → /review → /cso → /qa → /ship → /land-and-deploy → /canary

병렬 스프린트: 10배의 힘

Conductor를 사용하면 10~15개의 Claude Code 세션을 동시에 실행할 수 있습니다:

• 세션 1: 새 기능 아이디어에 /office-hours 실행
• 세션 2: 어제 계획한 기능 구현 중
• 세션 3: 완성된 PR에 /review 실행
• 세션 4: 스테이징에 /qa 실행
• 세션 5~10: 더 많은 기능, 더 많은 브랜치

gstack은 Claude Code 생태계에서 가장 잘 구조화된 스킬 패키지 중 하나입니다. 이것을 공부하면 다음을 배울 수 있습니다:

학습 경로

핵심 개념 4가지

연습 문제

1. 전체 스프린트 실행: 간단한 프로젝트(할 일 앱 등)를 골라서 /office-hours부터 /retro까지 모든 단계를 실행해보세요.
2. SKILL.md 3개 비교: /office-hours, /review, /qa의 SKILL.md를 읽고 공통 패턴을 찾아보세요.
3. 스킬 수정: gstack을 포크하고, /office-hours/SKILL.md에 7번째 질문을 추가해보세요.
4. 나만의 스킬 만들기: SKILL.md.tmpl 템플릿을 참고해서 자신만의 워크플로에 맞는 새 스킬을 만들어보세요.

gstack의 각 스킬은 좋은 엔지니어링 실천을 AI 도구로 감싼 것입니다. 커리큘럼 설계에 직접 활용할 수 있습니다.

6모듈 커리큘럼 (총 12시간)

모듈별 수업 운영 팁

강사 필수 팁

• 코드뿐 아니라 산출물을 평가하세요. 디자인 문서, 리뷰 보고서, QA 보고서, 회고록 모두 평가 가능한 학습 산출물입니다.
• 포크를 장려하세요. 스킬을 이해하는 가장 좋은 방법은 직접 수정하는 것입니다.
• /codex와 /review를 함께 사용하세요. 서로 다른 AI 모델이 서로 다른 문제를 잡는다는 것을 가르칠 수 있습니다.

gstack에는 두 가지 핵심 원칙이 내장되어 있습니다. 모든 스킬이 이 철학을 따릅니다.

원칙 1: 호수를 끓여라 (Boil the Lake)

"AI 지원 코딩은 완성의 한계 비용을 거의 제로로 만듭니다. 완전한 구현이 지름길보다 몇 분밖에 더 안 걸린다면, 매번 완전한 것을 하세요."

• "호수"는 끓일 수 있습니다 — 모듈 100% 테스트 커버리지, 전체 기능 구현, 모든 엣지케이스
• "바다"는 끓일 수 없습니다 — 전체 시스템 재작성, 수개월짜리 플랫폼 마이그레이션
• 호수를 끓이세요. 바다는 범위 밖으로 표시하세요.

하지 말아야 할 것:

• "B를 선택하자, 90%는 커버하니까" → A가 70줄만 더 많다면 A를 선택하세요
• "테스트는 후속 PR로 미루자" → 테스트는 가장 저렴하게 끓일 수 있는 호수입니다
• "이건 2주 걸릴 거야" → "사람 2주 / AI 보조 ~1시간"이라고 말하세요

원칙 2: 만들기 전에 찾아라 (Search Before Building)

"1000배 엔지니어의 첫 번째 본능은 '누군가 이미 이걸 해결했나?'이지, '내가 처음부터 설계해볼까'가 아닙니다."

지식의 3단계:

유레카 순간: Layer 1+2를 검색하고, Layer 3의 제1원칙으로 기존 접근법이 틀렸다는 것을 발견하는 순간. 이것이 혁신적인 제품이 탄생하는 지점입니다.

공식 문서

• gstack GitHub 저장소 — 소스 코드, 이슈, 기여
• 스킬 상세 가이드 — 모든 스킬의 철학, 예시, 워크플로
• 아키텍처 문서 — 설계 결정과 시스템 내부 구조
• 빌더 철학 (Ethos) — Boil the Lake, Search Before Building
• 브라우저 레퍼런스 — /browse 전체 명령어 참고
• 변경 로그 — 버전별 변경 사항

튜토리얼 & 기사

• GStack Tutorial: 주당 1만 줄 개발 워크플로 — SitePoint
• gstack 원클릭 설치 가이드 — SitePoint
• gstack: Claude를 엔지니어링 팀처럼 운영하기 — Medium
• gstack이 왜 이렇게 화제인가 — TechCrunch
• 단계별 설치 가이드 — gstacks.org

커뮤니티

• gstack on Product Hunt
• Awesome Agent Skills — 1000개 이상의 에이전트 스킬 모음