wayfinder

Plan large efforts as decision-ticket maps on an issue tracker.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/dulltackle/kangkang-skills --skill wayfinder-dulltackle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/dulltackle/kangkang-skills/tree/main/wayfinder
Command: npx skills add https://github.com/dulltackle/kangkang-skills --skill wayfinder-dulltackle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts are too big for a single agent session, and their path forward is unclear. Wayfinder breaks such work into a shared map of decision tickets on the repo's issue tracker, resolving them one at a time until the route to the destination is clear. ## Core Features & Use Cases - Map as an issue: Creates a single map issue (labelled wayfinder:map) holding the destination, notes, decisions-so-far index, fog of war, and out-of-scope sections. - Typed decision tickets: Child issues typed as 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 spanning many unknowns. Wayfinder creates a map issue, tickets the sharp questions, fires research subagents, and records each decision as tickets close. ## Quick Start Ask the agent to chart a wayfinder 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 frontier breadth-first, creates a map issue plus decision tickets on your issue tracker, and wires blocking edges so later sessions resolve one ticket at a time.

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, and is sized to fit one agent session.

Which issue trackers does wayfinder support?

Wayfinder is tracker-agnostic but needs labels, child issues, assignment, and native blocking. The tracker should be provided via setup; if none is given, 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 work, so concurrent sessions skip claimed tickets. Only open, unblocked, unassigned tickets form the workable frontier.

When should I not use wayfinder?

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