wayfinderlisted

一個鬆散的點子來了——大得單一代理 session 裝不下，而且籠罩在迷霧中：從這裡到**目的地**的路徑還看不見。尋路是關於找出那條路徑，而不是朝目的地衝刺。這個技能把路徑繪製成 repo Issue 追蹤器上的**共享地圖**，然後逐一處理它的**決策 tickets**——其解決是決策、而非待執行的建置切片的問題——直到路線清晰為止。 目的地因努力而異，而為它命名是繪圖的第一個動作——它會塑造每一張 ticket。它可能是要交接並反覆迭代的規格說明、要在規劃開始前鎖定的決策，或是一項就地完成的變更，例如資料結構遷移。地圖與領域無關——工程工作、課程內容，任何符合這個形狀的東西都行。 ## 規劃，而非動手 Wayfinder 預設是**規劃**：每張 ticket 解決一個決策，而當地圖清晰時就完成了——在有人去做這件事之前，沒有什麼需要再決定。那股只想動手做的衝動，通常就是你已經到達地圖邊緣、該交接的訊號。一次努力可以在它的 **Notes（備註）** 中推翻這個預設——把執行帶進地圖本身——但若沒有這樣做，產出的是決策，而非交付物。 ## 用名稱引用 每張地圖與每張 ticket 都是一個 issue，所以它有個**名稱**——它的標題。在人類閱讀的一切中——敘述、地圖的 Decisions so far——都用那個名稱引用它，絕不用孤伶伶的 id、編號或 slug。一整面 `#42, #43, #44` 難以閱讀；名稱則一眼就能看懂。id 與 URL 不會消失——名稱包裹著它的連結——但它們待在名稱*裡面*，絕不代替名稱。 ## 地圖 地圖是這個 repo Issue 追蹤器上單一的 issue，標籤�� `wayfinder:map`——正式產物。它的 tickets 是地圖的子 issues。 地圖是**索引**，不是儲存庫。它列出已作的決策，並指向持有其細節的 tickets；一個決策只住在一個地方——它的 ticket——所以地圖絕不重述它，只摘要並連結它。 **地圖、它的子 tickets、阻塞與前沿查詢實際存在哪裡，是追蹤器特定的。** Issue 追蹤器應該已經提供給你——如果沒有，執行 `/setup-matt-pocock-skills`。查閱追蹤器文件的「Wayfinding operations」區段，了解*這個* repo 如何表達它們。如果沒有提供追蹤器，預設使用本機 markdown 追蹤器。 ### 地圖內文 整張地圖以低解析度呈現，每個 session 載入一次。開放的 tickets **不**被列出——它們是開放的子 issues，靠查詢找到。 ```markdown ## Destination <what reaching the end of this map looks like — the spec, decision, or change this effort is finding its way to. One or two lines; every session orients to it before choosing a ticket.> ## Notes <domain; skills every session should consult; standing preferences for this effort> ## Decisions so far <!-- the index — one line per closed ticke