chatterbox

ChatterBox 허브 맵 파이프라인 — 광장/구역 블록·내부 관(館) 원화 생성→핫스팟·앵커 캘리브레이션→manifest 배선→유도 3단 인터랙션→E2E. 새 맵(밤 variant·신규 구역 블록·새 내부 관·다른 씬 허브)을 만들 때 사용. 화풍 고정 생성은 scene-pipeline 참조.

ChatterBox 씬 에셋 파이프라인 — 화풍 고정 이미지 생성(gpt-image edits+레퍼런스)→WebP→매니페스트 등재, 입장 영상(Seedance i2v→Topaz 업스케일→WebM). 새 씬/시간대 variant/씬 영상을 만들 때 사용.

Vtube AUTORIG rig 를 ChatterBox 아바타로 배포(Storage 업로드 + 매니페스트 등록)하고 네이티브 렌더러로 실렌더 검증하는 하네스. character.json+mini_rig.json 병합·_mini_rig 렌더필수·헤드리스 same-origin 스테이징 등 매번 재발견하던 함정을 고정. "아바타 배포/추가/넣기/Vtube 아바타 온보딩/새 캐릭터 슬롯" 요청 시.

Vtube AUTORIG rig 를 ChatterBox 아바타로 배포(Storage 업로드 + 매니페스트 등록)하고 네이티브 렌더러로 실렌더 검증하는 하네스. character.json+mini_rig.json 병합·_mini_rig 렌더필수·헤드리스 same-origin 스테이징 등 매번 재발견하던 함정을 고정. "아바타 배포/추가/넣기/Vtube 아바타 온보딩/새 캐릭터 슬롯" 요청 시.

ChatterBox 음원 자산 파이프라인 — BGM/앰비언트/SFX 를 프롬프트로 생성(fal Stable Audio 2.5 · CassetteAI SFX) → 주인님 청취 게이트 → loudnorm+AAC → public/sounds/ 안착. "BGM 만들어", "음원 생성", "효과음 뽑아", "앰비언트", "사운드 추가" 요청 시. 2026-07-13 G6 BGM 3곡 세션에서 밟은 함정을 고정.

구현 완료 슬라이스를 프로덕션에 올리고 라이브로 실증한 뒤 문서·커밋까지 닫는 일괄 마감 절차 — db push(서울 pooler)·함수 deploy(재시도·실측)·CF Pages·프로드 통합/2탭 E2E·백로그 §0/GAP/drift 문서 마감. "배포하고 라이브테스트", "라이브로 올려", "페이즈 마감", "배포 몰아치기" 요청 시.

ChatterBox 프론트(Vite SPA)를 Cloudflare Pages 에 배포하고 실렌더로 검증하는 하네스 — 2계정 non-interactive 선택·프로젝트 선생성·account_id env 전용·번들 비밀키 감사·SPA폴백·헤드리스 React 마운트 확인 등 매번 재발견하던 CF 배포 함정을 고정. "CF 배포/프론트 배포/pages 배포/배포판 검증/재배포/ㄱ 배포" 요청 시.

route/schema/env/worker/UI 변경 영향 범위를 먼저 그려야 할 때 쓰는 스킬. ChatterBox 문서망에 맞춰 커스터마이징됨.

코드 변경 후 어떤 문서를 같이 고쳐야 하는지 change class 기준으로 좁혀주는 점검 스킬. ChatterBox 문서망(contracts/state-machines/specs/GAP-MATRIX)에 맞춰 커스터마이징됨.

세션 종료 또는 pause 직전 다음 에이전트/다음 날을 위한 캡슐(진입점·블로커·미완결정·첫 검증)을 남기는 스킬. ChatterBox 문서망에 맞춰 커스터마이징됨.

문서 업데이트 요청 시 상태판을 얇게 유지해야 할 때 쓰는 스킬. 상세 이력은 GAP-MATRIX 진행 로그로, 최신 사실만 상태판에 남긴다. ChatterBox 문서망에 맞춰 커스터마이징됨.

