자료 기준 정책

요약

역기획서는 여러 자료를 섞어 작성하되, 자료 사이에 내용이 다를 경우 우선순위를 명확히 적용한다. 충돌이 발생하면 코드(현재 구현)를 본문 기준으로 채택하고, 충돌 자체는 별도 논의사항으로 기록한다.

자료 사용처 (역할 분담)

자료	주 용도
PDF 기획서 (개요 우선)	기획 의도와 시스템 설계 배경. 본문 절 구성과 명명의 1차 출처.
Google Sheets	실제 데이터·수치·ID·테이블 구조. 표 문서의 1차 출처.
PPT	흐름·화면 구성·MVP 범위·보조 설명. 비주얼 문서의 보조 출처.
Unity 구현 (Deluge/)	현재 구현 상태. 충돌 시 본문 기준.

충돌 시 우선순위 (확정 규칙)

상황	본문에 들어가는 사실	충돌의 기록 위치
코드와 PDF가 다름	코드 기준	backlog/risks.mdx의 “코드–기획서 불일치” 절
코드와 시트가 다름	코드 기준 (코드가 시트를 어떻게 해석하는지를 본문에 적음)	backlog/risks.mdx
PDF와 PPT가 다름	”개요” 표기된 PDF	backlog/risks.mdx
PDF끼리 다름	”개요” 표기된 쪽	backlog/risks.mdx
시트와 시트가 다름	시스템 의미가 일관된 쪽	backlog/risks.mdx
코드에는 있는데 기획서에 없는 항목	코드 기준 (존재한다고 서술)	backlog/risks.mdx (“기획서 누락” 절)
기획서에는 있는데 코드에 없는 항목	본문에서 명시적 미구현 표기	backlog/open-questions.mdx

코드 우선 규칙의 이유: 본문이 실제 동작과 불일치하면 개발 기준으로 쓸 수 없다. 의도가 다르면 코드 쪽을 고치는 결정을 하면 되고, 그 결정 자체는 논의사항에서 다룬다.

자료별 작성 원칙

• PDF의 기획 의도는 본문 절 구성·명명·전체 흐름의 가이드로 사용한다.
• 수치·ID·태그·드랍값·미션값처럼 데이터화된 내용은 Google Sheets를 기준으로 확인한다.
• Unity 코드는 실제 동작을 확인하는 1차 사실 출처다. 본문 표·enum·상태 머신·필드 이름은 가능한 한 코드 그대로를 따른다.
• 자료 간 충돌이 명확하면 안정된 본문에 섞지 않고 backlog/risks.mdx로 분리한다.

영향

• 시스템 문서는 코드의 enum·클래스·상태 머신을 그대로 사실 베이스로 적고, PDF의 의도는 보조 설명으로 둔다.
• 표 문서는 Google Sheets의 시트명·탭명·컬럼 의미를 기준으로 작성한다. 코드 DTO와 시트가 다르면 코드 DTO를 본문에 적고 차이를 risks로 기록한다.
• 비주얼 문서는 PPT/PDF 화면 자료를 참고하되, 확정 기획과 참고 이미지를 구분한다.