wayfinder

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

Updated May 19, 2026
One-click install
npx skills add https://github.com/wenyue/SmartKit --skill wayfinder-wenyue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/wenyue/SmartKit/tree/main/skills/wayfinder
Command: npx skills add https://github.com/wenyue/SmartKit --skill wayfinder-wenyue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts often exceed what a single agent session can hold, leaving teams without a clear path from a loose idea to a defined destination. This Skill charts that path as a shared map of decision tickets on the repo's issue tracker, resolving them one at a time until the way forward is clear. ## 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 items, and out-of-scope rulings. - Typed decision tickets: Breaks work into child issues typed as research, prototype, grilling, or task, with native blocking relationships defining the actionable frontier. - Concurrent session safety: Claims tickets via assignment, limits resolution to one ticket per session, and supports parallel research subagents. - Use Case: A team facing a vague data-structure migration invokes the Skill to chart a map, grill the destination, spawn research subagents on open questions, and work tickets session by session until every decision is resolved. ## Quick Start Ask the agent to chart a wayfinder map for your loosely defined initiative so it can create the destination, tickets, and blocking edges on your 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 wayfinder skill with your loose idea. It runs a grilling session to name the destination, maps the frontier breadth-first, creates a map issue with child decision tickets, and wires blocking edges so future sessions resolve one ticket at a time.

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 slice. 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 a tracker doc describing how the repo expresses maps, child tickets, blocking, and frontier queries. If no tracker is provided, it defaults to a local-markdown tracker; trackers without native blocking fall back to a body convention.

Can multiple agent sessions work the same map in parallel?▼

Yes. Sessions claim tickets by assigning them before starting work, so concurrent sessions skip claimed items. Research tickets can also be resolved in parallel by dedicated research subagents on throwaway branches.

When should I not use wayfinder for planning?▼

Skip it when the way 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-only by default, producing decisions rather than deliverables unless the map's Notes override this.