AI와 함께 만드는 삶

PM으로 일하며 AI와 함께 무언가를 만들어가는 삶을 기록합니다.

AI레퍼런스/오픈소스리뷰

gstack이 뭐길래 난리인가 — 게리 탄이 공개한 Claude Code 툴킷 뜯어보기

makewithai 2026. 7. 22. 09:53

이게 뭔데 화제였나

Y Combinator CEO인 게리 탄(Garry Tan)이 자신이 실제로 쓰던 Claude Code 설정을 통째로 공개했다. 이름은 gstack. 공식 저장소 설명을 보면, CEO·디자이너·엔지니어링 매니저·릴리스 매니저·문서 엔지니어·QA — 이렇게 여섯 개 역할을 대신해주는 23개의 "opinionated"(자기 주장이 뚜렷한) 도구 모음이라고 되어 있다.

공개 직후 짧은 기간에 GitHub 스타 수만 개를 넘기며 화제가 됐고, 지금도 활발히 업데이트되고 있다. 최신 버전은 v1.57.6.0이고, 최근 릴리스에서는 세션이 끊겨도 이전 결정을 기억하는 크로스 세션 메모리 기능과, 보안 가드 중 뚫려 있던(failing open) 4개를 막는 수정이 들어갔다.

구성은 23개 전문 스킬 + 8개 파워툴이다. 참고로 "51개"라는 숫자로 소개된 자료도 종종 보이는데, 이건 세부 하위 명령어까지 다 센 숫자로 추정된다. 실제 공식 저장소 기준으로는 23+8 구성이 맞다.

왜 필요한가 — Claude Code 기본 모드와 뭐가 다른가

Claude Code를 그냥 쓰면 대부분 빈 CLAUDE.md에서 시작해서, 리뷰 방식도 QA 방식도 배포 체크리스트도 전부 각자 만들어 써야 한다. gstack은 이 앞뒤 과정(기획 → 리뷰 → QA → 배포)에 이미 만들어진 역할극 페르소나를 끼워 넣는 방식이다.

코드를 직접 짜는 도구가 아니라, "무엇을 왜 할까"를 강제하는 거버넌스 레이어에 가깝다. Build 단계 자체는 Claude Code 기본 기능에 맡기고, gstack은 그 전후 과정을 채운다.

안전장치도 있다. "be careful"이라고 말하면 /careful이 rm -rf, DROP TABLE, force-push, git reset --hard 같은 파괴적 명령 앞에서 경고를 띄우고, /freeze는 디버깅 중 편집 범위를 한 디렉토리로 묶어 Claude가 엉뚱한 코드를 건드리지 못하게 막는다.

 

전체 스킬 맵 (단계별)

1. 기획 · 검증

  • office-hours — 아이디어 사전 검증. YC 파트너 세션처럼 코드 짜기 전에 질문을 던져 검증해준다.
  • spec — 막연한 의도를 5단계로 정밀한 실행 스펙으로 변환.
  • plan-tune — 질문 민감도·개발자 성향을 관찰해서 자가 튜닝.

2. 계획 리뷰 (역할별 검토)

  • plan-ceo-review — 창업자 관점 리뷰
  • plan-design-review — 디자이너 관점 리뷰
  • plan-devex-review — 개발자 경험(DX) 관점 리뷰
  • plan-eng-review — 엔지니어링 매니저 관점 리뷰
  • autoplan — 위 4개를 자동으로 순차 실행

3. 디자인

  • design-consultation — 톤·타이포·컬러·레이아웃 제안
  • design-html — 프로덕션 품질 HTML/CSS 생성
  • design-review — 시각적 불일치·간격·위계 문제 발견 및 수정
  • design-shotgun — 여러 시안 생성 → 비교 보드 → 피드백 수집

4. 개발 · 디버깅

  • investigate — 근본 원인 추적 디버깅
  • health — 코드 품질 대시보드
  • devex-review — 실시간 개발자 경험 감사
  • careful, guard, freeze/unfreeze — 안전장치

5. QA · 테스트

  • qa — 웹앱 QA + 버그 수정까지
  • qa-only — 리포트만 생성
  • browse — QA용 헤드리스 브라우저
  • benchmark, benchmark-models — 성능 회귀 감지, 모델 간 벤치마크
  • canary — 배포 후 모니터링
  • iOS 전용 5종 (ios-qa, ios-fix, ios-clean, ios-sync, ios-design-review)

6. 배포 · 운영

  • ship — 브랜치 머지 → 테스트 → 버전업 → CHANGELOG → PR까지 원스톱
  • land-and-deploy, setup-deploy, landing-report, document-release

7. 문서 · 산출물

  • document-generate — 기능/모듈/프로젝트 문서 자동 생성
  • make-pdf — 마크다운 → 출판 품질 PDF
  • diagram — 텍스트/mermaid → 다이어그램

8. 세션 · 컨텍스트 관리

  • context-save / context-restore — 작업 컨텍스트 저장/복원
  • learn — 프로젝트 학습 내용 관리
  • retro — 주간 회고

9. 브라우저 자동화

  • scrape, skillify, pair-agent, setup-browser-cookies, open-gstack-browser

10. 시스템 · 보안 · 유틸리티

  • cso — 보안 담당자 모드
  • setup-gbrain, sync-gbrain — 장기 기억(gbrain) 설정/동기화, 최근 업데이트로 dream-stage 캐싱 추가
  • gstack-upgrade, codex

설치 방법

 
bash
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
cd ~/.claude/skills/gstack && ./setup

MIT 라이선스, 무료로 공개되어 있다. 시스템 PATH를 건드리지 않고 .claude/ 디렉토리 안에서만 동작한다.

참고 및 주의

오픈소스 프로젝트 특성상 버전이 빠르게 바뀐다. 이 글은 v1.57.6.0 기준으로 작성했으며, 최신 스펙은 공식 저장소에서 다시 확인하는 걸 권한다.

전체 30개가 넘는 스킬을 한 번에 다 익히는 건 비효율적이다. 다음 편에서는 PM이 혼자 바이브코딩할 때 어떤 것부터 써야 하는지, 우선순위를 추려서 정리한다.


다음 편: PM 혼자 바이브코딩할 때 gstack에서 먼저 써볼 8개