Menu
코드 변경 후 어떤 문서를 같이 고쳐야 하는지 change class 기준으로 좁혀주는 점검 스킬. ChatterBox 문서망(contracts/state-machines/specs/GAP-MATRIX)에 맞춰 커스터마이징됨.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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 문서 마감. "배포하고 라이브테스트", "라이브로 올려", "페이즈 마감", "배포 몰아치기" 요청 시.
| name | doc-sync |
| description | 코드 변경 후 어떤 문서를 같이 고쳐야 하는지 change class 기준으로 좁혀주는 점검 스킬. ChatterBox 문서망(contracts/state-machines/specs/GAP-MATRIX)에 맞춰 커스터마이징됨. |
| user_invocable | true |
| tags | ["documentation","drift","post-edit","ssot"] |
| trigger | 코드 변경 후 문서 누락이 걱정될 때 |
| version | 2 |
문서를 많이 쓰게 만들기보다, 꼭 고쳐야 할 문서를 빠르게 찾는 데 목적이 있다.
gap-find가 대신함)git diff --name-only HEAD, git status --porcelain — ChatterBox가 git repo가 되면)docs/FEATURE-SPEC.md, docs/DATA-SCHEMA.md, docs/contracts/*.md, docs/state-machines/*.md, docs/GAP-MATRIX.mdgit diff --name-only HEAD
git diff --name-only --cached
git status --porcelain
아래만 바뀌면 문서 갱신이 불필요할 수 있다.
단, 동작이나 경계가 바뀌면 trivial이 아니다.
| Class | Example | Must Update | Maybe Update |
|---|---|---|---|
| UI 컴포넌트 | React 컴포넌트 신설/props 변경 | docs/contracts/<Component>.md | docs/FEATURE-CONTRACT-MAP.md, docs/STORE-DEPENDENCY-MATRIX.md |
| schema/model | DB 테이블·컬럼, Zustand store 타입 | docs/DATA-SCHEMA.md | docs/GAP-MATRIX.md (결정 이력) |
| state/flow | 상태머신, Edge Function 로직 | docs/state-machines/*.md, 관련 docs/specs/*.md | 연관 docs/contracts/*.md |
| automation/prompt | 스킬, 훅, 운영 루틴 | docs/status/AGENT-OPS.md | .claude/skills/*/SKILL.md |
| design/token | UI 토큰, 애니메이션 | docs/design/DESIGN-TOKENS.md | 관련 contracts |
| config/infra | env, build, 배포 | docs/PLATFORM-ARCHITECTURE.md, docs/specs/VITE-CONFIG.md | docs/archive/landing/DEPLOY.md, docs/ops/DEPLOY-PLATFORM.md |
주의:
docs/status/PROJECT-STATUS.md는 랜딩 페이지(snack-web) 전용이다. ChatterBox 앱 자체의 구현 진행상황은docs/GAP-MATRIX.md(진행 로그 + GAP 상태)와npm run docs:health가 담당한다. 둘을 혼동하지 말 것.
각 문서에 대해 updated / not needed / missing 중 하나로 판정한다. missing이면 이유와 섹션 힌트를 같이 적는다.
| 상황 | Companion Check |
|---|---|
| 계약서/스키마 변경 | npm run docs:check, npm run docs:check:strict |
| 코드 변경 (Phase 0 이후) | npm run type-check, npm run lint, npm run build, npm run test |
| 큰 변경 | gap-find 또는 doc-health-audit |
## Doc Sync Report
### Change classes
- UI 컴포넌트
- schema/model
### Must update
| 문서 | 이유 | 상태 | 섹션 힌트 |
|---|---|---|---|
| docs/contracts/DubRecorder.md | Props 변경 | missing | Props Interface |
| docs/DATA-SCHEMA.md | 컬럼 추가 | updated | §1.13 dub_tracks |
### Companion checks
- npm run docs:check
- npm run type-check
### Verdict
- ⚠️ 1 doc needs update
docs/GAP-MATRIX.md 진행 로그 갱신 필요 여부가 검토되었다 (구조/원칙 변경 시)npm run docs:check 통과 확인docs/contracts/*.md 또는 docs/state-machines/*.md만 우선 맞춘다docs/GAP-MATRIX.md에 신규 G-ID로 등록 후 gap-find로 채운다