wayfinder

wayfinder (documented in Chinese) is a planning skill for breaking a large piece of work that cannot fit in a single agent session into a shared "map" of decision tickets on an issue tracker, then resolving them one at a time until the path to a destination is clear. It solves a scoping-and-continuity problem: an idea that is too big and "fogged" to execute directly gets charted into decisions rather than build tasks, so the route is discovered incrementally instead of rushed. Its explicit default is "plan, don't do": each ticket resolves one decision, and the map is complete when nothing remains to decide before someone starts building.

The map is a single issue labeled wayfinder:map, acting as an index (not a store) with sections for Destination, Notes, Decisions-so-far, Not-yet-specified (fog), and Out-of-scope; tickets are its child issues, each a single question sized to fit within roughly a 100K-token session. Tickets carry a type label — research (AFK, delegated to a /research subagent), prototype (HITL), grilling (HITL, the default), or task (HITL or AFK) — and are claimed by assignment, blocked via the tracker's native dependency relationships, and resolved with answers recorded at resolution rather than pasted into the body. The skill defines a "fog of war" model distinguishing tickets you can specify now from fog you cannot yet, plus explicit out-of-scope handling, and two invocation modes: charting a new map and working through an existing one (never resolving more than one non-research ticket per session).

The target users are engineers and other planners tackling ambiguous, oversized efforts — engineering work, course content, or anything of that shape — who want a durable, collaborative planning structure on their issue tracker. It is a text-only methodology skill with no executable or risky components.