gstack 완벽 가이드: Claude Code를 가상 엔지니어링 팀으로 바꾸는 법

혼자서 하루에 1만 줄 이상의 프로덕션 코드를 작성할 수 있다면 어떨까요? Y Combinator 대표 Garry Tan이 공개한 gstack은 Claude Code를 CEO, 디자이너, 스태프 엔지니어, QA 리드, 보안 책임자, 릴리스 엔지니어로 구성된 가상 엔지니어링 팀으로 변환하는 오픈소스 도구입니다. 실제로 60일 만에 60만 줄 이상의 프로덕션 코드를 출하한 실적이 이를 뒷받침합니다.

이 가이드에서는 gstack의 설치부터 28개 스킬 활용법, 핵심 워크플로우, 그리고 실전 팁까지 체계적으로 안내합니다.

gstack이란?

gstack은 Claude Code 위에서 동작하는 소프트웨어 팩토리입니다. 단순한 코딩 어시스턴트가 아니라, 각 전문 역할을 수행하는 28개의 스킬(skill)을 제공하여 소프트웨어 개발의 전 과정을 체계적으로 관리합니다.

설치 방법

사전 요구사항

• Claude Code - Anthropic의 CLI 코딩 도구
• Git - 버전 관리
• Bun v1.0+ - JavaScript 런타임 (컴파일된 바이너리 생성용)
• Node.js - Windows 환경에서만 추가 필요

Step 1: 글로벌 설치 (30초)

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

이 명령으로 gstack이 ~/.claude/skills/gstack에 설치되고, Claude Code가 자동으로 모든 스킬을 인식합니다.

Step 2: 프로젝트에 추가 (선택)

팀 전체가 동일한 설정을 사용하려면 프로젝트 저장소에 복사합니다:

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

Codex/Gemini/Cursor 사용자

# 저장소 로컬 설치
git clone https://github.com/garrytan/gstack.git .agents/skills/gstack
cd .agents/skills/gstack && ./setup --host codex

# 또는 글로벌 설치
git clone https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack && ./setup --host codex

# 자동 감지
./setup --host auto

핵심 워크플로우: Think → Plan → Build → Review → Test → Ship

gstack의 가장 큰 강점은 소프트웨어 개발 라이프사이클 전체를 구조화된 단계로 나눈다는 점입니다. 각 단계에 전문 역할이 배정되어 있습니다.

1단계: 기획 (Planning)

/office-hours

2단계: 디자인 (Design)

3단계: 코드 리뷰 (Review)

4단계: 테스트 및 보안 (QA & Security)

5단계: 배포 (Ship & Deploy)

브라우저 자동화: /browse

gstack에는 실제 Chromium 기반 브라우저 자동화가 내장되어 있습니다. MCP 프로토콜 대비 토큰 오버헤드가 거의 없으며(MCP는 세션당 30,000~40,000 토큰 소모), 커맨드당 약 100~200ms의 응답 속도를 제공합니다.

주요 특징

• Persistent Daemon: 장시간 실행되는 Chromium 서버로 콜드 스타트 없음
• Ref 시스템: 접근성 트리 기반 요소 참조 (@e1, @e2). DOM 변경 없이 안전하게 동작
• 쿠키 임포트: Chrome, Arc, Brave, Edge에서 쿠키 가져오기 지원
• Localhost 전용 바인딩: 네트워크 접근 차단, 세션별 Bearer 토큰 인증

자주 쓰는 브라우저 명령

# 페이지 이동
browse goto https://example.com

# 스냅샷 (요소 참조 포함)
browse snapshot -i

# 요소 클릭
browse click @e5

# 폼 입력
browse fill @e12 "검색어"

# 스크린샷 촬영
browse screenshot

# JavaScript 실행
browse js "document.title"

안전장치 (Safety Guardrails)

gstack은 실수로 인한 치명적 명령 실행을 방지하는 안전장치를 제공합니다:

병렬 스프린트: Conductor 연동

gstack은 Conductor(macOS 앱)와 연동하여 여러 Claude Code 세션을 동시에 실행할 수 있습니다. 각 세션은 git worktree로 격리된 작업 공간에서 독립적으로 동작하므로 충돌 없이 병렬 개발이 가능합니다.

워크플로우는 간단합니다:

