wayfinder

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

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/kashman001/ai-workspace-template --skill wayfinder-kashman001
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/kashman001/ai-workspace-template/tree/main/skills/wayfinder
Command: npx skills add https://github.com/kashman001/ai-workspace-template --skill wayfinder-kashman001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, fuzzy efforts often exceed what a single agent session can hold, leaving teams without a clear path from a loose idea to a defined destination. Wayfinder turns that fog into a shared map of decision tickets on your issue tracker, resolved one at a time until the route is clear. ## Core Features & Use Cases - Map charting: Names the destination, sketches unresolved questions into a Not-yet-specified fog section, and creates child decision tickets with blocking dependencies on the issue tracker. - Typed decision tickets: Classifies work as research, prototype, grilling, or task tickets, distinguishing human-in-the-loop decisions from agent-driven investigation. - Frontier-based resolution: Claims one unblocked ticket per session, records the answer as a resolution comment, and graduates newly specifiable fog into fresh tickets. - Use Case: A team needs to plan a data-structure migration too big for one session. Wayfinder creates a map issue, spawns research subagents on open questions, grills the human on key decisions, and tracks every decision until the migration plan is fully specified. ## Quick Start Ask the agent to chart a wayfinder map for your large, loosely defined effort so it can break the work into decision tickets 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?▼

Chart a wayfinder map: name the destination, create a map issue on your tracker, and spawn child decision tickets with blocking edges. Each subsequent session claims and resolves one frontier ticket until no decisions remain.

What is a decision ticket in issue-tracker planning?▼

A decision ticket is a child issue whose resolution is a decision rather than a build task. It carries a type label — research, prototype, grilling, or task — and is closed with a resolution comment recording the answer.

Does wayfinder work with any issue tracker?▼

Wayfinder is tracker-agnostic but expects labels, child issues, assignment, and native blocking relationships. The repo's tracker documentation defines how maps and tickets are expressed; without one it defaults to a local-markdown tracker.

When should I not use a wayfinding map?▼

Skip the map when charting surfaces no fog — meaning the way to the destination is already clear and the whole journey fits in one session. In that case, simply proceed with the work directly.

Why does wayfinder limit one ticket per session?▼

Each ticket is sized to one 100K-token agent session, and resolving multiple tickets in one session risks shallow decisions. Research tickets are the exception, resolved in parallel by subagents.