gstack
gstack은 Claude Code를 위한 AI 협업 프레임워크입니다. 이 도구는 아이디어에서 배포까지의 전체 소프트웨어 개발 과정을 체계적으로 진행할 수 있게 도와주는 스킬 모음입니다.
gstack이란?
gstack은 다양한 AI 코딩 에이전트를 지원하는 협업 프레임워크입니다. 이 도구는 아이디어에서 배포까지의 전체 소프트웨어 개발 과정을 체계적으로 진행할 수 있게 도와주는 스킬 모음입니다.
Claude Code뿐만 아니라 OpenAI Codex, Cursor, Gemini CLI 등 다양한 AI 모델을 지원하므로, 자신이 사용하는 에이전트에 맞게 설치할 수 있습니다.
주요 특징
gstack은 다음과 같은 개발 사이클을 자동화합니다:
Think → Plan → Build → Review → Test → Ship → Reflect
- 23개의 전문화된 스킬로 구성
- 모든 스킬은 슬래시 명령어(
/명령어)로 접근 가능 - AI와 개발자가 함께 협업하는 방식으로 설계됨
지원하는 AI 모델
gstack은 8개의 AI 코딩 에이전트를 지원합니다:
| 모델 | 제공사 | 설명 |
|---|---|---|
| Claude Code | Anthropic | Claude 기반 코딩 에이전트 |
| OpenAI Codex CLI | OpenAI | GPT 기반 코딩 어시스턴트 |
| Cursor | Cursor | Cursor IDE 통합 에이전트 |
| OpenCode | - | 오픈소스 코딩 에이전트 |
| Factory Droid | - | 특화된 개발 에이전트 |
| Slate | - | 협업 코딩 플랫폼 |
| Kiro | - | 고급 코딩 에이전트 |
| 기타 통합 가능 | - | 호환되는 다른 모델 |
필수 요구사항
gstack을 설치하기 전에 다음 도구들이 필요합니다:
| 도구 | 버전 | 설명 |
|---|---|---|
| AI 에이전트 | - | 위 목록의 에이전트 중 하나 (Claude Code, Codex CLI 등) |
| Git | - | 버전 관리 시스템 |
| Bun | v1.0+ | JavaScript 런타임 (필수) |
| Node.js | - | Windows에서만 필요 |
Bun 설치하기
bun이 설치되어 있지 않다면 먼저 설치하세요:
# macOS / Linux
curl -fsSL https://bun.sh/install | bash
# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1|iex"
# 또는 npm으로 설치
npm install -g bun
설치 확인:
bun --version
설치 방법
모델별 설치 명령어
각 AI 에이전트마다 설치 경로와 설정 파일이 다릅니다. 자신이 사용하는 에이전트에 맞게 설치하세요:
| 에이전트 | 설치 명령어 | 설치 경로 | 설정 파일 |
|---|---|---|---|
| Claude Code | ./setup | ~/.claude/skills/gstack | CLAUDE.md |
| OpenAI Codex CLI | ./setup --host codex | ~/.codex/skills/gstack | .codex.md |
| Cursor | ./setup --host cursor | ~/.cursor/skills/gstack | .cursor.md |
| OpenCode | ./setup --host opencode | ~/.config/opencode/skills/gstack | OPENCODE.md |
| Factory Droid | ./setup --host factory | ~/.factory/skills/gstack | FACTORY.md |
| Slate | ./setup --host slate | ~/.slate/skills/gstack | .slate.md |
| Kiro | ./setup --host kiro | ~/.kiro/skills/gstack | .kiro.md |
기본 설치 (30초) - Claude Code 예시
Claude Code 터미널에서 다음 명령어를 실행하세요:
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup
이 명령어는:
- gstack 저장소를 로컬에 클론
~/.claude/skills/gstack디렉토리에 설치- 자동으로 setup 스크립트 실행하여 설치 완료
설치 후 CLAUDE.md 파일이 자동으로 업데이트되어 모든 스킬을 사용할 수 있게 됩니다.
Codex CLI 설치 예시
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.codex/skills/gstack && cd ~/.codex/skills/gstack && ./setup --host codex
설치 후 .codex.md 파일이 자동으로 업데이트됩니다.
Cursor 설치 예시
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.cursor/skills/gstack && cd ~/.cursor/skills/gstack && ./setup --host cursor
설치 후 .cursor.md 파일이 자동으로 업데이트됩니다.
팀 모드 설정 (권장)
여러 개발자가 공유하는 프로젝트에서는 --team 플래그를 추가하세요:
# Claude Code 팀 모드
cd ~/.claude/skills/gstack && ./setup --team
# Codex CLI 팀 모드
cd ~/.codex/skills/gstack && ./setup --host codex --team
# 모두 커밋
git add .claude/ .codex.md CLAUDE.md && git commit -m "require gstack for AI-assisted work"
이렇게 하면 모든 팀 멤버가 자동으로 최신 버전을 받게 됩니다.
자동 감지 기능
설정 파일이 자신이 설치한 에이전트를 자동으로 감지하므로, 여러 에이전트를 동시에 사용하는 경우 각각 설치할 수 있습니다. gstack은 호환되는 모든 에이전트에서 자동으로 작동합니다.
주요 명령어
| 명령어 | 설명 |
|---|---|
/office-hours | 제품 개념 재검토 및 설계 문서 작성 |
/plan-ceo-review | 범위와 전략 검토 |
/plan-eng-review | 아키텍처 및 테스트 계획 수립 |
/review | 코드 검토 및 버그 찾기 |
/qa | 실제 브라우저에서 앱 테스트 |
/ship | PR 생성 및 배포 |
사용 예시
예: 일일 브리핑 앱 만들기
1. /office-hours
→ 제품 개념 재검토
(예: "달력용 일일 브리핑"이 실제로는 "개인 비서 AI"를 원함)
2. /plan-ceo-review
→ 프로젝트 범위와 전략 검토
→ 4가지 범위 모드 중 선택
3. 코드 구현 (일반 작업)
4. /review
→ 코드 자동 검토 및 버그 찾기
5. /qa
→ 실제 브라우저에서 테스트 및 버그 수정
6. /ship
→ PR 생성 및 배포
기술 분류
gstack은 여러 AI 기술을 조합한 고급 AI 시스템입니다.
1. Agent Framework (에이전트 프레임워크)
정의: AI가 다양한 도구(스킬/명령어)를 상황에 따라 자율적으로 선택해서 사용하도록 하는 기술
gstack에서의 적용:
/office-hours,/review,/ship같은 각 명령어들이 독립적인 에이전트처럼 작동- 사용자의 요청에 따라 적절한 스킬을 선택해서 실행
2. Workflow Orchestration (워크플로우 오케스트레이션)
정의: 복잡한 작업들을 순차적인 프로세스로 자동화하는 기술
gstack에서의 적용:
- "Think → Plan → Build → Review → Test → Ship" 같은 단계별 프로세스 자동화
- 각 단계가 완료되면 다음 단계가 자동으로 실행되는 구조
3. Prompt Engineering/Chaining (프롬프트 엔지니어링)
정의: 여러 개의 전문화된 프롬프트를 조합해서 더 나은 결과물을 만드는 기술
gstack에서의 적용:
- 23개의 전문화된 스킬 = 23개의 최적화된 프롬프트
- 프롬프트 체인: 한 단계의 출력이 다음 단계의 입력이 되는 구조
- 예:
/office-hours결과 →/plan-ceo-review입력
- 예:
4. AI Code Generation Assistant (AI 코드 생성 어시스턴트)
정의: 개발 전 과정에서 AI가 함께 작업하는 협업 도구
gstack에서의 적용:
- 아이디어 단계부터 배포까지 모든 단계에서 AI가 개발자를 지원
- 자동 코드 검토, 테스트, 배포 등의 작업 자동화
관련 AI 개념
| 용어 | 설명 |
|---|---|
| Agent | 목표를 달성하기 위해 도구를 선택해서 사용하는 자율적 AI |
| Agentic Workflow | 에이전트가 자율적으로 여러 작업을 순차 실행하는 패턴 |
| Tool Use / Function Calling | AI가 필요한 도구(함수)를 호출하는 기술 |
| Prompt Chaining | 여러 프롬프트를 연결해서 복잡한 작업 수행 |
| ReAct (Reasoning + Acting) | AI가 생각하고 행동하는 반복 사이클 |
| Orchestration | 여러 작업을 조정하고 순서대로 실행 |
gstack의 혁신점
gstack은 이 모든 개념을 조합해서 다음을 실현합니다:
✅ AI와 개발자의 진정한 협업 - 일방적 지시가 아닌 상호작용
✅ 체계적인 개발 프로세스 - Think부터 Ship까지 구조화된 흐름
✅ 자동화된 품질 관리 - 코드 검토, 테스트, 배포 자동화
✅ 개발 생산성 향상 - 반복적인 작업을 AI가 담당