wayfinder

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

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

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 charted, claimed, and resolved one decision at a time. ## 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: Splits work into research, prototype, grilling, and task tickets, each sized to one agent session, with native blocking relationships defining the 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 clear. ## 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 tickets on the issue tracker, and wires blocking edges so each later session resolves one ticket at a time.

What is a decision ticket in Wayfinder?▼

A decision ticket is a child issue of the map whose body states one question sized to a single 100K-token session. Each carries a type label: research, prototype, grilling, or task, and is resolved by posting a resolution comment and closing the issue.

Does Wayfinder work with any issue tracker?▼

Wayfinder is tracker-agnostic but needs labels, child issues, assignees, and ideally native blocking relationships. The tracker-specific operations live in a tracker doc; if none is provided, 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. Research tickets are the exception to the one-ticket-per-session rule and can be fanned out to parallel subagents.

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 would add overhead with no fog to clear. It also produces decisions, not deliverables, unless the map's Notes explicitly carry execution into the map.