rengwu/wayfinder-maps

Provides a shared vocabulary and principles for designing deep modules with small interfaces and high leverage. Use when structuring code for testability, maintainability, and AI-navigability.

Actively build and sharpen a project's domain model by challenging terms, capturing a precise glossary, and recording architectural decisions when they meet strict criteria.

A relentless interview to sharpen a plan or design — one question at a time until every branch of the decision tree is resolved. Use it when you need to clarify and solidify a plan before execution.

A relentless interview process to sharpen a plan or design, producing Architecture Decision Records and a glossary as shared understanding is reached.

Generates a handoff document summarizing the current agent conversation, including suggested next skills and redacting sensitive information. Saves to the repository's .plan/handoffs/ directory for shared planning memory.

Scans a codebase for architectural friction and proposes deepening refactors that improve locality, testability, and AI navigability. Use it when you want a visual review of shallow modules and coupled seams.

Build a throwaway prototype to answer a design question. Use when you want to sanity-check a state model or logic, or explore UI variations.

Investigates questions using high-trust primary sources and saves cited findings as a Markdown file. Ideal for researching topics, gathering docs or API facts, and delegating reading legwork.

Review code changes against repo coding standards and spec requirements in two isolated axes (Standards and Spec). Use when reviewing branches, WIP, or requesting a diff review from a specific point.

Synthesizes a software specification from the ongoing conversation and saves it as a structured plan document. Useful for capturing requirements and decisions without interrupting the workflow.

Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges, saved to `.plan/`.

Build, launch, and drive the wayfinder-maps server with a headless browser to verify changes end-to-end. Suitable for validating map visualization, interactions, and cross-browser behavior.

Wayfinder Maps plans large efforts as a shared map of investigation tickets, then resolves them one at a time until the route to the destination is clear. Use it when the work is too big for one session and needs decisions, not deliverables.

Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.