> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userintuition.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Map shopper journey

> Use when the user wants shopper research on the path to purchase for a CPG brand or retailer, in store or online: the trip trigger, the shelf or product page, substitutions, and the decision in the aisle.

Use when the user wants shopper research on the path to purchase for a CPG brand or retailer, in store or online: the trip trigger, the shelf or product page, substitutions, and the decision in the aisle.

[Fetch raw SKILL.md](https://raw.githubusercontent.com/user-intuition/skills/e80368fd14123e3626c8c209989eff5d1313518e/plugins/user-intuition-research/skills/map-shopper-journey/SKILL.md) · [Source](https://github.com/user-intuition/skills/blob/e80368fd14123e3626c8c209989eff5d1313518e/plugins/user-intuition-research/skills/map-shopper-journey/SKILL.md) · [All skills](https://docs.userintuition.ai/skills/library.md)

Requires an authenticated [User Intuition MCP connection](https://docs.userintuition.ai/mcp-server/quickstart.md). Install the raw file as `map-shopper-journey/SKILL.md` inside your agent client's supported skills directory. The raw file is the installable artifact; this page is its documentation wrapper.

SHA-256: `0688dc9fcb46880f4a436c37134c749149ee4992de40dce3696b7eadb069d26f`

## Instructions

```markdown theme={null}
---
name: map-shopper-journey
description: Use when the user wants shopper research on the path to purchase for a CPG brand or retailer, in store or online: the trip trigger, the shelf or product page, substitutions, and the decision in the aisle.
allowed-tools: Read
---

When the user wants to map the shopper journey:

Apply the shared [consumer panel study policy](references/consumer-panel-study.md) and [approval and workflow continuity policy](references/approval-continuity.md).

1. Ask which trip and which decision: the category, the retailer or channel (in store, online, delivery app), and what the user will change (shelf placement, pack, promotion, page content, assortment).
2. Define the shoppers by a recent trip: bought the category at that retailer or channel in the last 2–4 weeks, so the trip is fresh. Use the panel by default; use `interview-recent-buyers` if the user has their own order or loyalty data.
3. Create the study with `create-study-from-brief` (Panel). A good brief walks the trip in order: the trigger for the trip, the list or plan, arriving at the shelf or page, what they noticed first, what they compared, what nearly stopped them, any substitution when an item was missing, checkout, and first use at home. Each stage should anchor on what they did on that trip.
4. Sharpen screening with `design-screeners`, then estimate and launch with `field-a-panel`. Use one study per country. The human approves the saved plan, then the complete quote, before anything is spent.
5. When interviews complete, offer `analyze-completed-study` and lay the findings out stage by stage, with the friction moments counted per stage.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.