一句话

给一个会话装不下的大工程画共享地图：在 issue tracker 上建 map issue 和一组 decision tickets，一次会话解一张票，产出决定不是交付物，直到通往 destination 的路清晰再移交 to-spec。

何时用

• 适合：greenfield 或大 feature，destination 能命名但路线看不见；老库更常用（雾常是「现状是什么」）。
• 不适合：一个会话能定的计划（matt-grill-with-docs）；决定已做完（直接 matt-to-spec）；已有会话膨胀过大可先 /handoff 进地图。

怎么用

/wayfinder 我想把整个课程平台迁到新架构

1. 建图：连调 matt-grilling+matt-domain-modeling 定 destination，再 breadth-first 问出 frontier；若无雾说明不需要地图，停下问用户。
2. 建 map issue（wayfinder:map 标签）：Destination、Notes、空的 Decisions-so-far，雾写进 Not yet specified。
3. 能写清的票建为 map 的子 issue，第二遍再补 blocking edges 和真实 id 交叉引用。
4. 每张 research 票立刻派子代理并行跑 matt-research，结果落 research/<name> 分支（不开 PR）。
5. 之后每会话：加载 map 低清视图 → 认领一张 frontier 票（先 assign 再动手）→ 按 wayfinder:<type> 标签的类型解 → 贴 resolution comment、关票、在 map 追加指针，毕业的雾转新票。
6. 地图清空后移交 to-spec，不直接进 implement。

产出

• map issue + decision tickets 及每张的 resolution comment；产出是决定，不是代码。

要点与坑

• 票分四型：research（AFK）、prototype（HITL）、grilling（HITL，默认）、task（为解锁决策做的手动活）；HITL 票 agent 不许替人回答。
• 地图是索引不是仓库：决定只活在自己的票里，map 只写一句 gist 加链接。
• 认领就是 assign：开放未 assign 的票才算无人认领。
• 每会话最多解一张票，唯一例外是 research 票（本来就派子代理跑）。

本机版本差异

仓库版新增硬规则：票只挂 wayfinder:<type> 标签、绝不挂 triage 标签；resolve 按 label 判类型；second pass 要用真实 issue id 写交叉引用（#<n> 占位会误链）。

关联

• 票型：matt-research、matt-prototype、matt-grilling · 下游：matt-to-spec
• 所属：00-matt-概览 · 工作流：W4-大型模糊项目