wayfinder

Plan large efforts as decision-ticket maps on an issue tracker.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/PVMalove/claude-agent-harness --skill wayfinder-pvmalove
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/PVMalove/claude-agent-harness/tree/main/skills/first-party/pvmalove/wayfinder
Command: npx skills add https://github.com/PVMalove/claude-agent-harness --skill wayfinder-pvmalove

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, resolving them one at a time until the route is clear. ## Core Features & Use Cases - Map as an index issue: A single issue labelled wayfinder:map holds the destination, notes, decisions-so-far, fog (Not yet specified), and out-of-scope rulings, while detail lives in child tickets. - Typed decision tickets: Each ticket is a child issue labelled research, prototype, grilling, or task, plus hitl/afk and workflow::ready, claimed by assignment and ordered by native blocking relationships. - Two invocation modes: Chart the map from a loose idea (name destination, map the frontier breadth-first, create and wire tickets, fire research subagents), or work through an existing map one ticket per session. - Use Case: A team facing a vague migration effort invokes wayfinder to chart a map: open questions become research and grilling tickets, blocking edges define the frontier, and each session resolves exactly one decision until the way is clear. ## Quick Start Invoke the wayfinder skill with a loose idea to chart a decision-ticket map on the issue tracker, or pass an existing map URL to resolve its next frontier ticket.

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 the loose idea to chart a map: it names the destination, maps the frontier breadth-first, and creates decision tickets as child issues on the issue tracker. Each later session resolves exactly one ticket until the way is clear.

What is a decision ticket in wayfinding?▼

A decision ticket is a child issue of the map whose resolution is a decision, not a build slice. Each carries a type label (research, prototype, grilling, or task) plus hitl or afk, and is sized to one 100K-token agent session.

Does wayfinder work with any issue tracker?▼

Wayfinder is tracker-agnostic but expects the tracker to be provided via setup; it consults the tracker doc's Wayfinding operations section. Trackers with native blocking render the frontier visually, while others fall back to a body convention or local markdown.

When should I use wayfinder instead of writing a spec directly?▼

Use wayfinder when the path to the destination is foggy and cannot fit one session. If charting surfaces no fog and the whole journey fits one session, the skill itself tells you to stop and skip the map.

Why does wayfinder limit resolution to one ticket per session?▼

The one-ticket rule keeps each session focused and lets concurrent sessions claim other frontier tickets safely via assignment. Research tickets are the exception, resolved in parallel by subagents.