Menú
Build, launch and drive wayfinder-maps to verify a change end-to-end (server + headless browser).
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
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: