[Epic] Magic Exam Hall MVP 공유 로드맵

[SilverSupplier]

한 문장 목표

Magic Exam Hall은 맵 위에 직접 마법 문양을 그리고, base family와 overlay operator를 조합해 세계 상태를 해결하는 2D top-down HCI 퍼즐 어드벤처입니다.

현재 기준 PR

• Docs: add Magic Exam Hall game design roadmap #10: 게임 디자인/로드맵 문서 PR
• Feat: add Unity Magic Exam Hall playable prototype #11: Unity Magic Exam Hall 플레이어블 구현 PR

MVP 기준

• Unity에서 바로 플레이 가능한 5층 마법탑 루프
• 우클릭 world casting과 0.8초 다획 입력 buffer
• 5개 base family: fire, water, wind, earth, life
• 6개 overlay operator: steel_brace, electric_fork, ice_bar, soul_dot, void_cut, martial_axis
• base seal + overlay stack + floor goal 진행
• 실패 이유, Magic Note, 반복 실패 힌트
• attempts/survey 로그와 ending report
• Web prototype은 recognizer 연구/검증 도구로 유지

우선순위 순서

P0: 모두가 같은 기준으로 움직이기

• [Docs] 현재 구현 기준 README/로드맵/작업 큐 동기화 #12
• [Unity] 5층 월드 캐스팅 루프 수동 플레이테스트 #13
• [Unity] Magic Note와 실패 피드백 문구 개선 #14
• [Contract] Web/Unity recognition 및 log schema 대응표 작성 #15
• [Research] HCI 사용자 테스트 프로토콜과 개인정보 기준 정리 #16

P1: 제출 가능한 짧은 게임으로 다듬기

• [Unity] 5층 final seal challenge와 층별 연출 polish #17
• [Release] Unity 실행 빌드와 제출 체크리스트 준비 #18
• [Web] 발표/검증용 research lab demo 경로 정리 #19
• [Recognition] TypeScript/C# regression fixture 공유 전략 결정 #20

작업 원칙

• 기능을 구현하면 관련 문서/issue 상태도 함께 갱신한다.
• Web과 Unity가 같은 개념을 다룰 때 family/operator/status/log 이름을 맞춘다.
• Unity generated state는 커밋하지 않는다: Library, Temp, Logs, Builds, test result XML, .log.
• 실패 피드백은 내부 상태명이 아니라 플레이어가 다음 행동을 알 수 있는 문장으로 쓴다.
• MVP 범위 밖의 아이디어는 닫지 말고 P2 follow-up으로 남긴다.

완료 조건

이 에픽은 아래가 충족되면 닫는다.

• P0 이슈가 모두 닫혔다.
• 사람이 5층을 완주하고 로그/리포트가 남는 것이 확인됐다.
• README와 roadmap이 현재 구현을 정확히 설명한다.
• 제출/발표/검증을 위한 최소 실행 순서가 문서화됐다.

[SilverSupplier]

Backfilled completed work

Open until linked PRs merge:

