Create kr patch

레트로 게임 한글 패치 제작

방향

대상 게임의 증거로 현재 판단을 갱신하며 초기 조사부터 폰트·인코딩, PoC, 추출, 번역, 재삽입, 빌드, 배포 패치와 실행 검증까지 연결한다.

도구·언어·라이브러리·폰트는 대상 프로젝트의 기존 구조와 현재 환경에서 선택하고, 선택과 무관하게 요구 능력과 검증 기준을 충족한다. 명확한 1차 자료 한 곳에서 쉽게 확인할 수 있는 기본 사양은 필요할 때 최신 자료에서 확인한다.

이 방법론은 일본어 원문·텍스트 중심의 선행 경험에서 출발했다. 빈도와 선행 구조는 대상 리비전의 증거로 다시 판정한다.

라우팅

기존 저장소에서는 코드·문서·산출물·검증 상태를 복원한 뒤 현재 판단을 고른다. 새 게임이나 구조가 불명확한 대상은 초기 조사에서 시작한다.

판단 영역	문서	내용
초기 조사	references/strategy/initial-survey.md	완성 여부를 좌우하는 조건, 실제 의존 경계, 초기 분량·미확정 모집단과 확정 리비전 사양
폰트·인코딩	references/strategy/font-strategy.md	코드→글리프 대응, 전체 레퍼토리와 활성 작업 집합, 표현·도달 검증
텍스트 추출	references/strategy/text-extraction.md	모집단·초기 분량 확정, 소비자 기반 경계·토큰, 가역 산출물과 라운드트립
PoC	references/strategy/poc.md	가시성·대표 E2E·조건부 PoC의 수행 여부와 통과 기준 판정
재삽입·훅	references/strategy/reinsertion.md	경계별 정책, 참조 완전성, 훅·공간·소비자 불변식
번역	references/strategy/translation-workflow.md	에이전트 배치, 맥락 확정, 승인 용어·문체, 보호 제약과 고위험 의미의 적격 판정
빌드·검증	references/strategy/build-and-verify.md	재현 가능한 산출물, 배포 경계, 계층별 검증과 종료 판정
디버깅·이슈 처리	references/strategy/debugging.md	플레이 경로·목표 상태 도달, 상태 개입의 증명 범위와 원인·수정·회귀 판정
그래픽 텍스트 (횡단)	references/strategy/graphics-text.md	픽셀 텍스트 모집단, 보호 시각 자산과 소비 경로 검증
압축 대응 (횡단)	references/strategy/compression.md	실제 변환 경계, 대상 소비자 호환성과 재패킹 검증
런타임 자산 도달성 (횡단)	references/strategy/runtime-assets.md	변경된 저장→탐색→적재·변환→상주→소비 연결 판정

산출물·교환 데이터·기록을 설계하거나 검증할 때 해당 시행 규약을 함께 적용한다. 기존 저장소에 동등한 구조가 있으면 그 구조를 유지한다.

범위	문서	내용
프로젝트 구현 (횡단)	references/conventions/project-conventions.md	빌드 경계, 기계어 검산, 라운드트립 동등 기준과 검증 분모, 최종 변경 검증, 외부 구성요소 재현·원본 자산 취급
번역 자산	references/conventions/translation-artifacts.md	원문 보호, 제어 토큰, 검토 상태와 빌드 입력의 의미 규칙
프로젝트 기록	references/conventions/project-records.md	조사·PoC·그래픽 카탈로그·HITL·QA 증거와 판정의 기록 규칙
분석·빌드 데이터	references/conventions/data-formats.md	문자 매핑, 제어코드, 포인터, 번역 자산 연결, 재삽입 정책과 폰트 구성 정보의 의미 규칙

현재 분기를 바꾸는 하드웨어·매체·주소공간·렌더링 제약은 해당 플랫폼 문서에서 확인한다.

플랫폼	문서
SNES (슈퍼패미컴)	references/platforms/snes.md
메가드라이브	references/platforms/megadrive.md
세가 새턴	references/platforms/saturn.md
PS1	references/platforms/ps1.md
드림캐스트	references/platforms/dreamcast.md
PC엔진 / CD-ROM²	references/platforms/pce.md
PC-98	references/platforms/pc98.md
게임기어	references/platforms/gg.md
닌텐도 DS	references/platforms/nds.md

목록에 없는 플랫폼은 현재 판단에 필요한 제약을 대상 게임에서 확정한다.

새 판단을 시작하거나 관측 증상이 바뀌면 references/tips/README.md에서 판단 영역과 발동 조건을 대조하고, 맞는 사례의 전이 한계를 현재 대상에서 검증한다. 완료는 사례가 아니라 그 사례의 관련 판단 기준이 가리키는 문서로 판정한다.

판단 흐름

