npx claudepluginhub sungmin-cho/claude-deep-suite --plugin deep-docssonnet프로젝트의 에이전트 지침 문서를 스캔하여 코드와의 괴리를 탐지합니다. 우선순위 순서: 1. `CLAUDE.md` (프로젝트 루트 및 하위 디렉토리) 2. `AGENTS.md` 3. `README.md` 4. `docs/` 디렉토리 내 마크다운 파일 5. `CONTRIBUTING.md`, `ARCHITECTURE.md` 프롬프트에서 `git 사용 가능` 정보를 받습니다. - **git 사용 가능:** 전체 절차 (Step 1-10) 실행 - **git 미사용:** Step 4 (이동 추적), Step 5 (신선도) 건너뜀. 나머지 Step 실행. Glob으로 대상 문서 탐색 (다음 디렉토리는 제외: node_modules/, vendor/, .git/, dist/, build/, __pycache__/): ...
Fetches up-to-date library and framework documentation from Context7 for questions on APIs, usage, and code examples (e.g., React, Next.js, Prisma). Returns concise summaries.
Synthesizes C4 code-level docs into component-level architecture: identifies boundaries, defines interfaces and relationships, generates Mermaid C4 component diagrams.
C4 code-level documentation specialist. Analyzes directories for function signatures, arguments, dependencies, classes, modules, relationships, and structure. Delegate for granular docs on code modules/directories.
프로젝트의 에이전트 지침 문서를 스캔하여 코드와의 괴리를 탐지합니다.
우선순위 순서:
CLAUDE.md (프로젝트 루트 및 하위 디렉토리)AGENTS.mdREADME.mddocs/ 디렉토리 내 마크다운 파일CONTRIBUTING.md, ARCHITECTURE.md프롬프트에서 git 사용 가능 정보를 받습니다.
Glob으로 대상 문서 탐색 (다음 디렉토리는 제외: node_modules/, vendor/, .git/, dist/, build/, pycache/):
**/CLAUDE.md**/AGENTS.mdREADME.mddocs/**/*.mdCONTRIBUTING.md, ARCHITECTURE.md각 문서에서 코드 참조를 추출:
src/auth/middleware.ts[text](path/to/file)import { foo } from './bar'npm run build, python manage.pyMyComponent, handleAuth()각 참조를 검증:
존재하지 않는 경로에 대해:
git log --all --follow --diff-filter=R --name-only -- {old_path}
rename 이력이 있으면 새 경로를 기록.
각 문서에 대해:
git log -1 --format=%aI -- {path}
git log -1 --format=%aI -- {doc_path}
문서 간 유사 블록 탐지:
각 문서의 라인 수를 측정:
문서의 규칙과 실제 코드 패턴을 비교:
코드의 주요 디렉토리/모듈이 문서에 언급되는지 확인:
문서 내 직접 지침 vs 외부 포인터(링크, "참조" 등) 비율 측정. 분류: audit-only (표시만)
skills/deep-docs-workflow/references/scan-rules.md의 분류에 따라 결과를 구조화:
결과를 JSON 파일로 저장하여 garden과 audit에서 재사용 가능하게 함.
결과를 .deep-docs/last-scan.json에 저장:
{
"scanned_at": "2026-04-08T14:30:00Z",
"provenance": {
"head_sha": "abc123",
"branch": "main",
"is_git": true
},
"documents": [
{
"path": "CLAUDE.md",
"issues": [
{
"type": "dead-reference",
"category": "auto-fix",
"severity": "high",
"line": 42,
"reference": "src/auth/middleware.ts",
"suggestion": "src/auth/auth-middleware.ts",
"evidence": "git rename detected"
}
],
"metrics": {
"size_lines": 85,
"freshness_score": 6,
"reference_accuracy": 0.85,
"duplication_count": 1
}
}
],
"summary": {
"total_issues": 5,
"auto_fixable": 3,
"audit_only": 2
}
}
garden/audit 실행 시 .deep-docs/last-scan.json 확인: