專案文件
工作流程
- 在開始實作或診斷時，先讀取
docs/CURRENT_HANDOFF.md以及穩定文件中相關的部分。 - 將文件中的主張與當前倉庫證據進行比對。
- 在探索或唯讀審查期間，報告文件與事實的偏差，除非用戶授權更改，否則不要編輯文件。
- 在任務開始時，將
CURRENT_HANDOFF.md中的當前目標和下一步行動更新為新內容。 - 在完成可驗證的里程碑後，更新當前狀態與驗證證據；不要在文件中添加時間線。
- 在交接前，移除已完成的流程細節，留下一個可接續的狀態。
- 僅在產品意圖、用戶、範圍、限制條件或驗收標準變更時，才更新
BLUEPRINT.md。 - 僅在元件、邊界、資料流、已驗證的命令、部署、回滾或風險變更時，才更新
ARCHITECTURE.md。 - 在重大交付前，執行
python3 .agents/skills/project-docs/scripts/docs_lint.py。
邊界條件
- 當前的程式碼、測試、配置、命令輸出與用戶指令的優先級高於這些文件。
- BLUEPRINT 保持在 160 行以內。
- ARCHITECTURE 保持在 160 行以內。
- CURRENT_HANDOFF 保持在 80 行以內。
- AGENTS 保持在 90 行以內。
- Git 儲存歷史版本。CURRENT_HANDOFF 僅儲存最新的工作狀態。