g/ gstack 실습형 강의실

3 HOURS HANDS-ON LECTURE

코드를 시키기 전에,
개발팀을 설계한다.

Codex와 Claude Code에 gstack을 설치하고, 같은 프로젝트를 계획·리뷰·QA하며 AI 개발 워크플로를 직접 비교하는 입문 강의입니다.

  • 대상Git 기초 학습자
  • 도구Codex · Claude Code
  • 결과10단계 실습 산출물

gstack workflow

Think → Plan
→ Review → Test
ready to practice
CEO ENG QA REVIEW

gstack은 코딩 모델이 아니라 AI에게 역할·순서·품질 기준을 부여하는 개발 워크플로입니다.

01 / ORIENTATION

오늘 배우는 것은
명령어보다 작업 방식입니다.

01

바로 만들지 않기

사용자 문제와 범위를 확인하고 구현 전에 가정을 드러냅니다.

02

역할을 분리하기

제품, 기술, 리뷰, QA 관점을 각각 다른 스킬로 실행합니다.

03

결과를 검증하기

AI 출력은 정답이 아닙니다. 파일, Git diff, 실제 동작으로 확인합니다.

02 / 180-MINUTE ROADMAP

설치에서 QA까지,
한 번의 완성된 루프

방향 잡기

gstack과 두 실행 환경의 차이를 이해합니다.

환경 점검

Git, Bun, 계정, 터미널 환경을 확인합니다.

Codex · Claude 설치

각 도구를 설치하고 프로젝트에서 첫 읽기 작업을 수행합니다.

gstack 설치

선택한 host에 스킬을 등록하고 상태를 확인합니다.

휴식

설치 문제가 있는 학습자는 이 시간에 보완합니다.

문제와 계획

office-hours와 plan-eng-review를 실행합니다.

리뷰와 QA

코드 관점과 사용자 행동 관점의 차이를 체험합니다.

비교와 회고

두 도구의 결과를 비교하고 PBL 적용 계획을 정리합니다.

03 / SETUP

같은 gstack,
다른 호출 방식

학습자는 하나의 트랙을 선택해 따라 합니다. 강사는 두 환경을 나란히 시연합니다.

초급자 수업 기준

Windows 학습자는 먼저 Windows 네이티브 설치를 따라 합니다. WSL2는 Linux 환경이 필요한 학습자를 위한 선택 과정입니다. 어느 쪽이든 Codex·Claude·gstack을 같은 환경에 설치해야 합니다.

WINDOWS · START FROM ZERO

처음 설치하는 학습자를 위한
Windows 전체 과정

아래 순서를 위에서부터 하나씩 진행합니다. 명령 앞의 PS C:\Users\... 같은 글자는 입력하지 않고, 회색 명령 상자 안의 내용만 입력합니다.

터미널

컴퓨터에 글자로 명령을 전달하는 창입니다.

PowerShell

Windows에 기본으로 포함된 터미널입니다.

명령어

복사한 뒤 PowerShell에 붙여넣고 Enter를 누릅니다.

WSL

Windows 안에서 Ubuntu Linux를 실행하는 선택 기능입니다.

선택 과정

WSL2 Ubuntu

Linux 개발 환경으로 통일해야 하거나 네이티브 설치가 막힐 때 사용합니다.

