From project-lifecycle
문서-코드 동기화 검증 스킬. 설계 문서와 실제 코드 사이의 불일치(Drift)를 탐지하고 수정 방안을 제안한다. "문서 동기화", "드리프트 체크", "코드와 문서 불일치", "문서 최신화", "sync check", "drift detection", "문서 검증" 요청 시 사용.
npx claudepluginhub shaul1991/shaul-plugin --plugin project-lifecycleThis skill uses the workspace's default tool permissions.
설계 문서(.claude/)와 실제 코드 사이의 불일치(Drift)를 체계적으로 탐지하고,
Batch-converts UI design screenshots from directories into Vue 3 Composition API components, mapping elements to Vant, Element Plus, or Ant Design Vue libraries.
Share bugs, ideas, or general feedback.
설계 문서(.claude/)와 실제 코드 사이의 불일치(Drift)를 체계적으로 탐지하고, 어떤 쪽을 업데이트해야 하는지 판단하여 수정을 제안한다.
담당 에이전트:
code-analyst(시니어 소프트웨어 분석가)
프로젝트가 진행되면 문서는 코드보다 뒤처지기 마련이다. 방치하면 문서는 신뢰를 잃고, 새 팀원은 잘못된 정보를 참고하며, 회귀 버그가 발생한다. 정기적인 Sync Check는 이 드리프트를 조기에 발견하여 문서의 신뢰도를 유지한다.
어떤 문서-코드 쌍을 검증할지 결정한다:
| 문서 (Source of Truth) | 코드/구현 | 검증 포인트 |
|---|---|---|
.claude/03-architecture/api-spec.md | 실제 API 라우트/핸들러 | 엔드포인트 URL, 메서드, 파라미터, 응답 형태 |
.claude/03-architecture/data-model.md | DB 스키마/마이그레이션 | 테이블명, 컬럼, 타입, 관계, 인덱스 |
.claude/03-architecture/tech-stack.md | package.json / requirements.txt | 실제 사용 기술, 버전 |
.claude/05-implementation/conventions.md | 실제 코드 | 네이밍, 디렉토리 구조, 에러 처리 패턴 |
.claude/04-design/interaction-specs/ | UI 컴포넌트 코드 | 컴포넌트 props, 상태, 이벤트 핸들러 |
.claude/06-infra/infrastructure.md | Dockerfile, CI/CD, IaC | 환경 구성, 파이프라인 단계, 인프라 설정 |
코드를 스캔하여 문서와 대조한다:
API 드리프트 탐지:
데이터 모델 드리프트 탐지:
컨벤션 드리프트 탐지:
발견된 불일치를 심각도별로 분류:
# Sync Check Report — YYYY-MM-DD
## 요약
| 심각도 | 건수 | 설명 |
|--------|------|------|
| Critical | N | 기능 동작에 영향을 줄 수 있는 불일치 |
| Major | N | 혼란을 유발할 수 있는 불일치 |
| Minor | N | 사소한 차이 (오타, 형식 등) |
## 상세 드리프트 목록
### [DRIFT-001] API 엔드포인트 불일치
| 항목 | 문서 | 코드 |
|------|------|------|
| 경로 | `/api/users/:id` | `/api/v2/users/:id` |
| 수정 방향 | □ 문서 업데이트 | □ 코드 수정 |
| 권장 조치 | 문서를 코드에 맞게 업데이트 (API v2 마이그레이션 반영) |
각 드리프트에 대해 수정 방향을 제안한다:
수정 방향 판단 기준:
.claude/sync-check-report.md (또는 날짜별)이 스킬은 다음 시점에 실행하는 것을 권장한다: