wayfinder

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

10|3|Updated Jul 18, 2019
One-click install
npx skills add https://github.com/tanqimin/MyFavsORM --skill wayfinder-tanqimin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/tanqimin/MyFavsORM/tree/main/.agents/skills/wayfinder
Command: npx skills add https://github.com/tanqimin/MyFavsORM --skill wayfinder-tanqimin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts often exceed what a single agent session can hold, leaving teams without a clear path from a loose idea to a defined destination. This Skill charts that path as a shared map of decision tickets on the repo's issue tracker, resolving them one at a time until the way forward is clear. ## 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 research, prototype, grilling, and task tickets, each sized to one agent session, with native blocking relationships defining the workable frontier. - Concurrent session safety: Claims tickets via assignment, records resolutions as comments, and graduates newly specifiable fog into fresh tickets as the frontier advances. - Use Case: A team facing a vague migration effort invokes the Skill to chart a map, then runs parallel sessions that each claim and resolve one decision ticket until no open questions remain. ## 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 large project across multiple agent sessions?

Invoke the Skill with your loose idea to chart a map issue on the repo's issue tracker. It creates decision tickets as child issues, wires blocking relationships, and lets each session claim and resolve one ticket until the path is clear.

What is a decision ticket in issue-based planning?

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

Does the wayfinder skill work with any issue tracker?

It works with any tracker that supports labels, child issues, assignment, and native blocking dependencies. If no tracker is provided, it defaults to a local-markdown tracker, and trackers without native blocking fall back to a body convention.

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 tickets. The frontier of open, unblocked, unclaimed tickets defines what each session can safely pick up.

When should I not create a wayfinder map?

Skip the map when the initial breadth-first grilling surfaces no fog, meaning the way to the destination is already clear and the whole effort fits in one session. The Skill is for planning decisions, not executing well-defined work.