메뉴
코드 변경 후 어떤 문서를 같이 고쳐야 하는지 change class 기준으로 좁혀주는 점검 스킬. 트리거 — "코드 고쳤는데 문서 뭐 고쳐", "문서 동기화", "doc sync", "문서 누락 점검", "어떤 문서 같이 고쳐야 해".
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
문서 업데이트/문서 갱신 요청의 기본 입구. 상태판을 얇게 유지하고 상세 증거는 일일 로그로 분리하는 스킬. 트리거 — "문서 업데이트", "문서 갱신", "문서 얇게 업데이트", "상태판 정리", "상태 문서 갱신", "daily 로그로 분리".
에이전트 컨텍스트, 토큰 사용, MCP/스킬 상태, 보안을 점검하고 복구 계획을 세우는 스킬. 트리거 — "에이전트 건강성 체크", "에이전트가 멍청해졌어", "컨텍스트 과밀 점검", "토큰/비용 점검", "MCP/스킬 상태 확인", "agent health".
프로젝트/태스크 첫 진입 시 필요한 정보가 바로 인덱싱되는지, 문서 하나하나가 토큰을 과하게 먹지 않는지, 폴더·파일이 잘 정리됐는지 점검하고 안전하게 정리하는 스킬. 트리거 — "문서건강성체크해줘", "문서건강성체크", "문서 건강성 체크", "문서 건강성", "진입 토큰 점검", "문서 정리", "문서 인덱싱", "always-read 무겁다", "스킬/문서 통합", "doc health".
작업 완료 선언 직전, 실행한 검증, 바뀐 문서, 남은 리스크와 release verdict를 확인하는 스킬. 트리거 — "이거 완료해도 돼?", "증거 검토", "릴리스 가능한지", "작업 끝났는지 확인", "evidence review".
한국어 마케팅/랜딩 카피에서 AI가 쓴 티(클리셰·과장·부정병렬·막연한 표현·em대시 등)를 걷어내고 사람이 쓴 듯 자연스럽게 다듬는다. blader/humanizer(MIT)를 한국어 카피용으로 재해석한 버전. 트리거 — "랜딩 카피 AI 티 빼줘", "마케팅 문구 자연스럽게", "카피 사람처럼 다듬어", "랜딩 문구 윤문".
Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences. 트리거 — "인터랙션 디자인", "마이크로인터랙션 추가", "모션/전환 효과", "로딩 상태 디자인", "UI 인터랙션 다듬어".
| name | doc-sync |
| description | 코드 변경 후 어떤 문서를 같이 고쳐야 하는지 change class 기준으로 좁혀주는 점검 스킬. 트리거 — "코드 고쳤는데 문서 뭐 고쳐", "문서 동기화", "doc sync", "문서 누락 점검", "어떤 문서 같이 고쳐야 해". |
| user_invocable | true |
| tags | ["documentation","drift","post-edit","ssot"] |
| trigger | 코드 변경 후 문서 누락이 걱정될 때 |
| version | 1 |
문서를 많이 쓰게 만들기보다, 꼭 고쳐야 할 문서를 빠르게 찾는 데 목적이 있다.
/self-review 전에git diff --name-only HEAD
git diff --name-only --cached
git status --porcelain
아래만 바뀌면 문서 갱신이 불필요할 수 있다.
단, 동작이나 경계가 바뀌면 trivial이 아니다.
| Class | Example | Must Update | Maybe Update |
|---|---|---|---|
| route/surface | /services, /pricing 페이지 추가 | docs/status/PROJECT-STATUS.md, docs/status/DECISION-LOG.md | docs/prd.md |
| schema/model | 문의 폼 필드 추가 (InquiryPayload) | ai-context/project-context.md | docs/status/PROJECT-STATUS.md |
| feature/flow | EmailJS 템플릿, 제출 로직 변경 | ai-context/project-context.md (연동 상태) | docs/prd.md |
| config/env | EmailJS 키, Vercel 환경 변수 | ai-context/project-context.md (형식), .env.local.example | docs/status/DECISION-LOG.md |
| design/token | 색상, 타이포, 간격 변경 | 구현 코드 레벨 (전용 doc 추가 시에만) | - |
| infra/build | Vercel 빌드, Next.js 설정 | docs/status/DECISION-LOG.md | docs/deploy-vercel.md |
각 문서에 대해 아래 중 하나를 판정한다.
updatednot neededmissingmissing이면 이유와 섹션 힌트를 같이 적는다.
| 상황 | Companion Check |
|---|---|
| route/surface 변경 | npm run build, visual smoke |
| schema/model 변경 | 타입 체크, 폼 제출 테스트 |
| feature/flow 변경 | EmailJS 연동 테스트 |
| design/token 변경 | visual smoke, 모바일 반응형 |
| 큰 변경 | self-review |
## Doc Sync Report
### Change classes
- route/surface
- design/token
### Must update
| 문서 | 이유 | 상태 | 섹션 힌트 |
|---|---|---|---|
| docs/status/PROJECT-STATUS.md | 현재 동작 변화 반영 | missing | Active Tracks |
| ai-context/project-context.md | InquiryPayload 타입 정의 변경 | updated | Schema |
### Companion checks
- npm run build
- visual smoke
### Verdict
- ⚠️ 1 doc needs update
docs/status/PROJECT-STATUS.md 필요 여부가 검토되었다docs/status/DECISION-LOG.md 필요 여부가 검토되었다docs/status/PROJECT-STATUS.md만 우선 맞춘다harnesses/change-class-doc-sync.md)탁디장의 change class 매트릭스는 harnesses/change-class-doc-sync.md를 우선 참고한다.