主要功能 / 知識持久化
知識持久化
Heddle 會在工作時學習持久知識，並在未來 session 中回想使用。
總覽
偏好的 ticket 格式、canonical command、recurring convention、architecture note 與 workflow rule 會被 catalog 到 .heddle/memory/，並在未來 session 中恢復使用，不需要重新探索脈絡。
Memory 是本地、可審查的 markdown。Heddle 會在一般工作中記錄 durable memory candidate，接著透過 bounded maintainer path 將 candidate 整理進 discoverable category catalog，例如 preferences、workflows、operations、domain knowledge 與 current state。
什麼適合放進 memory
未來 session 應該重用的 architecture note
Canonical build、test、release 與 verification command
Environment quirk 與 operational caveat
程式碼庫 convention 與 recurring workflow rule
使用者或團隊偏好，例如 ticket 格式與 review style
已完成 implementation 或 investigation work 得到的 durable finding
什麼不適合放進 memory
Memory 不是 scratch space。避免存放 secret、temporary plan、raw chat transcript、speculative guess，或很快就會 stale 的 one-off debugging note。Durable memory 應該幫助未來 session 做得更好，而不是讓它們信任未審查或私密資訊。
Memory structure
.heddle/memory/README.md
.heddle/memory/current-state/
.heddle/memory/workflows/
.heddle/memory/preferences/
.heddle/memory/domain/
.heddle/memory/operations/
.heddle/memory/history/
.heddle/memory/_maintenance/Example learning loop
先教 Heddle 一個可重用偏好，之後開啟另一個 session 並要求相關工作。目標不只是記住一個 fact，而是保存會改變未來回答的 operating style。
Whenever I ask you to create a ticket, use these sections:
problem statement, proposed approach, considered alternatives, conclusion.
# Later:
Create a ticket for maintaining doc consistency after feature updates.Commands
heddle memory status # Show catalog and candidate status
heddle memory list [path] # List memory notes
heddle memory read <path> # Read a memory note
heddle memory search <query> # Search cataloged markdown memory
heddle memory validate [--repair] # Check catalog shape
heddle memory maintain --dry-run # Inspect pending memory candidates