wayfinder

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

2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nseng-ai/ns --skill wayfinder-nseng-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/nseng-ai/ns/tree/main/.agents/skills/wayfinder
Command: npx skills add https://github.com/nseng-ai/ns --skill wayfinder-nseng-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large efforts that exceed a single agent session often lose context, stall, or get executed prematurely. This Skill turns a vague, oversized idea into a shared map of decision tickets on the repo's issue tracker, so work is resolved one decision at a time until the path to the destination is clear. ## Core Features & Use Cases - Map charting: Runs grilling and domain-modeling sessions to name the destination, then creates a map issue (label wayfinder:map) with child decision tickets wired by native blocking relationships. - Typed tickets: Classifies each ticket as research, prototype, grilling, or task, distinguishing HITL from AFK work and firing research subagents in parallel. - Frontier tracking: Maintains Decisions-so-far, Not-yet-specified fog, and Out-of-scope sections so concurrent sessions can claim unblocked, unassigned tickets safely. - Use Case: A team faces a vague data-structure migration too big for one session. The skill charts a map of decision tickets, resolves them one per session, and hands off a clear route before any implementation begins. ## Quick Start Ask the agent to chart a wayfinder map for your loosely defined project idea on this repository's 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 through a grilling session, creates a map issue labeled wayfinder:map, and files the specifiable decisions as child tickets. Each later session resolves exactly one ticket until the route is clear.

How do I break down vague ideas into actionable decision tickets?

The skill runs a breadth-first grilling pass to surface open decisions, then creates tickets only for questions that are already sharp. Everything still fuzzy is recorded in the map's Not yet specified section and graduates into tickets as the frontier advances.

Does wayfinder work with issue trackers other than GitHub?

The map, tickets, blocking, and frontier queries are tracker-specific and defined in docs/agents/issue-tracker.md for each repo. If that document is absent, the skill defaults to a local-markdown tracker instead of a hosted one.

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

Yes. A session claims a ticket by assigning it before starting work, so concurrent sessions skip claimed items. The frontier is the set of open, unblocked, unassigned child tickets, and blocking uses the tracker's native dependency relationship.

When should I not use a decision-ticket map?

Skip the map when charting surfaces no fog, meaning the way to the destination is already clear and the whole effort fits in one session. The skill also avoids execution: it produces decisions, not deliverables, unless an effort's Notes explicitly override that default.