설계 문서 드리프트 리포트
설계 문서·README와 실제 코드의 불일치를 전수 점검해 날짜별 드리프트 리포트로 정리해 주는 스킬.
개발·코딩중급★ 11,295⑂ 770AI 점수 8/10마지막 업데이트: 2026. 11. 3.
무엇을 해주나
- 지정한 디렉터리의 모든 설계 문서/README를 하나씩 읽고, 문서가 말하는 파일·클래스·필드·API를 실제 코드베이스에서 찾아 대조합니다.
- 누락된 기능, 필드가 빠진 데이터 모델, 하드코딩으로 대체된 로직, 제안과 다른 아키텍처/라이브러리 사용 등 네 가지 유형의 드리프트를 집중 탐지합니다.
- 일치하는 부분은 쓰지 않고 '차이점만' 추려
{YYYY-MM-DD}_DRIFT_REPORT.md파일에 정해진 포맷으로 누적 기록합니다. - 문서에 코드 경로 링크가 없으면 다음 점검이 쉬워지도록 링크 추가를 제안합니다.
이런 분께 추천
- 설계 문서(Design Doc)나 RFC를 쓰고 구현하는 팀의 개발자·테크리드
- README가 실제 동작과 어긋나 있는지 주기적으로 감사하고 싶은 오픈소스 메인테이너
- 스프린트 종료 시점에 '문서 대비 구현 완료도'를 확인해야 하는 PM/리뷰어
활용 예시
- "
docs/designs/아래 설계 문서 전부에 대해 드리프트 점검해줘" → 문서별 섹션으로 나뉜 리포트 생성 - "이번 릴리스 전 README와 CLI 옵션이 일치하는지 확인해줘" → README에만 존재하는 플래그, 코드에만 있는 옵션을 목록화
- "설계서의 데이터 모델과 실제 dataclass 필드를 비교해줘" → 누락 필드와 타입 차이를 불릿으로 보고
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/google/elephant-goldfish-model/HEAD/distributions/claude/skills/egm-drift-report/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
AI 스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 google/elephant-goldfish-model 의 distributions/claude/skills/egm-drift-report 폴더를 내 ~/.claude/skills/egm-drift-report/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/google/elephant-goldfish-model.git && mkdir -p ~/.claude/skills && cp -r elephant-goldfish-model/distributions/claude/skills/egm-drift-report ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/google/elephant-goldfish-model.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r elephant-goldfish-model/distributions/claude/skills/egm-drift-report ~/.claude/skills/ - 이 스킬은
docs/claude.md를 참조하므로, 저장소의docs폴더도 함께 복사하거나 플러그인 형태로 설치하는 것을 권장합니다. - Claude Code를 재시작한 뒤 "설계 문서 드리프트 점검해줘"처럼 요청하고, 점검 대상 디렉터리를 알려주면 됩니다.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0