为什么值得关注

它通过强制机器可验证的 markdown 文件契约，弥合了 AI 代理生成的规划文档与人类可读仪表板之间的差距，能够检测代理自身无法发现的漂移和重复声明。

适合谁使用

使用 wayfinder 方法和 AI 编码代理的团队
需要在不打开数十个 markdown 文件的情况下快速查看大型任务状态的开发者
验证代理生成的规划图内部一致性的工程师
任何运行 Claude Code 或类似生成 wayfinder 地图的代理的用户

典型使用场景

通过 wayfinder-maps status 快速查看哪些票证已解决、正在进行或可以认领
使用 wayfinder-maps lint 在下一次会话前捕捉过期或矛盾的数据
以浏览器或原生窗口中的交互式星空图形式展示任务全景
作为 Claude Code 插件集成，直接在代理环境中运行 wayfinder-maps 命令

项目优势

完全根据文件内容（是否包含 ## Answer）推导票证状态，消除第二个真实来源
Lint 能捕获人工检查容易遗漏的错误，如循环依赖、重复票证编号和空的结尾标题
跨平台原生窗口（macOS、Windows、Linux），最终用户无需安装 Go 工具链
同时提供独立二进制和 Claude Code 插件两种分发方式，适应不同工作流程

使用前须知

只读工具——不创建或编辑票证，仅报告现有内容
严格遵守格式契约；偏离预期 markdown 结构的地图将无法正确解析
不支持处理多个会话的并发编辑——只能在事后报告重复问题

README 快速开始

wayfinder-maps

A read-only CLI and viewer for wayfinder maps — the markdown planning memory an agent leaves under .plan// as it charts a large effort as a graph of investigation tickets. The wayfinder method and its skills were created by Matt Pocock; this repo adapts them and adds the tooling.

wayfinder-maps status — what is resolved, what is in flight, and what is ready to claim (the frontier: open, unclaimed, every blocker resolved).
wayfinder-maps lint — does the map still tell the truth?
wayfinder-maps serve / app — the map as a star-map, in a browser or a native window (design notes).

$ wayfinder-maps status ../expensif/.plan/daily-timeline
Daily Timeline — continuous days, empty days included
6 resolved · 0 claimed · 4 open · 0 out of scope

Frontier — ready to claim, first by number wins:
  05  Should HandleDaily's two branches converge      grilling
  06  Contain the day-card chrome drift               grilling
  07  The infinite-scroll island's contract           grilling
  10  Test strategy for the date-indexed timeline     grilling

Undermined — resolved on a premise that later changed:
  02  Window size and how older days load             broken by 08

Fog: 5 patches, 1 anchored to a ticket

Install

Skills, as a Claude Code plugin

/plugin marketplace add rengwu/wayfinder-maps
/plugin install wayfinder-maps@wayfinder-maps

/wayfinder-maps then works in every project; the map lands in that project's .plan/. The plugin bundles wayfinder-maps plus the four skills it invokes by name — grill-me, research, prototype, domain-modeling. All five were originally authored by Matt Pocock in mattpocock/skills; the copies under skills/ are MIT-licensed adaptations.

Skills, drop-in for any harness

Copy skills/ into your project and tell your agent to read skills/wayfinder-maps/SKILL.md and follow it; the skills it names live alongside. You may include any of the extras under skills/.optional/ too — skills/README.md describes the full set.

The binary

Download from [Releases](https://github.com/rengwu/wayfinder-maps/releases

项目描述

Planetary visualization tool for /wayfinder maps

wayfinder-maps

为什么值得关注

适合谁使用

典型使用场景

项目优势

使用前须知

README 快速开始

wayfinder-maps

Install

Skills, as a Claude Code plugin

Skills, drop-in for any harness

The binary

项目描述

相关仓库与替代方案

flow

ponytail-improved

poirot