AACE AI SW
👤ParticipantACE AI SW
DAY 03 · WEDNESDAY · DESIGN · 2-DAY INTENSIVE

gstack으로 AI 개발팀을 세우고,
문서로 설계한다

Day 2에서 “AI는 프롬프트에 없는 것을 만들지 못한다”는 것을 경험했습니다. 오늘은 그 해답을 배웁니다. Part 1에서 AI에게 역할·순서·품질 기준을 주는 워크플로 gstack을 익히고, Part 2에서 gstack으로 Markdown 명세를 만들고 검증하는 문서 기반 설계를 실습합니다.

2일 분량을 하루에 담은 집중 과정입니다. 세션 A~D는 수업 시간에, 심화 세션은 과제·자율 학습으로 이어서 완성합니다.

2-Day Content · 1-Day Intensive

오늘의 진행 순서

gstack을 먼저 이해한 뒤(Part 1), 그 도구로 문서 기반 설계를 진행합니다(Part 2). 심화 세션은 수업 후 과제로 이어집니다.

SESSION A · 90분 · PART 1

gstack 이해와 설치

  • Day 2 회고: AI가 다르게 만든 이유
  • gstack 3원칙·역할·53개 스킬 지도
  • Codex / Claude Code 설치, gstack 등록
  • git 기준점 만들기
슬라이드 P1 · 1–9
SESSION B · 90분 · PART 1

gstack 기획 루프 실습

  • Focus List 예제로 /office-hours
  • /spec 으로 Given/When/Then
  • /plan-ceo · design · eng-review
  • 리뷰·QA·출시와 사람의 4대 승인
슬라이드 P1 · 10–15
SESSION C · 120분 · PART 2

대화를 MD 명세로

  • 학생 초안 + 질문 5개 먼저
  • 사실·가정·질문·결정 분리
  • 4개 폴더 책임 분리
  • gstack으로 화면·데이터·API MD 생성
슬라이드 P2 · 1–10
SESSION D · 90분 · PART 2

문서를 검증하고 확정

  • REQ→UI→DATA→API→TEST 추적표
  • 교차 감사·plan-review로 모순 찾기
  • 설계 검증 판정과 DECISION_LOG
  • 구현 계약 작성
슬라이드 P2 · 11–13
심화 · 과제 · 자율 학습

구현과 서비스 검증

  • 문서 계약대로 요구사항 ID 단위 구현
  • /review · /qa-only · /qa 로 검증
  • 결함 리포트와 재검증
  • 회고: AI 제안 vs 사람의 판단
PBL 미션 3 · 4

HTML Presentation

Day 3 발표 슬라이드

탭으로 Part 1(gstack)과 Part 2(문서 기반 설계)를 전환합니다. ←/→ 이동, N 키 또는 버튼으로 강의 노트를 엽니다.

ACE AI SW Startup Training · Day 3 · Part 1

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

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

한 명의 AITHINK문제 정의PLAN계획 검토REVIEW근거 검토TEST검증·출시
Think문제와 사용자를 먼저 정의
Plan제품·디자인·기술 관점으로 계획 검토
Review변경 위험과 원인을 근거로 검토
Test실제 사용자 행동으로 검증·출시
Bridge from Day 2

어제 AI 결과가 내 설계와 달랐던 이유는?

프롬프트 누락내가 말하지 않은 것은 AI에게 존재하지 않았다→ 해결: 문서(명세)로 빠짐없이 전달
AI의 평균화모호한 부분을 AI가 흔한 패턴으로 채웠다→ 해결: 사실·가정·결정을 분리
검증 부재“됐어요”라는 AI의 말을 그대로 믿었다→ 해결: 역할별 리뷰·QA로 근거 확인
오늘의 답: gstack으로 AI의 일하는 순서를 통제하고, 문서로 AI가 추측할 여지를 없앤다.
What is gstack?

gstack = AI 에이전트에게 주는 역할별 업무 지침서 모음

Y Combinator CEO Garry Tan이 공개한 오픈소스 스킬 세트(github.com/garrytan/gstack). 한 명의 AI를 CEO·디자이너·엔지니어·리뷰어·QA로 나눠 일하게 합니다.

Claude Code (정식 지원)

/office-hours
이 프로젝트의 대상 사용자와 문제를 정리해 줘.
아직 코드를 수정하지 마.
  • 슬래시 명령으로 바로 호출

OpenAI Codex

gstack-office-hours 스킬을 사용해
이 프로젝트의 대상 사용자와 문제를 정리해 줘.
아직 코드를 수정하지 마.
  • 스킬 이름을 자연어로 지정해 호출
Analogy · 식당 주방

gstack을 식당 주방 팀으로 이해하기

AI 혼자 전부 하면주문 받기요리맛보기서빙빠르지만 순서 없음 → 실수를 늦게 발견gstackgstack: 역할을 나눈 주방 팀사장메뉴·가격 결정CEO/office-hours플레이팅보기 좋게Design/plan-design-review셰프레시피·조리ENG/spec · 구현검수재료·위생 확인Review/review시식손님처럼 맛보기QA/qa같은 AI지만, 지금 어떤 역할인지 정해 주면 실수가 줄어든다
Where does gstack live?

gstack은 앱이 아니라 AI가 읽는 업무 매뉴얼

설치하면 내 컴퓨터에 지침서 폴더가 생기고, AI 도구가 명령에 맞는 지침서를 꺼내 읽고 일합니다.

나 (사람)무엇을 만들지 결정하고, 결과를 승인채팅으로 요청: /office-hours …AI 코딩 도구Claude Code · Codex 같은 대화형 AI 에이전트명령을 받으면 해당 스킬 지침을 읽음gstack 스킬 (지침서 53개)~/gstack 폴더 · 각 스킬 = SKILL.md 문서“이 역할은 이렇게 일하라”는 규칙내 프로젝트코드 · 문서(MD) · git 기록AI가 지침대로 읽고 · 쓰고 · 검증
One AI · Five hats

슬래시 명령 하나 = 모자 하나

명령어를 외우기보다 각 역할이 던지는 질문을 기억하세요.

