用途：当想法过于庞大、单个智能体会话装不下，且从当前到目标的路径仍被迷雾笼罩时，Wayfinder 负责“找路”而非直接冲向目标。它把路线绘制成仓库问题追踪器上的共享地图，再逐个处理决策工单（其解决结果是决策，而非待执行的构建切片），直到路线清晰。
主要能力：地图是追踪器上带 wayfinder:map 标签的单个 issue，工单是其子 issue。地图只做索引，不重复存储决策；决策只存在于对应工单中。工单类型包括 research（AFK，读文档或知识库）、prototype（HITL，做粗糙原型以提升讨论精度）、grilling（HITL，对话，默认类型）、task（HITL 或 AFK，为解锁决策而必须完成的手工工作）。阻塞使用追踪器原生依赖关系，前沿是开放、未被阻塞、未被认领的子工单。地图含 Destination、Notes、Decisions so far、Not yet specified、Out of scope 等区块。
使用方式：两种模式。绘制地图：用户给出松散想法，先命名目标，再广度优先梳理前沿，创建地图与可明确的工单并连线，并行启动 research 子智能体，绘制本身不解决任何工单。推进地图：用户给出地图 URL 或编号，加载低分辨率视图，认领一个前沿工单（先分配给自己并加 in-progress 标签），解决后以解决评论记录答案、关闭工单、更新 Decisions so far，并graduation 新工单。每会话最多解决一个工单，research 工单除外。若未提供追踪器，提示用户运行 /setup-matt-pocock-skills，默认使用本地 markdown 追踪器。
限制：默认只做规划、不执行；工单正文是问题，答案在解决时记录，资产以链接而非粘贴方式关联。地图刻意不完整，无法精确表述的问题留在迷雾中。目标之外的工作属于 Out of scope，不会 graduation。HITL 工单必须与真人实时交流解决，智能体不得代替人类一方。具体追踪器操作细节需查阅追踪器文档的 Wayfinding operations 部分。