vault-health

name	vault-health
description	네이밍·메타데이터·링크·깊이 위생 점검

볼트 점검

목적

[볼트명] 볼트의 구조적 건강 상태를 점검하고 문제를 보고한다.

절차

1. 파일명 규칙 점검

• 모든 .md 파일이 YYMMDD-제목.md 형식을 따르는지 확인한다.
• 예외: tpl-, README.md, CLAUDE.md, SKILL.md, MAP-스킬.md, S{NN}-*-plan.md, S{NN}-*-record.md
• 위반 파일 목록을 작성한다.
• 구 네이밍(OPS-DOC-, _live, _arch 접미사) 잔존 여부를 확인한다.

2. Frontmatter 점검

• 모든 .md 파일의 frontmatter에 title, status, created가 있는지 확인한다.
• status 값이 draft | live | archived 중 하나인지 확인한다.
• 구 frontmatter 필드(id, area, unit, visibility, state, version) 잔존 확인.

3. 폴더 깊이 점검

• 5레벨 초과 경로를 탐지한다.
• _system/rules.md의 깊이 규칙 참조.

4. 빈 파일/폴더 탐지

• frontmatter만 있고 본문이 없는 파일.
• .md 파일이 하나도 없는 폴더 (assets 폴더 제외).

5. 위키링크 점검

• [[깨진링크]] 탐지 (대상 파일이 존재하지 않는 경우).

6. 중첩 복사본 감지

• 05_library/seasons/ 내부에 현재 구조와 동일한 중첩 복사본이 있는지 확인한다.

7. 절대경로 감지

• .claude/ 및 _system/ 파일에서 /Users/ 등 절대경로가 있는지 확인한다.

8. up: 누락 점검

• 볼트 전체 활성 .md 파일에서 up: 필드가 없는 파일을 탐지한다.
• 아래 명령으로 up: 없는 파일 목록을 추출한다:

  # up: 필드가 있는 파일 목록
  grep -rl "^up:" . --include="*.md" > /tmp/has_up.txt
  # 전체 .md 파일 목록과 비교
  

• 예외 (up: 없어도 정상인 파일):
  • CLAUDE.md, README.md (볼트 루트)
  • MOC-홈.md (최상위 허브, 의도적으로 up: 없음)
  • 01_ops/templates/tpl-*.md (템플릿은 빈 상태가 정상)
  • 05_library/seasons/2025-pre/ 아카이브 전체
• 위반 파일은 CRITICAL로 보고.

9. 고아 파일 점검

• 다른 어떤 파일에서도 [[wikilink]]로 참조되지 않는 파일을 탐지한다.
• 아래 절차로 확인:
  1. 대상 파일명(확장자 제외)을 추출
  2. grep -r "\[\[파일명\]\]" 으로 역참조 존재 여부 확인
  3. 역참조 0개인 파일 = 고아
• Obsidian CLI 활용:

  obsidian backlinks file="파일명"
  

  backlinks가 없으면 고아로 판정.
• 예외: MOC-홈.md, CLAUDE.md, README.md (루트), INDEX-MEMBER.md
• 고아 파일은 WARNING으로 보고 (삭제 아님 — 링크 추가 권고).

10. 태그 레지스트리 검증

정본 레지스트리: _system/obsidian/tag-registry.md. 상세 감사는 /tag-audit 스킬로 수행한다.

일반 .md 파일

• 볼트 전체에서 사용된 태그를 수집하고 레지스트리와 비교한다.
• 미등록 태그: 레지스트리에 없는 태그 → WARNING
• 사용 안 된 태그: 레지스트리에는 있지만 볼트에서 0번 사용 → INFO
• 05_library/seasons/2025-pre/ 아카이브의 태그는 검사 제외.

사이드카 .md 파일 (*.jpeg.md, *.jpg.md, *.png.md, *.webp.md)

• 별도 규약 적용: studio/*, style/*, session/* 네임스페이스 태그만 허용.
• 평탄 태그(lego, character, toy-photo 등) → CRITICAL
• 규약 정본: 04_studio/brand/lego/프롬프트-사이드카-규약.md

11. 결과 저장

_system/obsidian/audits/YYMMDD-vault-health.md 파일로 저장한다. frontmatter·섹션 구조는 [[_system/obsidian/audits/README|진단 감사 저장 규약]]을 따른다.

필수 필드:

• source_skill: vault-health
• kind: audit
• area: system
• up: "[[MAP-시스템]]"

본문 구조: 요약 → CRITICAL → WARNING → INFO → 이행 항목

• 카테고리별 위반 수 + 구체적 파일 목록
• 심각도: CRITICAL / WARNING / INFO
• CRITICAL: 파일명 규칙, frontmatter 필수 필드, up: 누락
• WARNING: 고아 파일, 깨진 위키링크, 미등록 태그
• INFO: 빈 파일, 사용 안 된 태그, 기타

주의사항

• 05_library/seasons/2025-pre/ 아카이브는 구명칭이 남아 있어도 WARNING으로만 보고.
• _system/ 거버넌스 파일(CLAUDE.md, rules.md, identity/ 폴더)은 직접 수정하지 않고 보고만 한다.