wayfinder

Plan large efforts as decision tickets on an issue tracker and resolve them one at a time.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/GregM1991/skills --skill wayfinder-gregm1991
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/GregM1991/skills/tree/main/skills/vendor/mattpocock/wayfinder
Command: npx skills add https://github.com/GregM1991/skills --skill wayfinder-gregm1991

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large efforts often exceed what a single agent session can hold, leaving the path from idea to destination unclear. Wayfinder charts that path as a shared map of decision tickets on the repo's issue tracker, so work is decomposed into resolvable questions instead of being charged at blindly. ## Core Features & Use Cases - Map-based planning: Creates a single map issue (labelled wayfinder:map) holding the destination, notes, decisions-so-far index, fog of war, and out-of-scope boundaries. - Typed decision tickets: Each child ticket is one of research, prototype, grilling, or task, with HITL or AFK modes, native blocking relationships, and claim-by-assignment for concurrent sessions. - Progressive resolution: Sessions claim one frontier ticket at a time, record resolutions as comments, and graduate newly specifiable fog into fresh tickets until the way is clear. - Use Case: You have a vague migration idea too big for one session. Invoke charting to name the destination, fan out the open decisions into tickets, fire research subagents in parallel, then work through the frontier ticket by ticket across multiple sessions. ## Quick Start Ask the agent to chart a wayfinder map for your large idea, naming the destination and creating the first decision tickets on the issue tracker.

Frequently Asked Questions about wayfinder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a project too big for one agent session?▼

Invoke the charting mode with your loose idea. The skill names the destination, grills breadth-first to surface open decisions, creates a map issue labelled wayfinder:map, and files the specifiable questions as child tickets with blocking edges.

What is a decision ticket in wayfinding?▼

A decision ticket is a child issue of the map whose resolution is a decision, not a build slice. Each carries a type label (research, prototype, grilling, or task), is sized to one agent session, and is claimed by assignment before work begins.

Does wayfinder require a specific issue tracker?▼

It works with whatever issue tracker the repo provides, consulting that tracker's documentation for how maps, child tickets, and blocking are expressed. If no tracker is provided, it defaults to a local-markdown tracker.

Can multiple agent sessions work the same map in parallel?▼

Yes. Sessions claim tickets by assigning themselves before starting, so concurrent sessions skip claimed work. The frontier is the set of open, unblocked, unclaimed tickets, and each session resolves at most one ticket, except research tickets.

When should I not use a wayfinder map?▼

Skip the map when charting surfaces no fog, meaning the way to the destination is already clear and the whole journey fits in one session. In that case the skill stops and asks how you would like to proceed instead.