wayfinder

Invoke Wayfinder with the loose idea to chart a map: it names the destination, runs a breadth-first grilling to surface open decisions, then creates a map issue and child decision tickets on the issue tracker. Each later session resolves one ticket at a time until the way is clear.

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

Wayfinder works with whatever issue tracker is configured for the repo, using its native labels, child issues, assignment, and blocking relationships. If no tracker is provided, it defaults to a local-markdown tracker and asks you to run the setup command.

Questions that cannot yet be phrased precisely go into the map's Not yet specified section as fog of war. As tickets resolve and clear the fog, each specifiable patch graduates into a fresh ticket and is removed from that section.

Skip Wayfinder when the way to the destination is already clear and the whole journey fits in one session; charting a map adds overhead with no benefit. It is also planning-first by default, so direct execution work belongs outside the map unless the effort's Notes override this.