透過系統地圖進行規劃
在開始繪製或建構之前,先建立共同的理解。地圖顯示系統行為;對話則容納討論。規劃絕不授予實作產品的權限。
在開始或恢復規劃之前,請先閱讀規劃指南。它定義了來源格式、零件記錄、導航及檢查項目。有關輔助工具設定與命令,請閱讀 README。
從證據開始
延續對話中唯一儲存的 .plan.json 來源。閱讀其目標、決策、未解決的問題以及目前的規劃位置。在描述現有行為之前,先檢查相關的專案證據。當來源很大時,僅載入目前零件及其相鄰零件。
對於新的對話,請選擇一個獨特且具描述性的來源名稱。切勿覆蓋其他對話的計畫。來源計畫具有權威性;所產生的圖形與清單並非可編輯的計畫。
區分經過驗證的事實、已同意的計畫、未知事項以及未被接受的提議。引用證據。切勿從模糊的標籤推斷先前的決策,或為了填補漏洞而編造事實。
在繪製前先定義意義
對於每個零件,記錄其單一職責、輸入、工作、結果、規則、下一個接收者、邊界及證據。使用指南中定義的欄位名稱。
將儲存與動作分開。區分等待狀態與工作。將每個結果連接到下一個零件預期的輸入。透過連接的零件走一個具體的範例。
使用簡短的標籤和具名箭頭。子頁面說明其父零件。透過明確的 detail 目的地連接它們,切勿使用相符的名稱或猜測的連結。將工具選擇、設計問題及關於已移除功能的評論排除在圖形之外。
協作與推進
先回答當前的問題。在提出另一個問題之前,先閱讀已確定的決策。明確要求的變更會更新來源,同時保留不相關的決策。協議僅接受實際顯示的提案。
在解決一個問題後,繼續朝下一個有意義的未解決零件前進。解釋其目的,提出有根據的方法,然後在會改變設計時,提出一個具體的選擇。不要將規劃變成面試,或在「已儲存」處就停止。
將次要的預設值標記為提案。切勿在未明確討論的情況下決定權限、隱私、成本或事實證據。在推進之前先解決混亂。如果沒有實質性的決策遺留,總結準備情況,並提供審查或另行授權的實作。
在聲稱完成前先行檢查
在變更計畫後,建置它並檢查受影響的連接及子頁面的意義。如果可以存取瀏覽器,也請檢查圖形與導航。誠實地報告無法執行的檢查。
輔助工具測試會檢查結構與產生的輸出,但不會檢查系統的真實性、實際的瀏覽器互動或與每個代理程式框架的相容性。