wayfinder

Plan large efforts as maps of decision tickets resolved one at a time.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/toderian/project_template --skill wayfinder-toderian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/toderian/project_template/tree/main/plugins/agents-tasks/skills/wayfinder
Command: npx skills add https://github.com/toderian/project_template --skill wayfinder-toderian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Large, fuzzy efforts that are too big for one agent session often stall because the path from idea to destination is unclear. This Skill turns a loose idea into a structured map of decision tickets held in a single task file, so decisions get resolved incrementally instead of being silently assumed. ## Core Features & Use Cases - Map-based planning: Creates one ordinary task file under docs/tasks_manager/_todos/ containing a destination, a decisions index, fog-of-war notes, and dotted sub-id tickets (e.g., T-042.1) with states like open, claimed, resolved, and out-of-scope. - Typed decision tickets: Supports grilling (HITL conversation), research (AFK background dispatch), prototype, and task ticket types, each resolved with the appropriate companion skill. - Frontier tracking and handoff: Claims tickets with a committed lock, graduates fog into new tickets as answers arrive, and hands off to plans, tasks, or ADRs when the frontier empties. - Use Case: You need to choose a storage architecture but the decision depends on vendor limits and team preferences. Chart a wayfinder map, fire research tickets in parallel, grill stakeholders on the rest, and end with a linked decision artifact. ## Quick Start Ask the agent to chart a wayfinder map for your loosely defined effort, naming the destination you want to reach.

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, map the frontier breadth-first, and create decision tickets in a single task file. Then work one ticket per session until the frontier is empty and hand off to a plan or implementation tasks.

What ticket types does the wayfinder map support?

Four types: grilling (HITL conversation), research (AFK background dispatch to a researcher subagent), prototype (a rough artifact to react to), and task (manual work blocking a decision). Each resolves with its corresponding companion skill.

How does wayfinder prevent two sessions from working the same ticket?

A session claims a ticket by writing its name into the Claimed by field and setting the state to claimed, then commits that edit before any work. The index row acts as a lock that concurrent sessions see and skip.

When should I use a wayfinder map instead of a regular task?

Use a map when the way to the destination is not visible and multiple decisions must be resolved first. If charting surfaces no fog and the work fits one session, use a plain task or the planning workflow instead.

What happens when all wayfinder tickets are resolved?

When the frontier is empty, the map hands off: produce the destination artifact such as a plan, task with spec sections, implementation tasks, or ADRs, link it from the map, and close the map through the complete-task flow.