GStack

gstack: Claude Code를 위한 강력한 AI 전문 팀 워크플로우

gstack은 일반적인 AI 비서인 Claude Code를 필요할 때마다 소환할 수 있는 전문 개발 팀으로 변환해 주는 도구입니다. Y Combinator의 CEO인 Garry Tan이 직접 구축한 이 시스템은 8가지의 독창적인 워크플로우 스킬을 제공하여 기획, 코드 리뷰, 배포, QA, 엔지니어링 회고 등 소프트웨어 개발의 모든 단계를 혁신합니다.

일반적인 AI 에이전트는 요청을 문자 그대로 수용하여 일관성 없는 결과를 내놓기 쉽지만, gstack을 사용하면 Founder의 시각, 엔지니어링의 정밀함, 편집증적인 리뷰어의 관점 등 명확한 '사고 모드'를 선택하여 업무를 처리할 수 있습니다.

---

What's gstack?

gstack은 Claude Code의 기능을 확장하는 8가지 특화된 슬래시 명령어 세트입니다. 이는 단순한 프롬프트 모음이 아니라, 개발자가 제품을 빌드할 때 거치는 사고의 과정을 AI에게 주입한 일종의 '운영 시스템'입니다.

사용자는 /plan-ceo-review를 통해 제품의 본질을 고민하고, /plan-eng-review로 설계를 확정하며, /review와 /ship을 통해 안전하게 배포할 수 있습니다. 특히 브라우저 자동화 도구인 /browse와 /qa를 통해 AI에게 직접 '눈'을 부여하여 실제 웹사이트의 동작을 검증할 수 있게 합니다.

---

gstack의 주요 기능 (Features)

1. 전략 및 설계 모드

• /plan-ceo-review (Founder 모드): 요청을 문자 그대로 구현하기 전에 "이 제품이 실제로 해결하려는 것이 무엇인가?"를 질문합니다. 사용자 공감과 10점 만점의 제품 경험을 위한 아이디어를 제안합니다.
• /plan-eng-review (Tech Lead 모드): 아키텍처, 데이터 흐름, 상태 전이, 엣지 케이스 및 테스트 매트릭스를 확립합니다. 특히 다이어그램 작성을 통해 숨겨진 설계를 명확히 시각화합니다.

2. 리뷰 및 배포 자동화

• /review (Staff Engineer 모드): CI 테스트를 통과하더라도 운영 환경에서 문제를 일으킬 수 있는 N+1 쿼리, 레이스 컨디션, 보안 취약점 등을 정밀 감사(Audit)합니다.
• /ship (Release Machine 모드): 메인 브랜치 동기화, 테스트 실행, 변경 로그 업데이트, PR 생성 등 반복적이고 지루한 배포 작업을 자동화합니다.

3. 브라우저 및 QA 자동화

• /browse (QA Engineer 모드): Playwright 기반의 헤드리스 브라우저를 사용하여 AI가 직접 화면을 보고 클릭하며 동작을 검증하고 스크린샷을 찍습니다.
• /qa (QA Lead 모드): Git diff를 분석하여 변경된 파일과 영향을 받는 경로를 파악하고, 자동으로 테스트 플랜을 수립하여 검증을 수행합니다.
• /setup-browser-cookies: 실제 사용 중인 브라우저(Chrome, Arc 등)에서 쿠키를 가져와 로그인 과정 없이 인증이 필요한 페이지를 테스트할 수 있게 합니다.

4. 팀 관리 및 분석

• /retro (EM 모드): 커밋 기록과 작업 패턴을 분석하여 팀원별 칭찬과 성장 기회를 포함한 통찰력 있는 주간 회고를 작성합니다.

---

Use Case: gstack 활용 시나리오

새로운 '판매자 사진 업로드' 기능을 개발한다고 가정해 보겠습니다.

1. 기획 단계: /plan-ceo-review를 실행합니다. AI는 단순 업로드가 아니라 사진에서 제품 정보를 자동 추출하고 가격을 제안하는 더 나은 방향을 제시합니다.
2. 설계 단계: /plan-eng-review를 통해 사진 업로드 파이프라인과 비동기 처리 구조를 다이어그램으로 확정합니다.
3. 코드 작성 후: /review를 실행하여 업로드 실패 시 남는 고아 파일(Orphan files) 문제나 보안 취약점을 발견하고 수정합니다.
4. 배포 준비: /ship을 사용하여 테스트를 돌리고 PR을 생성합니다.
5. QA 단계: /qa를 실행합니다. AI는 자동으로 업로드 페이지와 API 엔드포인트를 탐색하며 UI 레이아웃과 데이터 흐름이 정상인지 확인합니다.

---

How to Use: 설치 및 실행 방법

설치 전 요구사항

• Claude Code, Git, Bun v1.0+ 가 설치되어 있어야 합니다.
• macOS 및 Linux(x64, arm64) 환경을 지원합니다.

설치 단계

1. 개인 환경 설치: Claude Code 창에서 다음 명령어를 실행합니다.

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

2. 설정 업데이트: CLAUDE.md 파일에 gstack 섹션을 추가하고 사용 가능한 스킬 목록(/plan-ceo-review, /browse 등)을 기재합니다.
3. 프로젝트 적용 (선택 사항): 팀원들과 공유하려면 프로젝트의 .claude/skills/gstack 폴더로 파일을 복사한 뒤 ./setup을 실행합니다.

업데이트 및 관리

• 업데이트: cd ~/.claude/skills/gstack && git fetch origin && git reset --hard origin/main && ./setup 명령으로 최신 버전을 유지할 수 있습니다.
• 문제 해결: 스킬이 보이지 않거나 브라우저 바이너리 오류 발생 시 해당 디렉토리에서 ./setup을 다시 실행하여 심볼릭 링크와 바이너리를 재빌드합니다.

---

FAQ

Q: gstack은 무료인가요? A: 네, gstack은 MIT 라이선스로 제공되는 오픈 소스 프로젝트입니다.

Q: /browse 기능은 어떤 브라우저를 사용하나요? A: Microsoft Playwright를 기반으로 구축된 전용 Chromium 바이너리를 사용합니다.

Q: 여러 개의 Claude Code 세션에서 동시에 사용할 수 있나요? A: 네, Conductor를 활용하면 각 세션마다 독립된 워크스페이스와 브라우저 인스턴스를 사용하여 병렬로 여러 작업을 수행할 수 있습니다.

Q: Greptile과 연동이 가능한가요? A: 네, Greptile 계정이 있다면 /review 및 /ship 실행 시 자동으로 PR 코멘트를 읽어와 이슈를 분류하고 해결 제안에 반영합니다.

Q: 내 개인 쿠키 정보가 노출되지는 않나요? A: /setup-browser-cookies는 인터렉티브 UI를 통해 선택한 도메인의 쿠키만 로컬 세션으로 가져오며, 쿠키 값 자체를 직접 표시하거나 외부에 전송하지 않습니다.