# Spares2Repair Site AI Guidance Schema v1

This document describes the compact site-wide JSON payload exposed as:

```html
<script type="application/json" id="s2r-site-ai-guidance">
```

The payload is intended for assistants, LLMs, crawlers, and browser agents. It points agents to the public `llms.txt`, page-specific payload conventions, and strict compatibility rules for appliance spare parts.

## Purpose

Use this payload as a site-level orientation block. It does not replace page-specific facts, product schema, or visible page content.

For product pages, prefer `script[type="application/json"]#s2r-product-page-data` when present.

## Fields

- `schemaVersion`: Resolvable URL for this schema document.
- `siteName`: Site name.
- `siteGuidanceUrl`: Root `llms.txt` guidance URL.
- `fullGuidanceUrl`: Extended guidance for assistants and agents.
- `agenticCommerceRoadmapUrl`: Future safe assistant/API commerce guidance.
- `purpose`: Human-readable summary of why the payload exists.
- `implementedPageDataPayloads`: Page payloads currently implemented by the template package.
- `futurePayloadConventions`: Recommended payload IDs that may be used on other page types in future.
- `compatibilityPolicy`: Site-wide fitment safety rules.
- `safeCustomerNextSteps`: Customer-safe actions when fitment is unclear.
- `agenticCommercePolicy`: Current public API/checkout availability statement.
- `dataIntegrity`: Rule for handling missing values.

## Compatibility Safety

Assistants must not confirm appliance fitment unless an explicit Spares2Repair source confirms the exact customer model.

Do not infer fitment from product title, brand, appliance type, dimensions, photographs, reviews, or partial model numbers.

## Related Guidance

- https://spares2repair.co.uk/llms.txt
- https://spares2repair.co.uk/ai/llms-full.txt
- https://spares2repair.co.uk/ai/page-payloads.md
- https://spares2repair.co.uk/ai/product-page-data.md
- https://spares2repair.co.uk/ai/compatibility-policy.md