用途:为大体量的开发工作(如大型重构、跨多会话的任务)建立共享地图,并把待定决策拆成一张张决策工单,逐条解决而非一次性答完。触发场景包括 map out a large refactor、plan multi-session work、create decision tickets、navigate blocked work。
主要能力与流程:先通过一个“grilling session”明确终点(spec/change,“done”长什么样);再对代码库做广度优先展开,只暴露开放决策、不立即求解;随后生成导航地图 .lcs/work-items/{ts}-{slug}/wayfinder-map.md,并在 wayfinder-tickets/ 下生成子工单 DEC-###.md,工单用 YAML frontmatter 的 blocked_by 表达依赖。工单 frontmatter 必须遵循 OKF 状态生命周期(draft|reviewed|active|archived):status: active 表示开放/正在解决,status: archived 表示已解决/关闭;artifact_type 固定为 wayfinder,open/resolved 这类词汇只出现在正文,不写入 frontmatter。每次会话最多解决一个工单,记录解决结果、把工单置为 archived,并更新地图。当地图不再有开放决策时,交给 lcs-toprd 把决策收敛成可构建的计划。
约束与产物:需遵循共享契约 ../lcs-shared/contract.md 中的目录约定、Handoff 格式与 token 优化,并按 Artifact Writing Safety 规则先一次性生成内容、只写一个文件、校验失败即停。输出物为 wayfinder-map.md 与 wayfinder-tickets/DEC-###.md。Chain of Truth 等级为 Strict,报告需列出检查来源(如 .lcs/state.md)、假设(标注 [verified]/[unverified])、动作、验证状态、交接建议(下一技能 lcs-toprd、下一文件 wayfinder-map.md、当前阶段 wayfinder、置信度、阻塞问题、需带走的风险、真源文件包、需保留的 ID 如 DEC-### 与 SRC-###、未解决 ID)。注意:它服务于活跃开发中的规划与导航,不是一次性的架构测绘工具;面向入门学习的代码库测绘请使用 lcs-codebase-doc。具体安装命令与收费方式资料未提供。