• [Done via PR #10] Magic Exam Hall 게임 디자인/로드맵 문서 작성 #22 tracks the completed design/roadmap documentation work and is linked from PR Docs: add Magic Exam Hall game design roadmap #10.
• [Done via PR #11] Unity Magic Exam Hall 플레이어블 프로토타입 추가 #23 tracks the completed Unity playable prototype work and is linked from PR Feat: add Unity Magic Exam Hall playable prototype #11.

Already merged / completed and closed:

• Repository operations setup #2 Repository operations setup, completed by PR 저장소 운영 베이스라인 추가 #3.
• [Done] 프로젝트 개요 문서 베이스라인 추가 #24 Project overview documentation baseline, completed by PR Add project overview for Magic Recognizer V1.5 #1.
• [Done] Web recognizer base/overlay/final seal 파이프라인 구축 #25 Web recognizer base/overlay/final seal pipeline.
• [Done] Web tutorial/personalization/explain 데모 레이어 구축 #26 Web tutorial/personalization/explain demo layer.
• [Done] Survey flow, API contract, interaction metrics 구현 #27 Survey flow, API contract, and interaction metrics.
• [Done] Datacard, dashboard, ML baseline 기반 구축 #28 Datacard, dashboard, and ML baseline foundations.
• [Done] Gesture recognition feature-v2 signals and matcher enhancements #29 Gesture recognition feature-v2 signals and matcher enhancements.

This keeps the issue tracker usable both as a forward backlog and as a project history map.

[SilverSupplier]

Detailed child issue map

P0 documentation and shared project state:

• [Docs] 현재 구현 기준 README/로드맵/작업 큐 동기화 #12 parent
  • [Child #12] README 빠른 시작과 Unity 검증 안내 정리 #30 README quick start and Unity verification sync
  • [Child #12] roadmap 상태 표를 PR #10/#11 이후 기준으로 갱신 #31 Roadmap state table update after PR Docs: add Magic Exam Hall game design roadmap #10/Feat: add Unity Magic Exam Hall playable prototype #11
  • [Child #12] docs queue와 GitHub Issues 운영 기준 결정 #32 Decide docs queue vs GitHub Issues as source of truth

P0 Unity playable validation:

• [Unity] 5층 월드 캐스팅 루프 수동 플레이테스트 #13 parent
  • [Child #13] 5층 수동 플레이테스트 시나리오와 관찰표 작성 #33 Manual playtest script and observation sheet
  • [Child #13] 첫 5층 완주 플레이테스트 실행 및 결과 기록 #34 First full 5-floor playthrough and findings
  • [Child #13] world drawing buffer와 seal 유지시간 튜닝 #35 World drawing buffer and seal lifetime tuning
  • [Child #13] 플레이테스트 발견사항을 P0/P1 이슈로 triage #36 Triage playtest findings into P0/P1 follow-up issues

P0 feedback and player-facing language:

• [Unity] Magic Note와 실패 피드백 문구 개선 #14 parent
  • [Child #14] 현재 Magic Note/feedback copy 인벤토리 작성 #37 Inventory current Magic Note/feedback copy
  • [Child #14] base family별 실패 힌트 문구 개선 #38 Improve base family failure hints
  • [Child #14] overlay anchor/dependency 실패 힌트 개선 #39 Improve overlay anchor/dependency failure hints
  • [Child #14] feedback escalation 테스트 보강 #40 Strengthen feedback escalation tests

P0 recognition/research contract:

• [Contract] Web/Unity recognition 및 log schema 대응표 작성 #15 parent
  • [Child #15] RECOGNITION_CONTRACT.md 초안 작성 #41 Draft RECOGNITION_CONTRACT.md
  • [Child #15] Unity attempt log와 Web survey/log 필드 대응표 작성 #42 Map Unity attempt logs to Web survey/log fields
  • [Child #15] TypeScript/C# naming/status mismatch audit #43 Audit TypeScript/C# naming and status mismatches

P0 HCI test readiness:

• [Research] HCI 사용자 테스트 프로토콜과 개인정보 기준 정리 #16 parent
  • [Child #16] RESEARCH_PROTOCOL.md 테스트 세션 스크립트 작성 #44 Draft RESEARCH_PROTOCOL.md
  • [Child #16] LOGGING_AND_PRIVACY.md 작성 #45 Draft LOGGING_AND_PRIVACY.md
  • [Child #16] post-play survey 질문과 척도 확정 #46 Define post-play survey questions and scale
  • [Child #16] 첫 플레이테스트 분석 템플릿 정의 #47 Define first playtest analysis template

P1 Unity content polish:

• [Unity] 5층 final seal challenge와 층별 연출 polish #17 parent
  • [Child #17] 5층 성좌심 목표 가독성 개선 #48 Improve floor 5 constellation heart goal readability
  • [Child #17] final seal completion/ending presentation 강화 #49 Strengthen final seal completion and ending presentation
  • [Child #17] 3층/4층 world reaction 차별화 #50 Differentiate floor 3 and floor 4 world reactions

P1 release flow:

• [Release] Unity 실행 빌드와 제출 체크리스트 준비 #18 parent
  • [Child #18] Windows Unity batchmode build method 추가 #51 Add Windows Unity batchmode build method
  • [Child #18] 릴리스 후보 체크리스트 문서화 #52 Document release candidate checklist
  • [Child #18] 생성된 Windows 빌드 smoke test #53 Smoke test generated Windows build

P1 Web research lab:

• [Web] 발표/검증용 research lab demo 경로 정리 #19 parent
  • [Child #19] 3분 Web research lab 발표 시연 스크립트 작성 #54 Write 3-minute Web research lab demo script
  • [Child #19] Web demo 배포 경로 결정 #55 Decide Web demo deployment path

P1 regression strategy:

• [Recognition] TypeScript/C# regression fixture 공유 전략 결정 #20 parent
  • [Child #20] 공통 regression fixture 포맷 결정 #56 Decide shared regression fixture format
  • [Child #20] shared JSON fixture 1개를 TS/C# 테스트에 연결하는 spike #57 Spike one shared JSON fixture in TS and C# tests

Suggested next sequence: #30, #31, #33, #34, #37, #41, #44, then branch based on playtest findings.

[SilverSupplier]

Projects 권한이 없을 때의 운영 방식

현재 GitHub Projects 접근/토큰 스코프가 막혀 있어, 이 저장소는 우선 Issues + Milestones + Labels 조합으로 같은 목적을 운영합니다.

• MVP P0: Baseline, playtest, contract: 지금 바로 맞춰야 하는 문서 동기화, Unity 플레이테스트, 피드백 개선, Web/Unity 계약, 리서치 기준
• MVP P1: Polish, release, research lab: 다음 단계 polish, 릴리즈 패키징, research lab demo 경로, regression fixture 전략
• Completed Backfill: 이미 완료된 과거 작업을 이슈로 남겨 추적하는 묶음

운영 규칙:

• 작업 우선순위는 milestone을 먼저 보고, priority:*, area:*, type:* label로 좁힙니다.
• PR에 Closes #...가 연결된 완료 이슈는 PR merge 후 자동 close 여부를 확인합니다.
• 이미 완료된 작업은 Completed Backfill에 보관해서 왜 현재 구조가 생겼는지 추적합니다.
• Projects 권한이 생기면 이 milestone 구성을 그대로 Project view로 옮기면 됩니다.