deep-docs-workflow

Deep Docs Workflow

이 스킬은 /deep-docs 커맨드에서 로드되어 가드닝 프로세스를 가이드합니다.

참조 문서

• references/scan-rules.md — scan 항목 정의
• references/audit-metrics.md — audit 지표 정의

서브커맨드별 워크플로우

scan 워크플로우

1. doc-scanner 에이전트를 spawn
2. 에이전트가 문서 발견 → 참조 추출 → 참조 검증 → 이동 추적 → 신선도 → 중복 수행
3. 결과를 auto-fix / audit-only로 분류
4. 결과를 .deep-docs/last-scan.json에 저장
5. 리포트 출력

garden 워크플로우

1. .deep-docs/last-scan.json 확인:
   • 존재하고 10분 이내 + HEAD SHA가 현재와 동일 → 재사용
   • HEAD SHA가 다르거나 10분 초과 또는 없음 → 재scan
   • non-git 환경: scanned_at만으로 10분 TTL 판단
2. auto-fix 가능 항목만 추출
3. 각 항목에 대해: a. 수정 내용을 diff 형태로 사용자에게 보여줌 b. AskUserQuestion으로 사용자 확인: "이 수정을 적용할까요?" c. 수락 → Edit tool로 수정 적용 d. 거부 → 건너뜀
4. audit-only 항목은 "참고: 다음 항목은 자동 수정 대상이 아닙니다"로 표시
5. 수정 요약 출력

audit 워크플로우

1. .deep-docs/last-scan.json 확인:
   • 존재하고 10분 이내 + HEAD SHA가 현재와 동일 → 재사용
   • HEAD SHA가 다르거나 10분 초과 또는 없음 → 재scan
   • non-git 환경: scanned_at만으로 10분 TTL 판단
2. audit-metrics.md의 지표 계산:
   • 파일 크기
   • 신선도 (path-scoped)
   • 참조 정확도
   • 중복도
3. 측정 가능한 지표만으로 종합 점수 산출
4. 문서별 상세 리포트 출력

스캔 대상 판단

프로젝트에서 에이전트 지침 문서를 찾는 우선순위:

1. CLAUDE.md (모든 위치)
2. AGENTS.md (모든 위치)
3. README.md (루트)
4. docs/ 내 마크다운
5. CONTRIBUTING.md, ARCHITECTURE.md

없는 파일은 건너뛴다. 최소 1개 파일이 있어야 scan 실행 가능.