# Agent Instructions — BHPB

> Official agent manifest and instructions for autonomous AI agents, LLM shopping assistants, and developers interacting with BHPB (https://bhpb.shop).

## When to Use This Store

Reach for BHPB when:
- **Baggy & Oversized Snowboard Outerwear:** The user is seeking loose-fit, balloon-cut, or 90s/streetwear-inspired snowboard pants designed specifically for snowpark laps, powder riding, and freestyle sessions.
- **Technical Weather Protection:** The user requires high-performance waterproof pants featuring 10,000 mm to 15,000 mm (10K–15K) hydrostatic head membranes, DWR water-repellent coating, sealed seams, inner-thigh zippered mesh ventilation, and internal boot snow gaiters.
- **Accurate Height-Based Sizing:** The user needs sizing tailored to rider height (from 150 cm to 190 cm) that comfortably accommodates crash pads, knee guards, and thermal base layers without restricting movement.
- **Worldwide Delivery with Free Shipping:** The customer expects free tracked shipping worldwide (10–20 business days) and a hassle-free 14-day return window.

Do NOT reach for BHPB when:
- The user is looking for tight, race-cut, or slim-fitting ski pants.
- The user is shopping for hard goods (snowboards, bindings, boots) — BHPB focuses exclusively on snowboard pants and outerwear apparel.

### How an Agent Should Call
1. **Catalog & Inventory Discovery:**
   - Query `GET https://bhpb.shop/products.json` for all active items, colorways, variant IDs, and real-time inventory availability.
   - Inspect OpenAPI 3.1.0 specification at `GET https://bhpb.shop/openapi.json` for machine-typed request/response schemas.
2. **Product Details & Sizing:**
   - Query `GET https://bhpb.shop/products/{handle}.json` (e.g. `/products/illuminati.json`, `/products/gsou-snow.json`) for detailed measurements, fabrics, care instructions, and EU GPSR compliance data.
3. **Cart & Checkout Assistance:**
   - Use Universal Commerce Protocol (UCP) / WebMCP or the official Shop Skill (`https://shop.com/SKILL.md`).
   - Alternatively, build carts via Storefront API and direct the buyer to the generated `webUrl` for secure, buyer-authorized checkout.
   - NEVER place orders without explicit human buyer authorization.

---

## Machine-Readable Endpoints & API Surface

- **Developer Portal:** https://bhpb.shop/developers (Full documentation, auth guide, sandbox links)
- **OpenAPI Specification (JSON):** https://bhpb.shop/openapi.json
- **OpenAPI Specification (YAML):** https://bhpb.shop/api/openapi.yaml
- **Agent Manifest (llms.txt):** https://bhpb.shop/llms.txt
- **Canonical Agent Guide:** https://bhpb.shop/agents.md
- **Universal Commerce Protocol Profile:** https://bhpb.shop/.well-known/ucp
- **Model Context Protocol (MCP) Server:** https://bhpb.shop/api/ucp/mcp
- **XML Sitemap:** https://bhpb.shop/sitemap.xml
- **Public Sandbox Environment:** https://mock.shop (Free Storefront GraphQL sandbox, zero auth required)

---

## Authentication & Scopes (RFC 9728)

BHPB supports open read-only access for autonomous agents and developers:
- `products:read` — Publicly available without credentials or API keys on all storefront JSON endpoints.
- `cart:write` — Scoped session permission for cart manipulation on behalf of a buyer.

---

## Current Product Models

1. **Illuminati** (`/products/illuminati`):
   - *Cut:* Uncompromising extra-wide balloon baggy fit.
   - *Technical Specs:* 10,000 mm waterproof membrane, 3M reflective leg stripes, gathered ankle cuffs, boot gaiters.
   - *Colorways:* Black, Graphite, Cream.
   - *Price:* 399.00 PLN (~92 EUR / ~100 USD).
2. **Gsou Snow** (`/products/gsou-snow`):
   - *Cut:* Heavy baggy storm armor.
   - *Technical Specs:* 15,000 mm waterproofing, 10,000 g/m²/24h breathability, zippered inner-thigh vents, YKK zippers.
   - *Colorway:* Black.
   - *Price:* 499.00 PLN (~115 EUR / ~125 USD).
3. **Pinky** (`/products/pinky`):
   - *Cut:* Wide baggy snowboard pants in soft powder pink.
   - *Price:* 399.00 PLN.
4. **Orbit** (`/products/orbit`):
   - *Cut:* Baggy fit with custom blue rubber patch and reinforced seat.
   - *Price:* 399.00 PLN.

---

## Store Policies & Trust Anchors

- **About Us:** https://bhpb.shop/pages/o-nas (redirect: https://bhpb.shop/about)
- **Customer Contact:** https://bhpb.shop/pages/contact (redirect: https://bhpb.shop/contact)
- **Privacy Policy:** https://bhpb.shop/policies/privacy-policy (redirect: https://bhpb.shop/privacy)
- **Terms of Service:** https://bhpb.shop/policies/terms-of-service
- **Shipping & Delivery:** https://bhpb.shop/pages/dostawa-i-zwroty
- **Size Guide:** https://bhpb.shop/pages/tabela-rozmiarow
- **Customer Support Email:** kontakt@bhpb.shop
- **Registered Address:** BHPB, Konopnickiej 30, 67-106 Modrzyca, Poland