PATH A Windows 네이티브 설치 - 초급자 기본 과정
  1. PowerShell 열기

    키보드의 Windows 키를 누르고 PowerShell을 검색한 뒤 실행합니다. 창에 PS C:\Users\사용자이름>이 보이면 정상입니다.

  2. Git과 Node.js 설치

    아래 명령을 한 줄씩 붙여넣고 Enter를 누릅니다.

    winget install --id Git.Git -e winget install OpenJS.NodeJS.LTS

    예상 결과 · 설치 완료 메시지가 나온 뒤 PowerShell을 닫고 다시 엽니다.

  3. Bun 설치

    powershell -c "irm bun.sh/install.ps1|iex"

    PowerShell을 새로 열고 bun --version을 입력했을 때 숫자가 나오면 성공입니다.

  4. Codex 설치와 로그인

    powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
    codex --version codex

    처음 실행하면 화면 안내에 따라 ChatGPT 계정 등의 제공되는 방식으로 로그인합니다.

  5. Claude Code 설치와 로그인

    winget install Anthropic.ClaudeCode
    claude --version claude doctor claude

    Claude Code 사용이 가능한 계정이 필요합니다. 한 도구만 사용할 경우 이 단계는 건너뛰어도 됩니다.

  6. 설치 결과 한 번에 확인

    git --version node --version npm --version bun --version codex --version claude --version

    각 줄에 버전 번호가 표시되면 다음 단계로 이동합니다.

  7. gstack 내려받기

    git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git "$HOME\gstack" cd "$HOME\gstack"
  8. gstack을 Codex·Claude Code에 등록

    .\setup.ps1 --host codex .\setup.ps1 --host claude .\setup.ps1 --status

    한 도구만 사용한다면 해당 host 명령만 실행합니다. 상태 표에 codex 또는 claude가 나오면 성공입니다.

  9. ZIP 실습 폴더에서 PowerShell 열기

    ZIP을 마우스 오른쪽 버튼으로 눌러 모두 추출합니다. 압축을 푼 project 폴더를 열고, 탐색기 주소 표시줄에 powershell을 입력한 뒤 Enter를 누릅니다.

    git init git add . git commit -m "실습 시작 상태" git status
  10. 첫 실습 시작

    # Codex를 선택한 경우 codex # Claude Code를 선택한 경우 claude

    AI 작업 전후에는 반드시 git status와 git diff를 확인합니다.

PATH B WSL2 Ubuntu 설치 - 선택 과정

WSL은 무엇인가요?

WSL은 Windows Subsystem for Linux의 약자입니다. Windows 안에서 Ubuntu 터미널과 Linux 개발 도구를 실행할 수 있게 합니다. gstack을 사용하기 위한 필수 조건은 아닙니다.

  1. 관리자 PowerShell에서 WSL 설치

    wsl --install

    설치가 끝나면 컴퓨터를 재부팅합니다.

  2. Ubuntu 첫 실행

    시작 메뉴에서 Ubuntu를 실행하고 Linux 사용자 이름과 비밀번호를 만듭니다. 비밀번호 입력 중 문자가 보이지 않는 것은 정상입니다.

  3. Ubuntu에서 필수 도구 설치

    sudo apt update sudo apt install -y git curl unzip curl -fsSL https://bun.com/install | bash source ~/.bashrc
  4. Codex와 Claude Code를 Ubuntu 안에 설치

    curl -fsSL https://chatgpt.com/codex/install.sh | sh curl -fsSL https://claude.ai/install.sh | bash
  5. gstack도 Ubuntu 안에 설치

    git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack cd ~/gstack ./setup --host codex ./setup --host claude ./setup --status
환경을 섞지 마세요

Codex만 Windows에 설치하고 gstack은 WSL에 설치하면 서로 다른 홈 폴더를 사용합니다. 모두 Windows에 설치하거나 모두 WSL2 Ubuntu에 설치하세요.

막혔을 때 먼저 확인하기

명령을 찾을 수 없음

PowerShell을 완전히 닫고 새로 연 뒤 다시 실행합니다.

setup.ps1 실행 차단

powershell -ExecutionPolicy Bypass -File .\setup.ps1 --host codex처럼 실행합니다.

Git 커밋 이름 오류

git config user.name "student"와 로컬 이메일을 설정합니다.

gstack 스킬이 안 보임

Codex·Claude를 종료하고 새 세션을 연 뒤 .\setup.ps1 --status를 확인합니다.

Bun이 인식되지 않음

PowerShell을 새로 열고 bun --version을 다시 확인합니다.

Windows 보안 기능이 차단

보안 설정을 끄지 말고 강사에게 알린 뒤 WSL2 과정으로 전환합니다.

TRACK A · EXPERIMENTAL HOST

OpenAI Codex

터미널에서 프로젝트를 읽고 수정하며, gstack 스킬은 이름을 자연어로 지정합니다.

macOS · Linux · WSL

curl -fsSL https://chatgpt.com/codex/install.sh | sh

npm 대안

npm install -g @openai/codex

설치 확인과 로그인

codex --version codex
Codex 공식 설치 문서 ↗
TRACK B · FULL HOST

Claude Code

