Wayfinder charts the way to a destination when a loose idea is too large for one agent session. It names the destination, creates a map issue and child decision tickets, and then resolves one ticket per session until nothing is left to decide.
It is a planning skill: tickets produce decisions, and the map is finished when the route is clear.
What You Get
- A map issue labelled wayfinder:map with Destination, Notes, Decisions so far, Not yet specified and Out of scope sections
- Child tickets typed research, prototype, grilling or task, wired with native blocking links
- Resolution comments recorded on each closed ticket
- Research findings captured on throwaway branches
Common Use Cases
- Plan a data-structure migration that spans many sessions
- Work out a spec for a large feature through a series of decisions
- Run an effort shared between several people who each claim tickets
What Makes It Unique
It keeps the map as a low-resolution index while each decision lives in exactly one ticket. It models fog of war, so questions that cannot yet be stated sharply wait in a Not yet specified section until the frontier reaches them. Tickets are claimed by assignment so concurrent sessions skip each other’s work.
Under The Hood
A single SKILL.md with no scripts. It uses the tracker that setup-matt-pocock-skills configured, including its wayfinding operations, to create issues, labels, assignees and blocking links. It calls the grilling, domain-modeling, research and prototype skills by type, and research tickets run in subagents that push a research branch without opening a pull request.