wayfinder

Plan large efforts as decision tickets on an issue tracker.

Updated Apr 16, 2025
One-click install
npx skills add https://github.com/damoke012/eks_code --skill wayfinder-damoke012
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/damoke012/eks_code/tree/main/.claude-env/skills/wayfinder
Command: npx skills add https://github.com/damoke012/eks_code --skill wayfinder-damoke012

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts often exceed what a single agent session can hold, leaving the path from idea to destination unclear. This Skill breaks such work into a shared map of decision tickets on the repo's issue tracker, resolving them one at a time until the route is clear. ## Core Features & Use Cases - Map-based planning: Creates a single map issue (labelled wayfinder:map) that indexes decisions, open questions, fog of war, and out-of-scope work. - Typed decision tickets: Supports research, prototype, grilling, and task ticket types, each resolved in its own session with blocking relationships and a visible frontier. - Concurrent-session safety: Claims tickets via assignment so parallel sessions never collide, and records resolutions as comments linked from the map. - Use Case: You need to plan a data-structure migration too big for one session. Invoke the skill to chart a map, spawn research subagents for open questions, and work through grilling and prototype tickets until every decision is made. ## Quick Start Ask the agent to use the wayfinder skill to chart a map for your loosely defined project idea 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?▼

Invoke the skill with your loose idea to chart a map: it names the destination, sketches unresolved questions into a Not yet specified section, and creates decision tickets as child issues. Each later session resolves one ticket until the way is clear.

What is a decision ticket in issue tracker planning?▼

A decision ticket is a child issue of the map whose body states one question sized to a single agent session. It carries a type label (research, prototype, grilling, or task) and is resolved by posting an answer comment and closing the issue.

Does wayfinder work with any issue tracker?▼

It works with any tracker that supports labels, child issues, assignment, and native blocking relationships; the tracker-specific operations come from the tracker's own documentation. If no tracker is provided, it defaults to a local-markdown tracker.

Can multiple agent sessions work on the same map?▼

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 is queryable at any time.

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

Skip the map when charting surfaces no fog, meaning the whole journey fits in one session and the way is already clear. The skill is for planning decisions, not executing deliverables, unless an effort explicitly overrides that in its Notes.