DragonsHoard 建設歷程
這頁記錄 DragonsHoard 這個系統自己的架構、schema、工作模式演變——不是任何專案的寫作素材，是 Hoard 本身的建設史，屬於常青主題，不隨任何專案歸檔。判斷什麼算「值得記」的門檻見 CLAUDE.md Routing 表。
記錄格式：每筆紀錄應盡量交代三段——背景（為什麼需要改，當時要解決什麼問題或限制）、決策（最後採取什麼做法；若有重要替代方案，可一併記錄取捨理由）、結果（最後實際變成什麼樣，以及產生的影響或副作用）。只有「沒有值得記的替代方案」或「太新還沒有結果」這兩種情況可省略對應部分，其餘情況盡量寫齊。決策過程見 協作與元規則「二十一」。
2026-07-30 之前，這份記錄暫時掛在 iThome 鐵人賽 2026 專案的決策歷程 底下，當時定位是「系列可能用到的一手素材」；2026-07-30 確認這份記錄的真正定位是 Hoard 建設本體，即使 iThome 專案未來歸檔也不該隨之歸檔，因此獨立搬到這個常青主題。iThome 系列若真的引用到這段歷史，仍可以當素材使用，只是記錄本體不再掛在專案底下。
逐字稿見 raw/evergreen/topics/DragonsHoard建設歷程/DragonsHoard架構重新設計對話紀錄.md，需要逐字查證時直接開原檔。
這些決定背後的共同信念與模式，整理成獨立一頁：知識庫建設哲學。
這頁只是路由（2026-08-26 定案）
正文分四個主題檔案，章節編號跨檔案保持全域唯一、不重新編號——引用時一樣寫 [[檔名]]「N」，只是檔名要指到章節實際所在的檔案。拆分過程見「協作與元規則」二十八。
| 章節 | 標題 | 所在檔案 |
|---|---|---|
| 零 | 2026-07-29 起點——把 DragonsHoard 推上 GitHub（原獨立頁面 github-repo-setup.md，2026-09-01 併入當始祖記錄） | 架構與流程 |
| 一～五 | 起點～最終定案（起源敘事，無編號日期） | 架構與流程 |
| 六 | 這份記錄本身的產生過程 | 協作與元規則 |
| 七 | 獨立成常青主題 + 白板工作模式定案 | 架構與流程 |
| 八 | raw 唯讀技術性強制 + 混亂層概念定案 | 架構與流程 |
| 九 | Lint 觸發機制從「靠自己記得」改成 skill 綁 commit | 觸發機制演變 |
| 十 | 混亂層收整成 chaos/ + 單篇任務型捕捉檔規則 | 架構與流程 |
| 十一 | 修正「想法.md」範圍定義 | 架構與流程 |
| 十二 | raw 唯讀改回文件約定 + git diff 事後偵測 | 架構與流程 |
| 十三 | 新增「與 AI 協作的溝通風格」規則 | 協作與元規則 |
| 十四 | 白板 checklist 打勾同步 + 不用跨對話記憶 | 協作與元規則 |
| 十五 | 卡住/決策過多時給最小啟動行為 | 協作與元規則 |
| 十六 | 專案歸檔流程細節定案 | 架構與流程 |
| 十七 | Ingest 觸發點確認 + Claude Code 五層機制模型 | 觸發機制演變 |
| 十八 | Query 觸發機制從無到有 | 觸發機制演變 |
| 十九 | 結構擴張要節制 → 範圍判準優先於經濟判準 | 觸發機制演變 |
| 二十 | 定義「校準」 | 規則品質與判準 |
| 二十一 | 定義建設歷程條目本身該記錄什麼內容 | 協作與元規則 |
| 二十三 | CLAUDE.md 不該內嵌演變歷史 | 協作與元規則 |
| 二十四 | hoard-commit skill 遺漏 chaos/ 的 commit staging 範圍 | 規則品質與判準 |
| 二十五 | 規則有效性判準 | 規則品質與判準 |
| 二十六 | 「觸發評估」本身被判定範圍錯誤，從 Ingest 移除 | 觸發機制演變 |
| 二十七 | log.md 大小／時間雙門檻歸檔機制 | 架構與流程 |
| 二十八 | 建設歷程本身依主題拆成四檔 + 路由頁定案 | 協作與元規則 |
| 二十九 | Hoard 開一個公開網站分支（RambleWiki） | 架構與流程 |
| 三十 | 素材庫（materials/）設計定案與 Telegram 同步實測 | 架構與流程 |
| 三十一 | checkpoint 從各機獨立改為 git 共用，補上「刪除」被 per-machine 設計漏掉的洞 | 架構與流程 |
| 三十二 | Query 補上全文 grep 保底層、查無結果的回報義務、落地建議的機械化門檻 | 觸發機制演變 |
| 三十三 | Query 機制整套重新設計，三層遞進改成三步驟（facet／語意雙路徑＋wikilink 雙向補漏） | 觸發機制演變 |
| 三十四 | CLAUDE.md 新增第三類判準「嚴謹度」，逐條套用重寫既有規則 | 規則品質與判準 |
| 三十五 | 砍掉「Hoard meta 問題主動讀建設歷程」規則，跟 Query 明確觸發合流 | 觸發機制演變 |
| 三十六 | Query 全文 grep 限制撤銷＋落地建議判準刪除 | 觸發機制演變 |
| 三十七 | Ingest 步驟 3、4 之間的分支矛盾 | 規則品質與判準 |
| 三十八 | Query 全文 grep 保底步驟位置修正，從步驟 3 搬到步驟 2 | 觸發機制演變 |
| 三十九 | 新增梗圖庫（memes/） | 架構與流程 |
| 四十 | Query 步驟 1「無條件讀 chaos 全文」刪除，併入 grep 候選分支 | 觸發機制演變 |
| 四十一 | Ingest 觸發前提修正，改成貼上內容/路徑直接觸發 | 觸發機制演變 |
| 四十二 | CRLF/LF 假性 M 反覆復發，拔掉根源（core.autocrlf vs .gitattributes 衝突） | 架構與流程 |
| 四十三 | Query 候選收斂改三類聯集＋90KB 閱讀預算門檻，取代三層遞進 | 觸發機制演變 |
| 四十四 | Lint 從七項模糊健檢重新設計成五項純結構驗證，checkpoint 整個拿掉 | 觸發機制演變 |
| 四十五 | 質疑 A∪B∪C 是否過度設計，決定暫緩裁決、改記錄 backlink 實際命中率 | 觸發機制演變 |
| 四十六 | tag 名稱不合格重複發生，Frontmatter schema 補上標籤語法驗證 | 規則品質與判準 |
| 四十七 | 五層機制模型精修、CLAUDE.md 收錄門檻正式化、八類協作內容分層判斷 | 架構與流程 |
| 四十八 | 真實案例：專案歸檔該不該抽成 Skill，AI 推理錯誤又被糾正 | 規則品質與判準 |
| 四十九 | Ingest／Query／Lint 完整演算法卸載到 Skill | 觸發機制演變 |
| 五十 | raw/ 不變性 invariant 自相矛盾 | 架構與流程 |
| 五十一 | log.md append-only 與歸檔動作矛盾 | 架構與流程 |
| 五十二 | sources／status 兩個 frontmatter 欄位補齊操作型定義 | 規則品質與判準 |
| 五十三 | CLAUDE.md 規則精修連帶修正的四個機制小 bug | 觸發機制演變 |
| 五十四 | 「範圍判準優先於經濟判準」補回操作型定義 | 規則品質與判準 |
| 五十五 | 專案歸檔重新評估後卸載到 hoard-archive skill，翻案「十六」的舊決定 | 架構與流程 |
| 五十六 | Query 從「強制執行程序」轉向「限縮範圍＋輸出約束」，發現 skill 觸發沒有機制連結 | 觸發機制演變 |
| 五十七 | Query 簡化正式落地，查詢報告改為「相關主題→查詢紀錄→答案」三段式防造假設計 | 觸發機制演變 |
| 五十八 | Query 簡化建立的判準回頭套用到其餘六個 skill，補齊兩處未被保障的「不自動觸發」 | 規則品質與判準 |
| 五十九 | 釐清「先讀 index.md」是提供脈絡、不是定義程序，「五十六」原則精確化 | 觸發機制演變 |
| 六十 | telegram_materials_sync.py 從純手動改為 launch script 前景執行一次 | 架構與流程 |
| 六十一 | 新增 hoard-polish／hoard-title 兩個手動觸發 skill，取代潤稿/標題複製貼上流程 | 觸發機制演變 |
| 六十二 | launch-dragonshoard.ps1 的 Telegram 素材同步從自動前景執行改成先詢問是否同步 | 架構與流程 |
| 六十三 | 新增頂層目錄 Clippings/（Obsidian Web Clipper 自動擷取落地區），性質比照 raw/assets/ | 架構與流程 |
| 六十四 | CLAUDE.md「核心架構」瘦身：拆出獨立的「原始來源（raw/）」「Clippings/」兩個 section，砍掉跟樹狀圖重複的 raw/wiki 對稱敘述 | 架構與流程 |
| 六十五 | 混亂層「共通規則」精簡：合併「預設不整理」與「要求時整理成 checklist」兩條、砍掉跟「不要求先分類」重複的待辦特例 | 架構與流程 |
| 六十六 | Promote（chaos → wiki）卸載到 hoard-promote skill，取代混亂層區塊裡的完整步驟 | 架構與流程 |
| 六十七 | raw/assets/ 併入原始來源段落，wiki 直接編輯 改名「正式知識（wiki/）」搬到 raw/ 旁邊，跟 raw/ 對稱 | 架構與流程 |
| 六十八 | 「專案歸檔」CLAUDE.md 觸發指標整個刪除，賭 skill 描述本身足以語意觸發 | 架構與流程 |
| 六十九 | 「正式知識（wiki/）」補回角色定義與內部三大類說明，修正瘦身過度 | 架構與流程 |
| 七十 | entities/ 分類首次落地，定案資料夾＋樞紐頁結構 | 架構與流程 |
| 七十一 | entities/ 分類廢除，唯一案例併回 evergreen/topics/ | 架構與流程 |
| 七十二 | 任務型捕捉檔草稿完成後改歸檔至 raw/，不再一律整份刪除 | 架構與流程 |
| 七十三 | Telegram 素材同步的觸發時機改綁 hoard-pull，拿掉開 session 詢問 | 架構與流程 |
| 七十四 | 公開站排除範圍寫成 CLAUDE.md 執行規則，新增 hoard-public-site-sync skill | 架構與流程 |
| 七十五 | hoard-promote 逐字保留規則加上機械複製與事後 diff 核對，堵住「憑記憶重寫」漏洞 | 觸發機制演變 |
| 七十六 | 新增 raw/雜記寶庫/，收「已影響完、不預期再用」的原始來源 | 架構與流程 |
| 七十七 | CLAUDE.md 依 Global／Routing／Workflow／Object spec 四層重構，新增 .claude/specs/ | 架構與流程 |
| 七十八 | 回溯「七十七」這波重構真正的驅動，浮現「引導 vs. 指令堆疊」判準 | 架構與流程 |
| 七十九 | 以通用模板為鏡做三軸盤點，確立「規則檔只寫行為、連結都不留」 | 規則品質與判準 |
| 八十 | 規格外包——規則不該寫在它所規範的資料檔裡 | 規則品質與判準 |
| 八十一 | 連結檢查長期空轉與唯讀鐵律的範圍矛盾——兩個互相遮蔽的失效 | 規則品質與判準 |
| 八十二 | lint 觸發判斷從 commit 歸位到 lint 自己 | 規則品質與判準 |