ux-research-toolkit

Guided UX research map creation — experience maps, journey maps, service blueprints, storyboards, and user story maps

Builds or imports user personas for UX research maps. Searches for existing persona data from SRD personas.yml, business-model-toolkit's perfil-expectativas-cliente.md, or previous map JSONs. Falls back to guided proto-persona CREATE mode (Lean UX 4-quadrant format) if no persona found — rapid persona creation in minutes, not months.

Composes interactive HTML visualization from JSON map data and component templates. Reads the map JSON, determines the active profile, loads corresponding component HTML files, injects data, and writes the final self-contained HTML file.

Direct creation of Customer Journey Maps. Use when the user explicitly asks for "customer journey map", "journey map", "mapa del journey", "mapa de viaje del cliente", "journey del cliente", "customer journey", "mapear el viaje", "viaje del usuario", "flujo del cliente", "/customer-journey-map", or when mapping the experience with a specific existing product/service. Shortcut that skips map type selection.

Runs a collaborative sketch exercise (Design Studio / Design Charrette) adapted for AI-assisted workflows. Use when the user asks for "design studio", "design charrette", "ideacion colaborativa", "ejercicio de sketches", "generar ideas de UI", "6-up", "divergencia de ideas", "/design-studio", or wants to rapidly explore design solution space for a specific problem. Based on Lean UX (Jeff Gothelf, O'Reilly 2013), cap. 5. Focuses on divergent thinking first, then convergence. Output is a decision document with 6 variants + critique + converged solution + parking lot.

Direct creation of Experience Maps (Day in the Life). Use when the user explicitly asks for "experience map", "day in the life map", "mapa de experiencia", "dia en la vida del usuario", "dia en la vida", "day in the life", "mapear un dia tipico", "rutina del usuario", "como es el dia de mi usuario", "/experience-map", or when the end user does not yet have an existing product/service. Shortcut that skips map type selection.

Advises on what feedback to expect (and NOT expect) from user research sessions based on the fidelity level of the artifact being tested (sketches, wireframes, high-fi mockups, clickable prototypes, coded builds). Use when the user asks "what should I test", "fidelity level", "what feedback to expect", "nivel de fidelidad", "que esperar del testing", "testing wireframes vs prototype", "/fidelity-guide", or is unsure whether an artifact is ready to show users. Based on Lean UX (Jeff Gothelf, O'Reilly 2013), cap. 5 — "The Fidelity Sweet Spot".

Guided UX research map creation from scratch. Use when the user asks to "create a journey map", "map user experience", "day in the life", "experience map", "mapear experiencia", "journey del usuario", "mapa de experiencia", "customer journey", "service blueprint", "mapa del cliente", "investigacion de usuarios", "UX research", "mapear la experiencia del usuario", "como vive mi usuario", "mapa de viaje", "experiencia del cliente", "entender a mis usuarios", "/map-workshop", or wants to understand their users' experience. Detects existing personas and guides non-experts through the full process.