wayfinder

Plan large efforts as decision tickets on an issue tracker and resolve them incrementally.

2|Updated Oct 16, 2021
One-click install
npx skills add https://github.com/pattobrien/dotfiles --skill wayfinder-pattobrien
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/pattobrien/dotfiles/tree/main/.agents/skills/wayfinder
Command: npx skills add https://github.com/pattobrien/dotfiles --skill wayfinder-pattobrien

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, resolving them one at a time until the way forward is fully decided. ## 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 a research, prototype, grilling, or task ticket, claimed by assignment and ordered by native blocking relationships so the frontier is visible in the tracker's UI. - Incremental resolution: Sessions claim one frontier ticket, resolve it with a resolution comment, close it, and graduate newly specifiable fog into fresh tickets. - Use Case: You have a vague idea for a data-structure migration too big for one session. Invoke Wayfinder to grill out the destination, create the map and initial tickets, fire research subagents in parallel, then work through the frontier ticket by ticket across sessions. ## 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 to chart a map: it grills out the destination, creates a map issue labelled wayfinder:map, and files the specifiable decisions as child tickets. Later sessions work through the frontier one ticket at a time.

What is a decision ticket in issue tracker planning?▼

A decision ticket is a child issue of the map whose resolution is a decision rather than a build slice. Each carries a wayfinder label of research, prototype, grilling, or task, and is sized to fit one 100K token agent session.

Does Wayfinder work with GitHub Issues or other trackers?▼

Wayfinder is tracker-agnostic: the map, child tickets, blocking, and frontier queries are expressed per the tracker doc provided to the agent. If no tracker is configured, it defaults to a local-markdown tracker and asks you to run the setup command.

How does Wayfinder handle work that cannot be ticketed yet?▼

Unsharpened questions go in the map's Not yet specified section as fog of war rather than premature tickets. As frontier tickets resolve, specifiable fog graduates into fresh tickets, while work beyond the destination is ruled out of scope.

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

Yes, sessions claim tickets by assigning them before starting work, so concurrent sessions skip claimed items. Blocking uses the tracker's native dependency relationship, keeping the unblocked frontier visible in the tracker's own UI.