gstack

gstack은 Claude Code를 위한 AI 협업 프레임워크입니다. 이 도구는 아이디어에서 배포까지의 전체 소프트웨어 개발 과정을 체계적으로 진행할 수 있게 도와주는 스킬 모음입니다.

gstack이란?

gstack은 다양한 AI 코딩 에이전트를 지원하는 협업 프레임워크입니다. 이 도구는 아이디어에서 배포까지의 전체 소프트웨어 개발 과정을 체계적으로 진행할 수 있게 도와주는 스킬 모음입니다.

Claude Code뿐만 아니라 OpenAI Codex, Cursor, Gemini CLI 등 다양한 AI 모델을 지원하므로, 자신이 사용하는 에이전트에 맞게 설치할 수 있습니다.

주요 특징

gstack은 다음과 같은 개발 사이클을 자동화합니다:

text
Think → Plan → Build → Review → Test → Ship → Reflect
  • 23개의 전문화된 스킬로 구성
  • 모든 스킬은 슬래시 명령어(/명령어)로 접근 가능
  • AI와 개발자가 함께 협업하는 방식으로 설계됨

지원하는 AI 모델

gstack은 8개의 AI 코딩 에이전트를 지원합니다:

모델제공사설명
Claude CodeAnthropicClaude 기반 코딩 에이전트
OpenAI Codex CLIOpenAIGPT 기반 코딩 어시스턴트
CursorCursorCursor IDE 통합 에이전트
OpenCode-오픈소스 코딩 에이전트
Factory Droid-특화된 개발 에이전트
Slate-협업 코딩 플랫폼
Kiro-고급 코딩 에이전트
기타 통합 가능-호환되는 다른 모델

필수 요구사항

gstack을 설치하기 전에 다음 도구들이 필요합니다:

도구버전설명
AI 에이전트-위 목록의 에이전트 중 하나 (Claude Code, Codex CLI 등)
Git-버전 관리 시스템
Bunv1.0+JavaScript 런타임 (필수)
Node.js-Windows에서만 필요

Bun 설치하기

bun이 설치되어 있지 않다면 먼저 설치하세요:

Bash
# macOS / Linux
curl -fsSL https://bun.sh/install | bash

# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1|iex"

# 또는 npm으로 설치
npm install -g bun

설치 확인:

Bash
bun --version

설치 방법

모델별 설치 명령어

각 AI 에이전트마다 설치 경로와 설정 파일이 다릅니다. 자신이 사용하는 에이전트에 맞게 설치하세요:

에이전트설치 명령어설치 경로설정 파일
Claude Code./setup~/.claude/skills/gstackCLAUDE.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/gstackOPENCODE.md
Factory Droid./setup --host factory~/.factory/skills/gstackFACTORY.md
Slate./setup --host slate~/.slate/skills/gstack.slate.md
Kiro./setup --host kiro~/.kiro/skills/gstack.kiro.md

기본 설치 (30초) - Claude Code 예시

Claude Code 터미널에서 다음 명령어를 실행하세요:

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

이 명령어는:

  1. gstack 저장소를 로컬에 클론
  2. ~/.claude/skills/gstack 디렉토리에 설치
  3. 자동으로 setup 스크립트 실행하여 설치 완료

설치 후 CLAUDE.md 파일이 자동으로 업데이트되어 모든 스킬을 사용할 수 있게 됩니다.

Codex CLI 설치 예시

Bash
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 설치 예시

Bash
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 플래그를 추가하세요:

Bash
# 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실제 브라우저에서 앱 테스트
/shipPR 생성 및 배포

사용 예시

예: 일일 브리핑 앱 만들기

text
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 CallingAI가 필요한 도구(함수)를 호출하는 기술
Prompt Chaining여러 프롬프트를 연결해서 복잡한 작업 수행
ReAct (Reasoning + Acting)AI가 생각하고 행동하는 반복 사이클
Orchestration여러 작업을 조정하고 순서대로 실행

gstack의 혁신점

gstack은 이 모든 개념을 조합해서 다음을 실현합니다:

AI와 개발자의 진정한 협업 - 일방적 지시가 아닌 상호작용
체계적인 개발 프로세스 - Think부터 Ship까지 구조화된 흐름
자동화된 품질 관리 - 코드 검토, 테스트, 배포 자동화
개발 생산성 향상 - 반복적인 작업을 AI가 담당


참고 자료