ChatterBox Supabase 슬라이스(DB 마이그레이션 + Edge Function + 프론트)를 로컬/배포판에서 실측하는 검증 하네스 — 통합테스트(.mjs)와 헤드리스 브라우저 E2E. functions serve 재시작·키 파일화·node_modules 심링크·kong URL 재작성·헤드리스 CDN 인터셉트 등 매번 재발견하던 환경 함정을 고정. 배포판(BASE) 2탭 E2E·seed-and-drive(DB 시드→UI 액션→폴링→ffprobe) 템플릿 포함. "통합테스트/브라우저 E2E/슬라이스 실동작 검증/E2E 실증/배포판 테스트" 요청 시.

ChatterBox 이모트 Lottie 자산 파이프라인 — 옐로/앰버 라운드 이모트를 프로그래매틱 저작 → lottie_light 헤드리스 몽타주 육안 검증 → LOTTIE_BY_ID 배선 → 게이트/인룸 E2E. "이모트 추가", "새 이모트", "이모트 애니메이션", "옐로 이모트", "이모트 Lottie", "리액션 이모트 만들어" 요청 시. 2026-07-10 기본 8종 저작 세션에서 밟은 함정을 고정.

ChatterBox Supabase 슬라이스(DB 마이그레이션 + Edge Function + 프론트)를 로컬/배포판에서 실측하는 검증 하네스 — 통합테스트(.mjs)와 헤드리스 브라우저 E2E. functions serve 재시작·키 파일화·node_modules 심링크·kong URL 재작성·헤드리스 CDN 인터셉트 등 매번 재발견하던 환경 함정을 고정. 배포판(BASE) 2탭 E2E·seed-and-drive(DB 시드→UI 액션→폴링→ffprobe) 템플릿 포함. "통합테스트/브라우저 E2E/슬라이스 실동작 검증/E2E 실증/배포판 테스트" 요청 시.

플랫폼을 여러 사용자 페르소나(신규유저·호스트·뷰어/모바일·악성참가자·크레딧공격자·데이터절취)로 서브에이전트가 실제로 "써보게" 해서 보안취약점·UX마찰·누락기능·잘되는점을 발굴하고, uiux-distilled 원칙으로 UX 개선안까지 문서화하는 3단(정찰→페르소나 워커→종합) 도그푸딩 감사. "플랫폼 감사해줘", "여러 유저로 써봐", "도그푸딩", "보안+UX 같이 봐줘", "사용자 시뮬레이션", "보안취약점이랑 개선점 찾아줘" 요청에 발동.

외부 API(fal.ai, Supabase, LiveKit)·DB 컬럼명·모델명을 코드에 직접 박기 전에 계약과 런타임을 검증하는 스킬. ChatterBox 외부 의존성에 맞춰 커스터마이징됨.

규모가 큰 작업을 단계화하고 검증/문서 동기화까지 닫는 오케스트레이션 스킬. ChatterBox 문서망·게이트에 맞춰 커스터마이징됨.

route/schema/env/worker/UI 변경 영향 범위를 먼저 그려야 할 때 쓰는 스킬. ChatterBox 문서망에 맞춰 커스터마이징됨.

프로젝트 문서 건강성을 진단하고 선택적으로 고치는 스킬. "문서건강성체크", "문서 건강성 체크해줘", "문서 건강성 점검", "doc health", "문서 정리 상태 봐줘", "진입 문서 토큰 너무 큰지 확인" 같은 요청에 발동. 3대 기준(① 인덱싱성: 첫 진입에 필요 정보를 바로 찾아 들어갈 수 있는가·죽은 링크 ② 파일크기/토큰: always-read 진입 문서가 비대해 매 세션 토큰을 낭비하는가 ③ 폴더/정리: 폴더 경계·중복·스테일·방치·README 없는 폴더)으로 등급 판정 후 저가 모델 위임 편집(이관만/git mv)까지 닫는다.

