wayfinder

name	wayfinder
description	把单个 agent session 装不下的一大块工作规划成 issue tracker 上的 decision tickets shared map，并逐一解决，直到通往 destination 的路清晰。
disable-model-invocation	true

一个松散想法出现了：它太大，单个 agent session 装不下，而且被 fog 包围；从这里到 destination 的路还看不见。Wayfinding 的目标是找到这条路，而不是朝 destination 猛冲。这个 skill 会把路径绘制成 repo issue tracker 上的 shared map，然后逐个处理 decision tickets——它们承载需要决策才能解决的问题，而不是要执行的 build slices——直到路线清晰。

不同 effort 的 destination 不同，而为它命名是 charting 的第一个动作；它塑造每个 ticket。它可能是一份要 hand off 并迭代的 spec、一个必须在 planning 前确定的 decision，或 data-structure migration 之类原地完成的 change。Map 与领域无关：engineering work、course content，或任何符合这个形状的事项都可以。

Plan, don't do

Wayfinder 默认用于 planning：每个 ticket 解决一个 decision；当别人动手前已经没有任何事情需要决定、路径完全清晰时，map 才算完成。想直接做工作的冲动通常表示你已经到达 map 边缘，该 hand off 了。Effort 可以在 Notes 中覆盖这个默认值，把 execution 纳入 map；否则只产出 decisions，不产出 deliverables。

Refer by name

每张 map 和每个 ticket 都是 issue，因此都有一个 name：它的 title。在所有给人看的内容里，包括叙述和 map 的 Decisions-so-far，都用 name 引用它，不要只写裸 id、number 或 slug。一堵 #42, #43, #44 很难读；name 一眼就能看懂。Id 和 URL 不会消失，它们被包在 name 的 link 里面，但不单独替代 name。

The Map

Map 是这个 repo issue tracker 上一个带 wayfinder:map label 的单独 issue，是 canonical artifact。它的 tickets 是 map 的 child issues。

Map 是 index，不是 store。它列出已经做出的 decisions，并指向保存细节的 tickets；一个 decision 只存在一个地方，也就是它的 ticket。因此 map 不复述细节，只给 gist 和 link。

Map、child tickets、blocking 和 frontier queries 的物理表达方式取决于 tracker。 Issue tracker 应该已经提供；如果没有，运行 /setup-matt-pocock-skills。查阅 tracker doc 的 "Wayfinding operations" section，了解这个 repo 如何表达它们。如果没有 tracker，默认使用 local-markdown tracker。