迷途导航

问题：当需求大到装不进一个会话

当项目从“做个插件市场”这种模糊想法开始，而计费模型、沙箱边界、第三方发布流程都还没想清时，直接冲进实现往往会在反复推翻中耗掉大量时间。问题不在于写代码的能力，而在于“从此到目的地的路”还不可见：单会话装不下，会议越开越散，决策散落在聊天记录里。

工作方式：把“找路”拆成可追踪的决策工单

Wayfinder 不先冲向目的地，而是先找路。它把工作画成一张共享地图：一个标签为 wayfinder:map 的 issue 是规范产物，子 issue 是决策工单，每张工单只解一个决策，而不是一截要执行的构建。地图体包含：

• Destination：一两句话的最终目标，每次会话先对齐；
• Notes：领域背景、应查的 skill、工程偏好；
• Decisions so far：每关闭一张工单追加一行标题链接和一句要点；
• Not yet specified：尚不可 ticket 的迷雾；
• Out of scope：超出目的地、永不毕业的工作。

地图是索引，不是仓库；决策只存在自己的工单里。工单分四种类型：research 用于查文档、API 或本地知识库；prototype 做便宜粗糙的具体物抬高讨论保真度；grilling 通过逐问澄清默认情况；task 解决决策前必须发生的人工活。工单需先认领，阻断用跟踪器原生依赖关系，未阻断且未认领的工单构成前沿。每会话至多解一张工单，research 除外。

走地图时，先加载地图，选取首个前沿工单并认领；按需 zoom 相关工单全文，调用 Notes 指的 skill；拿不准就用 /grilling 或 /domain-modeling。解完后发 resolution 评论、关闭 issue、向地图 Decisions so far 追加指针，并把答案清出的迷雾毕业成新工单。输出工件为 WayfinderMap，供下游 to-spec、/research、/prototype 消费。

边界与注意点

默认只规划，不交付物；除非 Notes 显式声明带执行。地图故意不全，能精确说出的问题才进工单，说不清的留在 Not yet specified。若决策推翻地图其他部分，需更新或删除相应工单。它不适用于单会话就能装下的项目；若一条路已清到无需地图，画地图流程会直接停下询问用户。