프로젝트 문서의 건강성을 3기준으로 진단한다 — ① 인덱싱성(새 세션/태스크 시작 시 AGENTS.md→INDEX→PROJECT-STATUS 체인만으로 현재 작업을 바로 찾는가, staleness 없는가) ② 크기/토큰(개별 문서가 너무 커서 읽으면 토큰 과소비하는가, 핵심 내비는 작은가) ③ 정리(폴더 구조, 죽은 링크, 중복). 트리거 — "문서 건강성 체크", "문서 건강성", "문서 정리 상태 확인", "문서가 너무 큰지", "문서 토큰 점검", "인덱싱 되는지 확인", "SSOT 문서 점검", "doc health check", "문서 구조 감사", "문서 갱신", "문서 업데이트", "문서 정리해줘". 진단은 메인(최상위) 모델이, 편집은 Sonnet에 위임.

코드 변경 후 어떤 문서를 같이 고쳐야 하는지 change class 기준으로 좁혀주는 점검 스킬. ChatterBox 문서망(contracts/state-machines/specs/GAP-MATRIX)에 맞춰 커스터마이징됨.

완료 선언 전에 실행한 검증 명령·바뀐 문서·가정·잔여 리스크를 점검하는 스킬. ChatterBox 게이트(docs:check 등)에 맞춰 커스터마이징됨.

여러 독립 역할(보안/정합성/기능갭/운영 등)로 프로젝트를 병렬 심사해 취약점·결함·기능갭을 발굴하고, 승인 시 파일-클러스터 배타분리로 병렬 반영까지 닫는 스킬. "취약점 찾아줘", "개선할 기능 찾아줘", "레드팀 해줘", "gap find", "다역할로 감사해줘" 같은 요청에 발동. 코드가 없는 설계 문서 단계에서도 동작한다.

새 프로젝트나 큰 기능 착수 전에 파일, 스킬, phase, 검증 계약까지 잠그는 실행 계약형 planning 스킬

scripts/ 에 쌓이는 *죽은 스크립트*(아무도 import/subprocess/문서참조하지 않는 것)를 찾아 docs/archive/cubism-era-scripts/ 묘지로 안전 이동(삭제 아님)한다. Cubism 피벗(2026-06-10) 이전 저작 스크립트가 319개까지 쌓여 "뭐가 실제로 도는지"가 안 보이던 사건의 재발 방지. 트리거 — "스크립트 정리", "죽은 스크립트", "안 쓰는 스크립트 찾아", "스크립트 묘지", "scripts 정리", "도달성 감사", "graveyard audit", "묘지로 보내", "사용 안 하는 파이썬 파일", "스크립트 감사".

세션 종료 또는 pause 직전 다음 에이전트/다음 날을 위한 캡슐(진입점·블로커·미완결정·첫 검증)을 남기는 스킬. ChatterBox 문서망에 맞춰 커스터마이징됨.

문서 업데이트 요청 시 상태판을 얇게 유지해야 할 때 쓰는 스킬. 상세 이력은 GAP-MATRIX 진행 로그로, 최신 사실만 상태판에 남긴다. ChatterBox 문서망에 맞춰 커스터마이징됨.

프로젝트 문서 건강성을 진단하고 선택적으로 고치는 스킬. "문서건강성체크", "문서 건강성 체크해줘", "문서 건강성 점검", "doc health", "문서 정리 상태 봐줘", "진입 문서 토큰 너무 큰지 확인" 같은 요청에 발동. 3대 기준(① 인덱싱성: 첫 진입에 필요 정보를 바로 찾아 들어갈 수 있는가·죽은 링크 ② 파일크기/토큰: always-read 진입 문서가 비대해 매 세션 토큰을 낭비하는가 ③ 폴더/정리: 폴더 경계·중복·스테일·방치·README 없는 폴더)으로 등급 판정 후 저가 모델 위임 편집(이관만/git mv)까지 닫는다.