| name | gt-text-review |
| description | Text branch review handoff after technical QA: inspect the complete translated text sheet and emulator-ready candidate, record unresolved issues and optional user review materials, and continue automatically by default. Use after gt-text-qa when text review preparation, font/layout evidence, or an explicit user-gate policy must be handled. |
gt-text-review — 텍스트 브랜치 T4: 검수 handoff
이 단계의 검수는 번역·폰트·구조 QA가 끝난 결과를 에뮬레이터/통합 QA에 넘길 수 있도록
검수 시트와 준비 자료를 정리하는 것이다. text_review_policy=prepare-only가 기본이며,
이 경우 사용자에게 허락을 묻거나 작업을 중단하지 않는다. user-gate를 프로젝트에
명시한 경우에만 아래 산출물을 제출하고 명시적 승인을 기다린다.
입력 조건
gt-text-qa 완료: text_status=qa_ready, font_status=verifiedTEXT_QA_REPORT.md, TEXT_BUILD_MANIFEST.tsv, FONT_ATLAS_MANIFEST.tsv,
FONT_COVERAGE.tsv의 최신 해시- canonical
translation_manifest.tsv, glossary.tsv, STYLE.md
PROJECT.md의 text_review_policy와 현재 text staging 경로
font manifest·render probe·왕복 보고서가 없거나 현재 입력 해시와 다르면 검수 시트를
만들어 완료 처리하지 말고 BLOCKED로 돌린다. 이 단계에서 폰트 위치 문제를 시각적으로
발견하면 gt-text-qa로 되돌려 원인(좌표계·padding·metrics·consumer·fallback)을 고친다.
절차
- 입력 재확인: 행 수·안정 ID·원문·target_ko·제어 토큰·용어집·폰트 manifest와
text candidate의 해시를 exact 비교한다. 다른 candidate·Title ID·세션의 증거는 현재
결과로 승격하지 않는다.
- 전체 검수 시트 생성:
30_translation/text/reviews/REVIEW_TEXT.tsv에 모든
텍스트 행을 넣는다. 최소 컬럼은 id, source_file, source_key, 원문, 번역,
상태, font_status, layout_risk, 사용자의견, 비고다. 샘플링하지 않는다.
layout_risk에는 표시 폭·줄 수·baseline·루비·제어 토큰·폰트 의존성 위험을 적는다.
- 검수 요약:
TEXT_REVIEW_HANDOFF.md에 총 행·실제 변경 행·no-op·blocked/low
confidence·폰트 probe 범위·candidate/build/font manifest 해시·다음 단계와 알려진
제한을 기록한다. 검수 시트와 handoff는 artifact_key 하나로 manifest에 등록한다.
- 정책 분기:
prepare-only: 시트·handoff·candidate가 완성되면 text_status=review_ready,
text_review_approval=not_required, text_review_result=prepared를 기록하고 즉시
gt-image-analyze 또는 gt-qa로 진행한다. 사용자 응답을 기다리지 않는다.user-gate: text_review_approval=pending, text_status=review_waiting으로
기록하고 중단한다. 사용자가 PROJECT.md의 approval을 approved로 명시적으로
변경하기 전에는 review_ready로 바꾸지 않는다. 수정이 들어오면 해당 행만 반영하고
gt-text-qa의 폰트·왕복 검사를 다시 수행한다.
- 상태 분리:
review_ready는 사용자 승인, 런타임 PASS, 릴리스 준비를 의미하지
않는다. PASS (bench), PASS (runtime), user-approved를 각각 별도 증거로 둔다.
산출물
30_translation/text/reviews/REVIEW_TEXT.tsv30_translation/text/reviews/TEXT_REVIEW_HANDOFF.md- candidate·font·coverage·QA manifest 해시와
PROJECT.md 상태 기록
완료 기준
