wayfinder

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

Updated Feb 22, 2024
One-click install
npx skills add https://github.com/tlipoca9/dotfiles --skill wayfinder-tlipoca9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/tlipoca9/dotfiles/tree/main/home/dot_agents/skills/wayfinder
Command: npx skills add https://github.com/tlipoca9/dotfiles --skill wayfinder-tlipoca9

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts often exceed what a single agent session can hold, leaving decisions scattered and progress untracked. This Skill turns a loose idea into a shared map of decision tickets on the repo's issue tracker, so work proceeds one resolved decision at a time until the path to the destination is clear. ## Core Features & Use Cases - Map-based planning: Creates a single map issue (labelled wayfinder:map) that indexes decisions, tracks fog-of-war items not yet specifiable, and records out-of-scope rulings. - Typed decision tickets: Each child ticket is labelled research, prototype, grilling, or task, distinguishing HITL conversations from AFK agent-driven work. - Frontier and blocking management: Uses the tracker's native dependency relationships so open, unblocked, unclaimed tickets form a visible frontier that parallel sessions can claim safely. - Use Case: You need to plan a data-structure migration too big for one session. Invoke the Skill with the idea; it grills you to name the destination, charts the map, creates the first tickets, fires research subagents, and later sessions resolve one ticket at a time, recording each answer as a resolution comment. ## Quick Start Ask the agent to use the wayfinder skill to chart a map for your loosely defined project idea 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. It names the destination through a grilling conversation, creates a map issue labelled wayfinder:map, and files the specifiable open questions as child decision tickets to resolve one per session.

How do I break down ambiguous work into decision tickets?▼

The Skill charts tickets breadth-first across the problem space, labelling each as research, prototype, grilling, or task. Questions too vague to state precisely stay in the map's Not yet specified section until resolving tickets makes them sharp.

What issue trackers does the wayfinding workflow support?▼

The map and tickets live on the repo's configured issue tracker, which should provide child issues, labels, assignment, and native blocking. If no tracker is provided, the Skill 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 of open, unblocked, unclaimed tickets stays visible through the tracker's native blocking UI.

When should I not use a decision-ticket map?▼

Skip the map when the way to the destination is already clear and the whole effort fits one session; the Skill stops and asks how to proceed instead. It also produces decisions, not deliverables, unless the map's Notes explicitly carry execution into it.