1---
2name: yar-cafe-menu-flow
3description: "Use for YAR in Odesa (вул. Шишкіна, 48/1; https://yar.choiceqr.com) when a user wants to pick food/drinks without opening the site manually. Trigger on requests to browse YAR menu, find suitable items from free-form preferences, show photo links with descriptions, or prepare concise order-ready options from full menu data."
4---
5 
6# yar-cafe-menu-flow
7 
8## Purpose
9 
10This skill lets the assistant act as a menu concierge for **YAR (Одеса, вул. Шишкіна, 48/1)**.
11It is built for the flow: user describes preferences in natural language -> assistant parses the full menu -> assistant returns suitable items with photo links and descriptions, so the user can choose without visiting the website.
12 
13## What this skill does
14 
15- Fetches all YAR sections from one URL (`menu`, `bar`, `wine-list`, `banketne-menyu`).
16- Normalizes menu data (name, price, category, description, section, photo URL).
17- Supports keyword search and free-text preference-based suggestions.
18- Generates share-ready cards (`photo link + description + price`).
19 
20## Core commands
21 
22### 1) Dump full menu data
23 
24```bash
25python3 scripts/yar_menu_flow.py dump --out yar_dump.json
26```
27 
28### 2) Search by query
29 
30```bash
31python3 scripts/yar_menu_flow.py search --input yar_dump.json --query "салат"
32```
33 
34### 3) Suggest from free-form preferences (AI-style flow)
35 
36```bash
37python3 scripts/yar_menu_flow.py suggest \
38  --input yar_dump.json \
39  --preference-text "Хочу щось ситне, без алкоголю, до 700 грн" \
40  --no-alcohol \
41  --budget 700
42```
43 
44Use `--with-drink auto|yes|no` to control whether drink pairing is included.
45 
46### 4) Build photo-link cards
47 
48```bash
49python3 scripts/yar_menu_flow.py cards \
50  --input yar_dump.json \
51  --query "десерт" \
52  --require-photo
53```
54 
55## Delivery rule (important)
56 
57When showing menu visuals in chat, prefer hyperlinks to menu photos:
58- Use `photo_markdown` (or `photo_html`) from card output.
59- Send one item per message for readability.
60- Use direct media attachment only when hyperlink format is not appropriate.
61 
62## Resources
63 
64- `scripts/yar_menu_flow.py` — deterministic parser/search/suggest/cards CLI.
65- `references/preferences_profile_example.md` — generic preference/filter template.
66