wayfinder

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

Updated Jul 12, 2025
One-click install
npx skills add https://github.com/kpayakv2/check-products --skill wayfinder-kpayakv2
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/kpayakv2/check-products/tree/main/.agents/skills/wayfinder
Command: npx skills add https://github.com/kpayakv2/check-products --skill wayfinder-kpayakv2

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, so decisions are resolved one at a time until the route is clear. ## Core Features & Use Cases - Map Creation: Charts a loose idea into a single map issue (labelled wayfinder:map) with a destination, notes, decisions-so-far index, and fog-of-war sections. - Typed Decision Tickets: Creates child issues typed as research, prototype, grilling, or task, with native blocking relationships defining the workable frontier. - Incremental Resolution: Claims, resolves, and closes one ticket per session, recording answers as resolution comments and graduating newly specifiable fog into fresh tickets. - Use Case: A team facing a vague migration effort invokes the Skill to chart a map of open decisions, then works through research and grilling tickets across multiple sessions until a handoff-ready spec exists. ## 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
What is a decision ticket in wayfinding?▼

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

How does wayfinder track which tickets are ready to work?▼

It uses the tracker's native blocking relationships: a ticket is unblocked when everything blocking it is closed. The frontier is the set of open, unblocked, unclaimed tickets, and sessions claim work by assigning tickets before starting.

Can wayfinder execute the actual work instead of planning?▼

By default it produces decisions, not deliverables; the map is done when the way is clear. An effort can override this in its Notes section to carry execution into the map, but absent that it hands off once nothing remains to decide.

What happens to questions that cannot be ticketed yet?▼

They are recorded in the map's Not yet specified section as fog of war. As tickets resolve and clear the fog, these patches graduate into sharply phrased tickets; work ruled beyond the destination goes to the Out of scope section instead.