wayfinder

Plans large efforts as decision tickets on an issue tracker and resolves them one at a time.

Updated Nov 10, 2013
One-click install
npx skills add https://github.com/bnferguson/dotfiles --skill wayfinder-bnferguson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/bnferguson/dotfiles/tree/main/.agents/skills/wayfinder
Command: npx skills add https://github.com/bnferguson/dotfiles --skill wayfinder-bnferguson

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, so the route to the destination becomes visible and resolvable one ticket at a time. ## Core Features & Use Cases - Map creation: Charts a destination, notes, and fog-of-war sections into a single tracker issue labelled wayfinder:map, with child tickets for each open decision. - Ticket types: Classifies work as research, prototype, grilling, or task tickets, each resolved through the appropriate human-in-the-loop or agent-driven workflow. - Frontier tracking: Uses native tracker blocking and assignment to expose which tickets are unblocked and unclaimed, supporting parallel sessions. - Use Case: A team facing a vague data-migration effort invokes the skill to chart a map, then works through research and grilling tickets across multiple sessions until every decision is recorded and the way 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 the skill with your loose idea to chart a map: it names the destination, creates a tracker issue labelled wayfinder:map, and files each open decision as a child ticket. Later sessions work through one ticket at a time until the route is clear.

How do I break down vague work into trackable decision tickets?▼

The skill grills you breadth-first to surface open decisions, then creates child issues for questions that are already sharp and parks the rest in a Not yet specified fog section. Each ticket gets a type label: research, prototype, grilling, or task.

Does wayfinder work with issue trackers other than the default?▼

Yes, the map, tickets, blocking, and frontier queries are tracker-specific and follow the tracker doc's Wayfinding operations section. If no tracker is provided, it defaults to a local-markdown tracker.

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. The frontier is the set of open, unblocked, unclaimed child tickets, and blocking uses the tracker's native dependency relationship.

When should I not use wayfinder for a task?▼

Skip it when the way to the destination is already clear and the whole journey fits in one session; the charting step explicitly stops and asks how to proceed in that case. It also produces decisions, not deliverables, unless an effort's Notes override that default.