Day 2에서 “AI는 프롬프트에 없는 것을 만들지 못한다”는 것을 경험했습니다. 오늘은 그 해답을 배웁니다. Part 1에서 AI에게 역할·순서·품질 기준을 주는 워크플로 gstack을 익히고, Part 2에서 gstack으로 Markdown 명세를 만들고 검증하는 문서 기반 설계를 실습합니다.
2일 분량을 하루에 담은 집중 과정입니다. 세션 A~D는 수업 시간에, 심화 세션은 과제·자율 학습으로 이어서 완성합니다.
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에게 역할 · 순서 · 품질 기준을 부여하는 개발 워크플로입니다.
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을 식당 주방 팀으로 이해하기
Where does gstack live?
gstack은 앱이 아니라 AI가 읽는 업무 매뉴얼
설치하면 내 컴퓨터에 지침서 폴더가 생기고, AI 도구가 명령에 맞는 지침서를 꺼내 읽고 일합니다.
One AI · Five hats
슬래시 명령 하나 = 모자 하나
명령어를 외우기보다 각 역할이 던지는 질문을 기억하세요.
Why bother?
바로 만들면 빠를까? 늦게 고치면 더 비싸다
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
체크하면서 스스로 확인해 보세요
취창업 연결팀 프로젝트 면접 질문 “기획·디자인·개발·QA는 각각 무엇을 보나요?” — 오늘 고른 역할이 그대로 답이 됩니다.
Standard end-to-end workflow
가장 일반적인 gstack 파이프라인
/office-hours아이디어와 제품 방향을 YC 방식 질문으로 구체화
/autoplanCEO → 디자인 → 엔지니어링 → DX 검토를 한 번에
/review → /qa코드 관점 검토 후 실제 브라우저에서 사용자 흐름 테스트
/ship → /canaryPR·배포 후 오류와 성능 저하 감시
오늘 Day 3의 초점: 파이프라인의 앞부분(문제 정의 → 명세 → 계획 검토). 구현 전에 끝내야 할 일들입니다.
gstack skill map · 53 skills
53개 스킬, 10개 카테고리로 기억하기
53개를 외우지 마세요. “지금 어느 단계인가?”만 알면, 아래 명령어 사전에서 찾아 쓰면 됩니다.
Setup · 15–60 min
설치: 도구 확인 → gstack 등록 → 상태 확인
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
“고객은 휴대폰으로 샌드위치와 음료를 주문하고, 관리자는 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
체크하면서 스스로 확인해 보세요
취창업 연결초안을 먼저 쓰는 습관은 “AI를 쓰는 사람”과 “AI에 끌려가는 사람”을 가르는 차이입니다.
Mission 01 · Frame
대화를 사실 · 가정 · 질문 · 결정으로 나누기
/office-hours
다음 요구사항 대화를 [사실], [가정], [질문], [결정]으로 구분해 줘.
새 사실을 임의로 만들지 말고, 고객 모바일과 PC 관리자 요구를 분리해 줘.
누락된 예외·데이터 정합성 질문을 우선순위와 함께 제안해 줘. 아직 파일을 만들지 마.
HANDS-ON 0615분팀 · 분류 게임
대화 문장을 네 상자로 나눠 보기
목표요구사항 대화에서 사실과 추측을 구분해 AI가 추측을 사실로 만들지 못하게 한다
FACT사실대화에 명시된 요구
ASSUMPTION가정AI · 팀의 추정
QUESTION질문확인이 더 필요
DECISION결정근거 · 담당 · 재검토
힌트회의록에 있으면 사실 · “~것 같다”는 가정 · 물음표는 질문 · 담당과 재검토가 있으면 결정
회의록: “고객은 휴대폰으로 주문한다”
정답: FACT
점심시간에는 주문이 몰릴 것 같다
정답: ASSUMPTION
주문 접수 후에도 고객이 취소할 수 있나?
정답: QUESTION
MVP에서 결제는 제외 — 담당 PM, 2주 후 재검토
정답: DECISION
회의록: “관리자는 PC에서 품절을 바꾼다”
정답: FACT
음료는 아마 사이즈 옵션이 필요할 것이다
정답: ASSUMPTION
0 / 6 분류함
체크하면서 스스로 확인해 보세요
취창업 연결회의에서 사실과 추측을 구분하는 사람은 어느 팀에서나 신뢰받는 동료가 됩니다.
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
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.md
EVT 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 + 옵션 추가금 × 수량
UI-C03 와이어프레임 (가상 메뉴)
HANDS-ON 0720분팀 · 명세 작성
화면 명세 5요소 + 5상태 채우기
목표화면 하나를 AI가 추측 없이 구현할 수 있게 명세한다
목적이 화면에서 무엇을 이루나
정보무엇을 보여 주나
행동무엇을 누르나
다음 상태누르면 어디로
수용 기준Given/When/Then
정상만 쓰면 안 돼요 · 상태 5가지
정상
빈 목록
품절
오류
복구
UI-C02 · 메뉴 목록 (REQ-001, REQ-009)
문서에 적은 상태 표시
완성도
0 / 10
체크하면서 스스로 확인해 보세요
취창업 연결화면 명세는 프로덕트 디자이너 · PM 포트폴리오에 그대로 넣을 수 있는 결과물입니다.
Traceability
모든 요구는 ID로 끝까지 연결된다
REQ
요구
UI
DATA
API
TEST
REQ-004
필수 옵션을 고르지 않으면 담을 수 없다
UI-C03
menu.options[].required
—
TEST-007
REQ-009
품절 메뉴는 주문할 수 없다
UI-C02, UI-A05
menu.is_available, stock
API-004
TEST-011
REQ-012
관리자는 주문 상태를 순서대로만 바꾼다
UI-A03
order.status
API-006
TEST-015
빈 칸이 있으면? → 문서가 끊긴 곳 = AI가 추측으로 채울 곳입니다.
HANDS-ON 0810분짝 · 찾기 게임
추적표에서 끊긴 사슬 찾기
목표추적표의 빈칸 = AI가 추측할 곳임을 알고 먼저 찾아 막는다
1추적표 읽기REQ → UI → DATA → API → TEST
2빈칸 찾기“?”가 있는 줄
3정답 확인무엇이 빠졌나
4우리 표 점검같은 방법으로
주의빈칸이 있는 요구사항을 AI에게 맡기면, AI는 그 칸을 평균적인 추측으로 채웁니다.
REQ
요구
UI
DATA
API
TEST
REQ-009
품절 메뉴는 주문 불가
UI-C02
is_available
API-004
?
눌러서 표시
REQ-012
상태는 순서대로만 변경
?
order.status
API-006
TEST-015
눌러서 표시
REQ-015
주문 번호 표시
UI-C05
order.number
API-002
TEST-018
눌러서 표시
REQ-017
관리자만 품절 변경
UI-A05
?
?
TEST-020
눌러서 표시
끊긴 줄을 눌러 표시하세요
체크하면서 스스로 확인해 보세요
취창업 연결추적표를 관리하는 능력은 공공 · 금융 · 대기업 프로젝트에서 특히 중요하게 평가됩니다.
gstack × Markdown · Session C
gstack으로 MD 명세를 만드는 순서
단계
gstack
만들어지는 MD
사람이 할 일
1
/office-hours
PROJECT_BRIEF.md
내 초안과 비교, 문제 승인
2
/office-hours (분류)
DECISION_LOG.md
사실·가정·질문·결정 확정
3
/spec
REQUIREMENTS · 화면 명세 MD
수용 기준이 판정 가능한지
4
/plan-design-review
design-concept.md · 상태 보강
복제 금지 경계 확인
5
/plan-eng-review
MENU_DATA · API · 분석 정의
데이터 계약 고정
6
/diagram
주문 흐름·상태 전이 다이어그램
문서와 그림이 일치하는지
7
/plan-ceo-review
MVP 포함/제외 범위 갱신
범위 승인 → 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은 그 손에 순서를 주고, 문서는 방향을 주고, 사람은 최종 판단을 합니다.
P1 · 1 / 15
LECTURE NOTE
Hands-on Lab Guide
gstack으로 MD를 만들고 검증하는 실습 가이드
각 단계의 프롬프트를 복사해 Claude Code(/명령) 또는 Codex(gstack-명령 스킬을 사용해)에 붙여 넣으세요. 모든 단계 뒤에 사람이 결과를 읽고 고친 후 다음 단계로 넘어갑니다.
단계
gstack
입력
출력 (MD)
사람의 확인 · 통과 조건
0. 준비
git init
kiosk-pbl 폴더, 4개 하위 폴더
README.md
git 기준점 커밋 · 폴더 책임 1줄씩 작성
1. 내 초안
— (AI 사용 금지)
서비스 한 문장
MY_DRAFT.md
사용자 · 핵심 흐름 · 제외 범위 · 질문 5개
2. 문제 정의
/office-hours
MY_DRAFT.md · 요구 대화
PROJECT_BRIEF.md
기능명이 아니라 사용자 불편으로 설명되는가
3. 대화 분류
/office-hours
요구 대화 기록
DECISION_LOG.md
사실·가정·질문·결정 분리 · 결정마다 근거·담당
4. 요구 명세
/spec
BRIEF · DECISION_LOG
REQUIREMENTS.md · mobile/pc-screen-spec.md
REQ 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 또는 직접
모든 MD
TRACEABILITY.md
REQ→UI→DATA→API→TEST 빈칸 0
10. 설계 검증
/plan-eng-review (감사)
모든 MD
design-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자가 판정 가능하게
- [가정]에 해당하는 내용은 "확인 필요"로 표시
아직 구현하지 마.
/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 제안 처리: 채택 / 수정 / 반려 + 이유
- 재검토 기준: (언제 이 결정을 다시 볼 것인가)