200 아토믹 프론트매터 전수 감사
날짜: 2026-03-15
대상: ~/knowledge/200 아토믹 (519개 파일)
건강도: 72/100 (⚠️ 주의 — 구조적 수정 필요)
핵심 발견사항
| 항목 | 상태 | 영향 | 우선도 |
|---|---|---|---|
| DATE 쿼테이션 마크 오류 | ❌ 높음 | 488/519 (94.0%) | ⭐⭐⭐⭐⭐ |
| MATURITY/ZK_TYPE 쿼테이션 | ❌ 높음 | 489/519 (94.2%) | ⭐⭐⭐⭐⭐ |
| CATEGORY 누락 | ❌ 중간 | 95/519 (18.3%) | ⭐⭐⭐⭐ |
| DATE 누락 | ⚠️ 낮음 | 31/519 (6.0%) | ⭐⭐⭐ |
1. 주요 이슈
[우선도 1] DATE/MATURITY/ZK_TYPE 쿼테이션 마크 오류
상황
# 현재 (잘못됨)
date: "2026-03-10"
maturity: "seedling"
zk_type: "literature"
# 수정해야 함
date: 2026-03-10
maturity: seedling
zk_type: literature
영향 - 494개 파일의 date 필드 (94.0%) - 489개 파일의 maturity 필드 (94.2%) - 489개 파일의 zk_type 필드 (94.2%)
원인: vault_architect 등 자동화 스크립트의 YAML 생성 로직 버그
해결책: 일괄 정규화 스크립트 필요
[우선도 2] CATEGORY 필드 누락
문제 노트: 95개 (18.3%)
폴더별 누락 현황:
241 프로그래밍: 54/110 (49.1%) ← 가장 심함
226 기술: 5/10 (50.0%)
219 정책: 21/67 (31.3%)
215 통화: 4/19 (21.1%)
220 기업: 8/218 (3.7%)
현재 category 분포: - "기업": 227 (43.7%) ✓ - "시장": 64 (12.3%) ✓ - "프로그래밍": 39 (7.5%) ✓ - "경제/주식/국제정세/사회": 22 (4.2%) - "산업분석": 18 (3.5%) - "인사이트": 18 (3.5%) - "UNCLASSIFIED": 8 (1.5%) - 기타 소수 카테고리
해결책: vault_architect Phase 2 재실행 (자동 분류)
[우선도 3] DATE 필드 누락
문제 노트: 31개 (6.0%)
특징 - 주로 INDEX, 오래된 노트들 - 구버전 스키마로 작성된 노트
해결책: 파일 생성 시간 기반 자동 보정 또는 수동 입력
2. 필드별 상세 상태
✅ TITLE 필드 — 양호
- 필드 보유: 384/519 (74.0%)
- 빈 값: 0개
- 참고: 마크다운 본문의 H1 헤더로 대체되므로 실제 누락 없음
✅ TAGS 필드 — 매우 양호
- 필드 보유: 518/519 (99.8%)
- 빈 값: 0개
- 상태: 거의 완벽
❌ DATE 필드 — 문제 있음
- 필드 보유: 488/519 (94.0%)
- 쿼테이션 마크 오류: 488개 ⚠️
- 누락: 31개
❌ CATEGORY 필드 — 문제 있음
- 필드 보유: 424/519 (81.7%)
- 누락: 95개 (18.3%)
❌ MATURITY 필드 — 데이터 타입 오류
- 필드 보유: 489/519 (94.2%)
- 쿼테이션 마크 오류: 489개 ⚠️
- 분포:
- "seedling": 351개 ✓
- "evergreen": 83개 ✓
- "budding": 41개 ✓
- "growing": 13개 (비표준이지만 허용)
- "note": 1개 ❌ (수정 필요)
❌ ZK_TYPE 필드 — 데이터 타입 오류
- 필드 보유: 489/519 (94.2%)
- 쿼테이션 마크 오류: 489개 ⚠️
- 분포:
- "literature": 297개 ✓
- "fleeting": 170개 ✓
- "permanent": 21개 ✓
- "synthesis": 0개 (없음)
- "index": 1개 ❌ (수정 필요)
3. 카테고리별 세부 분석
| 폴더 | 파일수 | category 누락 | date 쿼테이션 | 상태 |
|---|---|---|---|---|
| 220 기업 | 218 | 8 (3.7%) | 195 (89%) | ✓ 양호 |
| 241 프로그래밍 | 110 | 54 (49.1%) | 110 (100%) | ❌ 주의 |
| 219 정책 | 67 | 21 (31.3%) | 67 (100%) | ⚠️ 중간 |
| 237 전략 | 32 | 0 (0.0%) | 32 (100%) | ✓ 양호 |
| 224 산업 | 22 | 1 (4.5%) | 20 (91%) | ✓ 양호 |
| 215 통화 | 19 | 4 (21.1%) | 19 (100%) | ⚠️ 중간 |
| 210 원자노트 | 14 | 1 (7.1%) | 14 (100%) | ✓ 양호 |
| 217 원자재 | 11 | 0 (0.0%) | 11 (100%) | ✓ 양호 |
| 226 기술 | 10 | 5 (50.0%) | 10 (100%) | ❌ 주의 |
4. 근본 원인 분석
원인 1: YAML 따옴표 오류
- 근원: vault_architect 등 자동화 스크립트의 YAML 생성 로직
- 영향: date, maturity, zk_type 총 1,476개 필드
- 심각도: 높음 (자동 파싱 실패 가능)
- 해결책: YAML 생성 코드 수정 (문자열 값에서 따옴표 제거)
원인 2: 자동 분류 미실행
- 근원: vault_architect Phase 2 미실행 또는 오류
- 영향: 241 프로그래밍, 226 기술, 219 정책 폴더의 category 누락
- 심각도: 중간
- 해결책: Phase 2 수동 실행 또는 자동화 재개
원인 3: 레거시 노트
- 근원: 구버전 스키마로 작성된 노트들
- 영향: 일부 date 누락 (31개)
- 심각도: 낮음
- 해결책: 수동 보정 또는 파일 메타데이터 활용
5. 권장 조치 (실행 순서)
Step 1: DATE/MATURITY/ZK_TYPE 쿼테이션 제거 (자동)
# 488개 파일의 쿼테이션 마크 일괄 제거
# sed 또는 Python 스크립트로 처리 가능
- 범위: 488 + 489 + 489 = 1,466개 필드
- 시간: ~5분
- 우선도: ⭐⭐⭐⭐⭐ (매우 높음)
- 예상 효과: 건강도 72 → 85
Step 2: 유효하지 않은 값 수정 (수동)
- maturity: "note" (1개) → seedling/budding/evergreen 중 선택
- zk_type: "index" (1개) → literature/permanent/fleeting/synthesis 중 선택
- 시간: 1분
- 우선도: ⭐⭐⭐⭐
Step 3: CATEGORY 자동 분류 (자동)
vault_architect --phase 2 --auto-classify
- 범위: 95개 파일
- 시간: 2~3분
- 우선도: ⭐⭐⭐⭐
- 예상 효과: 건강도 85 → 95
Step 4: DATE 누락 항목 보정 (반자동)
- 범위: 31개 파일
- 옵션:
- a) 파일 생성 시간 기반 자동 보정
- b) 관리자 수동 입력
- 우선도: ⭐⭐⭐ (중간)
- 예상 효과: 건강도 95 → 98
6. 개선 효과 예측
현재 상태: 72/100 (⚠️ 주의)
↓
Step 1: 85/100 (✅ 양호) — 쿼테이션 제거
↓
Step 2-3: 95/100 (✅ 우수) — category 완성
↓
Step 4: 98/100 (✅ 매우 우수) — date 완성
7. 검증 방법
수정 후 감사 재실행:
python3 /tmp/audit_frontmatter.py
기대 결과: - ✅ DATE 쿼테이션 오류: 0개 - ✅ MATURITY/ZK_TYPE 쿼테이션 오류: 0개 - ✅ CATEGORY 누락: 0개 - ✅ DATE 누락: 0개 (Step 4 완료 시) - ✅ 건강도: 98/100
첨부 자료
- 감사 스크립트:
/tmp/audit_frontmatter.py - 상세 보고서:
/tmp/detailed_audit_summary.txt - 문제 샘플: 상기 섹션 3 참조
감사 완료자: Claude Code
감사 날짜: 2026-03-15
차기 감사: Step 1-4 완료 후 (예상: 2026-03-16)