wayfinder

Plans large efforts as decision tickets on an issue tracker and resolves them one per session.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/mikalv/pi-extensions --skill wayfinder-mikalv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/mikalv/pi-extensions/tree/main/packages/pi-atelier/.agents/skills/wayfinder
Command: npx skills add https://github.com/mikalv/pi-extensions --skill wayfinder-mikalv

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-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 items. - Typed decision tickets: Breaks work into research, prototype, grilling, and task tickets, each sized to one agent session, with native blocking relationships defining the 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 idea too big for one session. Invoke wayfinder to chart a map of decision tickets on your issue tracker, then resolve them one at a time until the route to the destination is clear. ## Quick Start Ask the agent to chart a wayfinder map for your large idea, or give it an existing map issue URL to work through the next open decision 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 your loose idea to chart a map: it names the destination, sketches unspecifiable questions into a fog-of-war section, and creates decision tickets as child issues on your issue tracker. Each ticket is then resolved one per session 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 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?▼

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 are documented per repo.

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 — open, unblocked, unclaimed tickets — is what parallel sessions draw from.

When should I not use wayfinder?▼

Skip wayfinder when the path to the destination is already clear and the whole effort fits in one session — charting surfaces no fog in that case. It is also planning-oriented by default, so pure execution work belongs elsewhere unless the map's Notes opt into execution.