Consider: Wayfinder skill for planning work too big for one agent session

[alycda]

Reference

https://github.com/mattpocock/skills/blob/main/skills/engineering/wayfinder/SKILL.md

What it is

Wayfinder is one of Matt Pocock's agent skills (published on skills.sh, ~233K installs). It's a planning system for work that is "too big for one agent session, and wrapped in fog" — instead of executing, the agent builds a shared decision map on an issue tracker:

• The Map — a single issue (labeled wayfinder:map) holding the destination statement, open decisions, completed decisions, and anticipated fog
• Decision tickets — child issues of the map, one resolvable question each, typed by label (research, prototype, grilling, task)
• The frontier — the set of unclaimed, unblocked, open child tickets: "what's takeable next", made visible via the tracker's native blocking dependencies
• Workflow — one session charts the map; subsequent (potentially concurrent) sessions each claim and resolve a single decision ticket, graduating newly-discovered fog into new tickets; done when the way to the destination is clear

The distinguishing feature: it deliberately front-loads decisions and clarity rather than delivery — work items only exist when they unblock a decision.

Why this might be relevant here

• lib/skills-sh.nix is the existing pattern for pulling skills.sh skills in declaratively via nix-skills — mattpocock/skills is indexed on skills.sh, so wayfinder should be installable as another mkSkill entry (path skills/engineering/wayfinder) plus a home.file line in home-manager/modules/tools/agent-skills.nix
• This repo already runs multi-session agent workflows (Claude Code on the web, gh-dash, Linear API keys in secrets/), which is exactly the concurrent-sessions-over-a-shared-map shape wayfinder targets
• The commit-history-as-story philosophy in CLAUDE.md pairs naturally with a decision-map artifact: the map records the "why" before the commits record the "how"

To consider

• Read SKILL.md and any companion files in mattpocock/skills under skills/engineering/wayfinder/
• Verify the nix-skills pin for mattpocock/skills lists the skills/engineering/wayfinder path (the mkSkill path check throws loudly if not)
• Decide which tracker it should target here (GitHub issues on this repo vs. Linear) and whether the label conventions (wayfinder:map, ticket types) fit
• Check overlap with already-installed skills from the same author's collection (e.g. grill-me / prototype are referenced as ticket types) — a plugin/skill that bundles them shouldn't be double-installed per the "Plugins are not skills" rule
• Decide: adopt via lib/skills-sh.nix, adapt the idea into existing agent-instruction docs, or pass
• If adopted, document the decision per the "Meta: Updating This Document" section of CLAUDE.md