phase-5-validator

phase-5-validator 是一個關鍵的自動化工具，旨在作為軟體開發工作流程結束前的最後一道品質關卡。它針對資深開發人員、DevOps 工程師和自動化代理，確保所有專案產出物符合既定的組織標準。透過執行一系列程式化檢查，該工具可防止不完整的文件、未提交的程式碼或未解決的技術債進入交付階段。它具有阻斷權限，這意味著任何違反強制檢查清單的行為都將阻止工作流程被標記為完成。

• 執行強制性的單一真相來源驗證，以確保各個技能與文件之間不存在 bash、程序或自動化重複。

• 對「經驗教訓」(lessons learned) 文件實施嚴格的檔案大小限制，以維護儲存庫健康並防止技術債累積。

• 驗證版本控制完整性，檢查未提交的 git 變更、提交訊息標準、分支同步狀態以及是否有合併衝突。

• 審核文件完整性，確保檔案註冊表已更新、PROGRESS.md 是最新的、功能文件詳盡無遺，且 CLAUDE.md 得到維護。

• 透過檢查測試套件是否通過、是否存在阻礙性問題以及是否有部署說明，來驗證部署就緒狀態。

• 透過識別暫存檔、工作階段目錄和孤立的專案資產來自動化清理儲存庫。

• 離開代碼 0 表示最終確認成功，離開代碼 1 則表示存在阻礙性違規或品質門檻未通過。

• 對於所有功能開發週期皆為強制性，以確保垂直切片架構的合規性與文件的一致性。

• 當驗證失敗時，代理必須檢查日誌，解決特定的阻礙性違規（例如檔案大小、未提交的變更），然後重新執行驗證器。

• 與 WitchCityRope 代理生態系統直接整合，在所有開發階段提供一致且可重複的成果。

• 要求開發人員維護檔案註冊表、更新部署說明並遵守標準的提交格式，以確保自動化驗證的成功。