← 타임테이블 4-1 · 모듈 ④ · 연결망과 점검 ← → 넘기기 · F 전체화면 · Esc 목차 1 / 1
4-1 · 2:55 – 3:25 · 30분

④ 연결망으로 보는
나만의 지식 위키 완성하기

3 · 점검 LintObsidian 그래프 읽기
4-1 · 2:55 – 3:25 · 30분

이런 걸 배워요

- Obsidian 그래프로 연결 읽는 법 - 끊긴 링크·연결 안 된 문서·프론트매터 누락 점검하기 - 좋은 답을 저장할수록 촘촘해지는 위키

이런 걸 해봐요

- 그래프 읽는 방법 배우기 - 도전 과제 - 끊긴 링크 0, 연결 안 된 문서 0 - 내 전공에 맞게 규칙을 바꿔보기

지금 하는 작업

3 · 점검 (Lint)

스킬AI에게 "이런 일은 이렇게 처리해라"를 적어 둔 문서. 코드가 아니라 사람이 읽을 수 있는 한국어·영어 문장이라, 열어서 고칠 수 있습니다. skill

그래프 읽는 법

그래프에서 세 가지가 보입니다

Obsidian 그래프 뷰
가운데 붉은 점이 목차입니다. 떨어져 있는 점은 아직 어디에서도 연결되지 않은 문서입니다

그래프에서는 무엇이 중심이고 무엇이 겉도는지가 보입니다.

크고 진한 점

중심 개념

여러 문서가 참조하는 개념. 내 관심의 축입니다.

혼자 떨어진 점

연결 안 된 문서

어디서도 이어지지 않은 문서. 만들어 두고 잊힙니다.

끊어진 선

끊긴 링크

없는 문서를 가리키는 링크. 눌러도 이동하지 않습니다.

그래프에 점이 안 보이면 손을 들어 주시고, FAQ 6 · 그래프 도 참고해 주세요.

연결 안 된 문서다른 어떤 문서에서도 가리키지 않는 문서. 만들어 두고 잊히기 쉽습니다. 영어 자료에서는 orphan 이라고 부릅니다.

끊긴 링크존재하지 않는 문서를 가리키는 링크. 눌러도 아무 데도 가지 않습니다.

도전 과제

끊긴 링크 0
연결 안 된 문서 0

0
끊긴 링크
0
연결 안 된 문서
0
프론트매터 누락
0
출처 누락

네 항목을 모두 0으로 만들면 오늘의 위키는 완성입니다.

지식 그래프라는 개념 자체가 궁금하면 더 알아보기 에 정리해 두었습니다.
1단계

먼저 개수를 확인합니다

이렇게 말하세요위키 점검해 줘

네 항목이 몇 건씩 걸리는지, 어느 문서가 문제인지 알려 줍니다.

저장소에 점검 도구도 함께 들어 있습니다. 결과는 같고, 직접 돌려 보고 싶으신 분들을 위해 넣어 두었습니다.

점검문서들이 규칙에 맞는지, 링크가 제대로 이어져 있는지 기계적으로 훑어보는 일. 프로그램 세계에서는 lint 라고 부릅니다.

2단계

다양한 방법으로 고칠 수 있습니다

걸린 것왜 생기나어떻게 고치나
연결 안 된 문서목차나 다른 문서에서 아무도 이 문서를 가리키지 않음 관련 문서에 링크를 걸거나 목차에 추가합니다. "이 문서를 관련 개념과 이어 줘"라고 해도 됩니다.
끊긴 링크아직 만들지 않은 문서를 가리킴 그 문서를 만들거나, 링크를 지웁니다. 만들 만한 개념이면 만드는 쪽이 낫습니다.
프론트매터 누락맨 앞 type이 빠짐 "프론트매터 없는 문서에 type 채워 줘"라고 하면 한 번에 처리됩니다.
출처 누락어느 원문에서 왔는지 표시가 없음 원문을 확인해 붙이거나, 근거가 없는 문장이면 지웁니다.
3단계

고치고 다시 확인합니다

한 번에 0이 되지는 않습니다. 고치고 확인하기를 몇 번 반복합니다.

연결 안 된 문서를 없애려고 아무 문서에나 링크를 걸면 그래프만 촘촘해지고 쓸모는 없어집니다. 실제로 관련 있는 것끼리만 이어 줍니다. 링크는 "이 둘은 함께 봐야 한다"는 표시입니다.
한 걸음 더 · 여유가 되면

규칙 파일을 열어 봅니다

앞에서 세 층 구조를 봤습니다. 그 3층(규칙)이 바로 이 파일입니다.

지금까지 AI가 따른 규칙이 .claude/skills/okf-wiki/SKILL.md 에 적혀 있습니다. 코드가 아니라 사람이 읽는 문장입니다. Obsidian에서 그대로 열립니다.

## 철칙
1. type frontmatter 필수 — 없으면 OKF 위반.
2. 연결 누락 금지 — 모든 문서는 index.md에서 도달 가능.
3. 출처 추적 — 사실 단락 끝에 (raw/...) 표기.
   원문에 없는 내용 지어내기 금지.
4. 상호링크 — 관련 개념은 [[wiki/...]] 로 연결.
5. raw/ 는 절대 수정하지 않는다.
프론트매터가 붙은 것도, 출처가 달린 것도, raw/ 가 그대로인 것도 이 다섯 줄 덕분입니다.
한 걸음 더 · 여유가 되면

내 전공에 맞게 규칙을 바꿔보기

정리 규칙(스킬)은 .claude/skills/okf-wiki/SKILL.md 에 있습니다. 텍스트 파일이라 열어서 고칠 수 있습니다.

바꿀 수 있는 것

프론트매터 종류 추가 (예: 논문용 paper), 항상 넣을 항목 지정, 문서 길이 규칙.

바꾸는 방법

직접 고쳐도 되고 부탁해도 됩니다. "논문용 프론트매터를 추가하게 규칙 고쳐 줘"

바꾼 규칙은 다음 정리부터 적용됩니다. 기존 문서까지 맞추려면 "기존 문서도 새 규칙에 맞게 고쳐 줘"라고 합니다.
확인

완성 기준

  • 점검을 돌려 네 항목의 숫자를 확인했다
  • 연결 안 된 문서를 관련 개념과 이어 줬다
  • 끊긴 링크를 없앴다
  • 다시 점검했을 때 모두 0이 나왔다
  • 그래프 화면을 캡처해 두었다 (다음 시간에 씁니다)
숫자가 0이 안 되어도 괜찮습니다. 어디가 비어 있는지 알게 된 것이 이 시간의 결과입니다.
이 모듈 끝

다음으로