같은 AICEO/office-hours“누구의 어떤 문제야?”Design/plan-design-review“빈 화면·오류 화면은?”ENG/plan-eng-review“어디서 실패할 수 있어?”Review/review“이 변경, 근거가 있어?”QA/qa“손님처럼 써 보면?”
Why bother?

바로 만들면 빠를까? 늦게 고치면 더 비싸다

gstack 없이“앱 만들어 줘”바로 코드 생성“됐어요!”사용해 보니 버그처음부터 다시?gstack과 함께문제 질문/office-hours명세/spec계획 검토/plan-*-review작게 구현사람 승인리뷰 · QA/review /qa출시/ship고치는 비용기획명세계획구현리뷰출시 후gstack 앞부분 = 오늘 Day 3문제를 늦게 찾을수록 고치기 어렵다 (개념도)
3 Principles

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

01바로 만들지 않기코드 전에 사용자 문제와 범위를 확인하고, 숨겨진 가정을 드러낸다.“누구의 어떤 불편을 해결하는가?”
02역할을 분리하기제품·디자인·기술·리뷰·QA 관점을 섞지 않고 각각 다른 스킬로 실행한다.기획 단계에서는 코드 수정 금지
03결과를 검증하기AI 출력은 정답지가 아니다. 파일, git diff, 브라우저 실행으로 사람이 확인한다.근거 없는 통과는 인정하지 않음
Your AI development team

한 명의 AI를 다섯 개의 역할로 나눈다

CEO · 제품
“누구의 어떤 문제인가?”
사용자 문제 · 가치 · 범위
/office-hours/plan-ceo-review
→ 문제 정의 · MVP 범위
Design · 디자인
“사용자는 어떤 화면을 보나?”
UX 흐름 · 화면 상태 · 시각 방향
/plan-design-review/design-consultation
→ 화면 흐름 · 디자인 원칙
ENG · 기술
“어디서 실패할 수 있나?”
구조 · 데이터 흐름 · 실패 경로 · 테스트
/spec/plan-eng-review
→ 명세 · 구현 계획
Review · 리뷰
“이 변경, 근거가 있나?”
diff의 결함 · 보안 · 근본 원인
/review/investigate/cso
→ 심각도별 리뷰 보고
QA & Ship
“손님처럼 써 보면?”
실제 사용자 행동 · 문서 · 출시
/qa-only/qa/ship/retro
→ 판정표 · 출시 체크리스트
HANDS-ON 0110분짝 · 퀴즈

이 상황엔 어떤 모자가 필요할까?

목표상황을 보고 어떤 역할(명령어)을 불러야 하는지 스스로 고른다
CEO/office-hours“누구의 어떤 문제?”
Design/plan-design-review“화면 상태는?”
ENG/plan-eng-review“어디서 실패?”
Review/review“변경 근거는?”
QA/qa“써 보면?”
1
상황 읽기누가 · 무엇이 문제인가
2
짝과 상의30초 동안 이유 말하기
3
역할 고르기버튼을 눌러 확인
4
이유 정리왜 그 역할인가
학생들이 정말 이 앱을 원하는지 아무도 확인하지 않았다
✓ CEO — 사용자 문제와 가치를 먼저 확인하는 일 → /office-hours
품절일 때 메뉴 화면이 어떻게 보여야 하는지 정해진 게 없다
✓ Design — 빈·오류·품절 같은 화면 상태 누락 → /plan-design-review
100명이 동시에 주문하면 어디서 실패할지 모르겠다
✓ ENG — 데이터 흐름과 실패 경로 → /plan-eng-review
AI가 바꾼 코드에 innerHTML이 들어가 보안이 걱정된다
✓ Review — 변경(diff)의 결함·보안 → /review
휴대폰으로 주문해 보니 “담기” 버튼이 눌리지 않는다
✓ QA — 실제 사용자 행동으로 확인 → /qa
정답 0 / 5
0/4
체크하면서
스스로 확인해 보세요
취창업 연결팀 프로젝트 면접 질문 “기획·디자인·개발·QA는 각각 무엇을 보나요?” — 오늘 고른 역할이 그대로 답이 됩니다.
Standard end-to-end workflow

가장 일반적인 gstack 파이프라인

오늘 Day 3 집중 구간/office-hours문제 정의/autoplan계획 검토기능 구현사람이 승인/review코드 검토/qa사용자 테스트/shipPR · 출시/land-and-deploy배포/canary배포 후 감시사람 손
/office-hours아이디어와 제품 방향을 YC 방식 질문으로 구체화
/autoplanCEO → 디자인 → 엔지니어링 → DX 검토를 한 번에
/review → /qa코드 관점 검토 후 실제 브라우저에서 사용자 흐름 테스트
/ship → /canaryPR·배포 후 오류와 성능 저하 감시
오늘 Day 3의 초점: 파이프라인의 앞부분(문제 정의 → 명세 → 계획 검토). 구현 전에 끝내야 할 일들입니다.
gstack skill map · 53 skills

53개 스킬, 10개 카테고리로 기억하기

브라우저·QA10browse · qa · qa-only · benchmark · canary …기획·설계8office-hours · autoplan · spec · plan-*-review오늘 사용코드 품질8review · investigate · cso · health …배포·문서화6ship · land-and-deploy · document-release …기억·상태5context-save · context-restore · learn …iOS5ios-qa · ios-fix …안전장치4careful · freeze · guard · unfreeze디자인·구현3design-consultation · design-shotgun · design-html문서·시각2diagram · make-pdf오늘 사용운영2retro · gstack-upgrade
53개를 외우지 마세요. “지금 어느 단계인가?”만 알면, 아래 명령어 사전에서 찾아 쓰면 됩니다.
Setup · 15–60 min

설치: 도구 확인 → gstack 등록 → 상태 확인

1. 도구 확인git · node · bun · AI 도구2. gstack 받기git clone → ~/gstack3. 등록 · 상태 확인setup --host · --status

macOS · Linux · WSL

# 1. 버전 확인
git --version && node --version && bun --version
codex --version   # 또는 claude --version
# 2. gstack 받기 + host 등록
git clone --single-branch --depth 1 \
  https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack
./setup --host codex   # 또는 --host claude
./setup --status