• 선언한 완성 범위와 반드시 성립해야 할 조건을 먼저 확인한다.
• 실패하면 완성이 불가능하거나 설계를 크게 바꾸는 미확정 조건을 먼저 판정하고, 같은 조건을 가르는 증거 중 비용이 낮은 것을 고른다.
• 서로 독립된 경계는 병렬로 조사하고, 새 증거가 뒤집은 판정만 원인 경계로 되돌린다.
• 대표 PoC는 모집단 조사와 병행할 수 있다. 전체 배포 범위로 번역을 확대하기 전 모집단·분량은 references/strategy/text-extraction.md §1.5로, 초벌 코퍼스에서 드러난 글리프 수요와 공급 가능성은 references/strategy/translation-workflow.md §5와 references/strategy/font-strategy.md §3으로 판정한다.
• 유한한 표시 영역은 원본 사용 범위, 확인된 소비 한도와 채택한 표시 범위를 구분해 references/strategy/translation-workflow.md §4로 판정한다. 글리프·길이·레이아웃 예산이 부족하면 공급 확대 가능성을 먼저 판정하고, 의미 손실이 있는 축소는 사람이 승인한다.
• 변경 산출물은 실제 빌드와 소비 경로에서 검증하고, 결함은 처음 값이 달라진 원인 경계에서 수정한다.

핵심 불변식

어느 작업에서든 다음을 위반하지 않는다.

• 0원칙 — 플레이어는 보통 한 번만 플레이한다. 배포 기준은 "대체로 동작한다"가 아니라 알려진 치명 문제 0건이다. 크래시·진행 불가뿐 아니라 깨진 글자, 틀린 힌트·아이템명, 무너진 용어·말투도 단 한 번뿐인 경험을 망치므로 배포를 막는다. 오역은 문장 품질 문제가 아니라 진행 실패, 선택지 오판과 인물 오해를 부른다.
• 원본 ROM·디스크 이미지와 허가되지 않은 저작 자산은 커밋하지 않는다. 허용 자산과 원본 식별 기준은 references/conventions/project-conventions.md §6을 따른다.
• 변환 경계는 수정 전에 검증한다. 해당 경계가 요구하는 바이트 가역성 또는 소비 의미와 보호 정보의 동등성을 입증한다. 동등 기준과 검증 분모는 references/conventions/project-conventions.md §5.1을 따른다.
• 최종 산출물의 모든 변경은 적용 전에 검증 가능해야 한다. 불변 원본을 기준으로 각 변경을 만드는 경로와 허용 범위를 확인하고, 서로 겹치는 변경·보호 범위 침범·설명되지 않은 최종 변경을 빌드 실패로 처리한다. 상세 조건은 references/conventions/project-conventions.md §5.2를 따른다.
• 기계어 생성·이동은 대상 명령 집합의 유효 범위를 선언하고 그 전체를 검산한다. 패치에 필요한 일부 명령만 검증해 생성·이동·제어 흐름의 완전성을 주장하지 않는다. 상세 조건과 제한된 예외는 references/conventions/project-conventions.md §2.3을 따른다.
• 자유 문장의 번역과 그 판정은 사람이 한다. 규칙 기반 자동화와 언어 품질 휴리스틱(사전 등재 여부, 빈도, 맞춤법·띄어쓰기 검사, LLM 점수)은 후보와 영향 범위만 만들고 문맥을 읽는 번역·검토를 대신하지 않는다. 사람이 적용 단위와 허용값을 확정한 규칙, 또는 보호 정보·실제 소비 제약처럼 참·거짓을 기계적으로 가릴 수 있는 위반만 자동 판정한다. 상세 경계는 references/strategy/translation-workflow.md §3.1과 §5를 따른다.
• 번역문 일괄 변경은 사람이 승인한다. 기준선·변환 규칙·적용 범위·예상 영향을 사람이 확인하기 전에는 검출 결과를 번역문에 반영하지 않는다. 승인 대상과 예외는 references/strategy/translation-workflow.md §5가 판정한다.
• 증거는 하나의 완성 경로를 판정해야 한다. 구성요소별 성공을 합산해 완성으로 판정하지 않고, 선언한 범위의 모든 변경을 불변 원본과 승인 입력에서 주 빌드 경로로 함께 만든 하나의 빌드 결과에서 검증한다. 모집단·경계·소비 규칙이 확정된 범위만 완료로 판정하며, 완성 여부를 좌우하는 조건을 그대로 둔 부분 성공은 그 조건의 통과 증거가 아니다.
• 선행 사례의 구조와 수치는 가설이다. 같은 플랫폼·개발사·시리즈라도 스크립트 포맷, 포인터 규약, 제어코드는 역공학으로 확정하기 전에 이식하지 않고, 필요한 값은 대상 리비전과 실제 소비 조건에서 다시 측정한다.
• 주요 문자 집합은 검증 가능한 기성 글꼴에서 공급한다. PoC의 편의를 이유로 본문 자형을 직접 만들지 않는다. 직접 제작·보정은 필수 글리프의 국소 누락이나 확인된 UX 요구에 한정하며, 상세 판정은 references/strategy/font-strategy.md §4를 따른다.
• 인코딩 누락은 빌드 에러다. 번역문에 글리프·코드 매핑이 없는 문자가 있으면 조용히 건너뛰지 말고 빌드를 실패시킨다.