wayfinder

Plan large multi-session efforts as decision tickets on an issue tracker.

Updated May 22, 2026
One-click install
npx skills add https://github.com/kitfunso/claude-config --skill wayfinder-kitfunso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/kitfunso/claude-config/tree/main/skills/wayfinder
Command: npx skills add https://github.com/kitfunso/claude-config --skill wayfinder-kitfunso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts often exceed what a single agent session can hold, leaving decisions scattered and progress untracked. Wayfinder turns a loose idea into a shared map of decision tickets on the repo's issue tracker, resolving them one at a time until the path to the destination 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: Each ticket is a child issue labelled research, prototype, grilling, or task, 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 need to plan a data-structure migration 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 migration plan is fully decided. ## Quick Start Use the wayfinder skill to chart a map for my loose idea of migrating our database schema, then create 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 wayfinder with your loose idea to chart a map: it names the destination, sketches unspecified fog, and creates decision tickets as child issues on the tracker. Each later session claims and resolves one ticket until the way is clear.

What is a decision ticket in issue tracker planning?▼

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) and is sized to fit one 100K token agent session.

Does wayfinder work with any issue tracker?▼

Wayfinder is tracker-agnostic but needs labels, child issues, assignees, and ideally native blocking relationships. The tracker doc's Wayfinding operations section defines per-repo behavior; without one it defaults to a local-markdown tracker.

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

Yes. A session claims a ticket by assigning it before starting work, so concurrent sessions skip claimed tickets. The frontier is the set of open, unblocked, unclaimed child issues.

When should I not use wayfinder for planning?▼

Skip it when the way to the destination is already clear and the whole journey fits in one session; charting surfaces no fog in that case. It also produces decisions, not deliverables, unless an effort's Notes explicitly carry execution into the map.