# Use slipslop to get inspiration

Fetch the vocabulary first: `curl -sS 'https://www.slipslop.dev/api/vocabulary'`.
Score only terms you are confident about from 0 to 1 using their descriptions and anchors. Omitted terms are not compared; unknown ids are ignored. Describe the project, audience and desired feel, rather than scoring its current generic appearance.

Create a session with the actual project and your scores:

```sh
curl -sS -X POST 'https://www.slipslop.dev/api/sessions' -H 'Content-Type: application/json' \
  -d '{"project":{"name":"Notely","description":"AI note-taking app","stack":"HTML + CSS"},
    "target":{"playful":0.6,"consumer":0.9},"platform":"web","limit":8}'
```

Save the response's id as SESSION_ID. Open pickUrl for the user: `open <url>` on macOS,
`xdg-open <url>` on Linux, `start <url>` on Windows, or print the URL.
The pick page opens the orbit on the best match. The user browses, presses Apply on the one they
like, then chooses how it should be applied — the design system, colours only, layout & structure,
a faithful recreation, or their own instructions — and sends it to you.

Wait for the user, repeating this call while status is pending:

```sh
curl -sS "https://www.slipslop.dev/api/sessions/$SESSION_ID?wait=25"
```

A pending response after 25 seconds is normal; call again. Stop on picked or a 404 (expired).
Sessions last 24 hours. The pick page submits the user's chosen slug and mode with this third
call; do not choose either on the user's behalf:

```sh
curl -sS -X POST "https://www.slipslop.dev/api/sessions/$SESSION_ID/pick" \
  -H 'Content-Type: application/json' -d '{"slug":"atlas-workos","mode":"system"}'
```

## Apply the picked reference

The picked response's `pick.mode` says what the user wants taken from the reference, `pick.note`
carries their own words when the mode is `custom`, and `pick.instructions` spells out what to do.
`pick.instructions` is authoritative — follow it, using `designMd`, `tokens` and `shots` as the
reference material and keeping the project's own content and stack.

- `system` — **Design system**: Its palette, type, radius, spacing and component conventions, applied to my current layout and content.
- `palette` — **Colours only**: Just its colour scheme and colour roles. Keep my type, layout and everything else.
- `structure` — **Layout & structure**: Its page structure, section order, grid and visual hierarchy. Keep my colours and type.
- `replica` — **Faithful recreation**: Rebuild my page to look as close to this reference as possible, with my content, copy and images in place of theirs.
- `custom` — **Custom instructions**: Tell the agent what to take from this reference in your own words.

Whatever the mode, say what changed and name the reference with its `sourceUrl`.