gstack 실습: 설치부터 실행까지 전체 워크플로

소개

콘셉트에서는 Claude Code를 가상 엔지니어링 팀으로 바꾸는 역할 기반 기술 세트인 gstack의 핵심 포지셔닝과 GSD, Superpowers, Ralph 및 기타 솔루션과 비교하여 AI 프로그래밍 도구 생태계에서의 차별화된 포지셔닝에 대해 알아봤습니다.

이 실용적인 기사는 설치 및 구성부터 전체 워크플로 실행까지 사용 방법에 중점을 두어 30분 안에 gstack을 시작할 수 있도록 도와줍니다.

설치 및 구성

전제조건

• 클로드 코드가 설치되어 사용 가능합니다.
• Git 설치됨
• Bun v1.0+ 설치됨(gstack은 Bun에 구축됨)
• Windows 사용자에게는 Node.js도 필요합니다.

전역 설치(권장, 30초 안에 완료)

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

설치 스크립트는 다음 세 가지 작업을 수행합니다.

1. CLAUDE.md 파일에 gstack의 스킬 정보를 추가하세요.
2. 모든 스킬 파일을 스킬 디렉터리에 넣습니다.
3. Playwright 및 해당 Chromium 브라우저(/browse 및 /qa용)를 설치합니다.

프로젝트 수준 설치(팀 공유)

저장소를 복제한 후 팀 구성원이 자동으로 gstack을 얻도록 하려면 다음을 수행하세요.

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

###다중 에이전트 지원

gstack은 Claude Code에만 국한되지 않고 현재 10개의 AI 프로그래밍 에이전트를 지원합니다. ./setup은(는) 기본적으로 설치된 호스트를 자동으로 감지합니다.

./setup --host codex      # OpenAI Codex CLI
./setup --host opencode   # OpenCode
./setup --host cursor     # Cursor
./setup --host factory    # Factory Droid
./setup --host slate      # Slate
./setup --host kiro       # Kiro
./setup --host hermes     # Hermes
./setup --host gbrain     # GBrain（修改版）
./setup --host openclaw   # OpenClaw（通过 ACP 派发 Claude Code 会话）

각 호스트의 스킬 설치 경로는 ~/.<agent>/skills/gstack-*/ 형태로 되어 있어 서로 간섭하지 않습니다.

💡 OpenClaw 사용자를 위한 추가 옵션: OpenClaw는 ACP를 통한 호출 외에도 ClawHub를 통해 4가지 기본 방법론 기술(gstack-openclaw-office-hours, gstack-openclaw-ceo-review, gstack-openclaw-investigate, gstack-openclaw-retro)을 직접 설치할 수 있으며, 이는 Claude Code 세션 없이 대화식으로 사용할 수 있습니다.

팀 모드(팀 공유 + 자동 업데이트, 권장)

v1.x에는 팀 모드가 도입되었습니다. 각 개발자는 gstack을 전역적으로 설치하고 웨어하우스는 "우리는 gstack을 사용합니다"만 기록하고 업데이트는 자동으로 발생합니다.

(cd ~/.claude/skills/gstack && ./setup --team) && \
~/.claude/skills/gstack/bin/gstack-team-init required && \
git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"

required을 optional로 바꾸는 것은 필수가 아닌 "부드러운 알림"입니다. Claude Code를 시작할 때마다 자동으로 업데이트 확인이 실행됩니다(시간당 한 번씩 조절되며, 네트워크에 장애가 발생하면 안전하고 조용합니다). 웨어하우스에는 판매된 파일이 없으며 버전 드리프트도 없습니다.

업데이트

cd ~/.claude/skills/gstack && git pull && ./setup

또는 Claude Code에서 직접 /gstack-upgrade을 사용하세요.

전체 명령 참조

스프린트 프로세스

디자인

검토 및 보안

테스트 및 QA

출시 및 운영 및 유지보수

검토 및 학습

보안 보호

도구 통합

Standalone CLI（v0.19+）

슬래시 명령 외에도 gstack에는 독립형 CLI 세트도 함께 제공됩니다(Claude Code 세션 내에서는 실행되지 않음).

구성 세부정보

CLAUDE.md 콘텐츠 추가

설치 후 gstack은 CLAUDE.md에 사용 가능한 모든 기술의 목록과 간단한 설명을 추가합니다. 이를 통해 Claude Code는 어떤 명령을 사용할 수 있는지 알 수 있습니다.

스킬 디렉토리 구조

주요 입구는 최상위 ~/.claude/skills/gstack/SKILL.md이고, 각 하위 명령은 플랫 디렉터리 형태로 존재하며, 핵심은 SKILL.md 파일입니다.

