Wiki 링크·연결 감사 (2026-05-04)
범위: /Users/a03298/Documents/my-wiki-vault/wiki/ 전체 (403개 .md 파일)
대상: Obsidian wikilink 그래프 5개 차원 점검
검토자: wiki-audit-team / link-connection 리뷰어
TL;DR
| 차원 | 건수 | 우선순위 |
|---|---|---|
| index.md 내 깨진 wikilink | 20 | 🔴 Critical |
| 고아 페이지 (inbound 0) | 2 | 🟢 Low |
| 깨진 wikilink — 진짜 (파일 없음) | 441 | 🔴 High |
| 깨진 wikilink — 형식 (파일 존재, 형식만 잘못) | 179 | 🟡 Medium (자동 수정 가능) |
| index.md 등재 누락 | 59 | 🟡 Medium |
프로젝트 frontmatter related_* dangling | 0 | ✅ 깨끗함 |
| 프로젝트 본문 깨진 링크 | 12 | 🟠 High |
| 미커버 개념 (3회+ 언급, 페이지 없음) | 26 | 🟠 High |
가장 심각한 패턴: index.md 카탈로그가 실제 디스크 상태와 어긋나 있음. log.md 이력에는 vibe-coding·corporate-training·data-warehouse-architecture 등 다수 concept이 “Created”로 기록되어 있으나 현재 파일이 존재하지 않음 → 삭제 후 인덱스 정리 미수행 또는 다른 vault(llm-wiki-vault)로 이동된 흔적으로 추정.
1. 🔴 [Critical] index.md 내 깨진 wikilink (20건)
wiki/index.md는 LLM이 첫 번째로 읽는 카탈로그(index-first retrieval) 페이지인데, 자기 자신이 깨진 링크를 포함하고 있다. 즉시 수정 필요.
| 라인 | 링크 | 추정 원인 |
|---|---|---|
| L8 | “ | Obsidian Bases 플러그인 파일 (.base) — 미존재 |
| L79 | [[concepts/corporate-training]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L80 | [[concepts/ax-education-methodology]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L106 | [[concepts/data-warehouse-architecture]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L107 | [[concepts/query-optimization]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L108 | [[concepts/change-data-capture]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L109 | [[concepts/etl-pipeline]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L119 | [[concepts/blueprints]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L121 | [[concepts/harnessability]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L123 | [[concepts/vibe-coding]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L128 | [[concepts/model-native-harness]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L129 | [[concepts/claude-code-plugin-ecosystem]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L130 | [[concepts/vision-language-action]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L131 | [[concepts/receding-horizon-planning]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L132 | [[concepts/non-verbatim-memorization]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L133 | [[concepts/continual-learning]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L134 | [[concepts/temporal-taskification]] | concept 파일 삭제됨 (log.md에 Created 이력 있음) |
| L413 | nlm-anthropic-openai-google-gemini-ai | comparisons/ 폴더 미존재 (queries/로 통합?) |
| L414 | nlm-atomicbot-hermes-agent | comparisons/ 폴더 미존재 (queries/로 통합?) |
| L415 | nlm-3-openai | comparisons/ 폴더 미존재 (queries/로 통합?) |
조치 권장:
-
concepts/vibe-coding,corporate-training,data-warehouse-architecture등 16개 concept 링크: 페이지 재생성 OR 인덱스에서 제거 결정 -
comparisons/*3건: queries/ 폴더의 동명 파일로 링크 갱신 검토 -
views/projects-active.base: Bases 플러그인 사용 여부 확인 후 제거 또는 생성
2. 🟢 [Low] 고아 페이지 (2건)
어떤 다른 페이지에서도 링크되지 않는 페이지 (index.md, log.md 제외).
_inbox/audit-task2-document-quality-2026-05-04— _inbox 임시 파일이므로 자연스러움 (주기적 정리 대상)_inbox/ingest-queue-2026-04-27— _inbox 임시 파일이므로 자연스러움 (주기적 정리 대상)
조치 권장: _inbox 정리 워크플로 정착 후 자동 처리. views/faqs-and-guides는 형식 정정으로 해소.
3. 🔴 [High] 깨진 wikilink (총 620 인스턴스)
3-A. 진짜 깨짐 (파일 없음) — 상위 25 패턴
| 빈도 | 깨진 타깃 | 대표 위치 |
|---|---|---|
| 29x | [[concepts/vibe-coding]] | log.md:1729 |
| 16x | [[concepts/corporate-training]] | log.md:1986 |
| 14x | [[concepts/data-warehouse-architecture]] | log.md:2031 |
| 13x | [[concepts/ax-education-methodology]] | log.md:1986 |
| 12x | [[concepts/etl-pipeline]] | log.md:2031 |
| 10x | [[concepts/query-optimization]] | log.md:2031 |
| 9x | [[concepts/claude-code-plugin-ecosystem]] | log.md:1942 |
| 8x | [[concepts/change-data-capture]] | log.md:2031 |
| 8x | [[concepts/harnessability]] | log.md:2227 |
| 8x | [[concepts/blueprints]] | log.md:2233 |
| 7x | [[Bloom의 분류법]] | concepts/learning-objectives-abcd.md:40 |
| 6x | [[concepts/vision-language-action]] | log.md:1929 |
| 6x | [[concepts/receding-horizon-planning]] | log.md:1929 |
| 6x | [[concepts/model-native-harness]] | log.md:1959 |
| 6x | [[wiki/concepts/2026-04-02-gemma-4-open-models]] | sources/google-gemma-4-blog-post.md:21 |
| 5x | [[concepts/structured-logging]] | concepts/containerization.md:214 |
| 4x | [[concepts/continual-learning]] | log.md:1834 |
| 4x | [[concepts/temporal-taskification]] | log.md:1834 |
| 4x | [[concepts/non-verbatim-memorization]] | log.md:1925 |
| 3x | [[entities/playwright]] | concepts/playwright-html-to-image.md:17 |
| 3x | [[concepts/hyperparameter-tuning]] | concepts/ml-pipeline.md:210 |
| 3x | [[concepts/measurable-verbs-taxonomy]] | concepts/learning-objectives-abcd.md:262 |
| 3x | [[concepts/llm-fundamentals]] | sources/lora-qlora-insights-from-experiments.md:966 |
| 3x | [[concepts/vector-database-architecture]] | sources/sentence-transformers-sbert.md:370 |
| 3x | [[concepts/mlops-deployment]] | sources/structured-logging-fastapi.md:91 |
전체 244 종 / 441 인스턴스. 다수가 log.md(이력) 내 참조라 사후 정리 가능. 그러나 wiki 페이지 본문 내 참조는 우선 수정 필요.
3-B. 형식 깨짐 (파일 존재, 형식만 잘못) — 상위 패턴
자동 sed 일괄 수정 가능.
| 빈도 | 깨진 타깃 | 정정 형식 |
|---|---|---|
| 24x | [[index]] | [[index]] |
| 21x | [[wiki/teaching/curriculum/lecture-planning-2026]] | [[wiki/teaching/curriculum/lecture-planning-2026]] |
| 10x | [[views/dashboard]] | [[views/dashboard]] |
| 9x | [[views/faqs-and-guides]] | [[views/faqs-and-guides]] |
| 8x | [[99-Archive/projects/phase9-pkm-improvement]] | [[99-Archive/projects/phase9-pkm-improvement]] |
| 6x | [[concepts/DEPENDENCY-TREE]] | [[concepts/DEPENDENCY-TREE]] |
| 5x | [[wiki/teaching/curriculum/lecture-planning-2026]] | [[wiki/teaching/curriculum/lecture-planning-2026]] |
| 5x | [[views/use-cases]] | [[views/use-cases]] |
| 3x | [[concepts/agentic-ai-patterns]] | [[concepts/agentic-ai-patterns]] |
| 3x | log | log |
| 3x | [[99-Archive/projects/phase9-pkm-improvement]] | [[99-Archive/projects/phase9-pkm-improvement]] |
| 3x | [[entities/pinecone]] | [[entities/pinecone]] |
| 3x | [[entities/qdrant]] | [[entities/qdrant]] |
| 3x | [[concepts/agentic-ai-patterns]] | [[concepts/agentic-ai-patterns]] |
| 2x | [[index]] | [[index]] |
전체 179 인스턴스. 패턴: (1) wiki/ 접두어 포함, (2) .md 확장자 포함 — Obsidian 표준 형식 위반.
자동 수정 명령(예시):
# wiki/ 접두어 제거
find wiki -name '*.md' -exec sed -i '' 's|\[\[wiki/|[[|g' {} +
# .md 확장자 제거 (조심 — 일부 의도적일 수 있음)
find wiki -name '*.md' -exec sed -i '' 's|\.md\]\]|]]|g' {} +4. 🟡 [Medium] index.md 등재 누락 (59건)
디스크에는 존재하나 index.md 카탈로그에 등재되지 않은 파일.
_inbox/ (2개)
_inbox/audit-task2-document-quality-2026-05-04.md_inbox/ingest-queue-2026-04-27.md
concepts/ (25개)
concepts/ai-governance-and-compliance.mdconcepts/airflow-dag-design-patterns.mdconcepts/dag-idempotency.mdconcepts/datastage-job-design-troubleshooting.mdconcepts/datastage-parallel-job-architecture.mdconcepts/gen-1-prompt-engineering-learning-objectives.mdconcepts/gen-2-llm-finetuning-learning-objectives.mdconcepts/gen-3-vector-db-learning-objectives.mdconcepts/gen-4-langchain-learning-objectives.mdconcepts/gen-5-rag-pipeline-learning-objectives.mdconcepts/gen-6-ai-agent-learning-objectives.mdconcepts/incident-response-automation.mdconcepts/issue-tracking-system-design.mdconcepts/jira-workflow-optimization.mdconcepts/llmops-lifecycle-and-stack.mdconcepts/module-1-python-learning-objectives.mdconcepts/module-2-eda-learning-objectives.mdconcepts/module-3-ml-dl-learning-objectives.mdconcepts/module-4-fastapi-learning-objectives.mdconcepts/module-5-model-optimization-learning-objectives.mdconcepts/module-6-mlops-learning-objectives.mdconcepts/module-7-mini-project-learning-objectives.mdconcepts/observability-and-monitoring-architecture.mdconcepts/on-call-management-and-escalation.mdconcepts/recommendation-system-architecture.md
entities/ (8개)
entities/agentic-ai-frameworks.mdentities/apache-airflow.mdentities/blooms-taxonomy.mdentities/ibm-qualitystage.mdentities/incident-management-platforms.mdentities/jira.mdentities/recommendation-algorithms.mdentities/workflow-automation-tools.md
insights/ (7개)
insights/airflow-datastage-integration-best-practices-2026-04-25.mdinsights/airflow-idempotency-practical-methods-2026-04-25.mdinsights/dap-pipeline-governance-framework-2026-04-26.mdinsights/data-pipeline-monitoring-automation-integration-2026-04-25.mdinsights/lecture-sources-strategy-synthesis-2026.mdinsights/skala-curriculum-structure-analysis-2026.mdinsights/wiki-health-2026-04-27.md
projects/ (2개)
projects/category-knowledge-bootstrap.mdprojects/lecture-plan-teaching-guide-2026.md
sources/ (15개)
sources/agentic-ai-design-patterns-2026.mdsources/ai-incident-management-platforms-2026.mdsources/airflow-monitoring-observability-slas.mdsources/astronomer-dag-best-practices.mdsources/datastage-developing-parallel-jobs.mdsources/datastage-qualitystage-alphabetical-list-stages.mdsources/datastage-troubleshooting-job-design-issues.mdsources/google-gemma-4-blog-post.mdsources/issue-tracking-best-practices.mdsources/it-issue-tracking-systems.mdsources/jira-efficiency-best-practices.mdsources/llmops-explained-guide-2026.mdsources/recommendation-system-2026.mdsources/top-10-airflow-best-practices-data-engineers.mdsources/workflow-automation-best-practices.md
조치 권장: 카테고리별로 index.md 해당 섹션에 추가. 특히 concepts/module-*-learning-objectives, concepts/gen-*-learning-objectives 13개는 학습 모듈 시리즈로 묶어 별도 섹션 추가 권장.
5. 프로젝트 dangling pulls
5-A. ✅ frontmatter related_* 필드 깨짐: 0건
프로젝트 페이지의 related_concepts/related_sources/related_entities/related_insights 필드는 모두 정상. 좋은 위생 상태.
5-B. 🟠 [High] 프로젝트 본문 깨진 링크: 12건
| 프로젝트 | 라인 | 깨진 링크 |
|---|---|---|
projects/lecture-planning-2026.md | L310 | sources |
projects/llm-wiki-web-service.md | L35 | “ |
projects/llm-wiki-web-service.md | L166 | “ |
projects/phase9-pkm-improvement.md | L313 | [[wiki/syntheses/dap-agentic-ai-integration]] |
projects/phase9-pkm-improvement.md | L318 | [[wiki/syntheses/dap-agentic-ai-integration]] |
projects/pkm-expansion.md | L31 | “ |
projects/pkm-expansion.md | L201 | [[concepts/ax-education-methodology]] |
projects/pkm-expansion.md | L204 | [[concepts/corporate-training]] |
projects/pkm-expansion.md | L205 | [[concepts/data-warehouse-architecture]] |
projects/pkm-expansion.md | L205 | [[concepts/etl-pipeline]] |
projects/pkm-expansion.md | L205 | [[concepts/change-data-capture]] |
projects/pkm-expansion.md | L205 | [[concepts/query-optimization]] |
핫스팟: projects/pkm-expansion.md 7건 — 페이지 본문에서 삭제된 concept(ax-education-methodology, corporate-training 등) 다수 참조.
6. 🟠 [High] 미커버 개념 (26건, 3회+ 언급되었으나 페이지 없음)
log.md(작업 이력) 제외 — 실제 wiki 본문에서 참조된 빈도 기준.
| 언급 횟수 | 참조 파일 수 | 타깃 | 비고 |
|---|---|---|---|
| 23 | 19 | concepts/vibe-coding | |
| 13 | 11 | concepts/data-warehouse-architecture | |
| 11 | 10 | concepts/corporate-training | |
| 11 | 9 | concepts/etl-pipeline | |
| 9 | 8 | concepts/ax-education-methodology | |
| 9 | 9 | concepts/query-optimization | |
| 8 | 5 | concepts/claude-code-plugin-ecosystem | |
| 7 | 7 | concepts/change-data-capture | |
| 7 | 4 | concepts/blueprints | |
| 7 | 4 | concepts/harnessability | |
| 7 | 3 | Bloom의 분류법 | |
| 6 | 1 | raw/articles/2026-04-02-gemma-4-open-models | raw/ 직접 참조 — 보통 sources/로 우회해야 함 |
| 5 | 4 | concepts/model-native-harness | |
| 5 | 3 | concepts/vision-language-action | |
| 5 | 3 | concepts/receding-horizon-planning | |
| 5 | 5 | concepts/structured-logging | |
| 4 | 4 | concepts/hyperparameter-tuning | |
| 3 | 3 | concepts/non-verbatim-memorization | |
| 3 | 2 | concepts/continual-learning | |
| 3 | 2 | concepts/temporal-taskification | |
| 3 | 3 | entities/playwright | |
| 3 | 3 | concepts/measurable-verbs-taxonomy | |
| 3 | 3 | concepts/llm-fundamentals | |
| 3 | 3 | concepts/vector-database-architecture | |
| 3 | 3 | concepts/mlops-deployment | |
| 3 | 3 | concepts/bloom-cognitive-domain |
우선 작성 권장 Top 5 (5회+ 언급, 다중 파일 참조):
concepts/vibe-coding— 23회/19파일 (Karpathy 창시 개념, 핵심)concepts/data-warehouse-architecture— 13회/11파일 (DAP 핵심 개념)concepts/corporate-training— 11회/10파일 (강의 직무 핵심)concepts/etl-pipeline— 11회/9파일 (DAP 핵심 개념)concepts/ax-education-methodology— 9회/8파일 (전임교수 직무 핵심)
이들 모두 log.md 이력에 “Created” 기록이 있으나 디스크에 부재 → 재생성 또는 다른 vault(llm-wiki-vault)에서 복원 필요.
7. 권장 조치 우선순위
즉시 (Critical)
-
index.mdL79~134 깨진 concept 링크 16건: 페이지 재생성 vs 인덱스 정리 결정 -
index.mdL413~415comparisons/*3건: queries/ 폴더로 갱신 -
index.mdL8views/projects-active.base: Bases 플러그인 의존성 정리
단기 (High)
- 미커버 개념 Top 5 페이지 재생성 (
vibe-coding·corporate-training·data-warehouse-architecture·etl-pipeline·ax-education-methodology) -
projects/pkm-expansion.md본문 깨진 링크 7건 정리
중기 (Medium)
- 형식 깨진 wikilink 179건 일괄 sed 수정 (
wiki/prefix·.mdsuffix 제거) - index.md 등재 누락 61건 — 카테고리별 섹션 추가
장기 (Low)
-
_inbox/주기 정리 워크플로 점검 - log.md 내 깨진 링크는 이력 자료라 그대로 두되, lint 시 제외 규칙 추가
8. 산출물 위치
/tmp/wiki-audit/
├─ all-files.txt 전체 .md 파일 목록
├─ all-wikilinks-clean.txt 모든 wikilink 타깃 (정제)
├─ orphans.txt 고아 페이지
├─ broken-real.txt 진짜 깨진 링크 440
├─ broken-format.txt 형식 깨진 링크 179
├─ missing-from-index.txt 인덱스 누락 61
├─ uncovered.txt 미커버 개념
└─ dangling-pulls.txt 프로젝트 dangling 0
재현 스크립트: /tmp/wiki-audit/build_report.py