軟體工程
規劃軟體架構決策
一項有紀錄的架構決策:依明確限制比較方案、記錄後果,並在實作前指定驗證檢查點。
流程
照這個順序做。
- 說明決策、脈絡、受影響使用者、具有架構重要性的需求、時間範圍,以及誰可以核准這項選擇。
- 收集產品、儲存庫、可靠性、安全、成本與合規的相關限制,並將已核實事實與假設及未知事項分開。
- 至少定義兩個可行方案以及不採取行動,並以明確標準比較,而非依熟悉程度選擇。
- 以失敗模式、遷移工作量、營運負擔、可逆性、安全曝險與長期變更成本壓力測試每個方案。
- 選擇建議或明確記錄延後決策,並附理由、異議、被拒方案,以及會改變決策的條件。
- 在實作開始前,寫入包含狀態、脈絡、決策、後果、證據連結、負責人與複核觸發條件的決策紀錄。
- 與負責人複核紀錄,記錄核准或必要條件,並將成品、證據與未解決風險交回請求者。
先準備
貓會向你要的輸入。
- 架構決策與決策負責人
- 需求與限制
- 目前系統與版本
- 可用證據與複核利害關係人
路由器 + 一份 playbook
先路由。只選一份。
Cat Paw 每次任務只載入一份 playbook,不合併多份。先走這個路由器;其餘路徑是此 workflow 可檢查的候選。
- 路由器:
software-delivery-pack skills/software-delivery-pack/software-architecture-decision-gate/SKILL.md
界線
界線跟著提示一起走。
- 開始前先核實實際的工具、帳戶、權限與工作區;絕不聲稱擁有不可用的工具、帳戶、來源或能力。
- 私有程式碼、成品、即時探測或非公開資料請使用 Latch/target-workspace;若無法存取,就在邊界停下並回報阻礙,不可改用猜測。
- 任何有後果的外部行動前先暫停並取得明確核准;回傳證據、未解決風險、假設,以及仍在等待核准的行動。
完成代表
一個可核對的終點。
已核准或明確延後的架構決策紀錄包含脈絡、方案、理由、後果、負責人、證據與複核觸發條件。
來源
這個流程從哪來。
來源確立 workflow 的模式。若有 Reddit 或社群貼文,視為實務軼事,不是普遍事實。