대화의 요청을 사실·가정·질문·결정으로 나누고, 학생이 직접 구현 범위와 성공 조건을 확정합니다.
25POINTS
입력 요구사항 대화 기록출력 PROJECT_BRIEF · DECISION_LOG완료 신호 추측(가정)과 확정 결정 분리
01
서비스의 한 문장 정의를 직접 작성하세요
“고객은 휴대폰으로 샌드위치와 음료를 주문하고, 관리자는 PC에서 메뉴·재고·주문 상태를 관리한다.”를 출발점으로 삼아 대상 사용자, 해결할 문제, 핵심 행동, 제외 범위를 자신의 언어로 다시 정의합니다.
💡 학생 우선 규칙: Codex를 열기 전에 반드시 자신의 초안(사용자·핵심 흐름·제외 범위)과 아직 모르는 질문 5개를 먼저 작성합니다.
02
Codex에는 요구사항 구조화와 반례 질문을 요청하세요
AI가 임의로 기능을 지어내지 못하도록 제약을 걸고, 누락된 예외와 데이터 질문을 도출하게 합니다.
CODEX STRUCTURE PROMPT
다음 대화를 서비스 명세 초안으로 구조화해줘.
새 사실을 임의로 만들지 말고 [사실], [가정], [질문], [결정]을 명확히 구분해 표시해줘.
고객 모바일 주문 화면과 PC 관리자 화면의 요구사항을 분리하고,
누락된 예외 상황·데이터 정합성·검증 질문을 우선순위와 함께 제안해줘.
03
결정의 주인은 AI가 아니라 학생이어야 합니다
대화에 명시된 사실과 AI의 추정을 구분하고, 최종 결정에는 반드시 근거와 재검토 기준을 남깁니다.
FACT (사실)대화에 명시된 요구ASSUMPTION (가정)AI 또는 팀의 추정QUESTION (질문)추가 확인이 필요한 항목DECISION (결정)채택 근거 · 담당 · 기준
04
네 개 최상위 폴더의 책임을 분리해 고정하세요
기획, 분석, 구현, 검증은 서로 다른 책임을 가진 독립 영역입니다. 폴더 간 역할이 섞이지 않게 구성합니다.
📦kiosk-pbl/PROJECT ROOT
📁service-planning/기획 · 명세
서비스 요구사항, 공통 정책, 고객 모바일/PC 관리자 화면 명세, 디자인 컨셉(Fresh Route)
📁service-analysis/지표 · 분석
핵심 성과 지표(KPI), 이벤트 택소노미, 데이터 품질 기준, 분석 수집·조회 API 정책
📁service-implementation/서비스 구현
Antigravity IDE 기반 고객 모바일 주문(customer) · PC 관리자(admin) · 실시간 스토어(shared) 및 AI 작업 로그
📁service-validation/설계 · 서비스 검증
설계 검증 계획·결과, 서비스 실행 검증 시나리오, 표준 테스트 데이터, 결함 리포트 및 회고
PASS GATE
미션 1 완료 체크리스트
0 / 8
MISSION 02 · SPECIFY
구현 가능한 Markdown 명세 패키지를 만들어라
모바일 고객 주문, PC 관리자 센터, 디자인 컨셉, 데이터·분석·API와 검증 계획을 추적 가능한 문서로 연결합니다.
25POINTS
입력 PROJECT_BRIEF · DECISIONS출력 기획·분석·검증 MD 패키지완료 신호 REQ → UI → DATA → API → TEST 연결
01
화면별 행동·상태·완료 조건을 문서로 정의하세요
각 문서를 클릭하면 실제 작성된 레퍼런스 명세서를 바로 미리보거나 다운로드할 수 있습니다.
신선한 식재료 컬러감(Fresh Route), 단계별 옵션 선택의 즐거움, 명확한 진행 상태 표시는 참고하되 외부 브랜드의 로고·문구·이미지는 일절 복제하지 않습니다.
04
문서 간 모순과 누락을 Codex로 교차 감사(Audit)하세요
CROSS-DOC AUDIT PROMPT
아래 기획·분석·검증 문서들을 교차 검토해줘.
새로운 요구사항을 임의로 추가하지 말고 다음 항목만 찾아줘:
1. 문서 간 용어 · ID · 주문 상태값 불일치
2. 화면 명세에는 있지만 데이터/API 정의가 빠진 기능
3. 관찰하거나 측정할 수 없는 모호한 완료 기준
4. 개인정보 · 결제 · 권한 · 저작권 관련 위험 요소와 사람이 결정해야 할 질문
PASS GATE
미션 2 완료 체크리스트
0 / 8
MISSION 03 · BUILD
Antigravity IDE에서 문서 계약대로 구현하라
승인된 Markdown 명세를 유일한 구현 근거로 삼아 모바일 고객 화면과 PC 관리자 화면을 수직 사이클로 구현합니다.
30POINTS
입력 승인된 기획·분석·디자인 MD출력 작동 서비스(2 Views) · AI_WORK_LOG완료 신호 모바일·PC 실시간 연동 데모
01
Antigravity에 문서 우선 구현 계약을 선언하세요
한 번에 전체 앱을 만들어 달라고 요청하는 대신, 요구사항 ID 단위로 범위를 잠그고 구현·검증을 반복합니다.
ANTIGRAVITY BUILD CONTRACT
service-planning 및 service-analysis의 승인된 MD 문서만 구현 근거로 사용해줘.
이번 구현 범위는 [REQ-___ / 화면 ID] 하나다.
코드를 작성하기 전에 관련 문서 경로, 수정할 파일, 불명확한 점을 먼저 보고하고,
구현 후에는 변경 파일 목록·실행 방법·수용 기준별 동작 확인 결과를 요약해줘.
02
세 개의 수직 사이클(Vertical Slice)로 완성하세요
Cycle 1 · 고객 모바일 흐름메뉴 탐색 → 상세·옵션 선택 → 장바구니 담기·수량 조절 → 주문 완료 및 접수 번호 확인 (모바일 360px~430px 기준)
Cycle 2 · 관리자 PC 흐름실시간 신규 주문 알림·목록 확인 → 주문 상세 조회 → 상태 변경(접수→조리중→픽업대기→완료) → 품절·메뉴 관리 (PC 1280px+ 기준)
Cycle 3 · 예외 및 복구 흐름필수 옵션 미선택 안내, 품절 메뉴 선택 차단, 빈 장바구니 주문 방지, 네트워크/저장 실패 시 재시도 복구 처리
03
실제 구현된 통합 데모 서비스를 실행해 비교·확인하세요
본 워크스페이스에는 문서 계약과 Fresh Route 디자인 컨셉을 반영해 구현된 고객 모바일 + PC 관리자 실시간 연동 서비스가 포함되어 있습니다.
## DEF-001 — [결함 제목]
- 연결 요구사항 / 테스트 ID: REQ-___ / TEST-___
- 테스트 환경 및 재현 순서:
- 기대 결과 (문서 기준):
- 실제 결과 (발견 당시):
- 화면 캡처 · 콘솔 로그 · 관련 파일:
- 심각도 (Critical/High/Medium/Low) 및 상태:
- 원인 및 수정 내역:
- 수정 후 재검증 결과:
04
AI의 제안과 사람의 최종 판단 차이를 회고하세요
Codex와 Antigravity가 빠르게 구조화·구현한 부분, AI가 놓치거나 과도하게 가정한 부분, 사람이 직접 개입해 수정한 설계·코드 결정, 그리고 다음 프로젝트에서 가장 먼저 확인할 질문을 ID와 함께 정리합니다.
PASS GATE
미션 4 완료 체크리스트
0 / 8
EDITOR WORKSPACE · 4 CORE DOMAINS
프로젝트 작업 파일 및 실행 환경
수업 페이지와 실제 예제 프로젝트(기획·분석·구현·검증)가 같은 폴더에 구성되어 있습니다. 카드를 클릭해 문서를 바로 열람하거나 구현된 앱을 실행해 보세요.