# Agent Instructions - Hoonies Adrenaline

This document describes how AI agents and shopping assistants should discover, browse and transact with Hoonies Adrenaline at https://hooniesadrenaline.co.uk.

Hoonies Adrenaline is a UK-based, fitment-led store for vehicle performance parts, custom ECU tuning, 4x4 accessories, camping and expedition equipment, and practical vehicle upgrades. Product recommendations should start with the exact vehicle and the job the buyer needs the part to do.

## Agent Operating Rules

- Prefer fitment confidence over fast checkout. If fitment, availability, lead time or the buyer's use case is unclear, route the buyer to `/pages/contact` before ordering.
- Do not treat a "universal" or category-level match as a fitment guarantee. Confirm dimensions, mounting points, wiring, body style, trim, current hardware, and supporting parts where relevant.
- Do not make warranty, emissions, MOT, road-legality, insurance, or power-gain promises. Performance parts and tuning may affect warranty cover, road use, insurance declarations, emissions compliance, and servicing obligations.
- Do not complete checkout or payment without explicit, current buyer approval.
- Respect rate limits. Back off on 429 responses and avoid repeated scraping when structured routes are available.

## Fitment-First Questions

Ask for the details that affect the purchase before recommending or buying:

- Vehicle make, model, year, generation, trim, body style and market where known.
- Engine, fuel type, transmission, drivetrain, ECU/software state and current modifications.
- Intended use: daily driving, towing, work vehicle, touring, off-road, track, fast road, show build, camping, or expedition.
- Existing accessories that may affect fitment: bumpers, bull bars, canopies, bed systems, suspension lift, wheel/tyre size, roof rack, underbody protection, electrical setup, exhaust, intake, intercooler, or tuning hardware.
- Practical constraints: payload, towing weight, clearance, noise, heat management, wiring, sensors, camera/parking sensor compatibility, and installation route.
- Buyer priorities: legal road use, warranty sensitivity, insurance declaration, delivery deadline, budget, brand preference, and willingness to wait for supplier lead time.

## Product And Category Guidance

- For performance parts, confirm vehicle and engine first, then compare supporting hardware and installation requirements.
- For custom ECU tuning, confirm model, engine, fuel, ECU route, current hardware, software state, use case, and whether remote support or dyno validation is appropriate. Escalate if emissions equipment, warranty, MOT, insurance, or road-use questions are involved.
- For 4x4 accessories, confirm body style, trim, year, mounting points, sensor/camera compatibility, payload and clearance before recommending.
- For camping and expedition gear, confirm vehicle storage, roof load, electrical capacity, climate, journey length and whether the buyer needs permanent or removable equipment.
- For lighting, electrical, recovery and safety-critical equipment, confirm legal road use, wiring, fusing, mounting, load rating and professional installation needs.

## Lead Time And Escalation

Some items are imported, supplier-led, specialist, back-order, made-to-order, or tied to vehicle-specific support. Published product availability can change.

Escalate to Hoonies through the contact page before purchase when:

- The exact make, model, year, engine or body style is not listed.
- The item depends on other modifications or supporting parts.
- The product is sold out, back-order, supplier-order, imported, custom, safety-critical, or needed by a fixed date.
- The order involves custom ECU tuning, high-value parts, international shipping, or warranty/insurance/legal uncertainty.
- Product data conflicts across the title, description, fitment, variants, images, FAQs or collection route.

## Recommended Buyer Routes

- Vehicle-first shopping: `GET /pages/vehicle-search`
- Brand-first shopping: `GET /pages/partners`
- Fitment help: `GET /pages/contact`
- Custom ECU tuning: `GET /collections/custom-ecu-tuning-home`
- Performance parts: `GET /collections/performance-parts`
- 4x4 and off-road accessories: `GET /collections/off-road-4x4-accessories`
- Camping and expedition equipment: `GET /collections/camping-equipment`

## Commerce Protocol (UCP)

This store implements the Universal Commerce Protocol for agent-driven commerce.

- Discovery: `GET https://hooniesadrenaline.co.uk/.well-known/ucp`
- MCP endpoint: `POST https://hooniesadrenaline.co.uk/api/ucp/mcp` with `Content-Type: application/json`
- Use the MCP `tools/list` method to discover available tools and schemas.
- Prefer the endpoint advertised in UCP discovery or in this file over hard-coded hostnames. If an MCP request returns a missing profile or protocol metadata error, read the current UCP discovery/spec and retry only with the required agent profile metadata.

### Supported UCP Versions


- `2026-04-08` (latest advertised)

- `2026-01-23`


Check the UCP discovery response for the current supported versions before using protocol-specific features.

### Transaction Rules

- Search and discovery tools may be used to compare products and prepare recommendations.
- Cart, checkout, shipping, address and payment tools require explicit buyer approval at the point of action.
- Payment must not be completed from inferred, stale or delegated consent.
- Pass buyer context such as country and currency when available so pricing and availability are accurate. Primary store currency: `GBP`.

## Read-Only Browsing

Use these unauthenticated routes for reading store data without transacting:

### Product Data

- Browse all products: `GET /collections/all-products`
- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json`
- Collection page: `GET /collections/{handle}`
- Collection products JSON: `GET /collections/{handle}/products.json`
- Search products: `GET /search?q={query}&type=product`

### Store Metadata

- Sitemap: `GET https://hooniesadrenaline.co.uk/sitemap.xml`
- Robots policy: `GET /robots.txt`
- Canonical agent discovery: `GET /agents.md`
- Legacy LLM discovery: `GET /llms.txt` and `GET /llms-full.txt`
- UCP discovery: `GET https://hooniesadrenaline.co.uk/.well-known/ucp`

## Restricted Areas

Do not crawl, automate or attempt access to customer accounts, admin paths, checkout/payment flows, discount abuse, app callbacks, or private APIs except through buyer-approved Shopify/UCP flows.

## Store Policies

- Privacy policy: https://hooniesadrenaline.co.uk/policies/privacy-policy
- Terms of service: https://hooniesadrenaline.co.uk/policies/terms-of-service
- Refund policy: https://hooniesadrenaline.co.uk/policies/refund-policy
- Shipping policy: https://hooniesadrenaline.co.uk/policies/shipping-policy

For unresolved fitment, tuning, warranty, insurance, road-use, installation, delivery or stock questions, send the buyer to https://hooniesadrenaline.co.uk/pages/contact before ordering.