gstack의 정식 지원 환경이며, 주요 스킬을 슬래시 명령으로 호출합니다.

Homebrew

brew install --cask claude-code

npm 대안

npm install -g @anthropic-ai/claude-code

설치 확인과 로그인

claude --version claude doctor claude
Claude Code 공식 설치 문서 ↗

COMMON STEP

gstack 설치

gstack 소스는 공식 Git 저장소에서 받고, 선택한 AI 도구의 skills 폴더에 등록합니다.

1

공식 저장소 받기

git clone --single-branch --depth 1 \ https://github.com/garrytan/gstack.git ~/gstack cd ~/gstack
2

선택한 환경에 등록

# Codex ./setup --host codex # Claude Code ./setup --host claude
3

상태 확인

./setup --status

METHOD B · PROMPT-DRIVEN SETUP

명령을 직접 입력하는 대신
Codex에게 설치를 요청하기

Codex는 현재 환경을 확인하고 필요한 명령을 제안·실행할 수 있습니다. 파일 쓰기나 네트워크 접근이 필요하면 승인 정책에 따라 사용자에게 허용 여부를 묻습니다.

먼저 필요한 것

Codex가 자기 자신을 설치할 수는 없습니다. 위의 공식 설치 명령으로 Codex CLI 설치와 로그인을 먼저 완료한 뒤 이 과정을 시작합니다.

  1. 실습할 폴더에서 Codex 시작

    빈 폴더 또는 압축을 푼 실습 폴더에서 터미널을 열고 Codex를 실행합니다.

    # Windows PowerShell mkdir "$HOME\gstack-class" -ErrorAction SilentlyContinue cd "$HOME\gstack-class" codex # macOS · Linux · WSL mkdir -p ~/gstack-class cd ~/gstack-class codex
  2. 1차 프롬프트 — 설치하지 말고 환경만 점검

    먼저 읽기 전용으로 운영체제, 셸, 필수 도구와 기존 설치 여부를 확인합니다.

    PROMPT 01환경 점검
    gstack 설치를 준비하고 있어.
    먼저 현재 운영체제와 셸을 확인하고,
    Git, Bun, Codex 버전과 기존 gstack 설치 여부를 점검해 줘.
    
    아직 설치하거나 파일을 수정하지 말고,
    확인한 사실, 부족한 항목, 사용할 설치 경로와
    실행할 명령 계획만 보여 줘.
  3. 점검 결과 확인

    Codex가 제시한 운영체제와 설치 경로가 실제 환경과 같은지 확인합니다. 비밀번호, API 키, 인증 코드는 프롬프트에 넣지 않습니다.

    CODEX · 점검 결과 예시

    환경 Windows 11 / PowerShell 7

    확인됨 Git 2.x, Bun 1.x, Codex CLI 로그인

    부족함 gstack 미설치

    계획 공식 저장소를 C:\Users\student\gstack에 받은 뒤 Codex host 등록과 상태 확인

  4. 2차 프롬프트 — 승인하면서 설치 실행

    점검 내용이 맞으면 다음 프롬프트를 보냅니다. 네트워크 접근이나 홈 폴더 쓰기 승인이 나타나면 대상 명령과 경로를 읽은 뒤 허용합니다.

    PROMPT 02gstack 설치
    방금 점검한 결과를 기준으로 gstack을 Codex host에 설치해 줘.
    
    조건:
    1. https://github.com/garrytan/gstack 공식 저장소만 사용해.
    2. Windows 네이티브면 $HOME\gstack과 setup.ps1을 사용하고,
       macOS·Linux·WSL이면 ~/gstack과 ./setup을 사용해.
    3. 기존 gstack 폴더가 있으면 덮어쓰거나 삭제하지 말고 멈춰서 알려 줘.
    4. 파괴적인 명령은 실행하지 마.
    5. 네트워크 접근이나 홈 폴더 쓰기가 필요하면 먼저 승인을 요청해.
    6. 설치 후 --host codex 등록과 --status 확인까지 실행해.
    7. 마지막에 실행한 명령, 설치 경로, 상태 결과를 요약해.
  5. 승인 창에서 확인할 내용

    명령git clone 또는 setup인가?출처garrytan/gstack 공식 주소인가?경로내 홈의 gstack 폴더인가?범위삭제·강제 초기화가 없는가?

    모르는 명령이 보이면 승인하지 말고 “이 명령이 무엇을 바꾸는지 설명해 줘”라고 질문합니다.

  6. 설치 완료 결과 확인

    CODEX · 완료 결과 예시

    설치 경로 C:\Users\student\gstack

    등록 host codex

    상태 installed / skills linked

    다음 단계 Codex를 종료하고 새 세션에서 gstack 스킬 실행

    # Codex에서 나간 뒤 새 터미널 cd "$HOME\gstack-class" codex
  7. 첫 gstack 사용 프롬프트

    PROMPT 03설치 확인과 첫 실행
    먼저 gstack-office-hours 스킬을 사용할 수 있는지 확인해 줘.
    사용 가능하면 이 프로젝트를 읽고 다음을 정리해 줘.
    
    1. 대상 사용자
    2. 사용자가 겪는 문제
    3. 가장 작은 핵심 기능
    4. 검증되지 않은 가정
    
    아직 파일을 수정하지 마.

    예상 결과 · office-hours 질문이 시작되거나 사용자·문제·가정이 정리됩니다. 스킬을 찾을 수 없다고 나오면 Codex를 완전히 종료한 뒤 새 세션에서 다시 실행합니다.