~/.claude/skills/gstack/
├── SKILL.md            # 主入口 skill
├── browse/             # 浏览器 daemon
├── qa/                 # QA 测试
├── review/             # 代码审查
├── ship/               # 发布流程
├── plan-ceo-review/    # CEO 审查
├── office-hours/       # 产品门诊
├── pair-agent/         # 跨 Agent 浏览器配对
├── open-gstack-browser/ # GStack Browser 启动器
├── setup-gbrain/       # GBrain 数据库一键上手
├── hosts/              # 10 个 host 配置（claude/codex/cursor/...）
├── bin/                # standalone CLI（gstack-model-benchmark 等）
└── ...                 # 当前 v1.x 共 50 个 skill 目录

동작을 사용자 정의하기 위해 SKILL.md을 자유롭게 수정할 수 있습니다. 이것이 "포크 및 사용자 정의"의 장점입니다.

Browse Daemon

Browse Daemon은 영구 Chromium 인스턴스입니다. 주요 구성:

• 포트: 무작위로 선택되는 10000-60000, 10개 이상의 병렬 작업 공간 지원
• 보안: 로컬 호스트만 바인딩하고 각 세션마다 베어러 토큰 인증을 사용합니다.
• 쿠키: Chrome/Arc/Brave/Edge에서 가져오려면 /setup-browser-cookies을 사용하세요.

실제 작업 흐름 시연

다음은 일반적인 gstack 작업 흐름을 보여줍니다. 명령과 출력은 문서와 비디오의 실제 사례를 기반으로 합니다.

💡 참고: 다음 출력은 연구를 기반으로 편집된 일반적인 예입니다. 향후 실제 사례를 바탕으로 특정 프로젝트의 스크린샷이 추가될 예정입니다.

1단계: 제품 클리닉

> /office-hours

[YC Office Hours] 6 forcing questions:
1. Who specifically needs this?
2. What do they do today without it?
3. Why is this urgent right now?
4. How will you know it works?
5. What happens if you do nothing?
6. What is the smallest version you can ship?

→ Design doc generated

서두르지 말고 먼저 YC Office Hours의 관점에서 AI가 아이디어를 고문하도록 하세요.

2단계: 다중 역할 검토 계획

> /autoplan

[CEO Review] Finding the 10-star product...
[Design Review] Rating dimensions 0-10...
[Eng Review] Locking architecture + edge cases...

→ Fully reviewed plan ready

/autoplan은 CEO → 설계 → 엔지니어링 검토의 3단계를 자동으로 실행하여 완전한 사후 검토 계획을 생성합니다.

3단계: 코딩 구현

일반적으로 승인된 계획에 따라 코딩합니다. 표준 Claude Code 대화를 사용할 수 있습니다.

4단계: 여러 전문가의 코드 검토

> /review

Dispatching 7 specialist reviewers...
- Testing coverage ✓
- Maintainability ✓
- Security: Found 1 issue (auto-fixing)
- Performance ✓
- Data migration ✓
- API contract ✓
- Red team: No vulnerabilities found

→ Review complete, 1 auto-fix applied

5단계: 브라우저 QA

> /qa

Opening headless browser...
Testing user flows:
- Login flow ✓
- Dashboard load ✓
- Form submission: Bug found → fixing → re-testing ✓
- Image upload ✓

→ 4 flows tested, 1 bug fixed, regression test generated

6단계: 게시

> /ship

Syncing with main...
Running tests: 42 passed, 0 failed
Reviewing diff: 3 files changed
Updating VERSION: 1.2.0 → 1.3.0
Creating PR: "Add screenshot feature"

→ PR #47 created, ready for merge

실용적인 팁과 커뮤니티 경험

Garry Tan의 제안

gstack의 ETHOS.md, 세 가지 핵심 원칙:

1. Boil the Lake: AI는 완전성을 거의 무료로 만듭니다. 항상 완전한 작업을 수행하고 지름길을 택하지 않습니다.
2. 구축 전 검색: 먼저 검색하고, 먼저 이해하고, 3단계 지식 검증 후 시작
3. 사용자 주권: AI 추천은 귀하가 결정합니다. 두 AI 모델이 모두 동의하더라도 여전히 귀하의 판단이 우선합니다.

gstack의 README는 Karpathy의 인용문으로 시작됩니다. 이는 Garry Tan이 gstack을 구축하려는 이유를 설명하는 출발점이기도 합니다.

긍정적인 커뮤니티 경험

