wayfinder

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

3|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/mambo-wang/CodingHub --skill wayfinder-mambo-wang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/mambo-wang/CodingHub/tree/main/.codebuddy/skills/wayfinder
Command: npx skills add https://github.com/mambo-wang/CodingHub --skill wayfinder-mambo-wang

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 charts that path as a shared map of decision tickets on the repo's issue tracker, then resolves them one at a time until the way forward is fully decided. ## 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, and out-of-scope sections. - Typed decision tickets: Breaks work into child issues typed as research, prototype, grilling, or task, with native blocking relationships defining the workable frontier. - Session-safe claiming and resolution: Tickets are claimed by assignment, resolved with a resolution comment, and indexed back on the map so concurrent sessions never collide. - Use Case: A team needs to plan a data-structure migration too big for one session. The Skill grills the user to name the destination, fans out the open decisions into tickets, fires research subagents, and then works one ticket per session until every decision is made. ## Quick Start Ask the agent to chart a wayfinder map for your large, loosely defined idea so it can break the effort 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?▼

Invoke the skill with your loose idea and it runs a grilling session to name the destination, then creates a map issue and child decision tickets on the issue tracker. Each later session resolves one ticket until no decisions remain.

What is a decision ticket in wayfinding?▼

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 of research, prototype, grilling, or task, and is resolved by posting an answer comment and closing the issue.

Does wayfinder require a specific issue tracker?▼

The skill works with whatever issue tracker is configured for the repo, using its native labels, child issues, and blocking relationships. 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. Only open, unblocked, unassigned tickets form the workable frontier.

When should I not use wayfinding for a task?▼

Skip it when the path to the destination is already clear and the whole effort fits in one session. Wayfinding is planning, not execution, so it produces decisions rather than deliverables unless the map's Notes override that.