wayfinder

Plans large multi-session efforts as issue-tracker maps of investigation tickets.

1|Updated May 25, 2020
One-click install
npx skills add https://github.com/titaneric/dotfiles --skill wayfinder-titaneric
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/titaneric/dotfiles/tree/main/dot_agents/skills/wayfinder
Command: npx skills add https://github.com/titaneric/dotfiles --skill wayfinder-titaneric

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts exceed what a single agent session can hold, and the path from a loose idea to a clear destination is often unknown. Wayfinder breaks such efforts into a shared map of investigation tickets on the repo's issue tracker, resolving decisions one ticket at a time until the route 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, with child issues as tickets. - Typed tickets with blocking: Each ticket is typed as research, prototype, grilling, or task, claimed by assignment, and ordered via the tracker's native blocking relationships so the actionable frontier is visible. - Incremental resolution: Sessions claim one frontier ticket, resolve it through grilling, prototyping, or research, record the answer as a resolution comment, and graduate newly specifiable fog into fresh tickets. - Use Case: A team needs to plan a data-structure migration too big for one session. Wayfinder charts a map naming the migration as the destination, tickets the sharp open questions, parks vague concerns in Not yet specified, and works tickets one per session until every decision is made. ## Quick Start Ask the agent to use the wayfinder skill to chart a map for your loosely defined project idea, or invoke it with an existing map issue URL to work the next open ticket.

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, creates a map issue on the tracker, tickets the sharp open questions, and parks vague areas in Not yet specified. Later sessions work one ticket at a time until the way is clear.

How do I break down ambiguous work into trackable tickets?

Wayfinder runs a breadth-first grilling session to surface open decisions, then creates child issues typed as research, prototype, grilling, or task. Blocking edges are wired in a second pass so the tracker shows which tickets are actionable.

What issue trackers does wayfinder support?

Wayfinder is tracker-agnostic: it consults the tracker doc's Wayfinding operations section for how the repo expresses maps, child tickets, and blocking. If no tracker is provided, it defaults to a local-markdown tracker.

Can wayfinder resolve multiple tickets in one session?

No. Wayfinder strictly resolves at most one ticket per session, claiming it by assignment before work begins. This lets multiple sessions run unblocked frontier tickets in parallel without conflicts.

When should I not use wayfinder for planning?

Skip wayfinder when charting surfaces no fog — if the way to the destination is already clear and the whole journey fits one session, no map is needed. It also plans rather than executes by default, producing decisions, not deliverables.