200 아토믹 프론트매터 감사 — 전체 자료 색인

감사 완료 날짜: 2026-03-15
건강도: 72/100 (⚠️ 주의)
예상 복구 시간: 15분

빠른 네비게이션

1. 10초 컨설팅 (executive summary)

현재 상황: 519개 파일 중 1,466개 필드(date/maturity/zk_type)에 쿼테이션 마크 오류

해결책: 1. 쿼테이션 제거 (5분) → 건강도 72 → 85 2. category 자동 분류 (3분) → 건강도 85 → 95 3. date 누락 보정 (5분) → 건강도 95 → 98

총 소요: 15분 (전부 자동화 가능)

2. 상세 자료 위치

문서	경로	목적	읽는시간
종합 감사 보고서	`~/knowledge/800 운영/850 실행/frontmatter-audit-2026-03-15.md`	완전한 분석 + 해결책	10분
빠른 참조 카드	`/tmp/QUICK_REFERENCE.txt`	체크리스트 + 커맨드	2분
상세 분석 텍스트	`/tmp/detailed_audit_summary.txt`	섹션별 상세 데이터	5분
이 INDEX	(현재 문서)	자료 네비게이션	3분

3. 분석 스크립트 (재실행 가능)

# 최종 버전 (권장)
python3 /tmp/final_audit_report.py

# 확장 분석
python3 /tmp/audit_frontmatter_v2.py

# 기본 분석
python3 /tmp/audit_frontmatter.py

주요 발견

[우선도 1] YAML 따옴표 오류 (1,466개 필드)

# 현재 (잘못됨)
date: "2026-03-10"
maturity: "seedling"
zk_type: "literature"

# 수정해야 함
date: 2026-03-10
maturity: seedling
zk_type: literature

영향: 488 + 489 + 489 = 1,466개 필드 해결: sed/Python 일괄 처리 (5분) 건강도 개선: 72 → 85

[우선도 2] CATEGORY 누락 (95개 파일)

영향받는 폴더: - 241 프로그래밍: 54개 (49%) ← 가장 심함 - 226 기술: 5개 (50%) - 219 정책: 21개 (31%) - 215 통화: 4개 (21%)

해결: vault_architect Phase 2 실행 (3분) 건강도 개선: 85 → 95

[우선도 3] DATE 누락 (31개 파일)

특징: 주로 INDEX, 오래된 노트들

해결: 파일 메타 기반 자동 보정 (5분) 건강도 개선: 95 → 98

실행 계획

Step 1: YAML 따옴표 제거 (자동)

# 다음 스크립트 작성 필요:
# sed를 이용한 일괄 처리 또는 Python 스크립트
# 범위: ~/knowledge/200 아토믹 의 date/maturity/zk_type 필드

검증: date: "..." → date: ... 형식 확인

Step 2: 유효하지 않은 값 수정 (수동)

수정 대상: - 파일 검색: maturity: "note" → 1개 파일 - 파일 검색: zk_type: "index" → 1개 파일

수정 값: - maturity: "note" → "seedling" 또는 "budding" 또는 "evergreen" - zk_type: "index" → "literature" 또는 "permanent" 또는 "fleeting"

Step 3: CATEGORY 자동 분류 (자동)

vault_architect --phase 2

검증: category 누락 0개 확인

Step 4: DATE 누락 보정 (반자동)

# 옵션 A: 파일 생성 시간 기반 자동 보정
# 옵션 B: 수동으로 각 파일에 date 입력

# 대상: 31개 파일 (주로 INDEX)

완료 체크리스트

[ ] Step 1: YAML 따옴표 제거 스크립트 작성
[ ] Step 1: 일괄 처리 실행
[ ] Step 1: 검증 (date: 형식 확인)

[ ] Step 2: maturity: "note" 수정
[ ] Step 2: zk_type: "index" 수정

[ ] Step 3: vault_architect --phase 2 실행
[ ] Step 3: 검증 (category 누락 0)

[ ] Step 4: DATE 누락 항목 처리
[ ] Step 4: 검증 (date 누락 0)

[ ] 최종 검증: python3 /tmp/final_audit_report.py
[ ] 확인: 건강도 98/100

필드별 건강도

필드	필드보유율	문제	우선도
TAGS	99.8%	없음	✅ 양호
TITLE	74.0%	없음*	✅ 양호
MATURITY	94.2%	쿼테이션 489개	P1
ZK_TYPE	94.2%	쿼테이션 489개	P1
DATE	94.0%	쿼테이션 488개 + 누락 31개	P1+P3
CATEGORY	81.7%	누락 95개	P2

*TITLE은 마크다운 H1 헤더로 대체되므로 실제 누락 없음

폴더별 상태

양호 (category 누락 < 10%): - 220 기업: 218개 (3.7%) - 237 전략: 32개 (0%) - 224 산업: 22개 (4.5%) - 210 원자노트: 14개 (7.1%) - 217 원자재: 11개 (0%)

중간 (category 누락 10-30%): - 215 통화: 19개 (21%)

주의 (category 누락 30-50%): - 219 정책: 67개 (31%)

경고 (category 누락 > 50%): - 241 프로그래밍: 110개 (49%) ⚠️ - 226 기술: 10개 (50%) ⚠️

근본 원인

원인 1: YAML 따옴표 오류

출처: vault_architect 등 자동화 스크립트의 YAML 생성 로직
파일: ~/.openclaw/scripts/vault/vault_architect.py (또는 유사)
문제: 문자열 값을 따옴표로 감싸는 버그
영향: 1,466개 필드
심각도: 높음 (자동 파싱 실패 가능)

원인 2: 자동 분류 미실행

출처: vault_architect Phase 2 미실행
영향: 241 프로그래밍, 226 기술, 219 정책
심각도: 중간

원인 3: 레거시 노트

출처: 구버전 스키마 노트
영향: 31개 파일 (date 누락)
심각도: 낮음

예상 개선 곡선

현재:  72/100 (⚠️ 주의)
Step1: 85/100 (✅ 양호)
Step3: 95/100 (✅ 우수)
Step4: 98/100 (✅ 매우 우수)

총 소요 시간: 15분

최종 검증

감사 스크립트 재실행:

python3 /tmp/final_audit_report.py

기대 결과: - ✅ 건강도: 98/100 - ✅ DATE 쿼테이션: 0개 - ✅ CATEGORY 누락: 0개 - ✅ DATE 누락: 0개 - ✅ MATURITY/ZK_TYPE 유효성: 100%

문서 사용 가이드

상황별 읽기 순서:

5분 이내 이해하기
이 문서 읽기 (지금 하는 것)
/tmp/QUICK_REFERENCE.txt 읽기
완전히 이해하고 싶을 때
frontmatter-audit-2026-03-15.md 읽기 (10분)
/tmp/detailed_audit_summary.txt 읽기 (5분)
데이터 재검증
python3 /tmp/final_audit_report.py 실행
결과 확인
특정 문제 찾기
상세 보고서의 "문제 샘플" 섹션 참조
스크립트 재실행으로 최신 데이터 확인

연락처 및 참고

감사 완료자: Claude Code
감사 날짜: 2026-03-15
차기 재감사: 조치 완료 후 즉시

모든 자료는 /tmp/ 와 ~/knowledge/800 운영/850 실행/ 에 저장되어 있습니다.

준비 상태: ✅ 모든 조치 단계별 계획 완료. 실행 대기 중.

프론트매터 감사 — 전체 자료 INDEX