用途：当某个想法太大、单个 agent 会话装不下，且从起点到目标的路线尚不清晰时，wayfinder 用“寻路”而非“冲刺”的方式，把工作拆成一张共享地图，逐个解决决策票据，直到路线清晰。目标是先被命名的第一件事，它决定范围；地图与领域无关，工程、课程内容等皆可。
主要能力：地图是仓库 issue 跟踪器上带 wayfinder:map 标签的单个 issue，票据是其子 issue。地图只做索引，记录“Destination”“Notes”“Decisions so far”“Not yet specified”“Out of scope”；每个决策只存在于其票据中。票据是待决策的问题，按类型分为 research（AFK，由 /research 子智能体解决）、prototype（HITL，用 /prototype 产出粗糙可反应物）、grilling（HITL，默认，通过 /grilling 与 /domain-modeling 一次一问）、task（HITL 或 AFK，为解除决策阻塞而做的必要手工工作）。阻塞用跟踪器原生依赖关系，以便在 UI 中可视化前沿。
使用方式：两种调用模式。一、绘制地图：用户给出松散想法，先通过 grilling 与 domain-modeling 确定目标，再广度优先展开前沿，创建地图与当前可指定的子票据，第二遍再连阻塞边；随后为每个 research 票据并行启动 /research 子智能体，停止。二、推进地图：用户给出地图（URL 或编号），加载低分辨率视图，领取并解决一个前沿票据（research 票据例外），记录答案、关闭票据、追加指针到 Decisions so far，新增冒出的票据并毕业已明确的迷雾。每个会话最多解决一个票据（research 除外）。
限制：默认跟踪器为本地 docs/<effort-slug>/ 下的 markdown 文件（map.md 与 issues/NN-<slug>.md，含 Type、Status、Blocked by 行）；仅当用户显式指定 jira（Atlassian MCP）或 gh（gh CLI）时改用，且写入前需询问。HITL 票据必须由真人参与解决，agent 不得替人作答。地图故意不完整：尚不能精确陈述的问题留在“Not yet specified”迷雾中，不预先切片；超出目标的工作归入“Out of scope”，不再毕业。若广度展开后无迷雾且一个会话即可完成，则不需要地图，应询问用户如何继续。资料未提供收费、价格、效果等其它信息。