skills.rest
Suge8
Suge8COMMUNITY
Explore all skills by this author →
WebsiteGitHub

wayfinder

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

Updated Sep 14, 2026
Search Tags:#planning#issue tracker#agent workflow#task decomposition#project mapping#decision tickets
One-click install
npx skills add https://github.com/Suge8/skills --skill wayfinder-suge8
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/Suge8/skills/tree/main/workflow/wayfinder
Command: npx skills add https://github.com/Suge8/skills --skill wayfinder-suge8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a piece of work is too large or too vague for a single agent session, it is hard to know where to start or how to coordinate progress. This Skill turns that fog into a shared map of decision tickets on the repository's issue tracker, so the path to the destination becomes visible one resolved decision at a time. ## Core Features & Use Cases - Map Creation: Names the destination, sketches the fog of war in a Not-yet-specified section, and creates a tracker issue labeled wayfinder:map as the canonical index. - Decision Tickets: Breaks work into research, prototype, grilling, and task tickets with native blocking relationships, claimed and resolved one per session. - Frontier Tracking: Maintains Decisions-so-far, Out-of-scope, and open unblocked tickets so parallel sessions and humans always see what can be picked up next. - Use Case: You have a vague idea like migrating a data model or drafting a course curriculum. Invoke this Skill to grill out the destination, map the open decisions as tickets, launch research subagents, and then work through the frontier ticket by ticket. ## Quick Start Ask the agent to use the wayfinder skill to map out my vague project idea into decision tickets on the 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?▼

Use the wayfinder skill to name the destination, then create a map issue on the tracker with decision tickets as sub-issues. Each ticket is sized to fit a single 100K token session, and sessions resolve them one at a time until the path is clear.

What is the difference between research, prototype, grilling, and task tickets?▼

Research tickets gather facts via subagents, prototype tickets produce rough assets for feedback, grilling tickets resolve decisions through conversation with a human, and task tickets unblock decisions by completing manual prerequisites like registering a service.

Does wayfinder require a specific issue tracker?▼

Wayfinder works with any issue tracker that supports sub-issues, labels, and blocking dependencies; consult the tracker documentation for how this repository expresses those operations. If no tracker is provided, it defaults to a local Markdown tracker.

Can one agent session resolve multiple wayfinder tickets?▼

No, each session must resolve at most one ticket, with research tickets as the exception. Sessions claim a ticket by assigning it before starting work so parallel sessions skip it.

When should I not create a wayfinder map?▼

Skip the map when no fog remains after grilling, meaning the path to the destination is already clear and the whole job fits in one session. In that case, stop and ask the user how they want to proceed.

Related Skills

Explore More Product & Management Skills→
FradSerFradSer
588

wayfinder

Plans large ambiguous efforts as decision tickets on an issue tracker.

Community
Advanced
mark-brannanmark-brannan

wrapup

Writes session narrative logs, hand-off prompts, and board sweep results to a state repository.

Community
Intermediate
bbenefield89bbenefield89

scoped-grill-with-docs

Runs documentation-aware grilling sessions with numbered questions and a persistent scope ledger.

Community
Intermediate
TonyBlancoTonyBlanco

brainstorming

Guide abstract ideas into concrete designs and implementation strategies.

Community
Intermediate