바로 만들지 않기
사용자 문제와 범위를 확인하고 구현 전에 가정을 드러냅니다.
3 HOURS HANDS-ON LECTURE
Codex와 Claude Code에 gstack을 설치하고, 같은 프로젝트를 계획·리뷰·QA하며 AI 개발 워크플로를 직접 비교하는 입문 강의입니다.
gstack workflow
Think → Plangstack은 코딩 모델이 아니라 AI에게 역할·순서·품질 기준을 부여하는 개발 워크플로입니다.
01 / ORIENTATION
사용자 문제와 범위를 확인하고 구현 전에 가정을 드러냅니다.
제품, 기술, 리뷰, QA 관점을 각각 다른 스킬로 실행합니다.
AI 출력은 정답이 아닙니다. 파일, Git diff, 실제 동작으로 확인합니다.
02 / 180-MINUTE ROADMAP
gstack과 두 실행 환경의 차이를 이해합니다.
Git, Bun, 계정, 터미널 환경을 확인합니다.
각 도구를 설치하고 프로젝트에서 첫 읽기 작업을 수행합니다.
선택한 host에 스킬을 등록하고 상태를 확인합니다.
설치 문제가 있는 학습자는 이 시간에 보완합니다.
office-hours와 plan-eng-review를 실행합니다.
코드 관점과 사용자 행동 관점의 차이를 체험합니다.
두 도구의 결과를 비교하고 PBL 적용 계획을 정리합니다.
03 / SETUP
학습자는 하나의 트랙을 선택해 따라 합니다. 강사는 두 환경을 나란히 시연합니다.
Windows 학습자는 먼저 Windows 네이티브 설치를 따라 합니다. WSL2는 Linux 환경이 필요한 학습자를 위한 선택 과정입니다. 어느 쪽이든 Codex·Claude·gstack을 같은 환경에 설치해야 합니다.
WINDOWS · START FROM ZERO
아래 순서를 위에서부터 하나씩 진행합니다. 명령 앞의 PS C:\Users\... 같은 글자는 입력하지 않고, 회색 명령 상자 안의 내용만 입력합니다.
컴퓨터에 글자로 명령을 전달하는 창입니다.
Windows에 기본으로 포함된 터미널입니다.
복사한 뒤 PowerShell에 붙여넣고 Enter를 누릅니다.
Windows 안에서 Ubuntu Linux를 실행하는 선택 기능입니다.
추가 운영체제를 배우지 않고 PowerShell에서 바로 설치합니다.
Linux 개발 환경으로 통일해야 하거나 네이티브 설치가 막힐 때 사용합니다.
키보드의 Windows 키를 누르고 PowerShell을 검색한 뒤 실행합니다. 창에 PS C:\Users\사용자이름>이 보이면 정상입니다.
아래 명령을 한 줄씩 붙여넣고 Enter를 누릅니다.
winget install --id Git.Git -e
winget install OpenJS.NodeJS.LTS예상 결과 · 설치 완료 메시지가 나온 뒤 PowerShell을 닫고 다시 엽니다.
powershell -c "irm bun.sh/install.ps1|iex"PowerShell을 새로 열고 bun --version을 입력했을 때 숫자가 나오면 성공입니다.
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"codex --version
codex처음 실행하면 화면 안내에 따라 ChatGPT 계정 등의 제공되는 방식으로 로그인합니다.
winget install Anthropic.ClaudeCodeclaude --version
claude doctor
claudeClaude Code 사용이 가능한 계정이 필요합니다. 한 도구만 사용할 경우 이 단계는 건너뛰어도 됩니다.
git --version
node --version
npm --version
bun --version
codex --version
claude --version각 줄에 버전 번호가 표시되면 다음 단계로 이동합니다.
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git "$HOME\gstack"
cd "$HOME\gstack".\setup.ps1 --host codex
.\setup.ps1 --host claude
.\setup.ps1 --status한 도구만 사용한다면 해당 host 명령만 실행합니다. 상태 표에 codex 또는 claude가 나오면 성공입니다.
ZIP을 마우스 오른쪽 버튼으로 눌러 모두 추출합니다. 압축을 푼 project 폴더를 열고, 탐색기 주소 표시줄에 powershell을 입력한 뒤 Enter를 누릅니다.
git init
git add .
git commit -m "실습 시작 상태"
git status# Codex를 선택한 경우
codex
# Claude Code를 선택한 경우
claudeAI 작업 전후에는 반드시 git status와 git diff를 확인합니다.
WSL은 Windows Subsystem for Linux의 약자입니다. Windows 안에서 Ubuntu 터미널과 Linux 개발 도구를 실행할 수 있게 합니다. gstack을 사용하기 위한 필수 조건은 아닙니다.
wsl --install설치가 끝나면 컴퓨터를 재부팅합니다.
시작 메뉴에서 Ubuntu를 실행하고 Linux 사용자 이름과 비밀번호를 만듭니다. 비밀번호 입력 중 문자가 보이지 않는 것은 정상입니다.
sudo apt update
sudo apt install -y git curl unzip
curl -fsSL https://bun.com/install | bash
source ~/.bashrccurl -fsSL https://chatgpt.com/codex/install.sh | sh
curl -fsSL https://claude.ai/install.sh | bashgit clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack
./setup --host codex
./setup --host claude
./setup --statusCodex만 Windows에 설치하고 gstack은 WSL에 설치하면 서로 다른 홈 폴더를 사용합니다. 모두 Windows에 설치하거나 모두 WSL2 Ubuntu에 설치하세요.
PowerShell을 완전히 닫고 새로 연 뒤 다시 실행합니다.
powershell -ExecutionPolicy Bypass -File .\setup.ps1 --host codex처럼 실행합니다.
git config user.name "student"와 로컬 이메일을 설정합니다.
Codex·Claude를 종료하고 새 세션을 연 뒤 .\setup.ps1 --status를 확인합니다.
PowerShell을 새로 열고 bun --version을 다시 확인합니다.
보안 설정을 끄지 말고 강사에게 알린 뒤 WSL2 과정으로 전환합니다.
터미널에서 프로젝트를 읽고 수정하며, gstack 스킬은 이름을 자연어로 지정합니다.
curl -fsSL https://chatgpt.com/codex/install.sh | shnpm install -g @openai/codexcodex --version
codexgstack의 정식 지원 환경이며, 주요 스킬을 슬래시 명령으로 호출합니다.
brew install --cask claude-codenpm install -g @anthropic-ai/claude-codeclaude --version
claude doctor
claudeCOMMON STEP
gstack 소스는 공식 Git 저장소에서 받고, 선택한 AI 도구의 skills 폴더에 등록합니다.
git clone --single-branch --depth 1 \
https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack# Codex
./setup --host codex
# Claude Code
./setup --host claude./setup --statusMETHOD B · PROMPT-DRIVEN SETUP
Codex는 현재 환경을 확인하고 필요한 명령을 제안·실행할 수 있습니다. 파일 쓰기나 네트워크 접근이 필요하면 승인 정책에 따라 사용자에게 허용 여부를 묻습니다.
Codex가 자기 자신을 설치할 수는 없습니다. 위의 공식 설치 명령으로 Codex CLI 설치와 로그인을 먼저 완료한 뒤 이 과정을 시작합니다.
빈 폴더 또는 압축을 푼 실습 폴더에서 터미널을 열고 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먼저 읽기 전용으로 운영체제, 셸, 필수 도구와 기존 설치 여부를 확인합니다.
gstack 설치를 준비하고 있어.
먼저 현재 운영체제와 셸을 확인하고,
Git, Bun, Codex 버전과 기존 gstack 설치 여부를 점검해 줘.
아직 설치하거나 파일을 수정하지 말고,
확인한 사실, 부족한 항목, 사용할 설치 경로와
실행할 명령 계획만 보여 줘.Codex가 제시한 운영체제와 설치 경로가 실제 환경과 같은지 확인합니다. 비밀번호, API 키, 인증 코드는 프롬프트에 넣지 않습니다.
환경 Windows 11 / PowerShell 7
확인됨 Git 2.x, Bun 1.x, Codex CLI 로그인
부족함 gstack 미설치
계획 공식 저장소를 C:\Users\student\gstack에 받은 뒤 Codex host 등록과 상태 확인
점검 내용이 맞으면 다음 프롬프트를 보냅니다. 네트워크 접근이나 홈 폴더 쓰기 승인이 나타나면 대상 명령과 경로를 읽은 뒤 허용합니다.
방금 점검한 결과를 기준으로 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. 마지막에 실행한 명령, 설치 경로, 상태 결과를 요약해.모르는 명령이 보이면 승인하지 말고 “이 명령이 무엇을 바꾸는지 설명해 줘”라고 질문합니다.
설치 경로 C:\Users\student\gstack
등록 host codex
상태 installed / skills linked
다음 단계 Codex를 종료하고 새 세션에서 gstack 스킬 실행
# Codex에서 나간 뒤 새 터미널
cd "$HOME\gstack-class"
codex먼저 gstack-office-hours 스킬을 사용할 수 있는지 확인해 줘.
사용 가능하면 이 프로젝트를 읽고 다음을 정리해 줘.
1. 대상 사용자
2. 사용자가 겪는 문제
3. 가장 작은 핵심 기능
4. 검증되지 않은 가정
아직 파일을 수정하지 마.예상 결과 · office-hours 질문이 시작되거나 사용자·문제·가정이 정리됩니다. 스킬을 찾을 수 없다고 나오면 Codex를 완전히 종료한 뒤 새 세션에서 다시 실행합니다.
04 / DOWNLOAD & PRACTICE
GitHub 실습 저장소는 사용하지 않습니다. ZIP을 내려받아 압축을 풀고 로컬 Git 저장소를 생성합니다.
실습 파일 다운로드
압축 해제 후 이동
로컬 기준점 생성
Codex 또는 Claude 실행
cd 다운로드한-실습폴더/project
git init
git add .
git commit -m "실습 시작 상태"
git status15 MIN · 준비
Git, Bun, Codex, Claude 버전 확인 스크립트와 수강생 체크리스트입니다.
20 MIN · 첫 실행
의도적인 문제가 포함된 Focus List 앱에서 office-hours를 실행합니다.
25 MIN · 계획
plan-eng-review로 구성요소, 데이터 흐름, 예외와 테스트를 검토합니다.
20 MIN · 검증
review와 qa-only의 관점 차이를 확인하고 재현 가능한 보고서를 작성합니다.
INSTRUCTOR & OFFLINE PACK
10단계 자료와 샘플 앱, 워크시트를 하나의 ZIP으로 묶었습니다.
05 / PROMPT LAB
gstack-office-hours 스킬을 사용해 이 프로젝트를 검토해 줘.
1. 대상 사용자
2. 해결하려는 문제
3. 핵심 가치
4. 가장 작은 핵심 기능
5. 검증되지 않은 가정
아직 코드를 수정하지 마.
/office-hours
이 프로젝트의 대상 사용자, 해결하려는 문제,
핵심 가치, 가장 작은 핵심 기능과 검증되지 않은 가정을
정리해 줘. 아직 코드를 수정하지 마.
작업 전후에 git status와 git diff를 확인하고, AI의 설명은 실제 파일과 실행 결과로 검증합니다.
06 / FULL LIFECYCLE LAB
앞의 3시간 입문 강의가 설치와 첫 경험이라면, 이 과정은 PBL에 적용하는 후속 확장 실습입니다. 각 단계는 명령, 사람의 결정, 산출물, 통과 조건으로 끝납니다.
Focus List 앱에 빈 입력 방지, 중복 방지, 긴 제목 처리 기능을 추가한다고 가정합니다. 기획과 계획 단계에서는 코드를 수정하지 않고, 구현 단계부터 변경합니다.
아래 초록색 결과 상자는 명령을 실행했을 때 얻을 수 있는 예시입니다. 문장을 그대로 복사하는 정답지가 아니라, 내 결과에 사용자·근거·검증 조건이 빠지지 않았는지 비교하는 기준으로 사용합니다.
문제·사용자
요구·완료기준
제품·디자인·기술
작게 구현
리뷰·디버깅·QA
문서·출시·회고
DISCOVER · 수정 금지
대상 사용자, 현재 해결 방식, 가장 절박한 문제, 검증되지 않은 가정을 찾습니다. AI의 제안은 후보이며 최종 제품 방향은 사람이 결정합니다.
gstack-office-hours 스킬을 사용해 Focus List의
대상 사용자, 현재 대안, 핵심 문제, 최소 검증 기능을
정리해 줘. 아직 파일을 수정하지 마./office-hours
Focus List의 사용자 문제와 최소 검증 기능을
정리해 줘. 아직 파일을 수정하지 마.대상 사용자 수업·과제를 동시에 관리하는 교육생
핵심 문제 해야 할 일을 적어도 지금 처리할 한 가지를 빠르게 구분하기 어렵다.
최소 검증 기능 3초 안에 할 일을 추가하고 완료 상태를 바꾼다.
검증할 가정 사용자는 분류 기능보다 빠른 입력을 먼저 원한다.
사람의 확인 → “학생용 할 일 앱”처럼 기능명만 적지 않고, 실제 불편과 검증할 가정이 드러났는가?
SPEC · 수정 금지
범위, 사용자 시나리오, 정상·예외 흐름, 인수 조건을 고정합니다. “잘 동작한다” 대신 관찰 가능한 완료 기준을 씁니다.
gstack-spec 스킬로 빈 입력·중복 항목·긴 제목 처리의
정상/예외 시나리오와 인수 조건을 작성해 줘.
아직 구현하지 마./spec
세 기능의 시나리오와 인수 조건을 작성해 줘.
아직 구현하지 마.Given 입력창에 공백만 입력되어 있고
When “추가” 버튼을 누르면
Then 항목 수는 증가하지 않으며 “내용을 입력하세요”가 표시된다.
제외 범위 로그인, 서버 저장, 카테고리 분류는 이번 실습에서 다루지 않는다.
사람의 확인 → “적절히 처리한다” 같은 모호한 표현 없이 화면에서 성공과 실패를 판별할 수 있는가?
PLAN · 수정 금지
무엇을 제외할지, 사용자에게 어떻게 보일지, 코드와 데이터가 어떻게 흐를지를 분리해 검토합니다. 빠르게 진행할 때는 autoplan으로 세 관점을 연속 실행합니다.
gstack-plan-ceo-reviewClaude: /plan-ceo-reviewgstack-plan-design-reviewClaude: /plan-design-reviewgstack-plan-eng-reviewClaude: /plan-eng-reviewgstack-autoplanClaude: /autoplangstack-plan-eng-review 스킬로 현재 명세를 검토해 줘.
변경 파일, 데이터 흐름, 실패 경로, 테스트, 구현 순서를
포함하고 아직 구현하지 마.변경 파일 app.js 입력 검증·중복 비교, styles.css 오류·긴 제목 상태
데이터 흐름 입력 → trim → 빈 값 검사 → 중복 검사 → 배열 추가 → 다시 렌더링
실패 경로 공백, 대소문자만 다른 중복, 100자 이상 제목, 빠른 연속 클릭
구현 순서 입력 검증 → 중복 규칙 → 화면 상태 → 회귀 테스트
사람의 확인 → AI가 제안한 파일과 함수가 프로젝트에 실제로 존재하는지 직접 열어 확인한다.
BUILD · 여기서부터 수정 허용
구현은 기본 에이전트 기능으로 수행합니다. 한 기능씩 요청하고, 각 변경 뒤 실행 결과와 Git diff를 확인합니다. gstack은 구현 전후의 계획·검증 역할을 강화합니다.
승인한 명세와 기술 계획을 기준으로
먼저 빈 입력 방지만 구현해 줘.
검증을 수행하고 다른 기능은 건드리지 마.git status
git diff
git add .
git commit -m "feat: prevent blank tasks"$ git diff --stat
app.js | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)
$ git status --short
M app.js
브라우저 확인
✓ 공백 입력: 항목 0개 유지, 안내 표시
✓ 정상 입력: 항목 1개 추가
✓ 기존 완료 버튼: 정상 동작사람의 확인 → 계획에 없던 파일이 바뀌지 않았고, 정상 흐름도 그대로 동작하는가?
REVIEW & DEBUG
review는 diff의 버그·누락·구조적 위험을 찾고, investigate는 재현 → 증거 → 가설 → 수정 순서로 원인을 좁힙니다. 보고만 받을 때는 “수정하지 마”를 명시합니다.
gstack-review 스킬로 현재 diff를 검토해 줘.
심각도, 파일 근거, 재현 방법만 보고하고 수정하지 마.
Claude: /reviewgstack-investigate 스킬로 중복 항목 원인을 조사해 줘.
재현과 근거를 먼저 제시하고 승인 전에는 수정하지 마.
Claude: /investigateapp.js에서 제목을 innerHTML로 삽입한다. 악성 HTML 입력으로 재현 가능하며 텍스트 노드 또는 textContent 사용이 필요하다.
중복 검사를 렌더링 후 수행해 빠른 두 번째 클릭이 같은 배열 상태를 읽는다. 버튼 비활성화가 아니라 검증 순서가 원인이다.
사람의 확인 → 심각도, 파일 위치, 재현 조건, 사용자 영향이 하나의 근거로 연결되는가?
QA · 사용자 행동 검증
qa-only는 앱을 실제로 사용해 재현 가능한 보고서만 만들고, qa는 승인된 문제를 수정하고 다시 확인합니다. 첫 실행은 보고 전용으로 진행합니다.
gstack-qa-only 스킬로 정상/빈/중복/긴 입력,
연속 클릭, 새로고침, 모바일을 테스트해 줘.
수정하지 말고 기대/실제 결과를 작성해 줘.
Claude: /qa-onlygstack-qa 스킬로 승인한 결함만 수정하고
같은 사용자 흐름으로 재검증해 줘.
Claude: /qa재현 절차 예시 → 375px 화면 → 120자 입력 → 추가 → 완료 버튼이 화면 밖으로 밀리는지 확인한다.
HARDEN & DOCUMENT
사용자 입력이나 인증이 있으면 cso, 웹 성능이 중요하면 benchmark, 변경이 끝났으면 document-release로 문서를 동기화합니다.
gstack-csoClaude: /csogstack-benchmarkClaude: /benchmarkgstack-document-releaseClaude: /document-release보안 사용자 입력 렌더링 1건 P1 → textContent로 수정 후 재검증 완료
성능 항목 100개 렌더링 18ms → 20ms, 기준 50ms 이내로 PASS
문서 README에 실행 방법, 중복 판단 규칙, 새로고침 후 데이터가 사라지는 제한 추가
판단 중대한 미해결 위험 없음 → 출시 후보
사람의 확인 → 측정값이나 파일 근거 없이 “안전함·빠름”이라고만 결론 내리지 않았는가?
SHIP & LEARN
ship은 테스트·리뷰·변경 기록·PR 준비를 묶습니다. 실제 배포 환경이 준비된 경우에만 land-and-deploy를 사용하고, 마지막에는 회고를 남깁니다.
gstack-shipClaude: /shipgstack-land-and-deployClaude: /land-and-deploygstack-retro · gstack-learnClaude: /retro · /learn변경 요약 빈 입력·중복을 차단하고 긴 제목의 모바일 레이아웃을 보완했다.
검증 인수 조건 4개, QA 시나리오 8개 PASS. 보안 P1 재검증 완료.
남은 제한 데이터는 브라우저 메모리에만 있어 새로고침 후 사라진다.
회고 구현 전에 중복의 정의를 확정했더라면 재작업 1회를 줄일 수 있었다.
사람의 확인 → 다음 담당자가 변경 이유·검증 증거·남은 위험을 추가 질문 없이 이해할 수 있는가?
HUMAN CHECKPOINTS
07 / EXTENSION DOWNLOADS
각 ZIP에는 같은 Focus List 프로젝트, 단계별 README, 작성용 워크시트가 들어 있습니다. 앞 단계의 결과를 다음 단계 워크시트에 옮기며 진행합니다.
office-hours · spec
ZIP 다운로드 ↓plan-ceo · plan-design · plan-eng
ZIP 다운로드 ↓작은 구현 · diff · 기능별 커밋
ZIP 다운로드 ↓review · investigate · qa-only · qa
ZIP 다운로드 ↓cso · benchmark · document-release
ZIP 다운로드 ↓ship · land-and-deploy · retro · learn
ZIP 다운로드 ↓08 / COMPLETION
각 결과가 근거를 갖고 있는지, 사람이 중요한 판단을 수행했는지가 평가의 중심입니다.
도구와 gstack 상태를 확인했다.
목적에 맞는 역할을 선택했다.
파일과 동작으로 AI 출력을 검증했다.
재현 가능한 리뷰·QA 결과를 남겼다.
가정과 최종 결정을 구분했다.
NEXT PBL PROJECT
문제 정의 → 기술 계획 → 구현 → 리뷰 → QA → 회고