gstack은 무엇인가

gstack은 하나의 AI 코딩 도구에 제품 기획, 기술 설계, 코드 리뷰, 브라우저 QA, 보안 점검과 배포 같은 역할별 워크플로를 추가하는 오픈소스 스킬 모음입니다. Y Combinator의 Garry Tan이 공개했으며, 단순 프롬프트 모음보다 작업 순서를 반복 가능하게 만드는 데 초점이 있습니다.

설치 전 준비물

  • Git
  • Claude Code 또는 ChatGPT 앱과 설정을 공유하는 Codex CLI 등 지원 에이전트
  • Bun 1.0 이상
  • Windows에서는 Node.js와 Git Bash 또는 WSL처럼 ./setup을 실행할 셸

설치 스크립트는 사용자 홈의 스킬 폴더를 변경합니다. 실행 전에 저장소와 setup 파일을 확인하고 기존 사용자 설정을 백업하는 편이 안전합니다.

Claude Code에 설치하기

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

설치 후 새 Claude Code 세션을 열고 /office-hours, /review, /qa 같은 명령이 보이는지 확인합니다.

ChatGPT 앱의 Codex에 설치하기

여러 에이전트를 자동 감지하는 공통 설치 방식입니다.

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack
./setup --host codex

공식 안내 기준으로 Codex 스킬은 ~/.codex/skills/gstack-*/ 경로에 설치됩니다. 설치가 끝난 뒤 ChatGPT 앱의 Codex 또는 Codex CLI를 다시 시작하고 추가된 스킬을 확인합니다.

처음 사용할 명령

  1. /office-hours로 만들려는 기능의 문제와 범위를 정리합니다.
  2. /plan-ceo-review로 사용자 가치와 과도한 범위를 점검합니다.
  3. /plan-eng-review로 데이터 흐름과 실패 경로를 검토합니다.
  4. 구현 후 /review로 변경 코드를 확인합니다.
  5. 테스트 주소가 있으면 /qa로 브라우저 흐름을 점검합니다.
  6. 배포 준비가 끝난 경우에만 /ship을 검토합니다.

처음부터 모든 명령을 쓰기보다 기획, 리뷰, QA 세 가지부터 익히는 편이 좋습니다.

주의할 점

  • 역할이 많아지면 작은 수정에도 절차가 무거워질 수 있습니다.
  • /ship, /land-and-deploy처럼 외부 상태를 바꾸는 작업은 실행 전 범위를 확인합니다.
  • 브라우저와 쿠키를 사용하는 기능에는 개인 세션 정보가 연결될 수 있습니다.
  • 업데이트 전 변경 내역을 읽고 팀 프로젝트에서는 버전을 맞춥니다.
  • gstack의 제안을 최종 판단으로 취급하지 말고 실제 테스트와 코드 리뷰를 유지합니다.

이런 작업에 잘 맞는다

요구사항이 자주 바뀌는 신규 기능, 여러 관점의 리뷰가 필요한 PR, 반복되는 QA와 릴리스 절차에 유용합니다. 반대로 오탈자 한 줄 수정처럼 작은 작업은 필요한 단계만 골라 쓰는 편이 효율적입니다.