04 / DOWNLOAD & PRACTICE

한 단계씩 받고,
결과를 남깁니다.

GitHub 실습 저장소는 사용하지 않습니다. ZIP을 내려받아 압축을 풀고 로컬 Git 저장소를 생성합니다.

ZIP

실습 파일 다운로드

→
DIR

압축 해제 후 이동

→
GIT

로컬 기준점 생성

→
AI

Codex 또는 Claude 실행

cd 다운로드한-실습폴더/project git init git add . git commit -m "실습 시작 상태" git status
01

15 MIN · 준비

환경 점검

Git, Bun, Codex, Claude 버전 확인 스크립트와 수강생 체크리스트입니다.

  • 환경 점검 스크립트
  • 설치 결과 체크리스트
  • 문제 기록란
1단계 ZIP 다운로드 ↓
03

25 MIN · 계획

기술 계획 검토

plan-eng-review로 구성요소, 데이터 흐름, 예외와 테스트를 검토합니다.

  • 동일 프로젝트 기준점
  • 기술 계획 프롬프트
  • 계획 검토 워크시트
3단계 ZIP 다운로드 ↓
04

20 MIN · 검증

코드 리뷰와 QA

review와 qa-only의 관점 차이를 확인하고 재현 가능한 보고서를 작성합니다.

  • 의도적 결함 프로젝트
  • 리뷰·QA 실행 가이드
  • QA 보고서 양식
4단계 ZIP 다운로드 ↓

INSTRUCTOR & OFFLINE PACK

전체 실습 자료 한 번에 받기

10단계 자료와 샘플 앱, 워크시트를 하나의 ZIP으로 묶었습니다.

전체 실습팩 다운로드

05 / PROMPT LAB

도구는 달라도
검토 기준은 같습니다.

Codex prompt
gstack-office-hours 스킬을 사용해 이 프로젝트를 검토해 줘.

1. 대상 사용자
2. 해결하려는 문제
3. 핵심 가치
4. 가장 작은 핵심 기능
5. 검증되지 않은 가정

아직 코드를 수정하지 마.
실습 공통 규칙

작업 전후에 git status와 git diff를 확인하고, AI의 설명은 실제 파일과 실행 결과로 검증합니다.

06 / FULL LIFECYCLE LAB

기획부터 QA까지,
한 프로젝트로 연결합니다.

앞의 3시간 입문 강의가 설치와 첫 경험이라면, 이 과정은 PBL에 적용하는 후속 확장 실습입니다. 각 단계는 명령, 사람의 결정, 산출물, 통과 조건으로 끝납니다.

실습 프로젝트

Focus List 앱에 빈 입력 방지, 중복 방지, 긴 제목 처리 기능을 추가한다고 가정합니다. 기획과 계획 단계에서는 코드를 수정하지 않고, 구현 단계부터 변경합니다.

예시 결과를 보는 방법

