git:20260824.da779f9 to git:20260824.dfd64f3

---

{

"name": "wayfinder",

"description": "Plan a huge chunk of work as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear. Use when a task is too big for one agent session.",

"credit": "Matt Peacock (mattpocock/skills)"

}

---

# Wayfinder

Plan a huge chunk of work as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.

## Process

### Chart the map

1. **Name the destination** — What does reaching the end look like?

2. **Map the frontier** — Fan out breadth-first, surface decisions.

3. **Create the map** — Single issue with label wayfinder:map.

4. **Create tickets** — Child issues with blocking edges.

5. **Fire research subagents** — Resolve research tickets in parallel.

### Work through the map

1. **Load the map** — Low-res view.

2. **Choose the ticket** — First frontier ticket.

3. **Resolve it** — Zoom as needed, call skills.

4. **Record resolution** — Post answer, close issue, update map.

5. **Graduate fog** — Make newly-specified tickets.

## Ticket types

- Research (AFK): Reading docs and resources.

- Prototype (HITL): Making a cheap artifact.

- Grilling (HITL): Conversation.

- Task (HITL or AFK): Manual work that unblocks a decision.

## Credit

This skill is based on the work of **Matt Peacock** ([@mattpocock](https://github.com/mattpocock)). Original source: [mattpocock/skills](https://github.com/mattpocock/skills). Licensed under MIT.