Matt Pocock’s Wayfinder skill starts with a destination and a problem: the route is still hidden. It tracks decisions across several coding-agent sessions, so one conversation does not have to contain the entire plan.

A map through the fog

An initial interview explores the repository and the desired outcome. Wayfinder creates a parent map and decision tickets for the questions already visible. Other questions remain in the “fog” until earlier work makes them answerable. Blocking relationships record those dependencies; independent tickets can be handled in parallel.

Pocock’s command-palette example began with seven tickets, three immediately available. He starts a fresh session for each by invoking Wayfinder with the ticket. Completed decisions are recorded in the issue and summarized back into the parent map. He demonstrates GitHub and says setup can adapt the workflow to other trackers.

Four kinds of work

  • Research: an agent investigates a question and reports back, often via a subagent.
  • Prototype: a working example makes appearance or behavior concrete enough to judge.
  • Grilling: a conversation resolves a design or implementation decision.
  • Task: a real-world or agent-executable action, sometimes blocked by earlier work.

Pocock treats prototypes as feedback during planning, not as a promise that the first implementation is production-ready. His map may also contain errands, such as commissioning a site survey for a garden office.

From decisions to implementation

When the destination is a specification, Pocock turns the completed map into a spec, then into implementation tickets. The spec links back to the original decision tickets when a condensed answer needs context. He distinguishes those planning tickets from the later tickets that actually build the software.

He recommends skipping Wayfinder when the path fits comfortably into one session. In his own workflow, the spec is temporary: he closes it after implementation rather than maintaining it as a permanent source of truth. The video presents his method and examples, not a controlled comparison of planning approaches.

Wayfinder in Pocock’s skills repository