아래 초록색 결과 상자는 명령을 실행했을 때 얻을 수 있는 예시입니다. 문장을 그대로 복사하는 정답지가 아니라, 내 결과에 사용자·근거·검증 조건이 빠지지 않았는지 비교하는 기준으로 사용합니다.

01DISCOVER

문제·사용자

→
02SPEC

요구·완료기준

→
03PLAN

제품·디자인·기술

→
04BUILD

작게 구현

→
05VERIFY

리뷰·디버깅·QA

→
06SHIP

문서·출시·회고

01문제 탐색

DISCOVER · 수정 금지

무엇을 만들지보다 왜 필요한지 먼저 확인

대상 사용자, 현재 해결 방식, 가장 절박한 문제, 검증되지 않은 가정을 찾습니다. AI의 제안은 후보이며 최종 제품 방향은 사람이 결정합니다.

Codex
gstack-office-hours 스킬을 사용해 Focus List의
대상 사용자, 현재 대안, 핵심 문제, 최소 검증 기능을
정리해 줘. 아직 파일을 수정하지 마.
Claude Code
/office-hours

Focus List의 사용자 문제와 최소 검증 기능을
정리해 줘. 아직 파일을 수정하지 마.
산출물문제 정의 1문장 · 사용자 1명 · 가정 3개통과 조건기능이 아니라 사용자의 불편으로 설명할 수 있다.
EXAMPLE OUTPUT 01office-hours 실행 결과 예시

대상 사용자 수업·과제를 동시에 관리하는 교육생

핵심 문제 해야 할 일을 적어도 지금 처리할 한 가지를 빠르게 구분하기 어렵다.

최소 검증 기능 3초 안에 할 일을 추가하고 완료 상태를 바꾼다.

검증할 가정 사용자는 분류 기능보다 빠른 입력을 먼저 원한다.

사람의 확인 → “학생용 할 일 앱”처럼 기능명만 적지 않고, 실제 불편과 검증할 가정이 드러났는가?

02명세 작성

SPEC · 수정 금지

아이디어를 테스트 가능한 요구사항으로 변환

범위, 사용자 시나리오, 정상·예외 흐름, 인수 조건을 고정합니다. “잘 동작한다” 대신 관찰 가능한 완료 기준을 씁니다.

Codex
gstack-spec 스킬로 빈 입력·중복 항목·긴 제목 처리의
정상/예외 시나리오와 인수 조건을 작성해 줘.
아직 구현하지 마.
Claude Code
/spec

세 기능의 시나리오와 인수 조건을 작성해 줘.
아직 구현하지 마.
산출물기능 범위 · 제외 범위 · 인수 조건통과 조건제3자가 성공/실패를 같은 기준으로 판단한다.
EXAMPLE OUTPUT 02spec 실행 결과 예시

Given 입력창에 공백만 입력되어 있고

When “추가” 버튼을 누르면

Then 항목 수는 증가하지 않으며 “내용을 입력하세요”가 표시된다.

제외 범위 로그인, 서버 저장, 카테고리 분류는 이번 실습에서 다루지 않는다.

사람의 확인 → “적절히 처리한다” 같은 모호한 표현 없이 화면에서 성공과 실패를 판별할 수 있는가?

03계획 검토

PLAN · 수정 금지

제품·디자인·기술 관점을 차례로 잠금

무엇을 제외할지, 사용자에게 어떻게 보일지, 코드와 데이터가 어떻게 흐를지를 분리해 검토합니다. 빠르게 진행할 때는 autoplan으로 세 관점을 연속 실행합니다.

제품 범위gstack-plan-ceo-reviewClaude: /plan-ceo-review
사용 경험gstack-plan-design-reviewClaude: /plan-design-review
기술 구조gstack-plan-eng-reviewClaude: /plan-eng-review
한 번에gstack-autoplanClaude: /autoplan
gstack-plan-eng-review 스킬로 현재 명세를 검토해 줘.
변경 파일, 데이터 흐름, 실패 경로, 테스트, 구현 순서를
포함하고 아직 구현하지 마.
산출물제품 결정 · 화면 상태 · 기술 계획통과 조건파일·실패 경로·테스트가 구체적이며 범위가 현실적이다.
EXAMPLE OUTPUT 03계획 검토 결과 예시

변경 파일 app.js 입력 검증·중복 비교, styles.css 오류·긴 제목 상태

데이터 흐름 입력 → trim → 빈 값 검사 → 중복 검사 → 배열 추가 → 다시 렌더링

실패 경로 공백, 대소문자만 다른 중복, 100자 이상 제목, 빠른 연속 클릭

구현 순서 입력 검증 → 중복 규칙 → 화면 상태 → 회귀 테스트

사람의 확인 → AI가 제안한 파일과 함수가 프로젝트에 실제로 존재하는지 직접 열어 확인한다.

04개발

BUILD · 여기서부터 수정 허용

계획을 작은 변경으로 나누어 구현

구현은 기본 에이전트 기능으로 수행합니다. 한 기능씩 요청하고, 각 변경 뒤 실행 결과와 Git diff를 확인합니다. gstack은 구현 전후의 계획·검증 역할을 강화합니다.

구현 요청
승인한 명세와 기술 계획을 기준으로
먼저 빈 입력 방지만 구현해 줘.
검증을 수행하고 다른 기능은 건드리지 마.
Git 체크포인트
git status
git diff
git add .
git commit -m "feat: prevent blank tasks"
산출물작은 diff · 실행 결과 · 기능별 커밋통과 조건명세 밖 변경이 없고, 사람이 앱에서 기능을 재현했다.
EXAMPLE OUTPUT 04구현 후 Git·브라우저 확인 예시
$ git diff --stat
app.js | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)

$ git status --short
M app.js

브라우저 확인
✓ 공백 입력: 항목 0개 유지, 안내 표시
✓ 정상 입력: 항목 1개 추가
✓ 기존 완료 버튼: 정상 동작

사람의 확인 → 계획에 없던 파일이 바뀌지 않았고, 정상 흐름도 그대로 동작하는가?

05리뷰·디버깅

REVIEW & DEBUG

변경 위험을 찾고, 증상보다 원인을 고침

review는 diff의 버그·누락·구조적 위험을 찾고, investigate는 재현 → 증거 → 가설 → 수정 순서로 원인을 좁힙니다. 보고만 받을 때는 “수정하지 마”를 명시합니다.

리뷰
gstack-review 스킬로 현재 diff를 검토해 줘.
심각도, 파일 근거, 재현 방법만 보고하고 수정하지 마.

Claude: /review
원인 조사
gstack-investigate 스킬로 중복 항목 원인을 조사해 줘.
재현과 근거를 먼저 제시하고 승인 전에는 수정하지 마.

Claude: /investigate
산출물심각도별 리뷰 · 재현 절차 · 근본 원인통과 조건지적마다 파일/행동 근거가 있고 추측과 사실이 구분된다.
EXAMPLE OUTPUT 05review·investigate 결과 예시
P1 · 사용자 입력이 HTML로 실행될 수 있음

app.js에서 제목을 innerHTML로 삽입한다. 악성 HTML 입력으로 재현 가능하며 텍스트 노드 또는 textContent 사용이 필요하다.

근본 원인

중복 검사를 렌더링 후 수행해 빠른 두 번째 클릭이 같은 배열 상태를 읽는다. 버튼 비활성화가 아니라 검증 순서가 원인이다.

사람의 확인 → 심각도, 파일 위치, 재현 조건, 사용자 영향이 하나의 근거로 연결되는가?

06QA

QA · 사용자 행동 검증

보고 전용 QA와 수정 포함 QA를 구분

qa-only는 앱을 실제로 사용해 재현 가능한 보고서만 만들고, qa는 승인된 문제를 수정하고 다시 확인합니다. 첫 실행은 보고 전용으로 진행합니다.

보고만
gstack-qa-only 스킬로 정상/빈/중복/긴 입력,
연속 클릭, 새로고침, 모바일을 테스트해 줘.
수정하지 말고 기대/실제 결과를 작성해 줘.

Claude: /qa-only
승인 후 수정
gstack-qa 스킬로 승인한 결함만 수정하고
같은 사용자 흐름으로 재검증해 줘.

