Menu
Build, launch and drive wayfinder-maps to verify a change end-to-end (server + headless browser).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
A relentless interview to sharpen a plan or design, which also creates docs (ADRs and glossary) as we go.
Compact the current conversation into a handoff document so a fresh agent can continue the work.
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating spec/PRD asked for?). Use when the user wants to review a branch, work-in-progress changes, or asks to "review since X".
Turn the current conversation into a spec, saved to `.plan/` — no interview, just synthesis of what you've already discussed.
| name | verify |
| description | Build, launch and drive wayfinder-maps to verify a change end-to-end (server + headless browser). |
go build -o /tmp/wayfinder-maps ./cmd/wayfinder-maps
There is no sample map in the repo. Create an effort dir with map.md +
tickets/NN-slug.md. Ticket format: YAML frontmatter (type:, blocked_by: [01],
claimed_by:, undermined_by: [NN]) then # Title, ## Question; a ## Answer
section with prose = resolved, ## Ruled out = out_of_scope. Map format: # Name,
## Destination, and fog under ## Not yet specified as
- **Title.** clears-with: NN. Sanity-check the fixture with
wayfinder-maps status <effort-dir>.
PORT=78xx /tmp/wayfinder-maps serve <effort-dir> # pick a fresh port EVERY time
Gotcha: the user often has an instance (binary wm) already listening; a bind
failure only shows in the log while curl happily talks to the OLD server — check
the serve log says "serving", don't trust the port being answerable.
Dev mode: WAYFINDER_DEV=cmd/wayfinder-maps/web (path to web/ from cwd) serves
the frontend from disk with Cache-Control: no-store instead of the go:embed copy.
Playwright's cached headless shell works without a full playwright install:
cd <scratch> && npm i playwright-core
# executablePath: ~/Library/Caches/ms-playwright/chromium_headless_shell-*/chrome-headless-shell-mac-arm64/chrome-headless-shell
--screenshot --virtual-time-budget capture shows HUD but NO stars — artifact,
not a bug).## Answer\ntext to a ticket while the map is open;
the 1.5s poller updates the HUD counts in ~2-3s.Flows worth driving: map render (all statuses + fog + edges), click star → panel
markdown, data-goto cross-ticket link, Escape closes, wheel zoom (labels thin
out), back button → splash/maplist.
npx playwright-core install webkit (~77MB, cached in ms-playwright) then
require("playwright-core").webkit.launch() — no executablePath needed.
Covered headlessly: full map render, the label-alpha fade workaround (capture a
frame ~600ms into loadMap: labels must be dim WITH the stars, not opaque over
them), touch tap via a hasTouch context, wheel zoom, panel markdown.
NOT reachable headlessly — manual Safari checklist: