GhostMarch_DOTS — 지연 지적사항 문서화 스냅샷

1. 주요 변경사항

• docs/migration/deferred-review-findings.md가 추가되어 즉시 처리하지 않을 리뷰 지적사항을 P1/P2와 리포지토리 위생 항목으로 분류했다.
• docs/README.md에 새 문서 링크가 추가되어 문서 탐색성은 개선되었다.
• docs/migration/dots-rebuild-todo.md에 지연 지적사항 문서의 존재를 명시했다.
• 런타임 코드, Unity 씬, 프리팹, 패키지 파일 변경은 없다. 이번 커밋은 순수 문서 관리 성격이다.

2. 코드 품질 리뷰

이번 변경은 코드가 아니라 문서 변경이므로 Update(), GetComponent, pooling, 싱글톤, 입력 처리 같은 Unity 런타임 품질은 새로 악화되지 않았다. 이 점은 긍정적이다. 특히 지적사항을 단순 회고로 흘려보내지 않고 Status, Why not now, Required action, Reference 구조로 고정한 결정은 좋다. 나중에 같은 실수를 반복하지 않게 만드는 최소한의 추적 장치가 생겼다.

다만 문서가 “처리했다”와 “미뤘다”의 경계를 흐리면 위험하다. 현재 문서는 여러 항목을 Status: deferred 또는 apply from the next change set으로 표현하고 있어 실제 해결이 아니라 관리 대상으로 등록한 상태다. 이 차이를 다음 리뷰에서도 엄격히 유지해야 한다. 문서화는 부채를 보이게 만들지만, Unity 프로젝트에서 패키지·프리팹·자산 경계 문제는 실제 파일 이동, 검증 스크립트, 빌드 확인이 따라오지 않으면 해결되지 않는다.

문서 내용 중 가장 실용적인 부분은 첫 DOTS 수직 슬라이스 검증 범위를 명시한 점이다. 이동, 적 추적, 접촉 피해, 사망 표현, 일시정지/레벨업 중단까지 실제 플레이 루프 기준으로 확인하겠다는 기준은 적절하다. 다만 아직 구현 슬라이스가 없으므로 현재 품질 평가는 “준비 상태가 개선됨”이지 “게임 기능이 전진함”은 아니다.

3. 진행도 평가

이전 대비 전진은 기술 문서화와 작업 추적성에서 발생했다. 커밋 메시지도 docs: track deferred DOTS review findings로 목적이 분명하여 과거의 fix·wip 중심 흐름보다는 개선되었다. 이 부분은 명확히 칭찬할 만하다.

반대로 플레이 가능한 빌드 관점의 진척은 거의 없다. DOTS 재구현은 아직 첫 실제 수직 슬라이스 검증 전이며, 문서가 늘어난 만큼 다음 단계에서 구현으로 전환하지 못하면 문서 부채만 늘어날 위험이 있다. 현재 진행도는 약 32%로 보는 것이 적정하다.

4. 다음 권장사항

• 첫 DOTS 수직 슬라이스를 실제 플레이 루프에서 검증해야 한다. 문서상 체크리스트가 있으므로 바로 Play Mode 검증 기준으로 써야 한다.
• 패키지와 ProjectSettings 변경은 기능 커밋과 분리해야 한다. 원인 추적이 깨지면 Unity 회귀 디버깅 비용이 급격히 증가한다.
• Legacy와 DOTS asmdef 참조 방향을 CI 또는 로컬 스크립트로 막아야 한다. 문서 규칙만으로는 장기적으로 유지되지 않는다.
• Aseprite와 AudioGen 자산의 출처, 라이선스, 사용처를 문서화해야 한다. 출시 단계에서 법적·용량 리스크로 되돌아올 수 있다.
• Input System 샘플 리소스와 production UI 폴더 경계를 정리해야 한다. 샘플을 제품 자산처럼 취급하면 소유권이 흐려진다.

5. 문서화 상태

design 점수는 4점이다. DOTS 마이그레이션 의사결정은 보강되고 있지만, 게임 컨셉, 코어 루프, 플레이 경험 목표를 설명하는 디자인 문서 근거는 아직 약하다.

technical 점수는 7점이다. asmdef 경계, 검증 루프, 지연 지적사항 추적은 실무적으로 유용하다. 다만 CI 검증과 실제 구현 결과가 연결되기 전까지는 8점 이상으로 올리기 어렵다.

spec 점수는 4점이다. 첫 수직 슬라이스 검증 항목은 사양서처럼 쓸 수 있으나, 입력·상태·결과 매핑, 밸런싱 수치, 씬 구성표는 아직 _sample/docs 수준과 거리가 있다.

6. Backlog

• Unity 버전·패키지 업그레이드성 변경이 기능 커밋에 섞인 문제는 아직 실제로 해소되지 않았다. 다음 패키지 변경부터 커밋을 분리해야 한다.
• TextMesh Pro와 ShaderGraph 리소스 대량 변경은 의도와 사용처가 여전히 불명확하다. 전용 자산 정리 브랜치가 필요하다.
• Input System 샘플 리소스가 UI 폴더 아래에 있는 경계 문제는 남아 있다. 샘플·서드파티·production UI 위치를 분리해야 한다.
• fix·wip 중심 커밋 메시지 문제는 이번 커밋에서 개선 조짐은 있으나, 장기 습관으로 검증되기 전까지 이월한다.
• Aseprite·AudioGen 자산 출처와 사용처 문제는 문서에 기록되었을 뿐, 라이선스·참조 검증은 아직 끝나지 않았다.