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
- Name the destination — What does reaching the end look like?
- Map the frontier — Fan out breadth-first, surface decisions.
- Create the map — Single issue with label wayfinder:map.
- Create tickets — Child issues with blocking edges.
- Fire research subagents — Resolve research tickets in parallel.
Work through the map
- Load the map — Low-res view.
- Choose the ticket — First frontier ticket.
- Resolve it — Zoom as needed, call skills.
- Record resolution — Post answer, close issue, update map.
- 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 Pocock (@mattpocock). Original source: mattpocock/skills. Licensed under MIT.
How to use?
1. Download
Go to the AGENT KD SKILL gallery and find this skill card. Click Download to save the SKILL.md file to your computer.
2. Install
Copy the downloaded SKILL.md into your agent's skills directory:
| Agent | Path |
|---|---|
| opencode | ~/.config/opencode/skills//SKILL.md |
| Claude Code | ~/.claude/skills//SKILL.md |
| Codex CLI | ~/.codex/skills//SKILL.md |
| Cursor | ~/.cursor/skills//SKILL.md |
| Gemini CLI | ~/.gemini/skills//SKILL.md |
Example for opencode:
ash mkdir -p ~/.config/opencode/skills/<skill-name> cp SKILL.md ~/.config/opencode/skills/<skill-name>/SKILL.md
3. Use
Restart your agent session. The skill will auto-load based on its description. You can also invoke it explicitly by typing @ in your agent.
4. Verify
Ask your agent something related to the skill's purpose. If it responds using the skill's instructions, you're all set.