wayfinder

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large efforts often exceed what a single agent session can hold, leaving the path from idea to destination unclear. Wayfinder turns that fog into a shared map of decision tickets on the repo's issue tracker, so work is planned, tracked, and resolved incrementally across sessions. ## Core Features & Use Cases - Map as an issue: Creates a single map issue labelled wayfinder:map holding the destination, notes, decisions-so-far index, fog of war, and out-of-scope sections. - Typed decision tickets: Child issues carry wayfinder:research, prototype, grilling, or task labels, with native blocking relationships defining the workable frontier. - Two invocation modes: Chart a new map from a loose idea, or work 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 wayfinder to chart a map of research, prototype, and grilling tickets, then resolve them across sessions until the route to the destination is fully decided. ## 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 wayfinder with your loose idea to chart a map: it names the destination, sketches unresolvable questions into a fog-of-war section, and creates decision tickets as child issues. Each later session claims and resolves one ticket until the route is clear.

What is a decision ticket in wayfinding?

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

Does wayfinder work with any issue tracker?

Wayfinder is tracker-agnostic but expects the tracker to support labels, child issues, assignment, and native blocking relationships. If no tracker is provided, it defaults to a local-markdown tracker, and tracker-specific operations come from the tracker doc.

Can wayfinder resolve multiple tickets in one session?

No, wayfinder resolves at most one ticket per session, with the exception of research tickets which are fanned out to parallel research subagents. This keeps each decision focused and lets concurrent sessions claim other frontier tickets.

When should I not use wayfinder for planning?

Skip wayfinder when the way to the destination is already clear and the whole journey fits in one session — charting surfaces no fog in that case. It is also planning-only by default, so use it to produce decisions, not deliverables.