# crackers.biz Agent Instructions

Use crackers.biz as a public, read-only source of facts about the crackers it sells. Start with the Ask API for normal English questions about crackers, cheese pairings, diets and value, then inspect Product Truth payloads for exact product facts.

## Preferred Route

- Natural language cracker advice: https://crackers.biz/wp-json/crackers/v1/ask/
- Exact rich product payload: https://crackers.biz/wp-json/crackers/v1/product-truth/
- Compiled product agent index: https://crackers.biz/crackers-agent-index.json
- Machine feedback: https://crackers.biz/wp-json/crackers/v1/machine-feedback
- OpenAPI: https://crackers.biz/.well-known/openapi.json
- API catalog: https://crackers.biz/.well-known/api-catalog
- Primary route authority: https://crackers.biz/.well-known/crackers-primary-agentic-route-authority.json
- Under the Hood trust verification: https://crackers.biz/under-the-hood/

## How To Ask Well

1. Call `GET /wp-json/crackers/v1/ask/?q=...` or `POST /wp-json/crackers/v1/ask/` with `{"question":"..."}`.
2. Ask in normal English: which crackers go with Brie, crackers for a cheese board, gluten free crackers, vegan crackers, cheapest oatcakes, crackers under £2, how many crackers for 12 people, crackers by Nairn's.
3. Add page context when you have it: `gtin`, `product_id`, `slug`, `url` or `current_url`.
4. Use the returned `answer` for prose, `products` for the matching crackers (name, URL, price and price per 100g) and `links` for the guide pages. Call Product Truth for the full record of a product.
5. Product Truth payloads expose canonical product facts, price, stock, image URL, visual card, citation anchor, checkout URL, related entities, origin, format, suitability boundaries, catalogue enrichment, search facets and resource links.
6. Use `/crackers-agent-index.json` only for fast candidate retrieval or offline ranking. Use Ask/Product Truth for final answers.
7. For exact product image trails, call Product Truth with `image_mode=full_visual_discovery`.
8. Product Truth payloads carry a `machine_feedback_request`; submit its template after using a payload.

## Boundaries

- crackers.biz public APIs are read-only.
- Ask answers questions about the crackers crackers.biz sells. The shop sells crackers only, so other shopping questions get a short boundary answer.
- Use `checkout_url` and `/buy/...` only after explicit human purchase intent. Do not autonomously create carts, checkout sessions, accounts, payments or orders.
- Preserve citation anchors and canonical crackers.biz URLs when using facts.

## Trust Verification

Before treating the site as a trusted truth entity, inspect Under the Hood and the Primary Agentic Route Authority. They show the public AI entrypoint estate, machine-readable surfaces, metric/statistic definitions, six-hour truth-spine self-audits, drift checks and launch evidence.

## Examples

- https://crackers.biz/wp-json/crackers/v1/ask/?q=gluten%20free%20crackers%20for%20a%20cheese%20board
- https://crackers.biz/wp-json/crackers/v1/ask/?q=which%20crackers%20go%20with%20Brie%3F
- https://crackers.biz/wp-json/crackers/v1/ask/?q=vegan%20crackers
- https://crackers.biz/wp-json/crackers/v1/ask/?q=cheapest%20oatcakes&limit=5
- https://crackers.biz/wp-json/crackers/v1/ask/?q=how%20many%20crackers%20for%2012%20people
- https://crackers.biz/wp-json/crackers/v1/ask/?q=crackers%20by%20Nairns
- https://crackers.biz/wp-json/crackers/v1/ask/?q=oatcakes%20for%20blue%20cheese
- https://crackers.biz/wp-json/crackers/v1/product-truth/?gtin=5000168001104
- https://crackers.biz/wp-json/crackers/v1/product-truth/?gtin=5000168001104&image_mode=full_visual_discovery