7. 멘션 칩으로 페이지 잇기

7.1 칩의 형태

페이지 본문은 그냥 마크다운입니다. 단, 두 가지 링크 패턴은 약속된 의미 를 갖습니다:

어제 [LLM Wiki 가이드](/notes/8b3a-...-uuid) 에서 봤듯이,
원래 출처는 [Karpathy 인터뷰](/raws/c4f1-...-uuid) 였습니다.

• (/notes/UUID) — 다른 페이지 로 가는 칩.
• (/raws/UUID) — 원본 노트 로 가는 칩 (출처 인용).

UI 에서는 일반 마크다운 링크가 아니라 둥근 칩 으로 렌더됩니다. 클릭하면 해당 페이지/노트로 이동.

7.2 AI 는 손으로 칩을 만들지 않습니다

v3 의 모든 조회 MCP 도구 (recall, get_note, get_raw_item, list_recent_notes, list_raws) 는 응답마다 mention_md 필드를 붙여서 줍니다:

{
  "id": "8b3a-...-uuid",
  "title": "LLM Wiki 가이드",
  "mention_md": "[LLM Wiki 가이드](/notes/8b3a-...-uuid)"
}

AI 는 이 문자열을 그대로 본문에 붙여 넣기만 합니다. UUID 를 외워서 손으로 마크다운을 만들지 않습니다 (= 깨진 멘션 발생 0).

7.3 그래프가 자라면 recall 이 빨라집니다

Recall 은 매칭된 페이지에서 끝나지 않고 멘션 칩을 따라 1–2 hop 더 끌어옵니다. 그래서 페이지 사이의 칩이 빽빽할수록:

• 부분만 매칭된 질의 에서도 관련 페이지가 한 묶음으로 따라옵니다.
• 같은 토픽의 시간 흐름 이 자연스럽게 묶입니다 (어제 페이지 → 오늘 페이지의 칩이 자동 연결).
• 린트 의 orphan_notes 신호가 줄어듭니다.

이게 v2 의 벡터 임베딩을 대체하는 메커니즘입니다 — 임베딩 비용 0, 사용자 통제 100%, 카파시 정신 그대로.

7.4 끊긴 멘션은 어떻게 되나

페이지가 삭제되면 그 페이지를 가리키던 칩들은 깨진 상태가 됩니다. 본문은 안 건드립니다 (원본 보존 규약) — 대신 UI 에서 코드 주석 스타일의 // (deleted) 표식으로 비활성 처리됩니다. 린트 의 broken_mentions 규칙이 이걸 한 번에 모아서, 사용자가 칩을 대체 하거나 제거 할지 정하게 도와줍니다.

---