wayfinder

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

1|Updated Mar 2, 2025
One-click install
npx skills add https://github.com/marjorg/setup --skill wayfinder-marjorg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/marjorg/setup/tree/main/home/.agents/skills/archive/0-matt/wayfinder
Command: npx skills add https://github.com/marjorg/setup --skill wayfinder-marjorg

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 charts that path as a shared map of decision tickets on the repo's issue tracker, then resolves them one at a time until the way forward is fully decided. ## 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 sections. - 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. - 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 need to plan a data-structure migration too big for one session. Invoke the skill with the idea, and it grills you to name the destination, creates the map and initial tickets, fires research subagents, and leaves a clear frontier for future sessions. ## Quick Start Ask the agent to use the wayfinder skill to chart a map for your large, loosely-defined effort 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 names the destination through grilling, creates a map issue on the tracker, and files the decisions you can already specify as child tickets. Future sessions then resolve one ticket at a time until the way is clear.

What is a decision ticket in issue tracker planning?

A decision ticket is a child issue of the map whose resolution is a decision rather than a build deliverable. 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?

It works with any tracker that supports child issues, labels, assignment, and native blocking relationships; the tracker-specific operations live in a separate tracker doc. If no tracker is provided, 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. The frontier is the set of open, unblocked, unclaimed tickets, and each session resolves at most one ticket, except research tickets.

When should I not use a decision-ticket map?

Skip the map when charting surfaces no fog: if the way to the destination is already clear and the whole journey fits in one session, a map adds overhead. The skill itself stops and asks how to proceed in that case.