wayfinder

Plans large ambiguous work as a map of investigation tickets on an issue tracker.

2|Updated Jul 6, 2026
One-click install
npx skills add https://github.com/NAMEWTA/learning-open-code --skill wayfinder-namewta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/NAMEWTA/learning-open-code/tree/main/translator/open-ai-skills/matt-pocock-skills/skills/engineering/wayfinder
Command: npx skills add https://github.com/NAMEWTA/learning-open-code --skill wayfinder-namewta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large pieces of work often exceed what a single agent session can handle, and the path from the current state to the goal is unclear. Wayfinder turns that fog into a shared map of investigation tickets on the repository's issue tracker, then resolves them one at a time until the route to the goal is visible. ## Core Features & Use Cases - Map Creation: Names the destination through a grilling session, then creates a map issue labeled wayfinder:map with destination, notes, decisions-so-far, and fog-of-war sections. - Typed Tickets: Breaks work into research, prototype, grilling, and task tickets, each sized to fit one agent session and linked with native blocking relationships. - Frontier Traversal: Claims unblocked tickets by assignment, resolves exactly one per session, records answers as resolution comments, and promotes newly clarified fog into fresh tickets. - Use Case: A team faces a vague data structure migration. Wayfinder maps the open decisions as tickets, dispatches research sub-agents in parallel, and walks the frontier until every decision is resolved and implementation can begin. ## Quick Start Ask the agent to map this large piece of work with wayfinder, or give it an existing map URL to traverse the next open ticket.

Frequently Asked Questions about wayfinder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan work that is too big for one agent session?▼

Create a wayfinder map: name the destination through a grilling session, then break the open decisions into tickets on the issue tracker. Resolve one ticket per session until the path to the goal is clear and no decisions remain.

What ticket types does wayfinder use for investigation?▼

Wayfinder uses four ticket types: research (AFK, answered by a research sub-agent), prototype (HITL, builds a cheap artifact), grilling (HITL conversation, the default), and task (manual work that unblocks a decision).

Does wayfinder require a specific issue tracker?▼

Wayfinder works with any issue tracker that supports sub-issues, labels, assignment, and native blocking relationships. If no tracker is provided, it falls back to a local markdown tracker, and setup is handled by the setup skill.

When should I not create a wayfinder map?▼

Skip the map when the breadth-first grilling surfaces no fog, meaning the path to the goal is already clear and the whole journey fits in one session. In that case, stop and ask the user how they want to proceed.

Why does wayfinder limit each session to one ticket?▼

Each ticket is sized to fit a single 100K-token agent session, and the one-ticket rule keeps decisions atomic and traceable. Unblocked tickets can still be worked in parallel by separate concurrent sessions.