wayfinder

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

Updated Sep 21, 2026
One-click install
npx skills add https://github.com/maxentr/la-cuisine-de-mm --skill wayfinder-maxentr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/maxentr/la-cuisine-de-mm/tree/main/.agents/skills/wayfinder
Command: npx skills add https://github.com/maxentr/la-cuisine-de-mm --skill wayfinder-maxentr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts often exceed what a single agent session can hold, leaving teams without a clear path from a loose idea to a concrete destination. Wayfinder charts that path as a shared map of decision tickets on the repo's issue tracker, resolving them one at a time until the way forward 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. - Typed decision tickets: Splits work into research, prototype, grilling, and task tickets, each sized to one agent session, with native blocking relationships defining the workable frontier. - Concurrent session safety: Claims tickets via assignment so multiple parallel sessions never resolve the same ticket, and records resolutions as comments linked from the map. - Use Case: A team facing a vague data-migration effort invokes Wayfinder to name the destination, fan out the open decisions into tickets, fire research subagents, and then work through the frontier one decision per session until the route is fully specified. ## 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?

Use Wayfinder to chart the effort as a map issue on your repo's issue tracker, decomposed into decision tickets sized to one session each. Sessions then resolve tickets one at a time until the path to the destination is clear.

How do I break a vague idea into actionable decision tickets?

Wayfinder first names the destination through a grilling conversation, then maps the frontier breadth-first. Sharp questions become tickets immediately, while dimmer areas stay in the map's Not yet specified section until they can be phrased precisely.

What issue trackers does Wayfinder work with?

Wayfinder works with any tracker that supports labels, child issues, assignment, and native blocking relationships. The tracker should be provided to the agent; if none is given, it defaults to a local-markdown tracker.

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. Blocking relationships keep the frontier of unblocked, unclaimed tickets visible in the tracker's own UI.

When should I not use a decision-ticket 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 is planning by default, so it produces decisions rather than deliverables.