Context

2026-04-04 Discord 對話,對照 Karpathy LLM Knowledge Bases 概念與 Claude Code best practice,評估 vault 目前資料夾結構是否需要重構。

結論

三層架構正確,不需要重構。 真正的缺口是 workflow,不是結構。

現有架構對照 Karpathy

Karpathy對應 vault狀態
raw/Clippings/正確
wiki/ (per-article)ai/正確,但有命名問題
wiki/ (Q&A 輸出)notes/正確
wiki/ (概念合成)research/正確但孤立、手動
LLM auto-maintained indexinterest-map.md手動維護,缺口

待修問題(優先順序)

高優先 1:ai/ 命名雙軌問題

  • 現狀:ai/ 目錄有 54 個 title-named 舊檔(Clippings-How to Train Your Robots Demonstration Modality.md)+ 432 個 slug-named 新檔(Clippings-how-to-train-your-robots-demonstration-modality.md
  • 根本原因:早期 analyze-vault skill 使用 title 命名,後來改成 slug,舊檔沒有 migrate
  • 後果:interest-map.md 和 research/ 每次引用 ai/ 時要猜命名格式,是今天 37 個 broken link 的根源
  • 修法:一次性把 54 個 title-named 檔案重新命名為 slug 式,並同步更新所有 wikilink 引用

高優先 2:interest-map.md 不自動更新

  • 現狀:/analyze-vault 跑完後,interest-map.md 完全不更新
  • Karpathy 說的:「LLM auto-maintains index files」是 compounding loop 的核心
  • 後果:新增的 100+ 篇 ai/ 分析在 interest-map 裡是看不見的,整個 index 失效
  • 修法:在 /analyze-vault SKILL.md 的最後一步加入「update interest-map」步驟

中優先:沒有概念文章層(concept articles)

  • 現狀:ai/ 每篇只對應一篇來源,缺乏跨文章概念合成
  • Karpathy 說的:wiki 不只有 per-article 分析,還有 LLM 寫的概念文章
  • 修法:Layer 2 semantic linting 的 connection discovery 是解法起點;可考慮加 concepts/ 目錄

低優先:加 concepts/ 目錄

  • 只有在 connection discovery 穩定運作後才有意義,否則是空目錄

Connections