Jae0 — 최종 제출 직전 기획 문서 일괄 커밋

1. 주요 변경사항

• final_submission_overview.md 및 두 기획안(도둑과 해커 / 자석 실험실 탈출)의 계획 문서 3종 신규 작성, 총 5,878 라인 단일 커밋.
• thief_hacker/docs/ 하위에 concept·GDD·TDD 3종 문서 추가 (661 + 644 + 651 라인).
• magnet_lab_escape/docs/ 하위에 concept·GDD·TDD 3종 문서 추가 (656 + 635 + 644 라인).
• _guidlines-main/ 경로에 concept/GDD/TDD 템플릿 3종 포함 — 가이드라인 원본을 그대로 repo 에 복사한 형태.
• 실제 Unity 프로젝트, .cs 소스, 씬·에셋·ProjectSettings 등 구현 아티팩트는 0 건.

2. 코드 품질 리뷰

리뷰할 코드가 없다. 이 시점에 repo 에 존재하는 산출물은 전부 Markdown 문서이며, Unity 프로젝트의 흔적(Assets/, ProjectSettings/, .meta 파일)이 전혀 보이지 않는다. TDD 내부에 의사코드 블록이 있으나 실제 구현이 아닌 스케치 수준이라 정적 분석 대상에서 제외한다.

다만 문서 구조 자체에서 설계 관점의 위험 신호가 읽힌다. thief_hacker_tdd.md 의 BreacherController / OperatorController / AlertManager / GuardAIController / MissionManager 는 각각 단일 책임으로 분리돼 있으나, TDD 4-1 의 의사코드에서 Tick() 이 입력·FSM·이동·가시성·소음·네트워크 예측까지 한 번에 처리하도록 묘사돼 있다. 이대로 구현에 들어가면 한 메서드 안에서 6개 하위 시스템을 호출하는 god-method 가 된다. 설계 시점에 InputStage → StateStage → SensorStage → ReplicationStage 로 파이프라인을 분리해두는 게 안전하다.

또한 magnet_lab_escape_tdd 는 컴포넌트 이름조차 제시하지 않고 상위 개념만 나열돼 있어 TDD 두 본이 완성도가 불균일하다. 두 프로젝트를 동시에 들고 가겠다는 신호라면 위험하다 — 솔로 1인으로 협동 네트워크 게임 2개를 병렬 개발할 수 있는 스코프가 아니다.

3. 진행도 평가

첫 리포트 기준 전체 진행도 10% 로 판정한다. 컨셉·GDD·TDD 문서 골격은 갖춰졌으나 implementation 축이 완전 공백이고, M2 프로토타입 일정(2026.0506)까지 남은 시간이 불과 12개월이다. 문서만 놓고 보면 30%대로 보일 수 있으나, 코드 착수 지연과 이중 기획이 진행도를 끌어내린다. 커밋도 거대한 단일 import 커밋이라 작업 이력을 분해해서 검토할 수 없다. 방향 수정이 없으면 제출 직전에 “문서는 멋지나 빌드가 없음” 상황이 거의 확실하다.

4. 다음 권장사항

• 두 기획 중 하나를 버려라. 솔로 스코프에서 2D 협동 네트워크 게임을 1개월 반 안에 프로토타입까지 올리는 것도 공격적이다. 두 개를 동시에 끌고 가면 둘 다 미완이 된다.
• Unity 프로젝트 스캐폴드를 먼저 올려라 (2022.3 LTS, URP 2D, Input System, 폴더 구조, .gitignore). 프로젝트가 없으면 이후 모든 계획이 허상이다.
• 선택한 게임의 코어 메커닉 1개만 플레이어블로 만들어라 (브리처 이동+은신 또는 N/S 자력 끌림·밀림).
• GDD 의 빈 표(장르/플랫폼/조작 매핑/BGM·SFX 목록)를 실제 값으로 채워라. placeholder 는 문서 점수를 깎는다.
• 레벨 1개 분량의 spec 문서(오브젝트 배치, 수치 테이블, QA 체크리스트)를 만들어라 — _sample/docs 의 레벨디자인 사양서가 기준이다.
• 네트워킹은 미정 상태로 남겨라. 솔로 기준 Host-Client 구현은 프로토타입 단계에서 가장 늦게 붙이는 게 옳다.

5. 문서화 상태

• design = 7: 두 기획 모두 컨셉·GDD 가 섹션 골격을 갖추고 핵심 경험 정의·코어 루프·시스템 의존성 다이어그램까지 작성됐다. “왜 이 선택인가” 가 부분적으로 드러나 실무에 사용 가능한 수준. 다만 장르/플랫폼/조작 매핑 표, 캐릭터 시트 등 실제 값이 비어있는 섹션이 남아 있어 _sample/docs 10점 수준에는 미달한다.
• technical = 5: TDD 두 본 중 thief_hacker_tdd 는 아키텍처·패킷 구조·Spike 목록까지 제시해 신규 유입이 구조를 파악할 수 있는 수준. 반면 magnet_lab_escape_tdd 는 본문이 얕고, 양쪽 모두 Spike(SP-001~004) 가 “미완” 으로 남아 검증이 이루어지지 않았다.
• spec = 2: 레벨별 데이터·밸런싱 수치 테이블·QA 체크리스트가 repo 에 존재하지 않는다. GDD 5-2 에 레벨 A/B/C 가 한 줄씩 언급된 수준이며 _sample/docs 의 사양서_레벨디자인.md 수준과는 거리가 멀다.

6. Backlog

• Unity 프로젝트·코드베이스 부재 (구현 착수 0%).
• 두 게임 기획이 병렬 — 솔로 스코프에서 동시 개발 불가능, 하나 선택 필요.
• TDD 의 Spike 4종이 전부 미수행 상태로 리스크 검증 안 됨.
• spec 계층 문서 전면 부재 (레벨·수치 테이블·QA 체크리스트).
• GDD 내 여러 표가 헤더만 있고 값 비어있음(조작 매핑, BGM/SFX, 캐릭터 시트 등).
• M2 프로토타입 마감 대비 코드 착수 지연 — 일정 재산정 필요.
• 단일 거대 커밋으로 이력 추적 불가, feature 브랜치 전략 부재.