GStack + Superpowers 조합 세팅 가이드

GStack + Superpowers 조합 세팅 가이드

Claude Code 플러그인 딱 2개 조합으로 결과물이 달라지는 실전 세팅법 — 설치부터 워크플로우까지 총정리

---

1. 이 조합이 뭔데?

Claude Code 플러그인(Skills)은 수십 개가 넘는다. 다 써봤는데 대부분 별로다. 그런데 딱 2개를 조합했더니 결과물이 확 달라졌다.

💡 핵심 원리

GStack → "무엇을 만들지" 판단하는 의사결정 레이어 (CEO, 디자이너, 엔지니어링 매니저 역할)
Superpowers → "어떻게 만들지" 실행하는 레이어 (TDD, 플랜, 코드리뷰, 배포)

한 줄 요약: GStack이 생각하고, Superpowers가 실행한다.

구분	GStack	Superpowers
만든 사람	Garry Tan (Y Combinator CEO)	Jesse Vincent (Prime Radiant)
GitHub	garrytan/gstack	obra/superpowers
핵심 역할	의사결정 · 리뷰 · QA · 보안	브레인스토밍 · TDD · 실행 · 배포
비유	풀 클리닉 (진단~애프터케어)	메스 (정밀하고 효율적)
강점	요구사항이 모호할 때	요구사항이 명확할 때
라이선스	MIT (무료)	MIT (무료)

---

2. 설치 방법 (복붙용)

✅ 사전 준비

Claude Code가 설치되어 있어야 한다. 추가로 Git과 Bun(v1.0+)이 필요하다. Windows는 Node.js도 필요.

✅ GStack 설치 — Claude Code 터미널에 붙여넣기

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

붙여넣으면 Claude가 자동으로 설치를 진행한다. 설치 후 CLAUDE.md에 gstack 섹션이 추가되고, 슬래시 커맨드들이 활성화된다.

✅ Superpowers 설치 — Claude Code 터미널에 붙여넣기

방법 1: 공식 마켓플레이스 (권장)

/plugin install superpowers@claude-plugins-official

방법 2: 커뮤니티 마켓플레이스

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

✅ 설치 확인

GStack 확인 → Claude Code에서 /office-hours 입력. 반응하면 성공.
Superpowers 확인 → "help me plan this feature" 같은 요청을 하면 자동으로 스킬이 트리거된다.

---

3. 핵심 커맨드 비교표

카테고리	GStack	Superpowers
브레인스토밍	/office-hours, /plan-ceo-review	brainstorming
아키텍처 설계	/plan-eng-review, /autoplan	writing-plans
디자인	/design-consultation, /plan-design-review, /design-shotgun, /design-html	—
개발 실행	—	executing-plans, subagent-driven-development, dispatching-parallel-agents
테스트	/qa, /qa-only	test-driven-development
디버깅	/investigate	systematic-debugging
코드 리뷰	/review, /codex	requesting-code-review, receiving-code-review
검증 · 배포	/ship, /land-and-deploy, /canary	verification-before-completion, finishing-a-development-branch
보안	/cso, /careful, /freeze, /guard	—
문서화	/document-release	—
회고 · 학습	/retro, /learn	—
브라우저 테스트	/browse, /qa (실제 브라우저)	—

💡 핵심 포인트: GStack은 의사결정·리뷰·보안·QA가 강하고, Superpowers는 TDD·실행·병렬작업이 강하다. 겹치는 부분은 상황에 맞게 선택하면 된다.

---

4. 실전 워크플로우 — 6단계

두 플러그인의 강점만 조합한 실전 워크플로우다. 순서가 중요하다.

STEP 1 — 의사결정 (GStack)

코드 한 줄 치기 전에, GStack의 의사결정 커맨드를 순서대로 사용한다.

