DOC-DRIVEN BUILD Codex × Antigravity PBL

REAL PROJECT 02 · DOCUMENT-DRIVEN PBL

대화를 명세로 바꾸고,
명세를 작동하는 서비스로 만든다.

Codex와 나눈 요구사항 대화를 사람이 검토 가능한 Markdown 계약으로 정리하고, Antigravity IDE에서 그 문서를 기준으로 모바일 고객 주문 화면과 PC 관리자 화면을 구현한 뒤 설계와 서비스를 각각 검증하세요.

  • 16–24h권장 학습 시간
  • 4 Missions문서 → 구현 → 검증
  • 100 pts총 평가 점수
  • 2 Views모바일 주문 · PC 관리

YOUR PROGRESS

0 / 32 체크포인트 완료

0%

MISSION 01 · FRAME

대화를 프로젝트 요구사항으로 재구성하라

대화의 요청을 사실·가정·질문·결정으로 나누고, 학생이 직접 구현 범위와 성공 조건을 확정합니다.

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

EDITOR WORKSPACE · 4 CORE DOMAINS

프로젝트 작업 파일 및 실행 환경

수업 페이지와 실제 예제 프로젝트(기획·분석·구현·검증)가 같은 폴더에 구성되어 있습니다. 카드를 클릭해 문서를 바로 열람하거나 구현된 앱을 실행해 보세요.

🚀 구현 서비스 런처 열기 ↗

DOWNLOAD CENTER · MARKDOWN GUIDES

수업 안내서 및 미션 가이드

학생이 직접 읽고 템플릿으로 활용할 수 있는 미션별 Markdown 원본 파일입니다. 클릭하면 내용을 미리보거나 다운로드할 수 있습니다.

EVALUATION · 100 POINTS

화면 외형보다 추적성, 작동하는 흐름, 사람의 검증을 평가합니다

결과 화면만 보지 않고 학생 초안, 요구사항-구현-테스트 간 ID 추적성, 실행 증거, AI 제안에 대한 사람의 판단을 종합 평가합니다.

상세 루브릭 MD 다운로드 ↓
01 · 25점

요구사항 프레이밍

학생 사전 초안·질문
5점
사실·가정·질문·결정 분리
7점
MVP 범위·성공/실패 기준
7점
AI 제안 채택·수정·반려 근거
6점
02 · 25점

Markdown 명세 패키지

모바일·PC 화면·상태 명세
7점
메뉴 데이터·API·분석 계약
7점
디자인 원리·안전/저작권 경계
5점
REQ→UI→DATA→API→TEST 추적성
6점
03 · 30점

Antigravity 서비스 구현

고객 모바일 핵심 주문 흐름
8점
PC 관리자 주문 확인·상태 변경
7점
예외·복구·합계·상태 정합성
6점
승인된 문서 ID와의 일치성
5점
AI 작업 로그·사람의 판단 기록
4점
04 · 20점

설계·서비스 검증과 회고

설계 검증 (문서 정합성·누락)
5점
서비스 검증 (모바일·PC·예외 재현)
6점
결함 기록 및 수정 후 재검증
5점
AI vs 사람 판단 회고·발표 설명력
4점
최종 통과 기준 총점 70점 이상 (각 미션 50% 이상) 4개 미션 산출물 모두 제출 고객 모바일 + PC 관리자 핵심 흐름 실행 가능 치명(Critical) 결함 0건 AI 생성 결과를 사람이 직접 검증·설명
⚠️ 반드시 지켜야 할 안전·윤리 및 AI 책임 규칙 (위반 시 자동 미통과)
  • 실제 개인정보(이름·전화번호·주소), 실제 결제 정보, 비밀 API 키를 코드나 분석 이벤트에 절대 저장하지 않습니다.
  • 외부 상용 서비스(서브웨이 등)의 로고, 고유 문구, 상품 이미지, 소스 코드를 무단 복제하지 않고 자체 디자인 컨셉(Fresh Route)과 가상 메뉴 데이터를 사용합니다.
  • AI를 열기 전에 학생의 초안을 먼저 작성하며, AI가 대화에 없던 요구사항을 사실처럼 추가하지 못하게 통제합니다.
  • AI 제안을 거절하거나 수정한 사례를 최소 2건 이상 기록하고, 최종 발표에서 자신의 말로 아키텍처와 검증 근거를 설명해야 합니다.

SAVE YOUR WORK

현재 진행 상태를 Markdown 파일로 저장하세요

체크리스트 진행 기록은 브라우저에 자동 저장되며, 제출용 진행 기록(DOC_DRIVEN_PBL_PROGRESS.md)으로 즉시 내려받을 수 있습니다.