Menu
git diff 기반으로 VibeHub의 ref/status/automation 문서 drift를 change class 단위로 점검하고, 어떤 문서를 어느 섹션까지 봐야 하는지 좁혀준다.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | doc-sync |
| description | git diff 기반으로 VibeHub의 ref/status/automation 문서 drift를 change class 단위로 점검하고, 어떤 문서를 어느 섹션까지 봐야 하는지 좁혀준다. |
| user_invocable | true |
코드 변경에 따라 어떤 문서를 같이 고쳐야 하는지 점검한다. 목표는 문서를 많이 쓰게 만드는 것이 아니라, 필수 문서 누락과 잘못된 문서 선택을 줄이는 것이다.
/self-review 전에.claude/automations/README.md, CLAUDE.mdgit diff --name-only HEAD
git diff --name-only --cached
git status --porcelain
위 결과를 합쳐 변경된 파일 목록을 만든다.
아래에만 해당하면 보통 문서 업데이트가 불필요하다.
단, trivial처럼 보여도 동작/상태/경계가 바뀌었으면 trivial로 보지 않는다.
변경 파일을 아래 class로 묶는다. 한 변경이 여러 class에 걸칠 수 있다.
apps/web/app/**, public/admin page, metadata, redirect, navigationdocs/ref/ROUTE-SPECS.mddocs/status/PROJECT-STATUS.mddocs/status/PROJECT-STATUS.md (Execution Checklist 섹션 포함)docs/ref/PRD.mddocs/ref/ARCHITECTURE.mdsupabase/migrations/**, DB write path, read projectiondocs/ref/SCHEMA.mddocs/status/PROJECT-STATUS.mddocs/ref/PIPELINE-OPERATING-MODEL.mddocs/status/DECISION-LOG.mdapps/backend/src/workers/**, fetch/ingest/classifier/draft/critic/publish shared codedocs/ref/PIPELINE-OPERATING-MODEL.mddocs/ref/AGENT-OPERATING-MODEL.mddocs/status/PROJECT-STATUS.mddocs/ref/LLM-ORCHESTRATION-MAP.mddocs/ref/ORCHESTRATION-EVALUATION.mddocs/status/ORCHESTRATION-TRIAL-LOG.md.claude/automations/**, 관련 worker, Telegram 보고 semantics.claude/automations/README.mddocs/status/PROJECT-STATUS.mddocs/ref/AUTO-PUBLISH-RULES.mddocs/ref/REVIEW-POLICY.mdCLAUDE.mdnpm run automation:checkdocs/ref/SOURCE-CATALOG.mddocs/status/PROJECT-STATUS.mddocs/ref/SOURCE-TIER-POLICY.mddocs/ref/REVIEW-POLICY.mddocs/ref/AUTO-PUBLISH-RULES.mdpackages/design-tokens/**, CSS, presentational component, card layout, filter UXdocs/status/PROJECT-STATUS.mddocs/status/PROJECT-STATUS.md (Execution Checklist 섹션 포함)docs/ref/ROUTE-SPECS.mddesign-syncui-auditdocs/ref/PIPELINE-OPERATING-MODEL.mddocs/status/PROJECT-STATUS.mddocs/ref/ROUTE-SPECS.mddocs/ref/CHANNEL-PUBLISH-PIPELINE.mddocs/ref/SCHEMA.mddocs/status/DECISION-LOG.mdplans/harnesses/sidecar-safety-harness-plan.md각 class에서 필요한 문서가 실제 변경 목록에 들어 있는지 확인한다.
updatednot neededmissingmissing으로 판단할 때는 반드시 이유와 섹션 힌트를 함께 적는다.
문서만 볼 일이 아닐 때는 바로 관련 스킬도 붙인다.
| 상황 | 같이 제안할 것 |
|---|---|
| route/public/admin 변경 | ui-audit |
| design token/category/CSS 변경 | design-sync |
| pipeline/data path 변경 | pipeline-check |
| automation prompt 변경 | npm run automation:check |
| 여러 class가 동시에 걸침 | big-task |
| 작업 종료 직전 | commands/self-review.md |
## Doc Sync Report
### Change classes
- route/surface
- automation/prompt
### Must update
| 문서 | 이유 | 상태 | 섹션 힌트 |
| --- | --- | --- | --- |
| docs/ref/ROUTE-SPECS.md | `/newsletter` 목적/핵심 섹션 변경 | missing | `/newsletter` |
| docs/status/PROJECT-STATUS.md | 사용자 동작 변화 반영 필요 | missing | Current Delivery Status |
| .claude/automations/README.md | execution order 변경 | updated | Execution Order |
### Companion checks
- ui-audit
- npm run automation:check
### Safe skips
- docs/ref/SCHEMA.md — DB 변경 없음
### Verdict
- ⚠️ Doc sync: 2 doc(s) need update
✅ Doc sync: all required docs updated⚠️ Doc sync: N doc(s) need updateCLAUDE.mdplans/harnesses/doc-sync-harness-plan.mdplans/harnesses/sidecar-safety-harness-plan.md
를 함께 읽고 다시 분류한다docs/status/*는 구현과 충돌하면 구현을 먼저 확인하고 맞춘다PROJECT-STATUS.md는 기능/동작 변화가 있으면 거의 항상 후보에 넣는다EXECUTION-CHECKLIST는 PROJECT-STATUS.md에 통합됨 — 별도 파일 수정 불필요DECISION-LOG.md는 경계/원칙/상태 의미가 바뀌었을 때만 요구한다ROUTE-SPECS.md는 route 파일만이 아니라 route 목적/핵심 섹션이 바뀌어도 후보가 된다PIPELINE-OPERATING-MODEL.md는 lane, blocking semantics, step order가 바뀌면 본다CHANNEL-PUBLISH-PIPELINE.md는 채널 어댑터/미디어 publish 규칙이 바뀌면 본다automation:check는 자동화 문서와 스크립트 참조 drift를 잡는 companion check다규모가 큰 작업을 플랜 → 페이즈별 병렬 실행 → 자기 리뷰 → 요약 설명까지 체계적으로 진행한다. 마일스톤이 3개 이상이거나 파일 변경이 10개 이상 예상될 때 사용.
Telegram 대화 히스토리를 Obsidian에서 조회·수동 공고화·히스토리 초기화하는 스킬.
프로젝트 독립적 문서 관리 프레임워크 — 정본 1곳 원칙, change-class 기반 자동 갱신, 상태 자동 정리를 다른 프로젝트에 이식할 때 사용
Run the full pipeline (fetch → ingest → sync) and verify data reaches the UI via Playwright tests.
세션 회고 — 성공 패턴·실패 우회·반복 수작업·사용자 교정을 스킬/피드백/자동화로 자동 추출
Playwright로 admin/public 페이지의 overflow, 가독성, 반응성, 토큰 준수를 한번에 검증한다. 프론트엔드 CSS/컴포넌트 변경 후 사용.