Skip to content

Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.

2.4 KB
Raw Blame

리네임 게이트 — 어휘/키를 바꿀 때 (BLOCKING)

Owns: What must move together when a vocabulary word or key is renamed · Index: docs/README.md

SKILL.md 허브에서 옮겨온 계약 본문(2026-09-09, 허브 슬림화). 허브는 이 페이지를 가리키기만 한다.

스키마 키·식별자·라벨을 걸쳐 어휘를 바꾸는 작업(pixel_perfect → pixel_unfake 류)은 일괄 치환으로 시작하지 않는다. 치환은 이름을 바꾸지만 계약은 층위로 존재한다:

식별자 → 키 문자열 → 사용자 라벨(en+ko) → 문서 예제 → --help 문구 → 테스트 하니스

순서가 정해져 있다 (회귀 2026-07-25/26, plan sprite-gen/pixel-unfake-rename — 이 순서를 거꾸로 해서 검증자 리젝트 3라운드가 났다):

  • 구조 단정을 스윕보다 먼저 쓴다. 판독 SSoT(게이트) 밖에서 그 파일/키를 읽는 프로덕션 경로가 있으면 실패하는 테스트. 정규식이 아니라 AST 로 — 실제 회귀 형태는 보통 두 줄(경로를 변수에 담고 다음 줄에서 읽기)이라 한 줄 정규식은 못 잡는다 (tests/test_pixel_unfake_migration.py 마지막 케이스가 그 형태).
  • 그 단정을 mutant 로 검증한다. 옛 형태를 일부러 되돌려 실제로 실패하는지 본다. 통과만 하는 단정은 장식이고, 그걸 근거로 "구조로 닫았다" 고 말하면 거짓 보고가 된다.
  • 판독부는 키 이름만 바꾸지 않고 게이트 뒤로 옮긴다. 이관 전 데이터에서 그 판독부만 조용히 틀린 답을 본다 (실측: 리롤이 "언페이크가 꺼져 있다" 며 거짓 거부).
  • 구분자가 바뀌는 치환은 토큰 단위로. pixel-perfect → pixel unfake 처럼 하이픈이 공백이 되는 치환은 argparse 옵션·경로·식별자를 깨뜨린다 (실측: --fit-pixel unfake 유령 옵션 등록 + 은퇴 안내문이 현행 플래그를 은퇴했다고 말하는 자기모순).
  • 은퇴 이름은 조용한 별칭으로 남기지 않는다. 새 이름을 안내하며 hard error. 그 안내 문구 자체는 치환 대상에서 제외한다.
  • 순수 리네임 주장은 골든 회귀로 증명한다. 리네임 전/후 산출물이 바이트 동일한지.

Related