SOP：把不可見知識編碼進儲存庫

當重要脈絡仍散落在 Google Docs、聊天記錄、ticket 或人的記憶中時，就使用這份 SOP。

目標

讓代理原本看不見的知識，變成儲存庫中可發現的內容，讓新的工作階段不必依賴先前對話也能採取行動。

觸發信號

• 代理持續追問系統如何運作。
• 有人說「這是在 Slack 決定的」或「照某人上週說的做」。
• 審查意見引用了儲存庫中沒有寫下來的產品或安全規則。
• 新工作階段反覆做本來就該已經釐清的探索工作。

執行 SOP

1. 列出所有不可見知識來源，包含外部文件、聊天、預設團隊規則與口頭決策。
2. 逐條判斷它屬於架構、產品行為、安全政策、可靠性要求、計畫脈絡，或參考材料。
3. 依類別編碼到對應的儲存庫工件：
   • 架構 -> ARCHITECTURE.md
   • 產品行為 -> docs/product-specs/
   • 設計理由 -> docs/design-docs/
   • 執行狀態 -> docs/exec-plans/
   • 重複使用的外部參考 -> docs/references/
   • 品質或可靠性要求 -> docs/QUALITY_SCORE.md 或 docs/RELIABILITY.md
4. 把模糊敘述改寫成執行上有用的說法。
5. 移除或標示廢棄的舊副本，讓儲存庫保留單一且可查找的真實來源。

良好的編碼規則

• 為了可發現性而寫，不必追求文句完整。
• 優先使用簡短文件與清楚檔名。
• 相關工件彼此連結。
• 記錄可長期沿用的規則，不要保存會議逐字稿。
• 在做出決策的同一個工作階段更新儲存庫。

完成定義

• 新的代理不需要詢問人，也能找到相關規則。
• 同一個事實不會散落在多個彼此衝突的檔案中。
• 新工件放在它所治理的程式碼或流程附近。