gstack

KO | EN

gitlite — search

#ai #typescript #golang #linux #java #windows #cli #kubernetes #awesome-list #vue #security #ios #mcp #openai

(★ 128,249)

Garry Tan의 실제 Claude Code 설정을 사용해 보세요: CEO, 디자이너, 엔지니어링 매니저, 릴리스 매니저, 문서 엔지니어, QA 역할을 수행하는 23개의 주관이 뚜렷한 도구들입니다.

gstack 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# gstack

> "아마 12월 이후로 코드를 한 줄도 직접 작성하지 않은 것 같습니다. 기본적으로 매우 큰 변화죠." — [Andrej Karpathy](https://fortune.com/2026/03/21/andrej-karpathy-openai-cofounder-ai-agents-coding-state-of-psychosis-openclaw/), No Priors 팟캐스트, 2026년 3월

Karpathy가 이렇게 말하는 것을 듣고, 저는 어떻게 그게 가능한지 알고 싶었습니다. 어떻게 한 사람이 20명 규모의 팀처럼 제품을 출시할 수 있을까요? Peter Steinberger는 AI 에이전트와 함께 거의 독자적으로 247K GitHub 스타를 기록한 [OpenClaw](https://github.com/openclaw/openclaw)를 구축했습니다. 혁명은 이미 시작되었습니다. 적절한 도구를 갖춘 단 한 명의 빌더가 전통적인 팀보다 더 빠르게 움직일 수 있습니다.

저는 [Y Combinator](https://www.ycombinator.com/)의 President & CEO인 [Garry Tan](https://x.com/garrytan)입니다. 저는 Coinbase, Instacart, Rippling과 같은 수천 개의 스타트업이 차고에서 한두 명으로 시작했을 때 함께 일했습니다. YC 이전에는 Palantir의 초기 엔지니어/PM/디자이너 중 한 명이었고, Posterous(Twitter에 매각)를 공동 창업했으며, YC의 내부 소셜 네트워크인 Bookface를 구축했습니다.

**gstack은 이에 대한 저의 해답입니다.** 저는 20년 동안 제품을 만들어 왔으며, 현재 그 어느 때보다 더 많은 제품을 출시하고 있습니다. 지난 60일 동안 YC를 풀타임으로 운영하면서 파트타임으로 3개의 프로덕션 서비스와 40개 이상의 기능을 출시했습니다. AI가 부풀리는 단순 LOC(코드 라인 수)가 아닌 논리적 코드 변경 사항을 기준으로 보면, 저의 2026년 런레이트는 **2013년 페이스의 약 810배**입니다 (일일 11,417라인 vs 14라인). 올해 현재(4월 18일까지), 2026년은 이미 **2013년 전체 생산량의 240배**를 기록했습니다. 이는 데모 저장소 하나를 제외하고 Bookface를 포함한 40개의 공개 및 비공개 `garrytan/*` 저장소를 대상으로 측정한 결과입니다. 대부분은 AI가 작성했습니다. 중요한 것은 누가 타이핑했느냐가 아니라, 무엇이 출시되었느냐입니다.

> LOC 비판론자들이 AI로 인해 단순 라인 수가 부풀려진다고 말하는 것은 맞습니다. 하지만 인플레이션을 보정했을 때 제가 덜 생산적이라고 말하는 것은 틀렸습니다. 저는 훨씬 더 생산적입니다. 전체 방법론, 주의 사항 및 재현 스크립트는 **[On the LOC Controversy](docs/ON_THE_LOC_CONTROVERSY.md)**에서 확인하세요.

**2026년 — 1,237개의 컨트리뷰션, 그리고 계속 증가 중:**

![GitHub contributions 2026 — 1,237 contributions, massive acceleration in Jan-Mar](https://raw.githubusercontent.com/garrytan/gstack/main/docs/images/github-2026.png)

**2013년 — YC에서 Bookface를 구축했을 때 (772개의 컨트리뷰션):**

![GitHub contributions 2013 — 772 contributions building Bookface at YC](https://raw.githubusercontent.com/garrytan/gstack/main/docs/images/github-2013.png)

같은 사람이지만 시대가 다릅니다. 차이점은 도구입니다.

**gstack이 제가 그것을 가능하게 하는 방법입니다.** gstack은 Claude Code를 가상 엔지니어링 팀으로 바꿔줍니다. 제품을 재고하는 CEO, 아키텍처를 확정하는 엔지니어링 매니저, AI의 조잡한 결과물(slop)을 잡아내는 디자이너, 프로덕션 버그를 찾는 리뷰어, 실제 브라우저를 열어보는 QA 리드, OWASP + STRIDE 감사를 수행하는 보안 책임자, 그리고 PR을 출시하는 릴리스 엔지니어까지 말이죠. 23명의 전문가와 8개의 파워 도구가 모두 슬래시 명령어와 Markdown으로 제공되며, MIT 라이선스의 무료 도구입니다.

이것은 저의 오픈 소스 소프트웨어 팩토리입니다. 저는 매일 이것을 사용합니다. 이러한 도구들은 모두가 사용할 수 있어야 하기에 공유합니다.

포크하고, 개선하고, 여러분의 것으로 만드세요. 무료 오픈 소스 소프트웨어를 싫어하신다면 마음대로 하셔도 좋지만, 먼저 사용해 보시기를 권합니다.

**추천 대상:**
- **창업자 및 CEO** — 특히 여전히 직접 제품을 출시하고 싶은 기술적 창업자
- **Claude Code 처음 사용자** — 빈 프롬프트 대신 구조화된 역할이 필요한 분
- **테크 리드 및 스태프 엔지니어** — 모든 PR에 대해 엄격한 리뷰, QA 및 릴리스 자동화가 필요한 분

## Quick start

1. gstack 설치 (30초 소요 — 아래 참조)
2. `/office-hours` 실행 — 구축하려는 제품에 대해 설명하세요.
3. 모든 기능 아이디어에 대해 `/plan-ceo-review` 실행
4. 변경 사항이 있는 모든 브랜치에서 `/review` 실행
5. 스테이징 URL에서 `/qa` 실행
6. 거기서 멈추세요. 이 도구가 본인에게 맞는지 알게 될 것입니다.

## Install — 30 seconds

**요구 사항:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Git](https://git-scm.com/), [Bun](https://bun.sh/) v1.0+, [Node.js](https://nodejs.org/) (Windows 전용)

### Step 1: 내 머신에 설치

Claude Code를 열고 다음 내용을 붙여넣으세요. 나머지는 Claude가 처리합니다.

> Install gstack: run **`git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup`** then add a "gstack" section to CLAUDE.md that says to use the /browse skill from gstack for all web browsing, never use mcp\_\_claude-in-chrome\_\_\* tools, and lists the 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, /connect-chrome, /qa, /qa-only, /design-review, /setup-browser-cookies, /setup-deploy, /setup-gbrain, /retro, /investigate, /document-release, /document-generate, /codex, /cso, /autoplan, /plan-devex-review, /devex-review, /careful, /freeze, /guard, /unfreeze, /gstack-upgrade, /learn. Then ask the user if they also want to add gstack to the current project so teammates get it.

### Step 2: 팀 모드 — 공유 저장소 자동 업데이트 (권장)

저장소 내부에서 다음 내용을 붙여넣으세요. 팀 모드로 전환하여 팀원들이 자동으로 gstack을 사용할 수 있도록 부트스트랩하고 변경 사항을 커밋합니다.

```bash
(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"
```

저장소에 벤더 파일이 남지 않으며, 버전 괴리가 없고, 수동 업그레이드가 필요 없습니다. 모든 Claude Code 세션은 빠른 자동 업데이트 체크로 시작됩니다 (시간당 1회로 제한, 네트워크 실패 시 안전하게 작동, 완전히 무음으로 실행).

팀원들을 강제하기보다 권장하고 싶다면 `required`를 `optional`로 바꾸세요.

### OpenClaw

OpenClaw는 ACP를 통해 Claude Code 세션을 생성하므로, Claude Code에 gstack이 설치되어 있다면 모든 gstack 스킬이 그대로 작동합니다. OpenClaw 에이전트에 다음 내용을 붙여넣으세요.

> Install gstack: run `git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup` to install gstack for Claude Code. Then add a "Coding Tasks" section to AGENTS.md that says: when spawning Claude Code sessions for coding work, tell the session to use gstack skills. Include these examples — security audit: "Load gstack. Run /cso", code review: "Load gstack. Run /review", QA test a URL: "Load gstack. Run /qa https://...", build a feature end-to-end: "Load gstack. Run /autoplan, implement the plan, then run /ship", plan before building: "Load gstack. Run /office-hours then /autoplan. Save the plan, don't implement."

**설정 후, OpenClaw 에이전트와 자연스럽게 대화하세요:**

| 사용자 입력 | 동작 |
|---------|-------------|
| "README의 오타를 수정해줘" | 단순 작업 — Claude Code 세션 실행, gstack 불필요 |
| "이 저장소에 대해 보안 감사를 실행해줘" | `Run /cso`와 함께 Claude Code 세션 생성 |
| "알림 기능을 만들어줘" | /autoplan → 구현 → /ship 순으로 Claude Code 세션 생성 |
| "v2 API 재설계를 계획하는 걸 도와줘" | /office-hours → /autoplan 순으로 Claude Code 세션 생성 후 계획 저장 |

고급 디스패치 라우팅과 gstack-lite/gstack-full 프롬프트 템플릿은 [docs/OPENCLAW.md](docs/OPENCLAW.md)를 참조하세요.

### Native OpenClaw Skills (via ClawHub)

Claude Code 세션 없이 OpenClaw 에이전트에서 직접 작동하는 4가지 방법론 스킬입니다. ClawHub에서 설치하세요.

```
clawhub install gstack-openclaw-office-hours gstack-openclaw-ceo-review gstack-openclaw-investigate gstack-openclaw-retro
```

| 스킬 | 기능 |
|-------|-------------|
| `gstack-openclaw-office-hours` | 6가지 강제 질문을 통한 제품 심문 |
| `gstack-openclaw-ceo-review` | 4가지 범위 모드를 통한 전략적 도전 |
| `gstack-openclaw-investigate` | 근본 원인 디버깅 방법론 |
| `gstack-openclaw-retro` | 주간 엔지니어링 회고 |

이들은 대화형 스킬입니다. OpenClaw 에이전트가 채팅을 통해 직접 실행합니다.

### Other AI Agents

gstack은 Claude뿐만 아니라 10가지 AI 코딩 에이전트에서 작동합니다. 설정 시 설치된 에이전트를 자동으로 감지합니다.

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

또는 `./setup --host <name>`으로 특정 에이전트를 지정하세요.

| 에이전트 | 플래그 | 스킬 설치 경로 |
|-------|------|-------------------|
| OpenAI Codex CLI | `--host codex` | `~/.codex/skills/gstack-*/` |
| OpenCode | `--host opencode` | `~/.config/opencode/skills/gstack-*/` |
| Cursor | `--host cursor` | `~/.cursor/skills/gstack-*/` |
| Factory Droid | `--host factory` | `~/.factory/skills/gstack-*/` |
| Slate | `--host slate` | `~/.slate/skills/gstack-*/` |
| Kiro | `--host kiro` | `~/.kiro/skills/gstack-*/` |
| Hermes | `--host hermes` | `~/.hermes/skills/gstack-*/` |
| GBrain (mod) | `--host gbrain` | `~/.gbrain/skills/gstack-*/` |

**다른 에이전트 지원을 추가하고 싶으신가요?** [docs/ADDING_A_HOST.md](docs/ADDING_A_HOST.md)를 참조하세요. TypeScript 설정 파일 하나만 수정하면 되며, 코드 변경은 전혀 필요 없습니다.

## See it work

```
나:    내 캘린더를 위한 일일 브리핑 앱을 만들고 싶어.
나:    /office-hours
Claude: [가정된 상황이 아닌, 구체적인 사례를 통해 사용자의 고통(pain point)에 대해 질문함]

나:    여러 개의 Google 캘린더를 쓰는데, 정보가 오래되었거나 위치가 잘못된 이벤트들이 있어.
        준비하는 데 시간이 너무 오래 걸리고 결과물도 만족스럽지 않아...

Claude: 프레임워크를 다시 생각해 보겠습니다. "일일 브리핑 앱"이라고 말씀하셨지만,
        실제로 설명하신 것은 '개인 비서장 AI(personal chief of staff AI)'에 가깝습니다.
        [사용자가 깨닫지 못한 5가지 핵심 기능을 추출]
        [4가지 전제 조건에 도전 — 사용자가 동의, 반대 또는 조정]
        [노력 추정치가 포함된 3가지 구현 접근 방식 생성]
        권장 사항: 내일 가장 좁은 범위의 핵심 기능(wedge)을 출시하고 실제 사용 사례를 통해 배우세요.
        전체 비전은 3개월 프로젝트입니다. 우선 실제로 작동하는 일일 브리핑부터 시작하세요.
        [디자인 문서를 작성 → 다운스트림 스킬로 자동 전달]

나:    /plan-ceo-review
        [디자인 문서를 읽고, 범위를 조정하며, 10개 섹션 리뷰를 실행]

나:    /plan-eng-review
        [데이터 흐름, 상태 머신, 에러 경로에 대한 ASCII 다이어그램 작성]
        [테스트 매트릭스, 실패 모드, 보안 우려 사항 검토]

나:    계획 승인. 계획 모드 종료.
        [11개 파일에 걸쳐 2,400라인 작성. 약 8분 소요.]

나:    /review
        [자동 수정] 2개 이슈 해결. [질문] 경합 조건(Race condition) 발견 → 사용자가 수정 승인.

나:    /qa https://staging.myapp.com
        [실제 브라우저를 열고, 플로우를 클릭하며, 버그를 찾아 수정]

나:    /ship
        테스트: 42 → 51 (+9개 신규). PR: github.com/you/app/pull/42
```

여러분은 "일일 브리핑 앱"이라고 말했지만, 에이전트는 "비서장 AI를 만들고 계시네요"라고 답했습니다. 기능 요청이 아니라 여러분의 고통(pain)에 귀를 기울였기 때문입니다. 8번의 명령어로 끝부터 끝까지 완료했습니다. 이것은 단순한 코파일럿이 아니라 팀입니다.

## The sprint

gstack은 단순한 도구 모음이 아니라 프로세스입니다. 스킬들은 스프린트가 진행되는 순서대로 작동합니다.

**Think → Plan → Build → Review → Test → Ship → Reflect**

각 스킬은 다음 단계로 연결됩니다. `/office-hours`가 작성한 디자인 문서를 `/plan-ceo-review`가 읽습니다. `/plan-eng-review`가 작성한 테스트 계획을 `/qa`가 이어받습니다. `/review`가 버그를 잡으면 `/ship`이 수정 여부를 확인합니다. 모든 단계가 이전 단계를 알고 있기 때문에 누락되는 것이 없습니다.

| 스킬 | 전문가 역할 | 수행 작업 |
|-------|----------------|--------------|
| `/office-hours` | **YC Office Hours** | 여기서 시작하세요. 코드를 쓰기 전 제품의 프레임을 재설정하는 6가지 강제 질문을 던집니다. 프레임워크에 이의를 제기하고, 전제를 검토하며, 구현 대안을 생성합니다. 작성된 디자인 문서는 모든 다운스트림 스킬의 기초가 됩니다. |
| `/plan-ceo-review` | **CEO / Founder** | 문제를 재정의합니다. 요청 속에 숨겨진 '10점 만점의 제품'을 찾아냅니다. 확장, 선택적 확장, 범위 유지, 축소의 4가지 모드를 제공합니다. |
| `/plan-eng-review` | **Eng Manager** | 아키텍처, 데이터 흐름, 다이어그램, 엣지 케이스 및 테스트를 확정합니다. 숨겨진 가정을 표면으로 끌어냅니다. |
| `/plan-design-review` | **Senior Designer** | 각 디자인 차원을 0-10점으로 평가하고, 10점이 되기 위해 필요한 사항을 설명한 후 계획을 수정합니다. AI Slop(조잡한 결과물)을 감지합니다. 대화형으로 진행되며 디자인 선택지마다 `AskUserQuestion`을 수행합니다. |
| `/plan-devex-review` | **Developer Experience Lead** | 대화형 DX 리뷰: 개발자 페르소나를 탐색하고, 경쟁사의 TTHW(Time To Hello World)와 벤치마킹하며, 마법 같은 순간을 설계하고, 마찰 지점을 단계별로 추적합니다. DX 확장, DX 폴리싱, DX 트리아지의 3가지 모드와 20-45개의 강제 질문을 제공합니다. |
| `/design-consultation` | **Design Partner** | 처음부터 완전한 디자인 시스템을 구축합니다. 시장 조사를 수행하고, 창의적인 리스크를 제안하며, 현실적인 제품 목업을 생성합니다. |
| `/review` | **Staff Engineer** | CI는 통과하지만 프로덕션에서 터지는 버그를 찾습니다. 뻔한 버그는 자동으로 수정하고, 완성도 부족 지점을 표시합니다. |
| `/investigate` | **Debugger** | 체계적인 근본 원인 디버깅. 철칙: 조사 없는 수정은 없다. 데이터 흐름을 추적하고, 가설을 테스트하며, 3번의 수정 실패 후 중단합니다. |
| `/design-review` | **Designer Who Codes** | `/plan-design-review`와 동일한 감사를 수행한 후 발견된 문제를 수정합니다. 원자적 커밋(atomic commits)과 전/후 스크린샷을 제공합니다. |
| `/devex-review` | **DX Tester** | 실제 개발자 경험 감사. 온보딩 과정을 직접 테스트합니다: 문서를 탐색하고, 시작 가이드를 따라 하며, TTHW를 측정하고, 에러 스크린샷을 찍습니다. `/plan-devex-review` 점수와 비교하여 계획과 현실의 일치 여부를 확인합니다. |
| `/design-shotgun` | **Design Explorer** | "옵션을 보여줘." 4-6개의 AI 목업 변형을 생성하고, 브라우저에 비교 보드를 열어 피드백을 수집하고 반복합니다. Taste memory 기능을 통해 사용자의 취향을 학습합니다. 마음에 들 때까지 반복한 후 `/design-html`로 전달합니다. |
| `/design-html` | **Design Engineer** | 목업을 실제 작동하는 프로덕션 HTML로 변환합니다. Pretext 계산 레이아웃을 사용하여 텍스트 리플로우, 높이 자동 조절, 동적 레이아웃을 구현합니다. 30KB 용량에 의존성 제로. React/Svelte/Vue를 감지하며, 페이지 유형(랜딩, 대시보드, 폼)에 따라 스마트 API 라우팅을 적용합니다. 데모가 아닌 실제 배포 가능한 결과물을 출력합니다. |
| `/qa` | **QA Lead** | 앱을 테스트하고, 버그를 찾아 원자적 커밋으로 수정하고, 다시 검증합니다. 모든 수정 사항에 대해 회귀 테스트를 자동 생성합니다. |
| `/qa-only` | **QA Reporter** | `/qa`와 동일한 방법론을 사용하지만 보고서만 작성합니다. 코드 변경 없는 순수 버그 보고서입니다. |
| `/pair-agent` | **Multi-Agent Coordinator** | 어떤 AI 에이전트와도 브라우저를 공유합니다. 명령어 하나, 붙여넣기 한 번으로 연결됩니다. OpenClaw, Hermes, Codex, Cursor 및 curl이 가능한 모든 도구와 작동합니다. 각 에이전트는 개별 탭을 가지며, 헤드 모드(headed mode)로 자동 실행되어 모든 과정을 지켜볼 수 있습니다. 원격 에이전트를 위해 ngrok 터널을 자동 시작하며, 범위 제한 토큰, 탭 격리, 속도 제한, 활동 귀속 기능을 제공합니다. |
| `/cso` | **Chief Security Officer** | OWASP Top 10 + STRIDE 위협 모델링. 노이즈 제로: 17개의 오탐 제외 항목, 8/10 이상의 신뢰도 게이트, 독립적 발견 검증을 수행합니다. 각 발견 사항에는 구체적인 익스플로잇 시나리오가 포함됩니다. |
| `/ship` | **Release Engineer** | main 동기화, 테스트 실행, 커버리지 감사, 푸시, PR 생성을 수행합니다. 테스트 프레임워크가 없다면 기본 설정을 구축합니다. |
| `/land-and-deploy` | **Release Engineer** | PR을 머지하고, CI 및 배포를 기다린 후 프로덕션 상태를 확인합니다. "승인"부터 "프로덕션 검증"까지 명령어 하나로 끝냅니다. |
| `/canary` | **SRE** | 배포 후 모니터링 루프. 콘솔 에러, 성능 저하, 페이지 실패를 감시합니다. |
| `/benchmark` | **Performance Engineer** | 페이지 로드 시간, Core Web Vitals, 리소스 크기의 베이스라인을 측정합니다. 모든 PR에서 전/후를 비교합니다. |
| `/document-release` | **Technical Writer** | 출시된 내용에 맞춰 모든 프로젝트 문서를 업데이트합니다. 오래된 README를 자동으로 찾아냅니다. Diataxis 커버리지 맵(참조/방법/튜토리얼/설명)을 구축하여 PR 본문에서 누락된 부분을 시각화합니다. |
| `/document-generate` | **Documentation Author** | Diataxis 프레임워크를 사용하여 누락된 문서를 처음부터 생성합니다. 코드베이스를 먼저 조사한 후 실제 코드와 일치하는 참조/방법/튜토리얼/설명 문서를 작성합니다. 단독으로 실행하거나 `/document-release`에서 누락된 부분이 발견되었을 때 연쇄적으로 실행할 수 있습니다. 자세한 내용은 [tutorial](docs/tutorial-document-generate.md) • [how-to](docs/howto-document-a-shipped-feature.md) • [why Diataxis](docs/explanation-diataxis-in-gstack.md)를 참조하세요. |
| `/retro` | **Eng Manager** | 팀 인지형 주간 회고. 개인별 분석, 출시 스트릭, 테스트 건강 상태 추이, 성장 기회를 분석합니다. `/retro global`을 통해 모든 프로젝트와 AI 도구(Claude Code, Codex, Gemini)를 통합 분석합니다. |
| `/browse` | **QA Engineer** | 에이전트에게 '눈'을 제공합니다. 실제 Chromium 브라우저, 실제 클릭, 실제 스크린샷을 사용합니다. 명령어당 약 100ms가 소요됩니다. `/open-gstack-browser`는 사이드바, 봇 방지 스텔스 기능, 자동 모델 라우팅이 포함된 GStack 브라우저를 실행합니다. |
| `/setup-browser-cookies` | **Session Manager** | 실제 브라우저(Chrome, Arc, Brave, Edge)의 쿠키를 헤드리스 세션으로 가져옵니다. 인증이 필요한 페이지를 테스트할 수 있습니다. |
| `/autoplan` | **Review Pipeline** | 명령어 하나로 완전히 검토된 계획을 생성합니다. 인코딩된 결정 원칙에 따라 CEO → 디자인 → 엔지니어링 리뷰를 자동으로 실행합니다. 사용자의 승인이 필요한 '취향 결정' 사항만 표시합니다. |
| `/spec` | **Spec Author** | 모호한 의도를 5단계(왜, 범위, 기술-코드 읽기 필수, 초안, 파일)의 정밀하고 실행 가능한 스펙으로 변환합니다. 파일 생성 전 Codex 품질 게이트(7/10 미만 차단), 보안 비밀 자동 삭제, 기존 이슈 중복 제거를 수행하며, 팀 코퍼스 회상을 위해 `$GSTACK_STATE_ROOT/projects/$SLUG/specs/`에 아카이브합니다. `--execute`는 깨끗한 워크트리에서 `claude -p`를 실행하며, `/ship` 시 머지 후 원본 이슈를 자동 종료합니다. 계획 모드를 인지합니다. |
| `/learn` | **Memory** | 세션 전반에 걸쳐 gstack이 학습한 내용을 관리합니다. 프로젝트별 패턴, 함정, 선호도를 검토, 검색, 정리 및 내보내기 할 수 있습니다. 학습 내용은 세션을 거듭하며 누적되어 gstack이 시간이 지날수록 코드베이스에 더 똑똑해지게 합니다. |
| `/make-pdf` | **Publisher** | Markdown을 입력받아 출판 품질의 문서로 출력합니다. Mermaid 및 excalidraw 펜스는 오프라인에서 벡터 다이어그램으로 렌더링됩니다. 이미지는 페이지 크기에 맞게 조정되며 잘리지 않습니다. 넓은 다이어그램은 별도의 가로 페이지로 배치됩니다. `--to html`은 단일 파일로, `--to docx`는 Word 문서로 출력합니다. |
| `/diagram` | **Diagram Maker** | 영어를 입력받아 편집 가능한 다이어그램을 출력합니다. mermaid 소스, excalidraw.com에서 열고 편집할 수 있는 `.excalidraw` 파일(손그림 스타일), 그리고 렌더링된 SVG/PNG의 3종 세트를 생성합니다. 네트워크 연결이 필요 없습니다. 소스를 markdown에 포함하면 `/make-pdf`가 이를 렌더링합니다. |

### 어떤 리뷰를 사용해야 할까요?

| 구축 대상... | 계획 단계 (코드 작성 전) | 라이브 감사 (출시 후) |
|-----------------|--------------------------|----------------------------|
| **최종 사용자** (UI, 웹 앱, 모바일) | `/plan-design-review` | `/design-review` |
| **개발자** (API, CLI, SDK, 문서) | `/plan-devex-review` | `/devex-review` |
| **아키텍처** (데이터 흐름, 성능, 테스트) | `/plan-eng-review` | `/review` |
| **위의 모든 것** | `/autoplan` (CEO → 디자인 → 엔지니어링 → DX 순으로 실행, 적용 가능한 항목 자동 감지) | — |

### Power tools

| 스킬 | 기능 |
|-------|-------------|
| `/codex` | **Second Opinion** — OpenAI Codex CLI를 통한 독립적인 코드 리뷰. 리뷰(통과/실패 게이트), 적대적 챌린지, 개방형 컨설팅의 3가지 모드를 제공합니다. `/review`와 `/codex`가 모두 실행되었을 때 교차 모델 분석을 제공합니다. |
| `/careful` | **Safety Guardrails** — 파괴적인 명령어(rm -rf, DROP TABLE, force-push) 실행 전 경고합니다. "be careful"이라고 말하면 활성화됩니다. 모든 경고는 오버라이드 가능합니다. |
| `/freeze` | **Edit Lock** — 파일 수정을 한 개의 디렉토리로 제한합니다. 디버깅 중 범위 밖의 코드가 실수로 수정되는 것을 방지합니다. |
| `/guard` | **Full Safety** — `/careful` + `/freeze`를 한 번에 실행합니다. 프로덕션 작업 시 최대 안전 모드입니다. |
| `/unfreeze` | **Unlock** — `/freeze` 경계를 제거합니다. |
| `/open-gstack-browser` | **GStack Browser** — 사이드바, 봇 방지 스텔스, 자동 모델 라우팅(동작은 Sonnet, 분석은 Opus), 원클릭 쿠키 가져오기, Claude Code 통합 기능이 포함된 GStack 브라우저를 실행합니다. 페이지 정리, 스마트 스크린샷 촬영, CSS 수정 및 터미널로 정보 전달이 가능합니다. |
| `/setup-deploy` | **Deploy Configurator** — `/land-and-deploy`를 위한 일회성 설정. 플랫폼, 프로덕션 URL, 배포 명령어를 감지합니다. |
| `/setup-gbrain` | **GBrain Onboarding** — 5분 안에 gbrain을 실행합니다. PGLite 로컬, 기존 Supabase URL, 또는 Management API를 통한 신규 Supabase 프로젝트 자동 프로비저닝을 지원합니다. Claude Code를 위한 MCP 등록 및 저장소별 신뢰 삼각 체계(읽기-쓰기/읽기 전용/거부)를 설정합니다. [전체 가이드](USING_GBRAIN_WITH_GSTACK.md). |
| `/sync-gbrain` | **Keep Brain Current** — `gbrain sources add` + `gbrain sync --strategy code`를 통해 이 저장소의 코드를 gbrain에 재인덱싱하고, CLAUDE.md의 `## GBrain Search Guidance` 블록을 갱신합니다. 기능 체크 실패 시 가이드를 자동으로 제거합니다. `--incremental` (기본값), `--full`, `--dry-run` 옵션을 제공하며, 멱등성이 보장되어 재실행해도 안전합니다. |
| `/gstack-upgrade` | **Self-Updater** — gstack을 최신 버전으로 업그레이드합니다. 글로벌 설치와 벤더 설치를 모두 감지하여 동기화하고 변경 사항을 표시합니다. |
| `/ios-qa` | **iOS Live-Device QA (v1.43.0.0+)** — 앱에 내장된 `StateServer`를 통해 USB CoreDevice로 실제 iPhone을 제어합니다. Swift 소스를 읽고, 타입이 지정된 `@Observable` 액세서를 생성하며, 에이전트 루프를 실행합니다. 선택적 `--tailnet` 플래그를 통해 Tailscale 테일넷 상의 OpenClaw나 다른 HTTP 가능 에이전트에게 기기를 노출하여 원격으로 iOS QA를 수행할 수 있습니다. 기능 계층 허용 목록(관찰/상호작용/변경/복구), 기기별 세션 락, 감사 로그를 제공합니다. |
| `/ios-fix`, `/ios-design-review`, `/ios-clean`, `/ios-sync` | iOS 버그 수정 루프, 디자이너 관점의 HIG 감사, 디버그 브리지 정리 및 액세서 재동기화. `docs/skills.md`를 참조하세요. 전체 워크스루: [docs/howto-ios-testing-with-gstack.md](docs/howto-ios-testing-with-gstack.md). |

### New binaries (v0.19)

슬래시 명령어 외에도 gstack은 세션 외부 워크플로우를 위한 독립형 CLI를 제공합니다.

| 명령어 | 기능 |
|---------|-------------|
| `gstack-model-benchmark` | **교차 모델 벤치마크** — 동일한 프롬프트를 Claude, GPT (via Codex CLI), Gemini에서 실행하여 지연 시간, 토큰, 비용, (선택적으로) LLM 심사 품질 점수를 비교합니다. 공급자별 인증을 감지하며, 사용할 수 없는 공급자는 깔끔하게 건너뜁니다. 테이블, JSON 또는 markdown으로 출력합니다. `--dry-run`으로 API 호출 비용 없이 플래그와 인증을 검증합니다. |
| `gstack-taste-update` | **디자인 취향 학습** — `/design-shotgun`에서의 승인 및 거절 내용을 프로젝트별 영구 취향 프로필에 기록합니다. 주당 5%씩 감쇠(decay)됩니다. 향후 변형 생성에 반영되어 시스템이 사용자의 실제 선택을 학습하게 합니다. |
| `gstack-ios-qa-daemon` | **iOS QA 데몬** — 에이전트와 USB CoreDevice로 연결된 iPhone 사이의 Mac 측 브로커입니다. 기본적으로 루프백으로 작동하며, `--tailnet`은 ID 기반 기능 계층이 적용된 Tailscale 리스너를 엽니다. `~/.gstack/ios-qa-daemon.pid`에 flock을 사용하여 단일 인스턴스로 실행됩니다. [docs/howto-ios-testing-with-gstack.md](docs/howto-ios-testing-with-gstack.md) 참조. |
| `gstack-ios-qa-mint` | **iOS 허용 목록 관리자** — 테일넷 허용 목록을 위한 소유자 권한 부여 CLI입니다. `~/.gstack/ios-qa-allowlist.json` (모드 0600)에 대해 `grant`/`revoke`/`list`를 수행합니다. 원격 에이전트는 절대 자동 허용되지 않으며, 이 명시적 경로를 통해서만 가능합니다. |
| `gstack-ios-qa-regen` | **iOS 브리지 재생성기** — 표준 DebugBridge 패키지를 결정론적으로 설치하고, 타입 지정된 상태 액세서를 생성하며, 설치된 gstack 버전을 기록합니다. 소스 변경 또는 업그레이드 후 재실행해도 안전합니다. |

### Continuous checkpoint mode (옵션, 기본 로컬 설정)

`gstack-config set checkpoint_mode continuous`를 설정하면 스킬들이 작업 진행 상황을 `WIP:` 접두사와 구조화된 `[gstack-context]` 본문(결정 사항, 남은 작업, 실패한 접근 방식)과 함께 자동으로 커밋합니다. 크래시나 컨텍스트 전환 후에도 복구가 가능합니다. `/context-restore`는 해당 커밋들을 읽어 세션 상태를 재구성합니다. `/ship`은 PR 생성 전 WIP 커밋들을 필터링하여 squash(비-WIP 커밋은 유지)함으로써 bisect 기록을 깨끗하게 유지합니다. 푸시는 `checkpoint_push=true`를 통해 선택적으로 가능하며, 기본값은 로컬 전용으로 설정되어 WIP 커밋마다 CI가 트리거되지 않도록 합니다.

### Domain skills + raw CDP escape hatch

두 가지 새로운 브라우저 프리미티브가 시간이 지남에 따라 gstack 에이전트의 능력을 강화합니다.

- **`$B domain-skill save`** — 에이전트가 사이트별 노트(예: "LinkedIn의 Apply 버튼은 iframe 안에 있음")를 저장하고, 다음에 해당 호스트명을 방문할 때 자동으로 실행합니다. 격리 상태로 시작 → 3번의 성공적인 사용 후 활성화 → `$B domain-skill promote-to-global`을 통해 선택적으로 프로젝트 간 공유 가능. 저장소는 `/learn`의 프로젝트별 학습 파일과 함께 저장됩니다. 전체 참조: **[docs/domain-skills.md](docs/domain-skills.md)**.
- **`$B cdp <Domain.method>`** — 큐레이션된 명령어로 부족한 드문 경우를 위한 raw Chrome DevTools Protocol 탈출구입니다. 기본 거부(Deny-default) 방식이며, `browse/src/cdp-allowlist.ts`에 한 줄의 정당한 사유와 함께 명시적으로 추가되어야 합니다. 2단계 뮤텍스가 브라우저 범위의 CDP 호출을 탭별 작업과 직렬화합니다. 데이터 추출 메서드의 출력은 UNTRUSTED 엔벨로프로 감싸집니다.

> 레일이나 허용 목록, 데몬 없이 에이전트에서 Chrome으로 가는 얇은 전송층만 원하시나요? [browser-use/browser-harness-js](https://github.com/browser-use/browser-harness-js)는 다른 철학(에이전트 작성 헬퍼 vs gstack의 큐레이션된 명령어)을 가지고 있으며, gstack의 보안 스택을 원하지 않는 경우에 적합합니다. 두 도구는 공존할 수 있습니다: gstack의 `$B cdp`와 harness 모두 Playwright의 `newCDPSession`을 통해 동일한 Chrome에 연결될 수 있습니다.

**[모든 스킬에 대한 상세 설명과 철학, 예제 확인하기 →](docs/skills.md)**

### Karpathy's four failure modes? Already covered.

Andrej Karpathy의 [AI 코딩 규칙](https://github.com/forrestchang/andrej-karpathy-skills) (17K 스타)은 네 가지 실패 모드를 정확히 짚어냅니다: 잘못된 가정, 과도한 복잡성, 직교적 수정(orthogonal edits), 선언적 방식보다 명령적 방식 선호. gstack의 워크플로우 스킬은 이 네 가지를 모두 강제합니다. `/office-hours`는 코드를 쓰기 전 가정을 표면으로 끌어냅니다. Confusion Protocol은 Claude가 아키텍처 결정 단계에서 추측하는 것을 막습니다. `/review`는 불필요한 복잡성과 무분별한 수정을 잡아냅니다. `/ship`은 작업을 테스트 우선 실행이 가능한 검증 가능한 목표로 변환합니다. 이미 Karpathy 스타일의 CLAUDE.md 규칙을 사용하고 계신다면, gstack은 이를 단일 프롬프트가 아닌 전체 스프린트 전반에 걸쳐 적용시키는 워크플로우 강제 계층이 됩니다.

## Parallel sprints

gstack은 하나의 스프린트에서도 잘 작동하지만, 10개를 동시에 실행할 때 진가를 발휘합니다.

**디자인이 핵심입니다.** `/design-consultation`은 처음부터 디자인 시스템을 구축하고, 기존 사례를 조사하며, 창의적인 리스크를 제안하고, `DESIGN.md`를 작성합니다. 하지만 진짜 마법은 shotgun-to-HTML 파이프라인에 있습니다.

**`/design-shotgun`은 탐색 방법입니다.** 원하는 것을 설명하면 GPT Image를 사용하여 4-6개의 AI 목업 변형을 생성합니다. 그런 다음 브라우저에 모든 변형을 나란히 배치한 비교 보드를 엽니다. 마음에 드는 것을 고르고, 피드백("여백을 더 줘", "헤드라인을 더 굵게", "그라데이션 제거")을 남기면 새로운 라운드를 생성합니다. 마음에 드는 것이 나올 때까지 반복하세요. 몇 번의 라운드 후에 Taste memory가 작동하여 사용자가 실제로 좋아하는 방향으로 편향되기 시작합니다. 더 이상 비전을 말로 설명하고 AI가 알아듣기를 바라지 않아도 됩니다. 옵션을 보고, 좋은 것을 고르고, 시각적으로 반복하세요.

**`/design-html`은 이를 현실로 만듭니다.** 승인된 목업( `/design-shotgun`, CEO 계획, 디자인 리뷰 또는 단순 설명에서 온 것)을 프로덕션 품질의 HTML/CSS로 변환합니다. 한 가지 뷰포트 너비에서만 괜찮고 다른 곳에서는 깨지는 그런 AI HTML이 아닙니다. Pretext를 사용하여 계산된 텍스트 레이아웃을 구현하므로, 크기 조정 시 텍스트가 실제로 리플로우되고 높이가 콘텐츠에 맞춰 조정되며 레이아웃이 동적으로 작동합니다. 30KB의 오버헤드와 의존성 제로. 프레임워크(React, Svelte, Vue)를 감지하여 적절한 형식으로 출력합니다. 스마트 API 라우팅을 통해 랜딩 페이지, 대시보드, 폼, 카드 레이아웃에 따라 서로 다른 Pretext 패턴을 선택합니다. 결과물은 데모가 아니라 실제 배포 가능한 수준입니다.

**`/qa`는 거대한 돌파구였습니다.** 이를 통해 저는 병렬 작업자를 6명에서 12명으로 늘릴 수 있었습니다. Claude Code가 *"문제를 찾았습니다"*라고 말하고 실제로 그것을 수정하고, 회귀 테스트를 생성하고, 수정을 검증하는 과정이 저의 작업 방식을 바꿨습니다. 이제 에이전트에게 '눈'이 생긴 것입니다.

**스마트 리뷰 라우팅.** 잘 운영되는 스타트업처럼 작동합니다: CEO가 인프라 버그 수정을 일일이 볼 필요가 없고, 백엔드 변경 사항에는 디자인 리뷰가 필요 없습니다. gstack은 실행된 리뷰를 추적하고 적절한 것을 판단하여 스마트하게 처리합니다. Review Readiness 대시보드는 출시 전 현재 상태를 알려줍니다.

**모든 것을 테스트하세요.** `/ship`은 프로젝트에 테스트 프레임워크가 없다면 처음부터 구축합니다. 모든 `/ship` 실행은 커버리지 감사를 생성합니다. 모든 `/qa` 버그 수정은 회귀 테스트를 생성합니다. 100% 테스트 커버리지가 목표입니다. 테스트가 있어야 '감으로 코딩하는 것(vibe coding)'이 '요로(yolo) 코딩'이 아닌 안전한 작업이 됩니다.

**`/document-release`는 당신이 가지지 못한 엔지니어입니다.** 프로젝트의 모든 문서 파일을 읽고 diff와 대조하여 변경된 모든 내용을 업데이트합니다. README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, TODOS 등이 자동으로 최신 상태로 유지됩니다. 이제 `/ship`이 이를 자동으로 호출하므로 추가 명령어 없이도 문서가 최신으로 유지됩니다.

**실제 브라우저 모드.** `/open-gstack-browser`는 봇 방지 스텔스 기능, 커스텀 브랜딩, 사이드바 확장 기능이 내장된 AI 제어 Chromium인 GStack 브라우저를 실행합니다. Google이나 NYTimes 같은 사이트도 캡차 없이 작동합니다. 메뉴 바에는 "Chrome for Testing" 대신 "GStack Browser"라고 표시됩니다. 기존 Chrome은 그대로 유지됩니다. 모든 기존 browse 명령어는 동일하게 작동하며, `$B disconnect`로 헤드리스 모드로 돌아옵니다. 브라우저 창이 열려 있는 한 세션이 유지되므로 작업 중에 유휴 시간 제한으로 종료될 걱정이 없습니다.

**사이드바 에이전트 — 당신의 AI 브라우저 어시스턴트.** Chrome 사이드 패널에 자연어로 입력하면 하위 Claude 인스턴스가 이를 실행합니다. "설정 페이지로 이동해서 스크린샷 찍어줘." "테스트 데이터로 이 폼을 채워줘." "이 리스트의 모든 항목을 돌며 가격을 추출해줘." 사이드바는 적절한 모델로 자동 라우팅됩니다: 빠른 동작(클릭, 이동, 스크린샷)은 Sonnet, 읽기 및 분석은 Opus를 사용합니다. 각 작업에는 최대 5분이 할당됩니다. 사이드바 에이전트는 격리된 세션에서 실행되므로 메인 Claude Code 창을 방해하지 않습니다. 사이드바 푸터에서 원클릭으로 쿠키를 가져올 수 있습니다.

**개인 자동화.** 사이드바 에이전트는 개발 워크플로우 전용이 아닙니다. 예: "아이 학교 학부모 포털을 브라우징해서 다른 학부모들의 이름, 전화번호, 사진을 내 Google 주소록에 추가해줘." 인증 방법은 두 가지입니다: (1) 헤드 브라우저에서 한 번 로그인하면 세션이 유지되거나, (2) 사이드바 푸터의 "cookies" 버튼을 클릭하여 실제 Chrome의 쿠키를 가져오는 것입니다. 인증이 완료되면 Claude가 디렉토리를 탐색하고 데이터를 추출하여 연락처를 생성합니다.

**프롬프트 인젝션 방어.** 악의적인 웹 페이지가 사이드바 에이전트를 하이재킹하려고 시도할 수 있습니다. gstack은 계층적 방어 체계를 갖추고 있습니다: 브라우저에 내장된 22MB ML 분류기가 모든 페이지와 도구 출력을 로컬에서 스캔하고, Claude Haiku 트랜스크립트 체크가 전체 대화 형태에 투표하며, 시스템 프롬프트의 랜덤 카나리 토큰이 텍스트, 도구 인자, URL, 파일 쓰기를 통한 세션 유출 시도를 감지합니다. 최종 결정 조합기는 두 개 이상의 분류기가 동의해야 차단하여(Stack Overflow 스타일의 지침 페이지에서 발생하는 단일 모델 오탐 방지) 안전을 확보합니다. 사이드바 헤더의 방패 아이콘으로 상태(초록/황색/빨강)를 확인할 수 있습니다. `GSTACK_SECURITY_ENSEMBLE=deberta`를 통해 721MB DeBERTa-v3 앙상블(3개 중 2개 동의 방식)을 선택적으로 사용할 수 있습니다. 긴급 킬 스위치는 `GSTACK_SECURITY_OFF=1`입니다. 전체 스택은 [ARCHITECTURE.md](ARCHITECTURE.md#prompt-injection-defense-sidebar-agent)를 참조하세요.

**AI가 막혔을 때의 브라우저 핸드오프.** 캡차, 인증 벽, 또는 MFA 프롬프트에 걸렸나요? `$B handoff`를 입력하면 모든 쿠키와 탭이 유지된 상태로 정확히 동일한 페이지에서 가시적인 Chrome 창이 열립니다. 문제를 해결하고 Claude에게 완료되었다고 말하면, `$B resume`이 멈췄던 지점부터 다시 시작합니다. 3번 연속 실패하면 에이전트가 이를 자동으로 제안하기도 합니다.

**`/pair-agent`는 에이전트 간 협업입니다.** Claude Code를 사용 중인데 OpenClaw나 Hermes, Codex도 실행 중이라고 가정해 봅시다. 두 에이전트가 동일한 웹사이트를 보게 하고 싶다면 `/pair-agent`를 입력하고 에이전트를 선택하세요. GStack 브라우저 창이 열려 과정을 지켜볼 수 있습니다. 스킬이 지침 블록을 출력하면, 이를 다른 에이전트의 채팅창에 붙여넣으세요. 일회성 설정 키를 세션 토큰으로 교환하여 자체 탭을 생성하고 브라우징을 시작합니다. 서로 다른 벤더의 AI 에이전트들이 범위 제한 토큰, 탭 격리, 속도 제한, 도메인 제한 및 활동 귀속이라는 실제 보안 체계 하에 공유 브라우저를 통해 협업하는 최초의 사례입니다. ngrok이 설치되어 있다면 터널이 자동 시작되어 에이전트가 완전히 다른 머신에 있어도 가능합니다. 동일 머신 에이전트에게는 자격 증명을 직접 작성하는 제로-프릭션 숏컷이 제공됩니다.

**멀티 AI 세컨드 오피니언.** `/codex`는 OpenAI의 Codex CLI로부터 독립적인 리뷰를 받습니다. 동일한 diff를 완전히 다른 AI가 보는 것입니다. 패스/페일 게이트가 있는 코드 리뷰, 코드를 적극적으로 깨뜨리려는 적대적 챌린지, 세션 연속성이 있는 개방형 컨설팅의 3가지 모드를 제공합니다. `/review`(Claude)와 `/codex`(OpenAI)가 동일한 브랜치를 모두 리뷰하면, 어떤 발견 사항이 겹치고 어떤 것이 각 모델에 고유한지 보여주는 교차 모델 분석 결과를 얻을 수 있습니다.

**온디맨드 안전 가드레일.** "be careful"이라고 말하면 `/careful`이 rm -rf, DROP TABLE, force-push, git reset --hard와 같은 파괴적인 명령어 실행 전 경고합니다. `/freeze`는 디버깅 중 수정을 한 디렉토리로 제한하여 Claude가 관련 없는 코드를 실수로 "수정"하는 것을 방지합니다. `/guard`는 이 두 기능을 모두 활성화합니다. `/investigate`는 조사 중인 모듈로 자동 프리즈됩니다.

**선제적 스킬 제안.** gstack은 사용자가 브레인스토밍, 리뷰, 디버깅, 테스트 중 어떤 단계에 있는지 감지하여 적절한 스킬을 제안합니다. 제안이 싫다면 "stop suggesting"이라고 말하세요. 세션 전반에 걸쳐 기억합니다.

## 10-15 parallel sprints

gstack은 하나의 스프린트에서도 강력하지만, 10개를 동시에 실행할 때 혁신적입니다.

[Conductor](https://conductor.build)는 여러 Claude Code 세션을 병렬로 실행하며, 각 세션은 격리된 워크스페이스를 가집니다. 한 세션에서는 새 아이디어에 대해 `/office-hours`를 실행하고, 다른 세션에서는 PR에 대해 `/review`를 하며, 세 번째는 기능을 구현하고, 네 번째는 스테이징에서 `/qa`를 실행하며, 나머지 6개는 다른 브랜치에서 작업하는 식입니다. 이 모든 것이 동시에 일어납니다. 저는 정기적으로 10-15개의 병렬 스프린트를 운영하며, 이것이 현재 실질적인 최대치입니다.

병렬 처리를 가능하게 하는 것은 바로 스프린트 구조입니다. 프로세스가 없다면 10개의 에이전트는 10개의 혼란의 근원이 될 것입니다. 하지만 '생각 → 계획 → 구축 → 리뷰 → 테스트 → 출시'라는 프로세스가 있다면, 각 에이전트는 정확히 무엇을 해야 하고 언제 멈춰야 하는지 압니다. 여러분은 CEO가 팀을 관리하듯 이들을 관리하면 됩니다: 중요한 결정 사항만 확인하고, 나머지는 알아서 돌아가게 두세요.

### Voice input (AquaVoice, Whisper, etc.)

gstack 스킬들은 음성 친화적인 트리거 문구를 가지고 있습니다. "보안 체크 실행해줘", "웹사이트 테스트해줘", "엔지니어링 리뷰 해줘"와 같이 자연스럽게 말하면 적절한 스킬이 활성화됩니다. 슬래시 명령어 이름이나 약어를 기억할 필요가 없습니다.

## Uninstall

### Option 1: Uninstall 스크립트 실행

머신에 gstack이 설치된 경우:

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

이 스크립트는 스킬, 심볼릭 링크, 글로벌 상태(`~/.gstack/`), 프로젝트 로컬 상태, 브라우즈 데몬 및 임시 파일을 처리합니다. 설정과 분석 데이터를 보존하려면 `--keep-state`를 사용하세요. 확인 절차를 건너뛰려면 `--force`를 사용하세요.

### Option 2: 수동 제거 (로컬 저장소가 없는 경우)

저장소를 클론하지 않은 경우 (예: Claude Code 붙여넣기로 설치 후 클론 폴더를 삭제한 경우):

```bash
# 1. 브라우즈 데몬 중지
pkill -f "gstack.*browse" 2>/dev/null || true

# 2. SKILL.md가 gstack/을 가리키는 스킬 디렉토리 제거
find ~/.claude/skills -mindepth 1 -maxdepth 1 -type d ! -name gstack 2>/dev/null |
while IFS= read -r dir; do
  link="$dir/SKILL.md"
  [ -L "$link" ] || continue
  target=$(readlink "$link" 2>/dev/null) || continue
  case "$target" in
    gstack/*|*/gstack/*)
      rm -f "$link"
      rmdir "$dir" 2>/dev/null || true
      ;;
  esac
done

# 3. gstack 제거
rm -rf ~/.claude/skills/gstack

# 4. 글로벌 상태 제거
rm -rf ~/.gstack

# 5. 통합 도구 제거 (설치하지 않은 항목은 건너뛰세요)
rm -rf ~/.codex/skills/gstack* 2>/dev/null
rm -rf ~/.factory/skills/gstack* 2>/dev/null
rm -rf ~/.kiro/skills/gstack* 2>/dev/null
rm -rf ~/.openclaw/skills/gstack* 2>/dev/null

# 6. 임시 파일 제거
rm -f /tmp/gstack-* 2>/dev/null

# 7. 프로젝트별 정리 (각 프로젝트 루트에서 실행)
rm -rf .gstack .gstack-worktrees .claude/skills/gstack 2>/dev/null
rm -rf .agents/skills/gstack* .factory/skills/gstack* 2>/dev/null
```

### CLAUDE.md 정리

제거 스크립트는 CLAUDE.md를 수정하지 않습니다. gstack이 추가된 각 프로젝트에서 `## gstack` 및 `## Skill routing` 섹션을 제거하세요.

### Playwright

`~/Library/Caches/ms-playwright/` (macOS)는 다른 도구와 공유될 수 있으므로 그대로 둡니다. 더 이상 필요 없다면 직접 제거하세요.

---

무료, MIT 라이선스, 오픈 소스입니다. 프리미엄 티어나 대기 명단은 없습니다.

제가 소프트웨어를 만드는 방법을 오픈 소스로 공개했습니다. 포크해서 여러분만의 도구로 만드세요.

> **채용 중입니다.** AI 코딩 속도로 실제 제품을 출시하고 gstack을 더 견고하게 만드는 데 도움을 주고 싶으신가요?
> YC에서 함께 일하세요 — [ycombinator.com/software](https://ycombinator.com/software)
> 매우 경쟁력 있는 급여와 지분을 제공합니다. 샌프란시스코 Dogpatch 지구 근무.

## GBrain — persistent knowledge for your coding agent

[GBrain](https://github.com/garrytan/gbrain)은 AI 에이전트를 위한 영구적 지식 베이스입니다. 에이전트가 세션 사이에도 실제로 유지하는 '기억'이라고 생각하시면 됩니다. GStack은 단 한 번의 명령어로 "실행 중이며, 에이전트가 호출 가능함" 상태까지 안내합니다.

```bash
/setup-gbrain
```

다음 네 가지 경로 중 하나를 선택하세요:

- **Supabase, existing URL** — 클라우드 에이전트가 이미 브레인을 프로비저닝한 경우입니다. Session Pooler URL을 붙여넣으면 현재 노트북에서도 동일한 데이터를 사용합니다.
- **Supabase, auto-provision** — Supabase Personal Access Token을 붙여넣으세요. 스킬이 새 프로젝트를 생성하고, 상태를 확인하며, 풀러 URL을 가져와 `gbrain init`에 전달합니다. 끝까지 약 90초가 소요됩니다.
- **PGLite local** — 계정 필요 없음, 네트워크 연결 없음, 약 30초 소요. 이 Mac에서만 작동하는 격리된 브레인입니다. 우선 체험해 보기에 좋으며, 나중에 `/setup-gbrain --switch`로 Supabase로 이전할 수 있습니다.
- **Remote gbrain MCP** — 브레인이 다른 머신(Tailscale, ngrok, 내부 LAN)이나 팀원의 서버에서 실행 중인 경우입니다. MCP URL과 베어러 토큰을 붙여넣으세요. 선택적으로 로컬 PGLite와 페어링하여 스플릿 엔진 모드에서 심볼 인지 코드 검색을 수행할 수 있습니다. 로컬 DB를 구축하지 않고 머신 간 메모리를 공유할 때 가장 좋습니다.

초기화 후, 스킬은 gbrain을 Claude Code의 MCP 서버로 등록하도록 제안합니다 (`claude mcp add gbrain -- gbrain serve`). 이렇게 하면 `gbrain search`, `gbrain put` 등이 bash 셸 실행이 아닌 정식 타입 도구로 표시됩니다.

**브레인을 최신 상태로 유지하기.** 어떤 저장소에서든 `/sync-gbrain`을 실행하여 코드를 gbrain에 재인덱싱하세요 (기본값은 증분 인덱싱, `--full`은 전체 재인덱싱, `--dry-run`은 미리보기). 이 스킬은 현재 작업 디렉토리를 페더레이션 소스로 등록(`gbrain sources add`)하고, `gbrain sync --strategy code`를 실행하며, 프로젝트의 CLAUDE.md에 `## GBrain Search Guidance` 블록을 작성하여 에이전트가 Grep보다 `gbrain search`/`code-def`/`code-refs`를 선호하도록 유도합니다. 기능 체크 실패 시 해당 블록은 자동으로 제거되어, 설치되지 않은 도구로 안내하는 낡은 가이드가 남지 않도록 합니다.

**원격 저장소별 신뢰 정책.** 머신의 각 저장소는 다음 세 가지 티어 중 하나를 갖습니다:

- `read-write` — 에이전트가 브레인을 검색하고, 이 저장소에서 새로운 페이지를 브레인에 쓸 수 있습니다.
- `read-only` — 에이전트가 검색은 가능하지만 쓸 수는 없습니다 (멀티 클라이언트 컨설턴트에게 최적: 공유 브레인을 검색하되, 고객 B의 저장소에서 작업하는 동안 고객 A의 작업 내용으로 오염시키지 않음).
- `deny` — gbrain 상호작용을 완전히 차단합니다.

저장소당 한 번씩 질문하며, 결정 사항은 동일 원격 저장소의 워크트리와 브랜치 전반에 걸쳐 유지됩니다.

**GStack 메모리 동기화 (다른 기능이지만 동일한 프라이빗 저장소 인프라 사용).** 선택적으로 gstack 상태(학습 내용, CEO 계획, 디자인 문서, 회고, 개발자 프로필)를 프라이빗 git 저장소로 푸시하여 머신 간에 메모리를 공유할 수 있습니다. 일회성 개인정보 프롬프트(모두 허용 / 아티팩트만 / 꺼짐)와 AWS 키, 토큰, PEM 블록, JWT 등이 머신을 떠나기 전 차단하는 심층 방어 시크릿 스캐너가 작동합니다.

```bash
gstack-brain-init
```

**Conductor에서 gstack을 실행하시나요?** Conductor는 모든 워크스페이스의 프로세스 환경 변수에서 `ANTHROPIC_API_KEY` 및 `OPENAI_API_KEY`를 명시적으로 제거하므로, 유료 평가 및 gbrain 임베딩이 기본적으로 작동하지 않습니다. 대신 Conductor의 워크스페이스 환경 설정에서 `GSTACK_ANTHROPIC_API_KEY` 및 `GSTACK_OPENAI_API_KEY`를 설정하세요. gstack의 TS 엔트리 포인트가 런타임에 이를 표준 이름으로 승격시킵니다. 자세한 내용과 신규 엔트리 포인트에 임포트를 추가하기 위한 컨트리뷰터 체크리스트는 [Conductor + GSTACK_* env vars](USING_GBRAIN_WITH_GSTACK.md#conductor--gstack_-env-vars)를 참조하세요.

**모든 시나리오, 플래그, 바이너리 헬퍼, 트러블슈팅 단계 포함 상세 가이드:** [USING_GBRAIN_WITH_GSTACK.md](USING_GBRAIN_WITH_GSTACK.md)

기타 참조: [docs/gbrain-sync.md](docs/gbrain-sync.md) (동기화 전용 가이드) • [docs/gbrain-sync-errors.md](docs/gbrain-sync-errors.md) (에러 인덱스)

## Docs

| 문서 | 내용 |
|-----|---------------|
| [Skill Deep Dives](docs/skills.md) | 모든 스킬의 철학, 예제 및 워크플로우 (Greptile 통합 포함) |
| [Diagrams & Document Formats](docs/howto-diagrams-and-formats.md) | PDF 내 Mermaid/excalidraw 펜스, 이미지 크기 및 안전 기본값, `--to html\|docx`, `/diagram` 3종 세트 |
| [Builder Ethos](ETHOS.md) | 빌더 철학: Boil the Ocean, 구축 전 검색, 3단계 지식 계층 |
| [Using GBrain with GStack](USING_GBRAIN_WITH_GSTACK.md) | `/setup-gbrain`을 위한 모든 경로, 플래그, 바이너리 헬퍼 및 트러블슈팅 단계 |
| [GBrain Sync](docs/gbrain-sync.md) | 머신 간 메모리 설정, 개인정보 모드, 트러블슈팅 |
| [Architecture](ARCHITECTURE.md) | 설계 결정 및 시스템 내부 구조 |
| [Browser Reference](BROWSER.md) | `/browse`를 위한 전체 명령어 참조 |
| [Contributing](CONTRIBUTING.md) | 개발 설정, 테스트, 컨트리뷰터 모드 및 개발 모드 |
| [Changelog](CHANGELOG.md) | 버전별 업데이트 내역 |

## Privacy & Telemetry

gstack은 프로젝트 개선을 돕기 위해 **선택 참여(opt-in)** 방식의 사용량 텔레메트리를 포함하고 있습니다. 작동 방식은 다음과 같습니다:

- **기본 설정은 '꺼짐'입니다.** 명시적으로 동의하지 않는 한 아무것도 전송되지 않습니다.
- **첫 실행 시,** gstack이 익명 사용 데이터를 공유할지 묻습니다. 거절할 수 있습니다.
- **전송되는 내용 (동의 시):** 스킬 이름, 실행 시간, 성공/실패 여부, gstack 버전, OS. 그 외에는 없습니다.
- **절대 전송되지 않는 내용:** 코드, 파일 경로, 저장소 이름, 브랜치 이름, 프롬프트 또는 사용자가 생성한 모든 콘텐츠.
- **언제든지 변경 가능:** `gstack-config set telemetry off`를 통해 즉시 모든 전송을 중단할 수 있습니다.

데이터는 [Supabase](https://supabase.com) (오픈 소스 Firebase 대안)에 저장됩니다. 스키마는 [`supabase/migrations/`](supabase/migrations/)에 있으며, 정확히 무엇이 수집되는지 확인할 수 있습니다. 저장소의 Supabase publishable 키는 공개 키이며, 행 레벨 보안(RLS) 정책으로 모든 직접 접근을 차단합니다. 텔레메트리는 스키마 체크, 이벤트 유형 허용 목록, 필드 길이 제한을 강제하는 검증된 엣지 함수를 통해 흐릅니다.

**로컬 분석 데이터를 항상 사용할 수 있습니다.** `gstack-analytics`를 실행하여 로컬 JSONL 파일로부터 본인의 개인 사용 대시보드를 확인하세요. 원격 데이터는 필요하지 않습니다.

## Troubleshooting

**스킬이 보이지 않나요?** `cd ~/.claude/skills/gstack && ./setup`

**`/browse`가 실패하나요?** `cd ~/.claude/skills/gstack && bun install && bun run build`

**설치가 오래되었나요?** `/gstack-upgrade`를 실행하거나 `~/.gstack/config.yaml`에서 `auto_upgrade: true`를 설정하세요.

**더 짧은 명령어를 원하시나요?** `cd ~/.claude/skills/gstack && ./setup --no-prefix` — `/gstack-qa`에서 `/qa`로 변경됩니다. 이 선택은 향후 업그레이드 시에도 기억됩니다.

**네임스페이스가 지정된 명령어를 원하시나요?** `cd ~/.claude/skills/gstack && ./setup --prefix` — `/qa`에서 `/gstack-qa`로 변경됩니다. gstack 외에 다른 스킬 팩을 함께 사용할 때 유용합니다.

**Codex가 "Skipped loading skill(s) due to invalid SKILL.md"라고 하나요?** Codex 스킬 설명이 오래된 것입니다. 해결 방법: `cd ~/.codex/skills/gstack && git pull && ./setup --host codex` — 또는 저장소 로컬 설치의 경우: `cd "$(readlink -f .agents/skills/gstack)" && git pull && ./setup --host codex`

**Windows 사용자:** gstack은 Git Bash 또는 WSL을 통해 Windows 11에서 작동합니다. Bun 외에 Node.js가 필요합니다. Bun은 Windows에서 Playwright의 파이프 전송과 관련된 알려진 버그가 있습니다 ([bun#4253](https://github.com/oven-sh/bun/issues/4253)). 브라우즈 서버는 자동으로 Node.js로 폴백합니다. `bun`과 `node`가 모두 PATH에 있는지 확인하세요.

개발자 모드가 없는 Windows(MSYS2 / Git Bash)에서는 `ln -snf`가 `git pull` 시 갱신되지 않는 정적 복사본을 생성하므로, `setup`이 심볼릭 링크 대신 파일 복사 방식으로 작동합니다. **`git pull`을 할 때마다 `cd ~/.claude/skills/gstack && ./setup`을 다시 실행**하여 스킬 파일이 저장소와 일치하도록 하세요. `setup` 실행 시 이를 상기시키는 한 줄의 안내가 출력됩니다. Unix와 WSL은 심볼릭 링크를 유지하므로 재실행이 필요 없습니다.

**Claude가 스킬을 볼 수 없다고 하나요?** 프로젝트의 `CLAUDE.md`에 gstack 섹션이 있는지 확인하세요. 다음 내용을 추가하세요:

```
## 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, /open-gstack-browser, /qa, /qa-only, /design-review,
/setup-browser-cookies, /setup-deploy, /setup-gbrain, /sync-gbrain, /retro, /investigate,
/document-release, /document-generate, /codex, /cso, /autoplan, /pair-agent, /careful, /freeze,
/guard, /unfreeze, /gstack-upgrade, /learn.
```

## License

MIT. 영원히 무료입니다. 지금 무언가를 만들어 보세요.

gstack

gstack 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

gstack

gstack 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README