用途：当想法过大、单次智能体会话装不下，且从当前到目标的路径尚不清晰时，Wayfinder 负责“找路”而非直接冲向目标。它把路线绘制成仓库问题追踪器上的共享地图，再逐张处理决策票据，直到路径明确。目标可以是待交接的规格、规划前需锁定的决策，或就地完成的改动（如数据结构迁移），不限于工程领域。
主要能力：地图是追踪器上带 wayfinder:map 标签的单个 issue，票据为其子 issue。地图含 Destination、Notes、Decisions so far、Not yet specified、Out of scope 等区块，只做索引，不重复细节。票据类型有 research（AFK，由 /research 子代理解决）、prototype（HITL，产出粗糙原型）、grilling（HITL，默认，用 /grilling 与 /domain-modeling 逐问对话）、task（HITL 或 AFK，为解锁决策而做的必要手工工作）。阻塞用追踪器原生依赖关系表达，前沿即开放、未阻塞、未被认领的子票据。
使用方式：两种模式。绘制地图时，用户给出松散想法，先命名目标，再广度优先梳理前沿，创建地图与可明确的票据并连线阻塞关系，随后为 research 票据并行启动 /research 子代理，绘制本身不解决任何票据。推进地图时，用户给出地图 URL 或编号，可选指定票据；否则按顺序取第一张前沿票据，先认领（指派给自己）再解决，把答案作为解决评论记录、关闭 issue，并在地图 Decisions so far 追加指针，同时新增浮现的票据、把已可明确表述的迷雾升级为票据。每会话最多解决一张票据（research 票据除外）。
限制与前提：需已提供问题追踪器，否则运行 /setup-matt-pocock-skills；未提供时默认使用本地 markdown 追踪器。地图刻意不完整，无法精确表述的问题留在迷雾中，不预先切分。超出目标的工作归入 Out of scope，永不升级。HITL 票据必须与真人实时交流解决，智能体不得代替人的一方。引用地图与票据时用其标题名称，而非裸 id 或编号。其他会话可能并发编辑追踪器。