순서	커맨드	역할
①	/office-hours	아이디어를 구체화한다. YC 오피스아워처럼 핵심 질문 6개를 던져서 "진짜 만들어야 할 것"을 찾는다.
②	/plan-ceo-review	CEO 관점에서 검토한다. 비즈니스 가치, 우선순위, 스코프를 점검한다. 4가지 모드: 확장 / 선택적 확장 / 스코프 유지 / 축소.
③	/plan-eng-review	엔지니어링 관점에서 검토한다. 아키텍처, 데이터 흐름, 엣지케이스, 테스트 매트릭스를 확정한다.
④	/plan-design-review (선택)	디자인이 중요한 프로젝트일 때. 각 디자인 항목을 0~10점으로 평가하고 개선점을 제시한다.

🔑 이 단계를 건너뛰면 안 되는 이유: 요구사항이 모호한 채로 코드를 쓰면, 나중에 다 뒤엎게 된다. GStack의 의사결정 레이어가 이걸 방지한다.

STEP 2 — 컨텍스트 고정 (CLAUDE.md)

의사결정이 끝나면, 프로젝트 루트의 CLAUDE.md에 핵심 내용을 정리한다. 세션이 바뀌거나 작업이 길어질 때 Claude가 맥락을 잃지 않게 하는 장치다.

## 프로젝트 개요
- 목표: [STEP 1에서 확정된 내용]
- 기술 스택: [확정된 스택]
- 아키텍처 결정사항: [/plan-eng-review에서 나온 내용]

## gstack
Use /browse 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, /design-shotgun, /design-html, /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, /learn.

## 코딩 규칙
- [프로젝트에 맞는 규칙 추가]

STEP 3 — 계획 수립 (Superpowers)

이제 Superpowers의 실행 루프에 진입한다.

brainstorming → 가벼운 추가 정제가 필요하면 여기서 한 번 더 다듬는다.
writing-plans → 구현 계획을 작성한다. 작업을 2~5분 단위의 작은 태스크로 쪼개고, 각 태스크에 파일 경로·코드·검증 단계까지 포함한다.

💡 Superpowers의 계획은 "열정적이지만 경험 없는 주니어 개발자도 따라할 수 있을 정도로" 상세하게 작성된다. 이게 핵심이다.

STEP 4 — TDD + 구현 (Superpowers)

Superpowers의 가장 강력한 부분이다.

단계	스킬	설명
🔴 RED	test-driven-development	실패하는 테스트를 먼저 작성한다.
🟢 GREEN	test-driven-development	테스트를 통과하는 최소한의 코드를 작성한다.
🔵 REFACTOR	test-driven-development	코드를 정리하고 커밋한다.
⚡ 실행	executing-plans / subagent-driven-development	계획에 따라 배치 실행하거나, 서브에이전트가 태스크별로 독립 실행한다.
🔀 병렬	dispatching-parallel-agents	규모가 큰 작업은 여러 에이전트를 동시에 돌린다.

⚠️ 주의: Superpowers는 테스트 없이 작성된 코드를 삭제한다. "테스트 먼저"가 강제 규칙이다.

STEP 5 — 검증 · 리뷰 (양쪽 도구 모두 활용)

코드가 작성된 후, 두 프레임워크의 강점을 동시에 쓴다.

도구	커맨드	역할
Superpowers	requesting-code-review	계획 대비 코드 리뷰. 심각도별 이슈 보고. Critical은 진행 차단.
Superpowers	verification-before-completion	진짜 고쳐졌는지 증거 기반 검증.
GStack	/review	CI는 통과하지만 프로덕션에서 터지는 버그를 잡는다. 명확한 건 자동 수정.
GStack	/qa	실제 브라우저를 열어서 유저 관점으로 테스트. 버그 발견 → 수정 → 회귀 테스트까지 자동.
GStack	/cso	OWASP Top 10 + STRIDE 보안 감사. 8/10 이상 확신도 게이트.
GStack	/codex (선택)	OpenAI Codex로 세컨드 오피니언. Claude와 다른 AI의 교차 분석.

STEP 6 — 배포 · 회고 (GStack)

