wayfinder

Plans large efforts as decision tickets on an issue tracker.

Updated Sep 19, 2026
One-click install
npx skills add https://github.com/Ab0umar/selrs.cc.BU --skill wayfinder-ab0umar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/Ab0umar/selrs.cc.BU/tree/main/.agents/skills/wayfinder
Command: npx skills add https://github.com/Ab0umar/selrs.cc.BU --skill wayfinder-ab0umar

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. This Skill 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 forward is fully charted. ## Core Features & Use Cases - Map-based planning: Creates a single map issue (labelled wayfinder:map) that indexes decisions, open fog, and out-of-scope work, with child tickets for each decision. - Typed decision tickets: Supports research, prototype, grilling, and task ticket types, each resolved through subagents or human-in-the-loop conversation. - Frontier and blocking management: Uses the tracker's native dependency relationships so concurrent sessions can claim unblocked tickets in parallel. - Use Case: You have a vague idea like migrating a data structure or drafting a spec. Invoke the Skill to grill out the destination, chart the open decisions as tickets, fire research subagents, and then work through one ticket per session until nothing remains undecided. ## 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 the wayfinder skill with your loose idea. It names the destination through a grilling conversation, creates a map issue labelled wayfinder:map, and files the sharp open questions as child decision tickets to resolve one per session.

What ticket types does wayfinding use for decisions?▼

Tickets carry one of four labels: research (AFK fact-finding by subagent), prototype (HITL cheap artifact to react to), grilling (HITL conversation, the default), and task (manual work that unblocks a decision).

Does wayfinder require a specific issue tracker?▼

Wayfinder works with whatever issue tracker is provided for the repo, using its native blocking relationships and child issues. If no tracker is provided, it defaults to a local-markdown tracker and tells the user to run the setup command.

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. Unblocked tickets on the frontier can be worked in parallel, with research tickets as the exception to the one-ticket-per-session rule.

When should I not use a wayfinding 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 also produces decisions, not deliverables, unless the effort's Notes explicitly carry execution into the map.