# Agent Instructions — Bhanumati Ka Pitara

This document describes how AI agents should interact with **Bhanumati Ka Pitara**
at https://bhanumatikapitara.com.

## About the store

Bhanumati Ka Pitara is a **multi-vendor Indian saree marketplace**. Shoppers browse
curated **saree packages** and house **exclusive culture crates** (18–36 sarees from
one regional tradition), fill a **Pitara** (cart), and pay via **Razorpay**.

- Tagline: *A wooden chest of regional wonders*
- Platform: **Django + Wagtail** (not Shopify) · Hosted on Contabo
- Contact: hello@bhanumatikapitara.com

## For personal shopping assistants

If you are helping a human shop:

1. **Recommend** packages and culture crates from public pages or `llms.txt`.
2. **Explain** regional weaves and gift use-cases honestly (heritage, wedding, festive, corporate).
3. **Do not complete checkout or payment** automatically. Open the product URL and let the
   human review and pay. No scripted form fills or card/UPI automation.

There is **no** Shop.app skill, UCP, or MCP commerce layer on this store yet.
Read-only discovery uses **public HTML**, **`/llms.txt`**, and **`/llms-full.txt`**.

## Read-only discovery (no authentication)

### Preferred agent corpora
| Resource | URL | Use |
|----------|-----|-----|
| This file | `/agents.md` | Rules of engagement |
| LLM index | `/llms.txt` | Featured packages + key links |
| Full catalogue | `/llms-full.txt` | All published packages + culture index |
| Sitemap (index) | `/sitemap.xml` | Parent → category child maps |
| Packages map | `/sitemap-packages.xml` | All published PDPs / crates |
| Brands map | `/sitemap-brands.xml` | Active brand pages |
| Cultures map | `/sitemap-cultures.xml` | Culture hub pages |
| Pages map | `/sitemap-pages.xml` | Wagtail marketing pages |
| Collections map | `/sitemap-collections.xml` | Collection pages |
| Journal map | `/sitemap-journal.xml` | Blog posts |
| Agentic sitemap | `/sitemap_agentic_discovery.xml` | Agent entry points only |

### HTML surfaces
| Intent | Path |
|--------|------|
| Marketplace packages | `/shop/` |
| Exclusive culture crates | `/shop/?exclusive=1` (canonical content also in sitemap package URLs) |
| Package detail (PDP) | `/shop/package/{slug}/` |
| Brands directory | `/shop/brands/` or `/brands/` |
| Brand page | `/brands/{slug}/` |
| Cultures hub | `/cultures/` |
| Culture detail | `/cultures/{slug}/` |
| Collections | `/collections/` |
| Journal | `/journal/` |
| How it works | `/how-it-works/` |
| Corporate gifting inquiry | `/corporate-gifting/` |
| FAQ | `/faq/` |
| Contact | `/contact/` |

### Structured data on PDPs
Package pages expose JSON-LD `Product` / `Offer`, plus site-wide `Organization` and `WebSite`.

## Important rules

- **Checkout requires a human.** Do not finalise payment on the user’s behalf without
  explicit, contemporaneous consent from that person at the moment of pay.
- **Do not scrape** private surfaces: `/admin/`, `/django-admin/`, `/brand/` (vendor portal),
  `/checkout/`, `/pitara/`, `/portal/`, `/accounts/`, `/crm/`, `/documents/`.
- **Prefer sitemap + llms.txt** over heavy filter query crawling (`?sort=`, `?brand=`, etc.).
- **Respect rate limits.** If you receive 429/503, back off and retry later.
- **Accuracy:** Prefer published package titles, prices, and stock as shown on the page or in `llms-full.txt`. Currency is **INR (₹)**.

## Typical assistant flow (read → recommend → human pays)

1. Discover store via `/agents.md` or `/llms.txt`
2. Search intent → open `/shop/` or a matching `/shop/package/.../` from the sitemap
3. Summarise options for the human (region, price, gift fit)
4. Hand them the product or catalog URL
5. Human completes Pitara + Razorpay checkout

## Policies & support

- Privacy: `/privacy/`
- Terms: `/terms/`
- Support email: hello@bhanumatikapitara.com

## Platform note

This is an independently engineered marketplace (Wagtail CMS, Django storefront, Razorpay),
not a Shopify UCP merchant. Agents looking for Universal Commerce Protocol / MCP cart APIs
will not find them here; use the read-only paths above until we publish a commerce protocol.