wayfinderlisted

# wayfinder (Gaia) This is the Gaia expression of Matt Pocock's `wayfinder` skill. Upstream is deliberately tracker-agnostic: it says *"the issue tracker should have been provided to you… consult the tracker doc's 'Wayfinding operations' section for how THIS repo expresses them."* **This file is that document.** Upstream owns the method; this file pins down the mechanics — where maps live, how tickets are created and nested, how blocking is expressed, how the frontier is queried, how a ticket is claimed, how a resolution is recorded. Read the upstream SKILL.md for the method ([mattpocock/skills → engineering/wayfinder](https://github.com/mattpocock/skills/blob/main/skills/engineering/wayfinder/SKILL.md)); read this for how Gaia does it. Wayfinder is **cartography**: planning an effort too big for one agent session as a map of *decision* tickets, worked one at a time until nothing is left to decide. It is not backlog hygiene and not issue resolution — see [Not this skill](#not-this-skill). --- ## 1. Headquarters — one tracker, many repos **Every map and every ticket lives on the `gaia-research/gaia-skill-tree` issue tracker, regardless of which repository the resulting code lands in.** There is no second map tracker, and a map is never split across repos. ```bash export GAIA_HQ=gaia-research/gaia-skill-tree # headquarters — all wayfinder issues ``` Why: a map's whole value is that one issue holds the low-resolution view of an entire effort. Efforts here routinely