wayfinder

Plans large efforts as decision-ticket maps on an issue tracker.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/j172/bid --skill wayfinder-j172
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/j172/bid/tree/main/agent/skills/wayfinder
Command: npx skills add https://github.com/j172/bid --skill wayfinder-j172

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, fuzzy 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 is clear. ## Core Features & Use Cases - Map Creation: Charts a loose idea into a map issue (labelled wayfinder:map) with a destination, notes, decisions-so-far index, and fog-of-war sections. - Decision Tickets: Creates child issues typed as research, prototype, grilling, or task, with native blocking relationships defining the workable frontier. - Session Workflow: Supports two modes — charting a new map from a loose idea, or working through an existing map by claiming and resolving one ticket per session. - Use Case: You have a vague migration project too big for one session. Invoke the Skill to grill out the destination, fan out the open decisions into tickets, fire research subagents, and then resolve tickets session by session until the plan is fully decided. ## Quick Start Ask the agent to chart a wayfinder 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 grills out the destination, fans out open decisions breadth-first, and creates decision tickets as child issues on the repo's issue tracker. Each later session resolves one ticket until the way is clear.

What is a decision ticket in wayfinding?

A decision ticket is a child issue of the map whose resolution is a decision, not a build slice. Each carries a type label — research, prototype, grilling, or task — and is sized to fit one 100K-token agent session.

Does wayfinding require a specific issue tracker?

The map and tickets live on whatever issue tracker the repo provides, configured via the setup skill's tracker documentation. If no tracker is provided, it defaults to a local-markdown tracker, and blocking uses the tracker's native dependency feature when available.

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. The frontier — open, unblocked, unclaimed tickets — defines what is safe to take next.

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. The Skill itself stops and asks how to proceed in that case.