검색, 링크와 지식 관리

문서는 저장하는 것만으로 자산이 되지 않는다. 다시 찾고, 정확한 위치를 가리키고, 다른 문맥에서 재사용하고, 깨진 관계를 고칠 수 있어야 한다. 이 장은 검색에서 링크 작성, embed, graph 탐색과 유지보수까지 하나의 흐름으로 묶는다.

Glif의 LLM Wiki 방향은 이 기반 위에 있다. 현재 실행 가능한 Scope 검색·링크·Graph는 소유자의 지식을 관리하는 표면이고, PB-45 Knowledge Search v1은 heading·metadata·relation을 질문형으로 회수해 작성자와 독자의 최소 경험을 잇는 확장이다. 공개 검색은 아직 사람 release gate 전이므로, 현재 기능과 계획은 Author Search·Public Lens 공개 검색 로드맵에서 구분한다.

해결하는 질문

Scope 전체에서 단어를 찾되 현재 작업 범위 안팎 결과를 어떻게 구분하는가?
문서 전체가 아니라 현재 문단이나 section을 정확히 가리키려면 어떻게 하는가?
link와 embed는 언제 다르게 사용하는가?
[[ 자동완성은 어떤 경로를 제안하며 모호한 이름은 어떻게 처리하는가?
backlink, forward link와 broken link 수가 달라졌을 때 무엇을 먼저 확인하는가?
중복 note와 미연결 언급을 원본 손상 없이 검토하는가?

권장 실습 순서

project-brief.md의 핵심 문장을 Scope 검색으로 찾는다.
검색 결과 snippet과 문서 위치를 확인한다.
현재 section link와 embed를 각각 복사해 project-board.md에 붙여 넣는다.
[[ 입력으로 문서 경로 자동완성을 확인한다.
문서 이름을 바꾼 뒤 broken link와 reference rewrite 결과를 비교한다.
Graph에서 문서 관계를 열고 현재 문서의 heading tree를 보여 주는 Mindmap과 구분한다.
미연결 언급과 추천을 검토하고, 중복 문서를 merged_into stub을 남기며 병합한다.

첫 실습은 Scope 전체 검색과 결과 열기에서 바로 시작할 수 있다. 같은 검색어가 현재 프로젝트 안팎 네 문서에 들어 있는 fixture, 결과 수·snippet 화면과 전체 조작 영상을 함께 제공한다.

이어서 문단·섹션 link와 embed에서 정확한 원문 위치와 재사용을 익히고, 위키링크 자동완성에서 title·alias·path 후보 선택과 동명 문서 구분을 실습한다. 이미 작성된 언급을 제한적으로 연결하려면 자동 링크를 안전하게 적용하기에서 정책 설정, 적용 전후 diff와 한 단계 Undo까지 이어서 확인한다. 연결한 뒤에는 링크 상태와 로컬 그래프 읽기에서 backlink·forward·broken count, 직접 연결 graph와 원문 위치를 점검한다. Binder Graph로 문서 관계 탐색하기에서는 같은 Markdown link를 Scope 전체 관계로 넓혀 허브·고립 문서·로컬 이웃·섹션 index를 찾는다. 마지막으로 지식 연결을 검토하고 정리하기에서 link 문맥 미리보기, 미연결 언급, 추천과 중복 병합을 실제 후보별 action으로 수행한다.

자동 링크의 안전장치

자동 링크는 현재 문서에 무제한으로 관계를 삽입하지 않는다. 전체 on/off, 문서당·block당 최대 수, heading·table 제외와 모호한 후보 건너뛰기 정책을 먼저 설정한다. 적용 뒤에는 Markdown diff와 링크 목적지를 확인하고 필요하면 undo한다.

유지보수 결과

Link Health는 count만 보여 주는 dashboard가 아니라 깨진 위치를 열고, 미연결 언급을 변환·숨기고, 중복을 merged_into stub으로 보존하는 작업면이다. 독립적인 삭제 도구처럼 사용하지 않는다.

현재 빠른 레퍼런스는 지식 그래프에서 확인할 수 있다. 보기 선택 기준은 Projection 레퍼런스로 이어진다.

검색·링크·그래프의 실제 화면

검색 결과, 정확한 reference, 관계 graph는 같은 Markdown을 서로 다른 방식으로 회수하는 표면이다.

관계를 만들고 검증하는 순서

Scope 검색으로 대상 문장과 파일 경로를 찾는다.
문단·section·block 중 필요한 anchor를 선택한다.
link와 embed 중 원문을 재사용할지 참조만 남길지 결정한다.
wikilink 자동완성 후보가 title·alias·path 중 무엇으로 선택됐는지 확인한다.
rename 뒤 reference rewrite와 code block 예외를 대조한다.
Link Health에서 broken 위치를 열고 Graph의 파생 node와 원문 link를 구분한다.
자동 링크·중복 병합은 적용 전 diff와 한 단계 undo를 보존한다.

검색어, 선택된 node, filter와 lightbox는 session 상태일 수 있다. 검색 결과 수나 graph layout을 publish된 사실처럼 기록하지 않는다.

이 장의 완료 기준

파일명 검색과 본문 검색을 구분한다.
link·embed·wikilink의 원문 변화를 확인했다.
rename 뒤 reference rewrite와 rollback을 확인했다.
broken link의 실제 위치를 열었다.
자동 링크와 duplicate merge를 diff·undo와 함께 검토했다.