CLAUDE.md의 품질을 종합 검증합니다. Drift 검증(코드-문서 일치)과 재현성 검증(도메인 이해도 시뮬레이션)을 병렬로 수행하여 통합 보고서를 생성합니다.
From project-context-storenpx claudepluginhub 0pg/cc-marketplace --plugin project-context-storeThis skill uses the workspace's default tool permissions.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Retrieves current documentation, API references, and code examples for libraries, frameworks, SDKs, CLIs, and services via Context7 CLI. Ideal for API syntax, configs, migrations, and setup queries.
Uses ctx7 CLI to fetch current library docs, manage AI coding skills (install/search/generate), and configure Context7 MCP for AI editors.
CLAUDE.md의 품질을 종합 검증합니다.
검증 질문: "이 CLAUDE.md로 도메인을 파악하여 여러 번 시도 시 동일한 코드를 작성할 수 있는가?"
| 구분 | Drift 검증 | 재현성 검증 |
|---|---|---|
| Agent | drift-validator | reproducibility-validator |
| 목적 | 코드-문서 불일치 탐지 | 도메인 이해도 검증 |
| 방법 | 문서 내용과 코드 직접 비교 | AI가 문서만 보고 도메인 이해 후 코드 구조 예측 |
| 질문 | "문서와 코드가 일치하는가?" | "문서로 도메인을 파악하여 코드를 작성할 수 있는가?" |
| 탐지 대상 | 오래된 값, 삭제된 항목, 새 항목 | 도메인 컨텍스트 누락, 비즈니스 규칙 설명 부족 |
1. Glob으로 대상 경로의 모든 CLAUDE.md 파일 탐지
2. 각 파일의 위치와 담당 디렉토리 매핑
모든 CLAUDE.md에 대해 모든 Task를 한번에 병렬 실행:
# 모든 Task를 단일 메시지에서 호출하여 전체 병렬 실행
tasks = []
for claude_md in target_claude_mds:
tasks.append(Task(
subagent_type="project-context-store:drift-validator",
prompt=f"검증 대상: {claude_md}"
))
tasks.append(Task(
subagent_type="project-context-store:reproducibility-validator",
prompt=f"검증 대상: {claude_md}"
))
# 모든 Task 동시 호출 (단일 메시지)
중요: 모든 Task 호출은 반드시 단일 메시지에서 수행하여 전체 병렬 실행
에이전트들은 결과를 파일로 저장하고 경로만 반환합니다.
결과 수집 절차:
1. 각 Task 완료 시 반환된 result_file 경로 수집
- drift-validator: ---drift-validator-result--- 블록에서 result_file 추출
- reproducibility-validator: ---reproducibility-validator-result--- 블록에서 result_file 추출
2. 모든 Task 완료 후 결과 파일 읽기:
a. 각 result_file을 순차적으로 Read (scratchpad 경로)
b. 결과 내용 파싱 및 취합
3. 통합 보고서 작성:
- Drift 검증 결과 수집 (STALE, MISMATCH, UNCOVERED, MISSING, ORPHAN)
- 재현성 검증 결과 수집 (도메인 이해도, 누락 항목)
- 직접 파일 커버리지 통계 계산
- 심각도별 분류 및 정렬
- 권장 조치 통합
4. scratchpad는 세션 종료 시 자동 정리
결과 파일 위치: scratchpad에 저장
=== Context Validation Report ===
## 요약
| 항목 | 결과 |
|------|------|
| 검증된 CLAUDE.md | 5개 |
| Drift 문제 | 3개 |
| 도메인 이해도 문제 | 2개 |
| 전체 상태 | 개선 필요 |
---
## Part 1: Drift 검증 (코드-문서 일치)
drift-validator 에이전트의 결과
### src/auth/CLAUDE.md
#### [HIGH] MISMATCH
| 항목 | 문서 값 | 코드 값 | 위치 |
|------|---------|---------|------|
| TOKEN_EXPIRY | 3600 | 7200 | token.rs:15 |
#### [MEDIUM] MISSING
| 항목 | 코드 값 | 위치 |
|------|---------|------|
| MAX_REFRESH_COUNT | 5 | token.rs:18 |
---
## Part 2: 재현성 검증 (도메인 이해도)
reproducibility-validator 에이전트의 결과
### src/auth/CLAUDE.md
도메인 이해도: 85%
#### 예측 실패 항목
| 예측 실패 항목 | 실제 코드 | 원인 |
|---------------|----------|------|
| REFRESH_INTERVAL | 300 | 도메인 상수 설명 없음 |
| cleanup_expired() | session.rs:45 | 비즈니스 규칙 설명 없음 |
---
## 권장 조치
### 즉시 조치 필요 (High)
1. TOKEN_EXPIRY 값 업데이트 (3600 → 7200)
### 권장 (Medium)
2. MAX_REFRESH_COUNT 문서화 추가
3. REFRESH_INTERVAL의 도메인 의미 추가
4. cleanup_expired() 비즈니스 규칙 설명 추가
### 실행 명령
/context-update src/auth
| 상태 | 조건 |
|---|---|
| 양호 | Drift 문제 0개 AND 도메인 이해도 90% 이상 |
| 개선 권장 | Drift 문제 1-2개 OR 도메인 이해도 70-89% |
| 개선 필요 | Drift 문제 3개 이상 OR 도메인 이해도 70% 미만 |
/context-validate
/context-validate src/auth
| 유형 | 설명 | 심각도 |
|---|---|---|
| STALE | 문서화된 항목이 코드에 없음 | High |
| MISMATCH | 값이 다름 | High |
| UNCOVERED | 직접 파일이 커버되지 않음 | High |
| MISSING | 코드에 있지만 문서화되지 않음 | Medium |
| ORPHAN | 참조 파일 없음 | Low |
### 직접 파일 커버리지
| Node | 직접 파일 수 | 커버된 파일 | 커버리지 |
|------|------------|------------|----------|
| src/auth/ | 5 | 5 | 100% ✅ |
| src/api/ | 8 | 6 | 75% ⚠️ |
| src/utils/ | 3 | 1 | 33% ❌ |
### UNCOVERED 파일 상세
| 파일 | Node | 필요 조치 |
|------|------|----------|
| handler.rs | src/api/ | Files Covered에 추가 |
| logger.rs | src/api/ | Files Covered에 추가 |
| format.rs | src/utils/ | Files Covered에 추가 |
| parse.rs | src/utils/ | Files Covered에 추가 |