菜单
코드 변경 후 어떤 문서를 같이 고쳐야 하는지 change class 기준으로 좁혀주는 점검 스킬. ChatterBox 문서망(contracts/state-machines/specs/GAP-MATRIX)에 맞춰 커스터마이징됨.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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/VITE-CONFIG.md | docs/DEPLOY.md, docs/DEPLOY-PLATFORM.md |
주의:
docs/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로 채운다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 문서 마감. "배포하고 라이브테스트", "라이브로 올려", "페이즈 마감", "배포 몰아치기" 요청 시.