---
name: wayfinder
description: Plan work too big for one agent session as a shared map of decision tickets on GitHub, resolved one at a time until the way to the destination is clear.
disable-model-invocation: true
license: MIT
metadata:
forked-from: https://github.com/mattpocock/skills
forked-skill: wayfinder
forked-on: "2026-08-03"
upstream-copyright: Copyright (c) 2026 Matt Pocock, MIT
editor: Mike Zornek
---
A loose idea has arrived — too big for one agent session, and wrapped in fog: the way from here to the **destination** isn't visible yet. Wayfinding is about finding that way, not charging at the destination. This skill charts the way as a **shared map** on the repo's issue tracker, then works its **decision tickets** — questions whose resolution is a decision, not slices of a build to execute — one at a time until the route is clear.
The destination varies per effort, and naming it is the first act of charting — it shapes every ticket. It might be a spec to hand off and iterate on, a decision to lock before planning starts, or a change made in place like a data-structure migration. The map is domain-agnostic — engineering work, course content, whatever fits the shape.
## Plan, don't do
Wayfinder is **planning** by default: each ticket resolves a decision, and the map is done when the way is clear — nothing left to decide before someone goes and does the thing. The pull to just do the work is usually the signal you've reached the edge of the map and it's time to hand off. An effort can override this in its **Notes** — carrying execution into the map itself — but absent that, produce decisions, not deliverables.
This file has been truncated. show original
