專案大腦

專案大腦是 MindMux 的核心。它既不是筆記本，也不是對話記錄的歸檔，更不是向量資料庫。它是專案持久化、結構化的記憶層。

一個更具體的心智模型

最簡單的理解方式是：

• 根文件描述整個專案
• 頁面記錄具體且穩定的知識單元

在實踐中，一個專案大腦經常長這樣：

brain/
├── background.md
├── architecture.md
├── flow.md
├── mindmap.md
├── stack.md
├── roadmap.md
├── index.md
├── schema.md
├── mindmux.json
├── pages/
│   ├── runtime-profile-model.md
│   └── task-execution-model.md

專案大腦裡有什麼

專案大腦主要由兩層組成：

• 根文件
• 頁面

根文件

根文件是專案級別的固定輸出，包括：

• background
• architecture
• flow
• mindmap
• stack
• roadmap

這些是專案的長期總覽文件。它們會在原地更新，而不是衍生出多個版本。

每一份文件承擔的角色不同：

• background：專案是什麼、面向誰、為什麼存在
• architecture：系統的主要結構
• flow：關鍵的端到端使用者或系統流程
• mindmap：功能或能力地圖
• stack：重要的技術選擇和尚未敲定的決策
• roadmap：短中期方向

頁面

頁面是無上限擴展的結構化知識層。每一頁通常代表一個獨立實體，比如：

• 一個決策
• 一個概念
• 一條專案線索
• 一個人
• 一份參考資料

每個頁面有兩個關鍵部分：

• compiled_truth：整合後的事實，即當前最好的理解
• timeline：時間線，記錄形成這個理解的證據和變更歷史

這是 MindMux 最重要的設計之一：同時保留當前結論，以及通向該結論的路徑。

所以一個頁面同時回答兩個問題：

• “我們當前相信什麼？”
• “我們是怎麼走到這裡的？”

頁面生命週期狀態

每個頁面還攜帶一個生命週期狀態：

• draft（草稿）—— 仍在成形
• active（活躍）—— 當前專案知識
• archived（已歸檔）—— 不再活躍，但保留供歷史追溯

普通讀取和搜尋預設只包含 active 頁面，以保持工作上下文的聚焦。draft 和 archived 頁面仍然儲存在 brain/pages/ 中，可以在需要時顯式調出。

沉澱路徑

理想的知識流動通常是這樣：

Chat discussion
  -> 頁面
  -> 根文件更新

不是每條資訊都必須經過每一層，但這個結構表達了從原始材料到專案事實的典型演進路徑。新頁面可以先以 draft（草稿）狀態存在，成形後再轉為 active（活躍）。

為什麼使用 Markdown

MindMux 選擇 Markdown 和簡單後設資料，是因為專案大腦需要保持：

• 可移植
• 可檢查
• 可版本化
• 可脫離應用編輯

這是產品層面的選擇，不只是儲存實現細節。

專案大腦不是什麼

專案大腦不應該變成：

• 什麼都往裡塞的臨時堆放區
• 檔案上傳桶
• 原始碼控制的替代品
• 只有應用自己能讀懂的黑盒 AI 記憶庫

團隊應該怎樣理解它

最合適的心智模型是：

• 對話是思考發生的地方
• 專案大腦是穩定理解落地的地方

如果一段討論以後要重建起來成本很高，那它很可能應該以某種形式進入專案大腦。