| name | script-graveyard-audit |
| description | scripts/ 에 쌓이는 *죽은 스크립트*(아무도 import/subprocess/문서참조하지 않는 것)를 찾아 docs/archive/cubism-era-scripts/ 묘지로 안전 이동(삭제 아님)한다. Cubism 피벗(2026-06-10) 이전 저작 스크립트가 319개까지 쌓여 "뭐가 실제로 도는지"가 안 보이던 사건의 재발 방지. 트리거 — "스크립트 정리", "죽은 스크립트", "안 쓰는 스크립트 찾아", "스크립트 묘지", "scripts 정리", "도달성 감사", "graveyard audit", "묘지로 보내", "사용 안 하는 파이썬 파일", "스크립트 감사". |
스크립트 도달성 감사 (재발 방지)
scripts/가 다시 죽은 코드로 비대해지지 않게, 도달 불가 스크립트를 결정론으로 찾아 묘지로 보낸다.
1. 감사 (결정론 — 추측 금지)
python3 scripts/audit_script_reachability.py
python3 scripts/audit_script_reachability.py --json
python3 scripts/audit_script_reachability.py --check
판정: 한 스크립트가 LIVE = 다른 스크립트의 import/subprocess, 스킬, 핵심 문서(PROJECT-STATUS·INDEX·
docs/ref·CLAUDE.md), config/control_tower/mini_cubism_app 중 한 곳에 이름이 등장하거나, 엔트리포인트
패턴(run_autorig*·validate_·generate_·verify_·inspect_autorig·build_player* 등)에 해당. 그 외 = 후보.
2. 이동 (삭제 아님 — 되돌림 가능)
후보를 사람이 1차 검토한 뒤(엔트리포인트 오탐 경계), 묘지로 git mv:
mkdir -p docs/archive/cubism-era-scripts
git mv scripts/<name>.py docs/archive/cubism-era-scripts/
이동 후 검증(성역 — 확인):
python3 -m py_compile scripts/*.py scripts/lib/*.py
for s in run_autorig_pipeline build_autorig_rig_v0 build_player_webapp run_autorig_control_tower; do
python3 scripts/$s.py --help >/dev/null && echo "OK $s" || echo "FAIL $s"
done
python3 scripts/build_scripts_index.py
3. 가드레일 (박제된 교훈)
- 삭제 아니라 이동: 증거/재사용 가치가 남을 수 있다. git mv로 묘지에 보존(
docs/archive/cubism-era-scripts/README.md에 근거).
- 엔트리포인트 오탐 경계: 사람이 직접 호출하는 CLI 도구(서버·생성기·검증기)는 참조가 0이어도 LIVE. 감사 후보는 검토 대상이지 자동 삭제 목록이 아니다.
- 실제 import만이 파괴 위험: 카탈로그(INDEX) 등장은 LIVE 신호일 뿐. 이동 전
grep -rn "<name>" 으로 실 import/subprocess 의존을 확인(없으면 안전).
- 2026-06-20 1차 정리: 319→141, 178개(cubism_v2/live2d/mini_cubism_v[n]/패킷) 이동, 실 의존 0건 확인·스모크 PASS.
