programmersd21
Featured
flow
flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.
AI repository intelligence
FR-AI / ANALYSISWhy it is worth attention
It bridges the gap between AI-agent-created planning documents and human-readable dashboards by enforcing a machine-verifiable contract on markdown files, detecting drift and duplicate claims that agents alone cannot see.
Who it is for
- Teams using the wayfinder methodology with AI coding agents
- Developers who need to inspect the state of a large effort without opening dozens of markdown files
- Engineers validating that their agent's planning map is internally consistent
- Anyone running Claude Code or similar agents that produce wayfinder maps
Use cases
- Quickly see what tickets are resolved, in flight, or ready to claim with wayfinder-maps status
- Catch stale or contradictory data with wayfinder-maps lint before the next session starts
- Render the effort as an interactive star map in a browser or native window for a big-picture view
- Integrate as a Claude Code plugin to run wayfinder-maps commands directly inside the agent's environment
Strengths
- Derives ticket status purely from file contents (presence of ## Answer), eliminating a second source of truth
- Lint catches errors like cycles, duplicate ticket numbers, and empty closing headings that manual review would miss
- Cross-platform native window (macOS, Windows, Linux) with no Go toolchain required for end users
- Dual distribution as both a standalone binary and a Claude Code plugin, fitting different workflows
Considerations
- Read-only tool — it does not create or edit tickets, only reports on existing ones
- Strictly enforces the format contract; maps that deviate from the expected markdown structure will not parse correctly
- Does not handle concurrent edits from multiple sessions — it can only report duplicates after the fact
README quick start
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
Description
Planetary visualization tool for /wayfinder maps
Related repositories
Similar projects matched by category, topics, and programming language.
0xwilliamortiz
Featured
ponytail-improved
Ponytail is a plugin for AI coding agents that enforces a disciplined ladder of reuse before writing code, reducing code volume by roughly 54% while preserving safety.
HezaoHezao
Featured
poirot
Poirot is a deep research agent kernel with a middleware-first architecture, five-layer long-term memory, multi-agent orchestration, sandbox isolation, and a three-layer skill self-evolution system, backed by 2400+ tests.