wayfinder

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

2|2|Updated Dec 23, 2017
One-click install
npx skills add https://github.com/xriu/dotfiles --skill wayfinder-xriu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/xriu/dotfiles/tree/main/home/.skills/mattpocock/wayfinder
Command: npx skills add https://github.com/xriu/dotfiles --skill wayfinder-xriu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous 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, then resolves them one at a time until the way forward is clear. ## 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: Breaks work into research, prototype, grilling, and task tickets, each sized to one agent session, with native blocking relationships defining the workable frontier. - Two invocation modes: Chart a new map from a loose idea, or work through an existing map by claiming and resolving one ticket per session. - Use Case: You have a vague migration idea too big for one session. Invoke wayfinder to grill out the destination, fan out the open decisions into tickets, fire research subagents in parallel, and then resolve tickets session by session until the route is decided. ## Quick Start Ask the agent to use the wayfinder skill to chart a map for your loosely defined project idea on the repo's 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 wayfinder with your loose idea. It grills you to name the destination, maps the open decisions breadth-first, creates a map issue plus typed decision tickets, and then resolves one ticket per session until the route is clear.

What ticket types does wayfinder use for decision planning?▼

Wayfinder uses four ticket types: research (AFK fact-finding), prototype (rough artifacts to react to), grilling (live conversation, the default), and task (manual work that unblocks a decision). Each ticket carries a wayfinder:<type> label.

Does wayfinder work with issue trackers other than the default?▼

Yes. The map, tickets, blocking, and frontier queries are tracker-specific and defined by the tracker doc provided to the agent. If no tracker is provided, it defaults to a local-markdown tracker and may prompt you to run the setup skill.

Can multiple agent sessions work on the same wayfinder map?▼

Yes. Sessions claim tickets by assigning themselves before starting work, so concurrent sessions skip claimed tickets. The frontier is the set of open, unblocked, unclaimed child issues of the map.

When should I not use wayfinder for planning?▼

Skip wayfinder when the way to the destination is already clear and the whole journey fits in one session. Charting surfaces no fog in that case, and the skill itself tells you to stop and decide how to proceed directly.