Document verified Android game architecture, rules and development procedures

tools/AGENTS.md

@@ -0,0 +1,9 @@
+# 개발 검증 진입점
+
+이 영역은 검증 명령·Android QA·음성/모델 제작 도구를 소유한다. 제품 규칙·씬·실제 이용자 기록·원격 게시를 소유하지 않는다. 개발 도구의 의존성을 APK에 연결하지 않는다.
+
+verify.ps1의 네 Phase와 Milestone 선택 계약을 유지한다. 실제 하위 명령 종료 코드와 XML/JSON의 평가 결과를 함께 검사하고 빈 결과·실행 불가를 성공으로 만들지 않는다. AndroidBuild의 소스·APK SHA가 AndroidSmoke와 이어져야 한다.
+
+검사 준비는 제품 목표·배치·완료 규칙을 완화하지 않는다. 정상 순차 진행에 저장 주입을 사용하지 않고 경계용 주입은 별도 이름·출처·변경 필드를 남긴다. 소스가 dirty이거나 실행 중 바뀌면 완료 검증으로 인정하지 않는다.
+
+변경에는 parser 확인과 실제 영향을 받은 인수·자료 호출을 수행한다. PowerShell은 파싱 성공만으로 배열·native 인수 의미를 보장하지 않는다. 전체 검증 수정은 동일 소스의 네 Phase를 수행하고 로그·실제 종료·기기·설치 해시를 보존한다.

tools/android/AGENTS.md

@@ -0,0 +1,11 @@
+# Android 실제 입력과 음성 검사
+
+이 영역은 시험 APK 설치·네이티브 입력·JSON 관찰·스크린샷·실제 PCM 녹음과 APK inspection을 소유한다. 게임 규칙·자산 채택·실기기 성능 합격은 소유하지 않는다. 현재 좌표/라벨 검사는 emulator-5554의 가로 2400×1080 AVD를 전제로 한다.
+
+ADB·에뮬레이터 입력·녹음은 한 작성자만 수행한다. UI 안전 영역·현재 투영·앞쪽 구를 확인하고 가려진 구는 빈 공간의 좌우·상하 회전과 실제 핀치로 드러낸다. 특정 모양이나 모든 구의 단일 시점 노출을 성공 조건으로 추가하지 않는다.
+
+Fresh30은 새 저장과 실제 터치만 사용한다. 별도 빠른 계수 fixture는 실제 완료·수집 원문을 출처로 남기고 완료 기록을 보존한다. 파일 pull의 마지막 입력 경쟁은 제한된 반복 관찰로 확인하고 각 UTC/JSON을 유지한다. Free 관찰이 마지막 발화 종료보다 빠르다는 증거 없이 독립 전이 합격을 주장하지 않는다.
+
+녹음은 준비 때 확인한 원래 process handle·이름·시작 시각을 유지한다. PID 재조회로 무관한 프로세스를 기다리거나 종료하지 않는다. 정리 때 네트워크와 speaker/submix/default 음량을 모두 실제 확인해 복원한다. gRPC 토큰은 로그에 기록하지 않는다.
+
+음성은 이번 실제 APK의 AudioClip PCM·승인 WAV SHA·전체 발화 순서를 확인한다. 잘림·중복·잡음·다른 발화·누락/변형 APK의 부정 대조가 실제 거부되는지 검사한다. 부분 상관·BuildReport·파일 존재로 전체 발화나 APK 자산 포함을 대신 증명하지 않는다.

tools/audio/AGENTS.md

@@ -0,0 +1,9 @@
+# 로컬 음성 제작
+
+이 영역은 대본/profile 검증, Qwen 생성·재사용·후보 내보내기를 소유한다. Unity 음성 큐·게임 성공·사용자 청취 승인·SFX/BGM 선정은 소유하지 않는다. conda qwen3-tts의 GPU 1.7B CustomVoice·Korean·Sohee를 사용하고 CPU·다른 목소리·클라우드로 자동 전환하지 않는다.
+
+재사용은 ID뿐 아니라 대본·설정·고정 revision과 실제 파일 해시를 비교한다. 회차별 원본 catalog/profile snapshot을 보존하고 새 생성은 별도 runId에 남긴다. 실패·무음·비유한 파형을 정상 출력으로 올리지 않는다. validate-only는 모델 로딩·다운로드 없이 파일만 검사한다.
+
+prepare_voice는 원본을 보존해 44.1kHz mono PCM16 후보를 내보내고 draft/not_listened로 기록한다. 기존 runtime와 다른 바이트는 기본 경로에서 거부하며 새 후보는 별도 target으로 만든다. 내보내기 종료 0은 청취 승인이나 active-adoption 갱신이 아니다.
+
+test_generate_voice.py로 입력 오류·ID 선택·재사용·원본 이력·잘못된 manifest를 검사한다. GPU 실제 생성 변경에는 CUDA 연산·모델 장치·실제 sample rate와 후보 청취를 별도로 확인한다. 이미 승인된 44개와 교정된 count_08을 검사를 위해 재생성하지 않는다.

tools/models/AGENTS.md

@@ -0,0 +1,7 @@
+# 배경 소품 제작
+
+이 영역은 Blender의 장난감 소품 메시와 .blend/FBX 내보내기를 소유한다. Unity 재질·프리팹 배치·콜라이더·수학 목표는 소유하지 않는다. 현재 builder는 13개 소품과 원본을 재작성하므로 기존 수작업 변경을 확인한 뒤 실행한다.
+
+단위는 m, 제작 Z-up, FBX는 -Z forward/Y-up·scale 적용·애니메이션 없음·바닥 피벗이다. Unity 입력에서 scale1·축 변환을 사용하고 imported root 회전을 보존한다. 빛나는 구나 별도 얼굴 머리를 배경 소품으로 추가해 수량을 혼동시키지 않는다.
+
+변경 후 실제 FBX 방향·피벗·면·재질과 아치 구멍 선택을 Unity에서 확인한다. 제작 파일 저장 성공을 자석 발견·조작 가능성 합격으로 처리하지 않는다. 출처/provenance의 도구와 실제 원본·내보낸 파일 해시도 갱신한다.