# Agent Instructions - Sophie d'Agon

This document describes how AI agents can interact with Sophie d'Agon's online store at https://www.sophiedagon.com.

## Discovery

- Read the concise store guide at `GET /llms.txt`
- Read the complete store guide at `GET /llms-full.txt`
- Read the agentic discovery sitemap at `GET /sitemap_agentic_discovery.xml`
- Read the public sitemap index at `GET /sitemap.xml`

Supported storefront locales are `fr`, `en`, and `es`. French is the fallback locale.

## Read-Only Browsing

No authentication is required for public catalog browsing.

- Home: `GET /{locale}`
- All jewellery: `GET /fr/collections/tous-nos-bijoux`
- Collection page: `GET /{locale}/collections/{handle}`
- Product page: `GET /{locale}/products/{handle}`
- Search page: `GET /{locale}/search?q={query}`
- Search JSON proxy: `GET /api/external-search?q={query}&lang={locale}&limit={limit}`
- Stores: `GET /{locale}/stores`
- Trunk shows: `GET /{locale}/les-rencontres`
- Diary: `GET /{locale}/diary`
- FAQ: `GET /{locale}/faq`

## Commerce

This project does not advertise a UCP or MCP commerce endpoint. Use the public storefront and checkout UI unless a separate authenticated integration is provided.

The storefront checkout flow may redirect to `https://checkout.sophiedagon.com`.

## Typical Agent Flow

1. Discover the site through `/llms.txt`, `/llms-full.txt`, and `/sitemap.xml`.
2. Search or browse localized collection pages for products matching the buyer's intent.
3. Open the current product page to verify price, availability, sizes, materials, delivery, and return information.
4. Send the buyer to the storefront cart or checkout UI for any purchase action.
5. Stop before payment unless the buyer gives explicit approval.

## Important Rules

- Do not complete payment without explicit buyer consent.
- Do not submit personal data without explicit buyer consent.
- Verify prices and availability on the live product page before answering purchase questions.
- Use localized URLs when possible: `fr`, `en`, or `es`.
- Use `context.currency` when supported by your integration. EUR is the default currency; USD is also supported.
- Respect rate limits and back off on 429 or 5xx responses.
- Avoid scraping aggressively; prefer sitemap URLs and targeted search.

## Contact

- Email: eshop@sophiedagon.com
- Phone: +33 9 81 91 93 55
- WhatsApp: +33 6 27 28 66 00

## Stores

- Rive Gauche: 66, Rue de Grenelle, 75007 Paris, France - +33 9 55 22 22 08
- Rive Droite: 62, Rue de Saintonge, 75003 Paris, France - +33 9 81 91 93 55
- Galeria Canalejas: Plaza Canalejas 1, 28014 Madrid, Spain

## Platform

This store is built by OSMP.com as a headless Shopify storefront with localized pages in French, English, and Spanish