wayfinder

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

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/QT-7274/dotfiles --skill wayfinder-qt-7274
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/QT-7274/dotfiles/tree/main/wayfinder
Command: npx skills add https://github.com/QT-7274/dotfiles --skill wayfinder-qt-7274

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 turns that fog into a shared map of decision tickets on the repo's issue tracker, so work is planned and resolved one decision at a time 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: Breaks work into child issues typed as research, prototype, grilling, or task, with native blocking relationships defining the actionable 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 route is clear. ## Quick Start Ask the agent to use the wayfinder skill to chart a map for your loosely defined project idea 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 unspecifiable questions into a fog-of-war section, and creates decision tickets as child issues. Each later session claims and resolves one ticket until the route 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 rather than a build slice. Each carries a type label (research, prototype, grilling, or task) and is sized to fit one 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 should be provided via setup; otherwise it defaults to a local-markdown tracker with a body convention for blocking.

When should I not use a decision-ticket 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. Wayfinder is planning by default, so it is also a poor fit when you simply want execution.

How does Wayfinder handle concurrent agent sessions?▼

Sessions claim a ticket by assigning it before any work, so concurrent sessions skip claimed tickets. Only one ticket is resolved per session, except research tickets, which run as parallel subagents on throwaway branches.