순서	커맨드	역할
①	/ship	main 동기화 → 테스트 실행 → 커버리지 감사 → PR 생성. 테스트 프레임워크가 없으면 자동 구축.
②	/land-and-deploy	PR 머지 → CI 대기 → 프로덕션 배포 → 헬스체크 검증. 한 커맨드로 끝.
③	/canary	배포 후 모니터링. 콘솔 에러, 성능 회귀, 페이지 실패 감시.
④	/document-release	README, ARCHITECTURE 등 모든 문서를 자동 업데이트. (/ship이 자동 호출하기도 함)
⑤	/retro	주간 회고. 작업량, 테스트 건강도, 성장 포인트 정리. /retro global은 전체 프로젝트 통합 회고.
⑥	/learn	세션에서 배운 패턴·실수를 축적. 다음 세션부터 Claude가 더 똑똑해진다.

---

5. 전체 흐름 한눈에 보기

┌─────────────────────────────────────────────────┐
│  STEP 1: 의사결정 (GStack)                        │
│  /office-hours → /plan-ceo-review → /plan-eng-review │
├─────────────────────────────────────────────────┤
│  STEP 2: 컨텍스트 고정                             │
│  CLAUDE.md 정리                                    │
├─────────────────────────────────────────────────┤
│  STEP 3: 계획 수립 (Superpowers)                   │
│  brainstorming → writing-plans                     │
├─────────────────────────────────────────────────┤
│  STEP 4: TDD + 구현 (Superpowers)                  │
│  test-driven-development → executing-plans         │
├─────────────────────────────────────────────────┤
│  STEP 5: 검증 (GStack + Superpowers)               │
│  /review → /qa → /cso → code-review               │
├─────────────────────────────────────────────────┤
│  STEP 6: 배포 · 회고 (GStack)                      │
│  /ship → /land-and-deploy → /retro → /learn        │
└─────────────────────────────────────────────────┘

---

6. 실전 팁 & 주의사항

⚠️ 토큰 절약 — 전부 켜지 마라

GStack의 모든 역할을 동시에 활성화하면 단일 실행에 10,000+ 토큰이 소모된다. 핵심 3개 커맨드(/office-hours, /plan-ceo-review, /plan-eng-review)만 선별적으로 사용하는 게 좋다.

⚠️ 작업 크기에 따라 유연하게

작업 크기	추천 조합
2줄 수정, 오타 수정	Superpowers만 (또는 플러그인 없이)
중간 기능 추가	GStack 의사결정 일부 + Superpowers 실행
대규모 새 기능	6단계 풀 워크플로우
요구사항이 모호할 때	GStack부터 시작
요구사항이 명확할 때	Superpowers부터 시작

⚠️ GStack 팀 모드 설정 (선택)

팀 프로젝트라면, GStack을 팀 전체가 공유하도록 설정할 수 있다.

# 팀 모드 활성화 (자동 업데이트 포함)
cd ~/.claude/skills/gstack && ./setup --team

# 프로젝트 레포에 적용
cd <your-repo>
~/.claude/skills/gstack/bin/gstack-team-init required
git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"

⚠️ GStack 업그레이드

# Claude Code 안에서 실행
/gstack-upgrade

⚠️ Superpowers 업데이트

/plugin update superpowers

---

7. 삭제 방법 (혹시 모르니까)

GStack 삭제

~/.claude/skills/gstack/bin/gstack-uninstall

Superpowers 삭제

Claude Code 플러그인 마켓플레이스에서 uninstall.

---

8. 참고 링크

항목	링크
GStack GitHub	https://github.com/garrytan/gstack
Superpowers GitHub	https://github.com/obra/superpowers
GStack 스킬 상세 문서	https://github.com/garrytan/gstack/blob/main/docs/skills.md
GStack Builder 철학	https://github.com/garrytan/gstack/blob/main/ETHOS.md
Superpowers 블로그 원문	https://blog.fsck.com/2025/10/09/superpowers/