• /office-hours(YC 지원): Reddit r/ycombinator의 여러 S26 지원자는 gstack의 업무 시간을 사용하여 지원 자료를 스트레스 테스트하는 것이 매우 효과적이라고 보고했습니다.
• 보안 감사를 통해 실제 취약점이 발견되었습니다: CTO 피드백이 있었습니다. /review은(는) 팀이 인식하지 못한 XSS 취약점을 발견했습니다.
• /browse 실제 브라우저 테스트: 커뮤니티(비평가 포함)에서 "진정한 기술적 기여"로 인정

일반적인 함정

• 잦은 권한 메시지: 일부 사용자는 "권한 메시지는 30초마다 승인을 받아야 하기 때문에 잠을 잘 수 없다"고 보고했습니다. Claude Code 설정에서 적절한 자동 승인 규칙을 구성하는 것이 좋습니다.
• 높은 토큰 소비: 특성화된 프롬프트는 컨텍스트 소비를 증가시킵니다. 비용에 민감한 경우 가장 필요한 기술을 선택적으로 사용할 수 있습니다.
• 에이전트 루프: HN에는 에이전트가 70분 루프에 갇혔다고 사용자가 보고한 사례가 있습니다. 합리적인 시간 초과 및 체크포인트를 설정하는 것이 좋습니다.
• 모든 사람에게 해당되는 것은 아닙니다: 숙련된 개발자는 대부분의 기술이 불필요한 래퍼라고 느낄 수 있습니다. gstack은 성숙한 엔지니어링 프로세스를 갖춘 팀보다는 독립적인 창립자 및 소규모 팀에 더 적합합니다.

자주 묻는 질문(FAQ) 및 모범 사례

**Q: gstack과 Superpowers를 동시에 사용할 수 있나요? **

그렇습니다. 둘은 서로를 보완합니다. Superpowers는 프로세스 규율과 TDD 보증에 능숙하고 gstack은 제품 사고와 다중 역할 검토에 능숙합니다. 많은 팀이 일일 코딩 훈련에 Superpowers를 사용하고 제품 계획 및 QA에 gstack을 사용합니다.

**Q: 토큰은 비싼가요? **

기본 Claude Code보다 높습니다. 각 기술의 역할 프롬프트는 상황에 맞는 창을 차지합니다. 그러나 귀하의 시간이 토큰 수수료보다 더 가치가 있다면 이는 일반적으로 좋은 거래입니다.

**Q: 어떤 유형의 프로젝트에 적합합니까? **

아이디어부터 출시까지 전체 프로세스 제품 개발에 가장 적합합니다. 단순히 버그를 수정하거나 작은 기능을 만드는 정도라면 네이티브 클로드 코드만으로도 충분합니다. gstack의 가치는 "완전한 프로세스"에서 극대화됩니다.

**Q: 스킬을 어떻게 맞춤설정하나요? **

각 스킬은 SKILL.md 파일입니다. 직접 편집하세요.

1. 스킬 디렉토리 찾기: ~/.claude/skills/gstack/<skill-name>/
2. SKILL.md 편집
3. ./setup 다시 실행

커뮤니티에서는 전역 설치를 직접 수정하는 대신 저장소를 포크하고 사용자 정의하는 것을 권장합니다.

모범 사례

1. 먼저 /office-hours 후 코드: 코드를 작성하기 전에 제품 클리닉을 하는 습관을 들입니다.
2. /browse 확인을 잘 활용하세요: 코드만 보지 말고 AI가 애플리케이션을 실제로 "볼" 수 있도록 하세요.
3. 주기적 /retro: 코드 품질 및 작업 속도에 대한 가시성을 유지합니다.
4. 점진적 채택: 모든 기술을 한 번에 사용할 필요가 없습니다. /office-hours + /review + /ship부터 시작
5. 포크 사용자 정의: 부적절한 프롬프트가 표시되면 직접 변경하세요. 이것이 오픈소스의 장점이다

요약

gstack의 핵심 가치는 특정 기술이 얼마나 강력한지에 있는 것이 아니라 구조화된 AI 협업 모드를 제공한다는 점입니다. 역할 전환을 통해 다양한 단계에서 다양한 유형의 AI 지원을 받을 수 있습니다. 먼저 CEO 관점에서 제품 방향을 검토하고, 엔지니어링 관리자의 엄밀한 아키텍처 검토를 거쳐 최종적으로 QA의 실제 브라우저를 통해 결과를 검증합니다.

다음으로 직접 설치해 보고 /office-hours에서 첫 번째 gstack 프로젝트를 시작할 수 있습니다.

자세한 내용:

• gstack 개념 — gstack의 핵심 개념과 도구 생태학적 포지셔닝을 이해합니다.
• GSD 실무장 — 또 다른 구조화된 AI 프로그래밍 솔루션에 대한 실무 가이드
• 클로드 스킬실습편 — 스킬 생성 메커니즘을 이해한다