Claude Code 開發的分形文檔架構

來源: @chunxiangai | 原文連結
日期: Sun Dec 21 17:47:29 +0000 2025
標籤: 知識管理 文檔組織 Claude Code

來源: @chunxiangai (赵纯想)
日期: 2025-02-01
標籤: claude-code 文檔架構 開發工作流 自指系統

核心概念

在 Claude Code 開發中實現分形文檔結構，通過多層級的自指設計，讓局部與整體相互影響，形成自我維護的文檔系統。這種架構靈感來自《哥德爾、埃舍爾、巴赫》中提到的「複調」與「自指」概念。

層級	位置	內容要求	自指機制
根目錄主文檔	專案根目錄 `.md`	強調功能、架構、寫法更新必須同步更新相關子文檔	工作結束後必須更新
資料夾架構說明	每個資料夾內 `.md`	3 行以內極簡架構說明 + 每個檔案的名稱、地位、功能	開頭聲明：一旦資料夾有變化，請更新我
檔案開頭註釋	每個檔案開頭	三行極簡註釋：Input / Output / Position	開頭聲明：一旦我被更新，請更新我的註釋及所屬資料夾的 md

每個檔案開頭必須包含三行極簡註釋：

javascript

// Input: 依賴外部的什麼（例如：config.json, database connection）
// Output: 對外提供什麼（例如：API endpoints, utility functions）
// Position: 在系統局部的地位（例如：核心路由層、資料轉換中介層）

★ Insight ─────────────────────────────────────

自蔓延更新機制：每次修改會自動觸發相關文檔的更新需求，形成從局部到整體的連鎖反應
雙向影響：局部影響整體（檔案更新 → 資料夾文檔 → 根目錄），整體影響局部（架構調整 → 資料夾說明 → 檔案註釋）
複調與自指：每個層級都在描述自己，同時也在描述其他層級，形成相互印證的文檔網絡 ─────────────────────────────────────────────────

這種架構的美在於：