YJ — 십이장기 기획 골격 스냅샷

1. 주요 변경사항

• repo 루트 재정비: MultiPlay/ 하위에 묻혀있던 Unity 프로젝트를 루트로 끌어올려 GitHub Actions·CI 가 표준 경로에서 동작 가능해짐.
• docs/concept.md (696줄) 신규: 십이장기(4×3 보드) 컨셉, 5개 시스템(이동/포로/승급/승리/타이머)을 시스템별 템플릿으로 기술.
• docs/gdd.md (418줄) 신규: GDD 전체 목차와 표 골격을 잡았으나 본문은 대부분 placeholder.
• docs/tdd.md (360줄) 신규: 기술 설계 목차를 잡았으나 스택·아키텍처 표 모두 [예: Unity] 수준의 가이드 텍스트.
• ProjectSettings/ShaderGraphSettings.asset 의 overrideShaderVariantLimit: 0 한 줄 외 코드 변경 0건.

2. 코드 품질 리뷰

이번 범위에 평가할 게임 로직 코드는 사실상 존재하지 않는다. 변경된 C# 파일은 Unity 템플릿이 자동 생성한 Assets/TutorialInfo/Scripts/Readme.cs·ReadmeEditor.cs 뿐이며 그마저도 경로 이동만 발생했다. 따라서 가독성·SRP·매직넘버 같은 일반 항목은 판정 대상이 없다.

다만 폴더 재구성 자체는 옳은 방향이다. MultiPlay/Assets/... 처럼 한 단계 더 들어가 있으면 빌드 스크립트와 Unity Cloud Build, GitHub Actions 의 unityci/editor 액션이 대부분 루트의 Assets/·ProjectSettings/ 를 가정하므로 충돌이 났을 것이다. 다음 커밋부터는 Assets/Scripts/ 하위에 시스템별 폴더(Board/, Pieces/, Network/, UI/)를 먼저 끊어두고 작업을 시작하길 권한다. 또한 SampleScene 한 개만 존재하는 상태에서 매칭→대기실→인게임 씬을 한 씬에 몰아넣는 실수가 자주 나오니, 씬 분리와 SceneManager.LoadScene 경계를 초기에 정해두는 것이 좋다.

3. 진행도 평가

“첫 리포트 = 기획서 3종 초안” 단계로, 코드 진척은 사실상 0이다. 컨셉 문서가 5개 시스템을 시스템별 템플릿으로 정리한 것은 강점이지만, GDD·TDD 가 placeholder 비중이 70% 를 넘어 “문서를 썼다”기보다 “템플릿을 복사했다”에 가깝다. 5월 중순 프로토타입 마일스톤을 가정하면, 다음 리포트까지 보드 데이터 구조와 단일 클라이언트 기준 이동/포로 로직 정도는 동작해야 일정이 파국으로 가지 않는다.

4. 다음 권장사항

• docs/gdd.md placeholder 섹션 중 코어루프·조작 매핑·게임 모드 정의 3개를 우선 실제 값으로 채울 것.
• docs/tdd.md 에 네트워킹 라이브러리(Mirror/NGO/Photon Fusion) 후보와 선정 사유를 1주 내 결정해 명시.
• Assets/Scripts/ 에 BoardState(4×3 배열), Piece(타입/소유자/위치), TurnManager 최소 골격을 우선 작성.
• 기물 5종(왕/장/상/자/후)의 이동 규칙을 ScriptableObject 로 분리해 데이터 주도로 시작 — 추후 네트워크 동기화 시 검증 로직 재사용 용이.
• 서버 권위 모델 전제(컨셉 문서 § 5 리스크에 명시됨)를 코드 시작 전에 TDD 권한 모델 섹션으로 1페이지 분량 확정.

5. 문서화 상태

• design (6/10): concept.md 가 시스템별 핵심 규칙·데이터테이블·플로우·연계 매트릭스를 일관된 템플릿으로 채웠다는 점은 큰 강점. 다만 KPI·재방문 동기·아트 컨셉 표가 비어있고, “왜 이 시스템이 필요한가” 의 설계 의도가 약하다. 도식 코드블록이 닫히지 않아 마크다운 렌더링이 깨지는 지점도 있음.
• technical (2/10): tdd.md 는 목차와 빈 표만 존재한다. ERD·패킷 구조·서버 아키텍처 다이어그램 모두 “[다이어그램 삽입]” 수준이라 신규 유입이 코드 구조를 추정할 수 없다.
• spec (2/10): 별도 사양서 디렉토리 없음. GDD 의 시스템 4-N 템플릿이 있지만 모두 비어있어 테스트 체크리스트로 활용 불가.

6. Backlog

• Unity C# 게임 로직 코드 0줄 — Board/Piece/Turn 등 도메인 객체 부재.
• GDD·TDD 본문 다수가 [입력하세요]·[예: ...] placeholder 로 미작성.
• 네트워킹 라이브러리(Mirror / NGO / Photon Fusion) 미선정 상태.
• Scene 구성이 SampleScene 단일 — 매칭/대기실/인게임 씬 분리 미정.
• 컨셉 문서 § 3-2 의 “포로 재배치 시 상대 진영(첫 줄) 금지” 규칙이 일본 쇼기 표준 룰과 상이 — 십이장기(Dōbutsu Shōgi) 원전 룰과 교차검증 필요.
• concept.md 의 분기 구조 ASCII 다이어그램에서 코드펜스(```)가 닫히지 않아 이후 본문이 코드블록으로 흡수됨.