1. 저장소 등록
2. 여러 에이전트 동시 배포 (각각 격리된 워크스페이스)
3. 실시간 진행 모니터링 및 코드 리뷰 후 머지

빌더 철학 (Ethos)

gstack은 두 가지 핵심 원칙을 따릅니다:

Boil the Lake (호수를 끓여라)

완성 비용이 지름길보다 몇 분밖에 더 들지 않으면, 항상 완성하라는 원칙입니다. AI 보조 시대에는 "2주 걸린다"를 "1시간이면 된다"로 재해석해야 합니다. 90% 솔루션보다 100% 완성을 추구합니다.

Search Before Building (만들기 전에 찾아라)

"누가 이미 해결했는가?"를 "처음부터 설계하자"보다 먼저 물어야 합니다. 지식의 3개 레이어를 활용합니다:

• Layer 1 (검증된 것): 널리 쓰이는 배틀테스트된 패턴
• Layer 2 (새롭고 인기 있는 것): 최신 베스트 프랙티스 (비판적 검증 필요)
• Layer 3 (퍼스트 프린시플): 문제 고유의 독창적 추론

실전 워크플로우 예시

새로운 기능을 기획부터 배포까지 진행하는 전체 흐름입니다:

# 1. 제품 아이디어 검증
/office-hours
→ 6가지 핵심 질문으로 제품 재정의

# 2. CEO 리뷰로 범위 결정
/plan-ceo-review
→ 4가지 모드 중 선택하여 구현 범위 확정

# 3. 엔지니어링 아키텍처 확정
/plan-eng-review
→ 다이어그램, 엣지 케이스, 테스트 계획 생성

# 4. (또는 자동화) 전체 기획 파이프라인
/autoplan
→ CEO → 디자인 → 엔지니어링 리뷰 자동 순차 실행

# 5. 구현 완료 후 코드 리뷰
/review
→ 프로덕션 장애 패턴 감지 + 자동 수정

# 6. QA 테스트
/qa
→ 버그 발견 + 자동 리그레션 테스트 생성

# 7. 보안 감사
/cso
→ OWASP Top 10 + STRIDE 위협 모델링

# 8. 배포
/ship
→ 테스트 → 커버리지 → PR 생성

# 9. 배포 후 모니터링
/canary
→ 콘솔 에러, 리그레션 감시

프라이버시 및 텔레메트리

• 기본값: OFF - 명시적 동의 없이 아무것도 전송되지 않음
• 수집 항목(동의 시): 스킬 이름, 소요 시간, 성공/실패, 버전, OS만
• 절대 수집 안 함: 코드, 파일 경로, 저장소명, 브랜치명, 프롬프트, 사용자 생성 콘텐츠
• 즉시 비활성화: gstack-config set telemetry off
• 로컬 분석: gstack-analytics로 항상 로컬 확인 가능

트러블슈팅

핵심 정리

• gstack은 Claude Code를 28개 전문 역할의 가상 팀으로 변환하는 오픈소스 소프트웨어 팩토리
• Think → Plan → Build → Review → Test → Ship → Reflect 전 과정을 커버
• /office-hours로 시작하여 /ship으로 마무리하는 구조화된 워크플로우
• 내장 Chromium 브라우저로 실제 UI 테스트 및 스크린샷 자동화 지원
• /careful, /freeze, /guard로 치명적 실수 방지
• Conductor 연동으로 병렬 스프린트 가능
• MIT 라이선스 - 완전 무료, 프리미엄 티어 없음
• 설치 30초: git clone + ./setup 한 줄이면 완료

참조 링크

• garrytan/gstack - GitHubgstack 공식 저장소 (README, 설치 가이드, 소스 코드)
• gstack Skills Documentation28개 스킬 상세 설명, 워크플로우, Greptile 연동
• gstack Builder Ethos빌더 철학: Boil the Lake, Search Before Building 원칙
• gstack Architecture시스템 설계, 데몬 아키텍처, 보안 모델, Ref 시스템
• gstack Browser Reference/browse 명령어 전체 레퍼런스, 스냅샷, 상호작용
• gstack Contributing Guide개발 환경 설정, 테스트, 컨트리뷰터 모드
• Conductor병렬 AI 코딩 에이전트 오케스트레이션 macOS 앱