Windows (PowerShell)

winget install --id Git.Git -e
winget install OpenJS.NodeJS.LTS
powershell -c "irm bun.sh/install.ps1|iex"
git clone --single-branch --depth 1 `
  https://github.com/garrytan/gstack.git "$HOME\gstack"
cd "$HOME\gstack"
.\setup.ps1 --host codex
.\setup.ps1 --status
  • setup.ps1 차단 시: -ExecutionPolicy Bypass -File .\setup.ps1
  • 스킬이 안 보이면: 도구 종료 → 새 터미널 → --status 재확인
Golden rule

AI 작업 전후에는 반드시 git으로 확인

저장 지점 만들기git commit게임의 세이브 포인트AI에게 작업 맡기기gstack 스킬 실행AI가 파일을 바꿈무엇이 바뀌었나?git status · git diff말이 아니라 증거 확인마음에 안 들면git restore세이브 포인트로 돌아가기

실습 시작 기준점

cd 실습폴더/project
git init
git add .
git commit -m "실습 시작 상태"
# AI 작업 후
git status
git diff

AI 승인 창 4가지 체크

  • ① 지금 실행하려는 것이 git clone / setup 인가?
  • ② 저장소가 공식 garrytan/gstack 인가?
  • ③ 내 홈 폴더 안에서만 작업하는가?
  • ④ 삭제·강제 덮어쓰기 명령이 없는가?
AI의 설명은 실제 파일 · git diff · 브라우저 실행 결과로 검증합니다. 말이 아니라 증거.
HANDS-ON 0215분혼자 · 터미널

git 세이브 포인트 직접 만들어 보기

목표AI가 파일을 바꿔도 언제든 확인하고 되돌릴 수 있는 상태를 만든다
1
저장 지점git commit
2
AI 작업gstack 스킬 실행
3
변경 확인git status · git diff
4
되돌리기git restore
비유게임에서 보스전 전에 저장하듯, AI에게 일을 맡기기 전에 꼭 저장합니다.

순서대로 실행 · 복사 버튼 사용

1
저장 지점 만들기git init && git add . git commit -m "실습 시작 상태"
2
AI에게 작업 맡기기/office-hours (… 아직 파일을 수정하지 마)
3
무엇이 바뀌었나 확인git status && git diff
4
마음에 안 들면 되돌리기git restore .

AI 승인 창 4가지 체크

0 / 4
0/4
체크하면서
스스로 확인해 보세요
취창업 연결git 사용은 개발 직무 기본 중의 기본입니다. GitHub 커밋 기록은 그대로 포트폴리오가 됩니다.
Step 01 · DISCOVER · 코드 수정 금지

/office-hours — 무엇을 만들지보다 왜를 먼저

문제명세계획구현리뷰QA출시← 지금 위치

프롬프트

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

결과 예시

  • 대상 사용자: 수업·과제를 동시에 관리하는 교육생
  • 핵심 문제: 지금 처리할 한 가지를 빠르게 구분하기 어렵다
  • 최소 검증 기능: 3초 안에 할 일 추가·완료 전환
  • 검증할 가정: 분류보다 빠른 입력을 먼저 원한다
산출물: 문제 정의 1문장 · 사용자 1명 · 가정 3개 → Part 2의 PROJECT_BRIEF.md가 됩니다.
HANDS-ON 0315분짝 → 혼자 · 판정

/office-hours 결과, 통과일까 실패일까?

목표AI 결과를 그대로 믿지 않고 사용자 · 문제 · 가정 기준으로 판정한다

✓ 통과 기준

대상 사용자가 구체적이다
문제가 실제 불편으로 쓰였다
검증할 가정이 1개 이상 있다

✗ 실패 신호

기능 이름만 나열 (“알림, 카테고리…”)
“모든 사람”, “생산성” 같은 막연한 말
확인할 질문 · 가정이 없음
1
예시 3개 판정통과 / 실패 누르기
2
내 결과 받기/office-hours 실행
3
같은 기준으로내 결과 판정
4
1문장 정리문제 정의 쓰기
AI 결과 A
학생용 할 일 앱
기능: 할 일 추가 · 삭제
      카테고리 · 알림
기능 이름만 있고, 누구의 어떤 불편인지 · 검증할 가정이 없습니다.
AI 결과 B
대상: 수업·과제를 동시에
      관리하는 교육생
문제: 지금 할 한 가지를
      빨리 고르기 어렵다
가정: 분류보다 빠른 입력
사용자 · 문제 · 검증할 가정이 모두 보입니다. 통과!
AI 결과 C
대상: 모든 사람
문제: 생산성이 낮다
해결: AI 일정 추천
대상이 너무 넓고, 문제가 막연하며, 검증할 가정이 없습니다.
0/4
체크하면서
스스로 확인해 보세요
창업 포인트창업 피치의 첫 장은 언제나 “누구의 어떤 문제인가”입니다. 기능 목록으로 시작하는 피치는 투자자를 설득하지 못합니다.
Step 02 · SPEC · 코드 수정 금지

/spec — 테스트 가능한 요구사항으로 바꾸기

문제명세계획구현리뷰QA출시← 지금 위치

프롬프트

/spec
빈 입력·중복 항목·긴 제목 처리의
정상/예외 시나리오와 인수 조건을
Given/When/Then 으로 작성해 줘.
아직 구현하지 마.

결과 예시 · Given / When / Then

Given상황공백만 입력된 상태에서
When행동“추가” 버튼을 누르면
Then결과항목 수는 그대로 · “내용을 입력하세요” 표시
제외 범위 로그인 · 서버 저장 · 카테고리
판별 기준: 제3자가 화면을 보고 성공/실패를 동일하게 판정할 수 있는가?
HANDS-ON 0415분혼자 → 짝 · 작성

Given / When / Then 직접 써 보기

목표누가 봐도 성공/실패를 똑같이 판정할 수 있는 인수 조건을 쓴다
Given어떤 상황에서 — 공백만 입력된 상태에서
When무엇을 하면 — “추가” 버튼을 누르면
Then무엇이 보인다 — 항목 수는 그대로, “내용을 입력하세요” 표시

✗ 판정 불가

Then: 오류를 잘 처리한다

✓ 판정 가능

Then: 항목 수는 그대로이고 “내용을 입력하세요”가 보인다

시나리오 고르기

인수 조건 카드 · 실시간

Given…
When…
Then…
빈칸을 채우면 판정 가능 여부를 알려 줘요
0/4
체크하면서
스스로 확인해 보세요
취창업 연결테스트 가능한 요구사항을 쓰는 능력은 QA · 기획 · 개발 직무 모두에서 바로 쓰이는 실무 역량입니다.
Step 03 · PLAN · 코드 수정 금지

같은 명세, 세 개의 시선으로 검토

같은 명세CEODesignENG
문제명세계획구현리뷰QA출시← 지금 위치
/plan-ceo-review제품 가치·범위·우선순위. “이번 릴리즈에서 뺄 것은?”
/plan-design-reviewUI/UX 계획. 빈 상태·오류 상태·모바일 흐름 누락 점검
/plan-eng-review변경 파일, 데이터 흐름, 실패 경로, 테스트, 구현 순서
plan-eng-review 결과 예시
데이터 흐름입력 → trim → 빈 값 검사 → 중복 검사 → 배열 추가 → 렌더링
실패 경로공백, 대소문자 중복, 100자 이상 제목, 빠른 연속 클릭
구현 순서입력 검증 → 중복 규칙 → 화면 상태 → 회귀 테스트
Step 04–08 · BUILD → REVIEW → QA → SHIP

구현 이후: 작게 만들고, 나눠서 검증

문제명세계획구현리뷰QA출시← 지금 위치
Build승인한 명세 기준으로 한 기능씩 구현 → git diff → 커밋여기서부터 수정 허용
/review · /investigatediff의 심각도·파일 근거·재현 방법. 원인은 재현 먼저예: innerHTML → textContent
/qa-only → /qa먼저 수정 없이 판정표, 승인 후 수정정상·빈·중복·모바일
/cso · /ship · /retro보안·성능·문서 동기화 → 출시 → 회고/document-release
qa-only 판정표기대 결과실제 결과판정
공백 입력추가 안 됨빈 항목 추가FAIL
정상 입력1개 추가1개 추가PASS
Human checkpoints

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

/office-hours/spec · plan구현/review · /qa/ship① 문제 승인누구의 어떤 문제인지 확정② 범위 승인이번 릴리즈에서 뺄 것 결정③ 결함 승인무엇을 지금 고칠지 결정④ 출시 승인남은 위험을 수용할지 결정노란 문 = AI가 멈추고 사람이 결정하는 곳 → DECISION_LOG.md에 기록
모든 승인은 DECISION_LOG.md에 근거·담당·재검토 기준과 함께 남깁니다. (Part 2에서 작성)
Part 1 wrap-up

완료 기준은 “실행했다”가 아니라
근거와 사람의 판단

환경 구성도구와 gstack 등록 상태 확인
스킬 선택단계 목적에 맞는 역할 호출
근거 확인파일·diff·실제 동작으로 검증
품질 보고재현 가능한 리뷰·QA 결과
사람의 판단AI 가정과 최종 결정 구분
문제 정의→요구 명세→다각도 계획→문서로 확정 (Part 2)→작은 구현→리뷰·QA
Day 3 · Part 2 · Document-driven design

대화를 명세로,
명세를 서비스로.

요구사항 대화를 사람이 검토할 수 있는 Markdown 계약으로 정리하고, gstack으로 검증한 뒤, 그 문서만을 근거로 구현합니다.

01 · 대화 정리FACT · QUESTION · DECISION25점 · 3–4h
02 · 명세 설계UX · DATA · API · QA25점 · 4–6h
03 · 서비스 구현BUILD · TRACE · TEST30점 · 6–9h (심화)
04 · 설계·서비스 검증VERIFY · EVIDENCE · RETRO20점 · 3–5h (심화)
01 대화 정리 · 25점3–4h02 명세 설계 · 25점4–6h03 서비스 구현 · 30점6–9h · 심화04 검증 · 20점3–5h · 심화배점 100점오늘 Day 3는 여기까지 (50점)
Why documents?

문서는 보고서가 아니라 AI와의 구현 계약

품절은 회색으로?결제도 되나요?관리자는 PC로옵션은 필수?주문 취소는…?하루 100건쯤?흩어진 대화 · AI가 빈칸을 추측REQ-009품절 메뉴는 주문할 수 없다UI-C02 · TEST-011REQ-004필수 옵션 없으면 담기 불가UI-C03 · TEST-007DEC-003MVP에서 결제는 제외근거 · 담당 · 재검토ID가 붙은 계약 · 누구나 같은 판정

대화로만 개발

  • 요구사항이 채팅 기록 속에 흩어진다
  • AI가 빈칸을 임의로 채운다 (가정이 사실이 됨)
  • 고객 화면과 관리자 화면의 데이터가 어긋난다
  • “무엇이 완료인가”를 아무도 판정할 수 없다

문서 기반 개발

  • 모든 요구에 ID가 있고 화면·데이터·테스트로 연결
  • 사실·가정·결정이 분리되어 추측이 드러난다
  • 공통 데이터 계약을 양쪽 화면이 공유
  • 수용 기준으로 PASS/FAIL을 판정
Project scenario

실습 서비스: 모바일 주문 + PC 관리자

“고객은 휴대폰으로 샌드위치와 음료를 주문하고, 관리자는 PC에서 메뉴·재고·주문 상태를 관리한다.”
주문하기고객 · 모바일주문 생성공통 데이터menu · order상태 변경접수조리중픽업대기완료관리자 · PC

📱 고객 주문 (Mobile 360–430px)

  • 메뉴 탐색 → 상세·옵션 선택
  • 장바구니 담기·수량 조절
  • 주문 완료 및 접수 번호 확인
  • 품절·필수 옵션 누락·빈 장바구니 처리

🖥️ 매장 관리자 (PC 1280px+)

  • 실시간 신규 주문 알림·목록
  • 상태 변경: 접수 → 조리중 → 픽업대기 → 완료
  • 메뉴·품절 관리, 매출 통계
  • 권한과 실수 방지 확인 단계
Mission 01 · Student-first rule

AI를 열기 전에, 내 초안과 질문 5개부터

① 한 문장 정의대상 사용자 · 해결할 문제 · 핵심 행동 · 제외 범위를 내 말로
② 핵심 흐름 초안고객 3~5단계, 관리자 3~5단계를 직접 그린다
③ 모르는 질문 5개예: 품절은 누가, 언제 바꾸나? 주문 취소는 가능한가?
초안이 없으면 AI 결과를 평가할 기준도 없습니다. 결정의 주인은 AI가 아니라 학생입니다.
HANDS-ON 0515분혼자 · 초안

AI를 열기 전에, 내 초안과 질문 5개

목표AI 결과를 평가할 나만의 기준(초안 + 질문)을 먼저 만든다
1
한 문장 정의누가 · 무엇을 · 왜
2
핵심 흐름고객 3~5단계
3
모르는 질문 5개확인이 필요한 것
4
그다음 AI초안과 비교

좋은 질문 예시

① 한 문장 정의

…

② 모르는 질문 5개

0 / 5
0/4
체크하면서
스스로 확인해 보세요
취창업 연결초안을 먼저 쓰는 습관은 “AI를 쓰는 사람”과 “AI에 끌려가는 사람”을 가르는 차이입니다.
Mission 01 · Frame

대화를 사실 · 가정 · 질문 · 결정으로 나누기

요구사항 대화FACT사실 · 대화에 명시된 요구“관리자는 PC에서주문 상태를 바꾼다”ASSUMPTION가정 · AI · 팀의 추정“주문은 하루100건 이하일 것”QUESTION질문 · 추가 확인 필요“접수 후에도 고객이취소할 수 있나?”DECISION결정 · 근거 · 담당 · 재검토“MVP에서 결제는제외 (DEC-003)”
/office-hours
다음 요구사항 대화를 [사실], [가정], [질문], [결정]으로 구분해 줘.
새 사실을 임의로 만들지 말고, 고객 모바일과 PC 관리자 요구를 분리해 줘.
누락된 예외·데이터 정합성 질문을 우선순위와 함께 제안해 줘. 아직 파일을 만들지 마.
HANDS-ON 0615분팀 · 분류 게임

대화 문장을 네 상자로 나눠 보기

목표요구사항 대화에서 사실과 추측을 구분해 AI가 추측을 사실로 만들지 못하게 한다
FACT사실대화에 명시된 요구
ASSUMPTION가정AI · 팀의 추정
QUESTION질문확인이 더 필요
DECISION결정근거 · 담당 · 재검토
힌트회의록에 있으면 사실 · “~것 같다”는 가정 · 물음표는 질문 · 담당과 재검토가 있으면 결정
회의록: “고객은 휴대폰으로 주문한다”
정답: FACT
점심시간에는 주문이 몰릴 것 같다
정답: ASSUMPTION
주문 접수 후에도 고객이 취소할 수 있나?
정답: QUESTION
MVP에서 결제는 제외 — 담당 PM, 2주 후 재검토
정답: DECISION
회의록: “관리자는 PC에서 품절을 바꾼다”
정답: FACT
음료는 아마 사이즈 옵션이 필요할 것이다
정답: ASSUMPTION
0 / 6 분류함
0/4
체크하면서
스스로 확인해 보세요
취창업 연결회의에서 사실과 추측을 구분하는 사람은 어느 팀에서나 신뢰받는 동료가 됩니다.
Project structure

네 개 폴더, 네 개의 책임

kiosk-pbl/
├── PROJECT_BRIEF.md · DECISION_LOG.md        # 미션 1 산출물
├── service-planning/      # 기획·명세: 요구사항, 공통 정책, 화면 명세, 디자인 컨셉
│   ├── common/service-policies.md
│   ├── customer-order/  mobile-screen-spec.md · order-flow.md
│   ├── admin/           pc-screen-spec.md · admin-features.md
│   └── design-concept.md
├── service-analysis/      # 지표·분석: KPI, 이벤트 정의, 분석 API
│   └── analysis-definition.md · analytics-api-definition.md
├── service-implementation/ # 구현: customer · admin · shared 데이터 스토어
└── service-validation/    # 검증: 설계 검증 · 서비스 검증 · 테스트 데이터 · 리포트
    └── design-validation-plan.md · service-validation-plan.md · test-data.md
기획 · 명세service-planning/요구사항 · 정책 · 화면 명세지표 · 분석service-analysis/KPI · 이벤트 · 분석 API구현service-implementation/customer · admin · shared검증service-validation/설계 · 서비스 검증 · 리포트
Mission 02 · MD blueprint package

구현 가능한 Markdown 명세 패키지

문서담는 내용완료 신호
mobile-screen-spec.md메뉴 탐색·상세·옵션·장바구니·완료 + 로딩·빈·품절·오류·복구 상태8개 화면, 화면별 수용 기준
pc-screen-spec.md주문 보드·상태 전이·메뉴/품절 관리·권한상태 전이 규칙 명시
design-concept.md색·타이포·간격·상태 색, 가져올 원리 / 복제 금지 자산Fresh Route 원칙
MENU_DATA가상 메뉴 10개+: menu_id, category, base_price, options, stock, is_available고유 ID·옵션 그룹·재고 규칙
analysis-definition.mdEVT ID, 발생 조건, 속성, 지표 (개인정보 제외)menu_viewed → order_completed
analytics-api-definition.md요청·응답·오류 코드, 주문 상태 전이API-### 정의
design-validation-plan.md문서 간 정합성 검사 기준검증 항목별 판정 방법
How to write a screen spec

화면 하나 = 목적 · 정보 · 행동 · 다음 상태 · 수용 기준

## UI-C03 — 메뉴 상세 · 옵션 선택  (REQ-004, REQ-005)
- 목적: 고객이 빵·소스·사이즈를 고르고 최종 가격을 확인한다
- 표시 정보: 메뉴명, 설명, 기본 가격, 옵션 그룹(필수/선택), 실시간 합계
- 행동: 옵션 선택, 수량 +/-, [장바구니 담기]
- 다음 상태: 담기 성공 → 토스트 + 장바구니 배지 증가 (UI-C04)
- 상태: 정상 / 품절(담기 버튼 비활성) / 필수 옵션 미선택(안내) / 저장 실패(재시도)
- 수용 기준:
  - Given 필수 옵션 미선택 When [담기] Then 담기 안 됨 + "빵을 선택하세요" 표시
  - 합계 = base_price + 옵션 추가금 × 수량
메뉴 이미지치킨 샌드위치₦3,500빵 선택 (필수)화이트통밀소스 (선택)칠리 +200마요− 1 +합계 ₦3,700장바구니 담기필수 옵션 미선택 → 안내옵션 추가금 반영합계 = (기본가 + 추가금) × 수량품절이면 버튼 비활성UI-C03 와이어프레임 (가상 메뉴)
HANDS-ON 0720분팀 · 명세 작성

화면 명세 5요소 + 5상태 채우기

목표화면 하나를 AI가 추측 없이 구현할 수 있게 명세한다
목적이 화면에서 무엇을 이루나
정보무엇을 보여 주나
행동무엇을 누르나
다음 상태누르면 어디로
수용 기준Given/When/Then

정상만 쓰면 안 돼요 · 상태 5가지

정상
빈 목록
품절
오류
복구

UI-C02 · 메뉴 목록 (REQ-001, REQ-009)

문서에 적은 상태 표시

완성도
0 / 10
0/4
체크하면서
스스로 확인해 보세요
취창업 연결화면 명세는 프로덕트 디자이너 · PM 포트폴리오에 그대로 넣을 수 있는 결과물입니다.
Traceability

모든 요구는 ID로 끝까지 연결된다

REQ-009요구 · 품절 메뉴는 주문 불가UI-C02화면 · 품절 표시 · 버튼 비활성DATA데이터 · is_available · stockAPI-004API · 재고 확인 응답TEST-011테스트 · 품절 주문 시도 → 차단
REQ요구UIDATAAPITEST
REQ-004필수 옵션을 고르지 않으면 담을 수 없다UI-C03menu.options[].required—TEST-007
REQ-009품절 메뉴는 주문할 수 없다UI-C02, UI-A05menu.is_available, stockAPI-004TEST-011
REQ-012관리자는 주문 상태를 순서대로만 바꾼다UI-A03order.statusAPI-006TEST-015
빈 칸이 있으면? → 문서가 끊긴 곳 = AI가 추측으로 채울 곳입니다.
HANDS-ON 0810분짝 · 찾기 게임

추적표에서 끊긴 사슬 찾기

목표추적표의 빈칸 = AI가 추측할 곳임을 알고 먼저 찾아 막는다
1
추적표 읽기REQ → UI → DATA → API → TEST
2
빈칸 찾기“?”가 있는 줄
3
정답 확인무엇이 빠졌나
4
우리 표 점검같은 방법으로
주의빈칸이 있는 요구사항을 AI에게 맡기면, AI는 그 칸을 평균적인 추측으로 채웁니다.
REQ요구UIDATAAPITEST
REQ-009품절 메뉴는 주문 불가UI-C02is_availableAPI-004?눌러서 표시
REQ-012상태는 순서대로만 변경?order.statusAPI-006TEST-015눌러서 표시
REQ-015주문 번호 표시UI-C05order.numberAPI-002TEST-018눌러서 표시
REQ-017관리자만 품절 변경UI-A05??TEST-020눌러서 표시
끊긴 줄을 눌러 표시하세요
0/4
체크하면서
스스로 확인해 보세요
취창업 연결추적표를 관리하는 능력은 공공 · 금융 · 대기업 프로젝트에서 특히 중요하게 평가됩니다.
gstack × Markdown · Session C

gstack으로 MD 명세를 만드는 순서

단계gstack만들어지는 MD사람이 할 일
1/office-hoursPROJECT_BRIEF.md내 초안과 비교, 문제 승인
2/office-hours (분류)DECISION_LOG.md사실·가정·질문·결정 확정
3/specREQUIREMENTS · 화면 명세 MD수용 기준이 판정 가능한지
4/plan-design-reviewdesign-concept.md · 상태 보강복제 금지 경계 확인
5/plan-eng-reviewMENU_DATA · API · 분석 정의데이터 계약 고정
6/diagram주문 흐름·상태 전이 다이어그램문서와 그림이 일치하는지
7/plan-ceo-reviewMVP 포함/제외 범위 갱신범위 승인 → DEC 기록
Validate the design · Session D

gstack으로 문서를 검증하기

교차 감사 프롬프트

/plan-eng-review
service-planning, service-analysis,
service-validation 문서를 교차 검토해 줘.
새 요구사항을 추가하지 말고 다음만 찾아줘:
1. 용어·ID·주문 상태값 불일치
2. 화면에는 있지만 DATA/API가 없는 기능
3. 측정할 수 없는 모호한 완료 기준
4. 개인정보·결제·권한 위험과 사람이 정할 질문
파일은 수정하지 마.

설계 검증 체크

  • 용어·REQ ID·상태값·필드명이 모든 문서에서 일치
  • 모든 핵심 REQ에 수용 기준과 TEST 연결
  • 고객 주문 생성 → 관리자 상태 변경까지 데이터 흐름이 끊기지 않음
  • 권한·개인정보 제외·예외 처리 누락 없음
  • AI 지적마다 채택 / 수정 / 반려 이유 기록
Build contract · 심화 세션 준비

구현은 요구사항 ID 하나씩, 문서가 먼저

service-planning 및 service-analysis의 승인된 MD 문서만 구현 근거로 사용해줘.
이번 구현 범위는 [REQ-___ / 화면 ID] 하나다.
코드를 작성하기 전에 관련 문서 경로, 수정할 파일, 불명확한 점을 먼저 보고하고,
구현 후에는 변경 파일 목록 · 실행 방법 · 수용 기준별 동작 확인 결과를 요약해줘.
문서 ID 확인→최소 범위 구현→/review · /qa-only→AI_WORK_LOG→다음 REQ
문서와 다른 구현이 필요하면? 코드보다 DECISION_LOG와 명세를 먼저 고친다.
Day 3 deliverables & takeaway

오늘의 산출물 → 내일 구현의 유일한 근거

gstack 기록office-hours · spec · plan-review 결과와 내 판단
프레이밍PROJECT_BRIEF.md · DECISION_LOG.md
명세 패키지화면 2종 · 메뉴 데이터 · 분석/API · 디자인
검증추적표 · 설계 검증 결과 · AI 채택/반려 기록
AI는 빠른 손입니다. gstack은 그 손에 순서를 주고, 문서는 방향을 주고, 사람은 최종 판단을 합니다.
AI빠른 손+gstack순서+문서방향+사람최종 판단=서비스
P1 · 1 / 15
LECTURE NOTE

Hands-on Lab Guide

gstack으로 MD를 만들고 검증하는 실습 가이드

각 단계의 프롬프트를 복사해 Claude Code(/명령) 또는 Codex(gstack-명령 스킬을 사용해)에 붙여 넣으세요. 모든 단계 뒤에 사람이 결과를 읽고 고친 후 다음 단계로 넘어갑니다.

단계gstack입력출력 (MD)사람의 확인 · 통과 조건
0. 준비git initkiosk-pbl 폴더, 4개 하위 폴더README.mdgit 기준점 커밋 · 폴더 책임 1줄씩 작성
1. 내 초안— (AI 사용 금지)서비스 한 문장MY_DRAFT.md사용자 · 핵심 흐름 · 제외 범위 · 질문 5개
2. 문제 정의/office-hoursMY_DRAFT.md · 요구 대화PROJECT_BRIEF.md기능명이 아니라 사용자 불편으로 설명되는가
3. 대화 분류/office-hours요구 대화 기록DECISION_LOG.md사실·가정·질문·결정 분리 · 결정마다 근거·담당
4. 요구 명세/specBRIEF · DECISION_LOGREQUIREMENTS.md · mobile/pc-screen-spec.mdREQ ID · Given/When/Then · 정상·빈·품절·오류 상태
5. 디자인 검토/plan-design-review화면 명세design-concept.md가져올 원리 / 복제 금지 자산 · 접근성 기준
6. 기술 검토/plan-eng-review요구·화면 명세MENU_DATA · analytics-api-definition.md메뉴 10개+ · 상태 전이 · 오류 코드 · 개인정보 제외
7. 시각화/diagram주문 흐름 · 상태 전이order-flow.md (Mermaid)그림과 문서의 상태값이 일치하는가
8. 범위 확정/plan-ceo-review전체 명세DECISION_LOG.md 갱신MVP 포함/제외 · 범위 승인
9. 추적표/spec 또는 직접모든 MDTRACEABILITY.mdREQ→UI→DATA→API→TEST 빈칸 0
10. 설계 검증/plan-eng-review (감사)모든 MDdesign-validation-plan.md · 결과AI 지적별 채택/수정/반려 이유 기록

① 대화 분류 → DECISION_LOG

/office-hours (Codex: gstack-office-hours 스킬)

/office-hours
아래 요구사항 대화와 내 초안(MY_DRAFT.md)을 읽고
DECISION_LOG.md 초안을 만들어 줘.
- 각 항목을 [사실] [가정] [질문] [결정]으로 구분
- 대화에 없는 사실을 새로 만들지 말 것
- 고객(모바일) / 관리자(PC) / 운영 요구를 분리
- [결정]에는 근거 · 담당 · 재검토 기준 칸을 비워 둘 것
- 누락된 예외·데이터 질문을 우선순위와 함께 제안
코드는 작성하지 마.

② 요구 명세 → 화면 명세 MD

/spec (Codex: gstack-spec 스킬)

/spec
PROJECT_BRIEF.md 와 DECISION_LOG.md 의 [결정]만 근거로
service-planning/customer-order/mobile-screen-spec.md 를 작성해 줘.
- 화면마다 UI-C## ID, 연결 REQ-### ID
- 목적 / 표시 정보 / 행동 / 다음 상태 / 수용 기준
- 정상·로딩·빈·품절·필수 옵션 누락·저장 실패·복구 상태
- 수용 기준은 Given/When/Then 으로, 제3자가 판정 가능하게
- [가정]에 해당하는 내용은 "확인 필요"로 표시
아직 구현하지 마.

③ 데이터·API 계약

/plan-eng-review (Codex: gstack-plan-eng-review 스킬)

/plan-eng-review
모바일·PC 화면 명세를 검토하고 다음을 제안해 줘.
1. MENU_DATA: 가상 메뉴 10개 이상
   (menu_id, category, name, base_price, options, stock, is_available)
2. 주문 상태 전이: 접수 → 조리중 → 픽업대기 → 완료 / 취소 규칙
3. API-### 요청 · 응답 · 오류 코드
4. 고객·관리자 화면이 공유해야 할 데이터 계약
5. 분석 이벤트(EVT-###) — 이름·전화·주소·결제 원문 제외
문서 초안만 보여 주고 파일은 내가 승인한 후 저장해.

④ 문서 교차 감사 (설계 검증)

/plan-eng-review 또는 /plan-ceo-review

service-planning, service-analysis, service-validation 폴더의
모든 MD를 교차 검토해 줘. 새로운 요구사항은 추가하지 말고:
1. 문서 간 용어 · ID · 주문 상태값 불일치
2. 화면 명세에는 있지만 DATA/API 정의가 빠진 기능
3. TRACEABILITY.md 의 빈 칸과 끊긴 연결
4. 관찰·측정할 수 없는 모호한 수용 기준
5. 개인정보 · 결제 · 권한 · 저작권 위험과 사람이 결정할 질문
결과를 표(문서 / 위치 / 문제 / 제안 / 심각도)로 보여 주고 파일은 수정하지 마.

DECISION_LOG.md 템플릿

## DEC-001 — [결정 제목]
- 구분: 사실 / 가정 / 질문 / 결정
- 출처: 대화 n번째 · MY_DRAFT · /office-hours 결과
- 내용:
- 근거:
- 담당:
- 대안과 반려 이유:
- AI 제안 처리: 채택 / 수정 / 반려 + 이유
- 재검토 기준: (언제 이 결정을 다시 볼 것인가)

TRACEABILITY.md 템플릿

| REQ | 요구 (한 문장) | UI | DATA | API | EVT | TEST | 상태 |
|---|---|---|---|---|---|---|---|
| REQ-001 | 고객은 카테고리별로 메뉴를 본다 | UI-C02 | menu.category | API-001 | EVT-001 | TEST-001 | 설계완료 |
| REQ-004 | 필수 옵션 미선택 시 담을 수 없다 | UI-C03 | menu.options[].required | — | — | TEST-007 | 설계완료 |
| REQ-009 | 품절 메뉴는 주문할 수 없다 | UI-C02 · UI-A05 | menu.is_available | API-004 | — | TEST-011 | 확인필요 |

Command Cheat Sheet

오늘 쓰는 gstack 명령어

Claude Code는 /명령, Codex는 “gstack-명령 스킬을 사용해 …”로 호출합니다. 전체 53개는 gstack 강의실의 명령어 사전을 참고하세요.

명령용도오늘의 사용 시점
/office-hours아이디어와 제품 방향을 YC 방식 질문으로 구체화문제 정의 · 대화 분류
/spec모호한 요구사항을 실행 가능한 상세 명세로 변환요구·화면 명세 작성
/plan-ceo-review제품 가치, 범위, 우선순위를 CEO 관점에서 검토MVP 범위 확정
/plan-design-reviewUI/UX 계획을 디자이너 관점에서 검토화면 상태·디자인 컨셉 보강
/plan-eng-review아키텍처, 데이터 흐름, 예외 상황, 테스트 계획 검토데이터·API 계약 · 교차 감사
/autoplanCEO → 디자인 → 엔지니어링 → DX 검토를 한 번에 실행개별 리뷰에 익숙해진 후
/plan-devex-reviewAPI·CLI·SDK·문서의 개발자 경험 계획 검토API 문서 점검(선택)
/diagram설명을 Mermaid·Excalidraw·SVG·PNG 다이어그램으로 생성주문 흐름 · 상태 전이도
/make-pdfMarkdown을 PDF·HTML·DOCX로 변환명세 패키지 제출본
/design-consultation제품 디자인 시스템과 시각 방향 제안디자인 컨셉(선택)
/document-generate누락된 문서를 Diataxis 방식으로 새로 작성README · 가이드 보완
/review현재 브랜치 또는 변경사항의 코드 리뷰심화: 구현 후
/investigate버그의 근본 원인을 조사한 후 수정심화: 결함 원인 분석
/qa-only수정 없이 QA 보고서만 작성심화: 서비스 검증 판정표
/qa웹 앱을 테스트하고 발견한 버그까지 수정심화: 승인 후 수정
/careful · /freeze위험 명령 경고 · 지정 폴더 밖 편집 차단기획 단계 코드 보호
/context-save · /context-restore작업 진행 상태 저장·복원2일 분량 이어서 작업할 때
/ship · /retro테스트·리뷰·PR 생성 · 회고 작성심화: 마무리

10-Day Course Navigation

상단 버튼을 클릭해 Day 1~10 학습 페이지로 이동할 수 있습니다.

Learning Workspace

gstack 기획 영상과 Day 3 AI 도우미

gstack 이해 → 설치 → 기획 워크플로 → 문서(스펙) 기반 개발 순서로 영상을 정리했습니다.

관련 YouTube 영상Day 3 추천 학습 자료
  • gstack 이해
  • 1. 하네스 엔지니어링 - gstack으로 Claude Code와 Codex에게 제대로 일시키는 법gstack의 역할 분리와 두 도구 활용KR
  • 2. How to Make Claude Code Your AI Engineering TeamAI를 역할별 개발팀으로 운영하기EN
  • 3. gstack Explained: Is It Right for You?gstack 스킬 구성과 적합성 점검EN
  • 4. YC’s Garry Tan: Use this Claude skill to Build 10x Fastergstack 제작자의 사용 방식EN
  • 5. YC CEO Shipped 100 PRs/Week — His 8 Claude Code Skills (gstack)핵심 스킬 8개 해설EN
  • 6. Gstack Is Not What I Expected — Non-Engineer Review비개발자 관점의 사용 후기EN
  • 설치·세팅
  • 7. How to Set Up Gstack Locally in VSCode Using Claude CodeVS Code + Claude Code 로컬 설치EN
  • 8. GStack GitHub Install Guide: Garry Tan’s AI Workflow for Claude CodeGitHub 설치 · 브라우저 QA · LinuxEN
  • 기획 워크플로
  • 9. [한글자막] GStack + GSD + Superpowers 를 함께 사용하는 워크플로우기획 → 실행 → 검증 워크플로 조합KR
  • 10. GStack + Superpowers로 클로드코드 완전히 달라진 사람의 후기실사용 후기와 작업 방식 변화KR
  • 11. The Y Combinator CEO Just Open-Sourced His Entire AI Setupoffice-hours → plan → review 흐름 소개EN
  • 문서·스펙 기반 개발
  • 12. AI한테 코드부터 시키면 다시 짜는 이유설계 없이 코딩하면 생기는 재작업KR
  • 13. 전문 개발자처럼 AI로 바이브코딩 하는 법 - SpecKit 가이드스펙 주도 개발 도구 실습KR
  • 14. Spec-Driven Development with Claude Code: A Practical Guide명세 → 계획 → 구현 실전 가이드EN
  • 15. Create PRDs in Minutes with Claude Code & Codex (4 Proven Workflows)AI와 PRD 문서를 만드는 4가지 방법EN
  • 16. Stop Vibe Coding Without a Plan (Do This First)구현 전 계획 문서의 중요성EN

영상은 YouTube 공개 영상을 임베드합니다. 게시자 설정에 따라 재생이 제한되면 YouTube에서 직접 열어 주세요.

Day 3 · Daily Feedback

오늘의 교육 만족도 조사

Day 3 수업을 마친 후 간단한 설문에 참여해 주세요. 응답은 다음 수업과 교육 운영을 개선하는 데 활용됩니다.

Open Day 3 Survey버튼 또는 QR 코드로 참여
Day 3 Daily Feedback Survey QR codeSCAN TO OPENNigeria AI Training · Day 3