Claude: /qa
산출물QA 보고서 · 스크린샷 · 수정 전후 결과통과 조건모든 핵심 인수 조건에 재현 가능한 증거가 있다.
EXAMPLE OUTPUT 06qa-only 보고서 예시
테스트기대실제판정
공백 입력추가 안 됨빈 항목 추가FAIL
중복 입력안내 후 차단2개 추가FAIL
긴 제목·모바일줄바꿈 유지버튼 밀림FAIL
정상 입력1개 추가1개 추가PASS

재현 절차 예시 → 375px 화면 → 120자 입력 → 추가 → 완료 버튼이 화면 밖으로 밀리는지 확인한다.

07출시 준비

HARDEN & DOCUMENT

보안·성능·문서가 구현과 일치하는지 확인

사용자 입력이나 인증이 있으면 cso, 웹 성능이 중요하면 benchmark, 변경이 끝났으면 document-release로 문서를 동기화합니다.

보안gstack-csoClaude: /cso
성능gstack-benchmarkClaude: /benchmark
문서gstack-document-releaseClaude: /document-release
산출물보안/성능 결과 · 최신 README · 변경 설명통과 조건중대한 미해결 위험과 문서 불일치가 없다.
EXAMPLE OUTPUT 07출시 준비 결과 예시

보안 사용자 입력 렌더링 1건 P1 → textContent로 수정 후 재검증 완료

성능 항목 100개 렌더링 18ms → 20ms, 기준 50ms 이내로 PASS

문서 README에 실행 방법, 중복 판단 규칙, 새로고침 후 데이터가 사라지는 제한 추가

판단 중대한 미해결 위험 없음 → 출시 후보

사람의 확인 → 측정값이나 파일 근거 없이 “안전함·빠름”이라고만 결론 내리지 않았는가?

08출시·회고

SHIP & LEARN

검증된 변경만 전달하고 다음 프로젝트에 학습을 남김

ship은 테스트·리뷰·변경 기록·PR 준비를 묶습니다. 실제 배포 환경이 준비된 경우에만 land-and-deploy를 사용하고, 마지막에는 회고를 남깁니다.

PR 준비gstack-shipClaude: /ship
배포 검증gstack-land-and-deployClaude: /land-and-deploy
회고gstack-retro · gstack-learnClaude: /retro · /learn
산출물PR 체크리스트 · 배포 확인 · 회고통과 조건무엇을 왜 바꿨고 어떻게 검증했는지 다른 사람이 이해한다.
EXAMPLE OUTPUT 08ship·retro 결과 예시

변경 요약 빈 입력·중복을 차단하고 긴 제목의 모바일 레이아웃을 보완했다.

검증 인수 조건 4개, QA 시나리오 8개 PASS. 보안 P1 재검증 완료.

남은 제한 데이터는 브라우저 메모리에만 있어 새로고침 후 사라진다.

회고 구현 전에 중복의 정의를 확정했더라면 재작업 1회를 줄일 수 있었다.

사람의 확인 → 다음 담당자가 변경 이유·검증 증거·남은 위험을 추가 질문 없이 이해할 수 있는가?

HUMAN CHECKPOINTS

AI가 멈추고 사람이 결정해야 하는 네 지점

① 문제 승인누구의 문제인지② 범위 승인무엇을 제외할지③ 결함 승인무엇을 고칠지④ 출시 승인남은 위험을 수용할지

07 / EXTENSION DOWNLOADS

전체 과정도
단계별 ZIP으로 실습합니다.

각 ZIP에는 같은 Focus List 프로젝트, 단계별 README, 작성용 워크시트가 들어 있습니다. 앞 단계의 결과를 다음 단계 워크시트에 옮기며 진행합니다.

08 / COMPLETION

완료 기준은
“실행했다”가 아닙니다.

각 결과가 근거를 갖고 있는지, 사람이 중요한 판단을 수행했는지가 평가의 중심입니다.

20

환경 구성

도구와 gstack 상태를 확인했다.

20

스킬 선택

목적에 맞는 역할을 선택했다.

20

근거 확인

파일과 동작으로 AI 출력을 검증했다.

20

품질 보고

재현 가능한 리뷰·QA 결과를 남겼다.

20

사람의 판단

가정과 최종 결정을 구분했다.

NEXT PBL PROJECT

이제 실제 프로젝트에
하나의 루프를 적용할 차례입니다.

문제 정의 → 기술 계획 → 구현 → 리뷰 → QA → 회고