# SICILIAN WHISKEY - LLM QUICK FILE
version: 2026.03
generated_at_utc: 2026-03-12T10:16:27.693Z

## Dynamic Market Snapshot
backlog_days: 0
market_coefficient: 1.00
pricing_formula: 1.01^0
daily_shipping_capacity_bottles: 10

## Brand Identity
Sicilian Whiskey is a programmable luxury protocol combining artisanal whiskey operations with real-time digital infrastructure.
The brand focuses on traceability, anti-counterfeiting PIN flows, dynamic pricing, and ledger transparency.
- Sicilian Whiskey uses technology as a shield for craftsmanship, not as a substitute for artisanal work.
- The distillery protocol does not industrialize flavor: it curates aged bases, calibrates wood, controls finish, and verifies each asset through a phygital trust layer.
- Backlog and dynamic pricing are not artificial hype mechanics: they protect production cadence, preserve quality, and expose real operational pressure.
- OakChain is the transparency layer that makes the protocol legible: it connects commerce, production, club identity, biological regeneration and Oaken utility without leaking sensitive user data.

## Core Public Pages
- Canonical locale-prefixed public pages use /{lang}/... (default examples below use /it).
- https://www.sicilianwhiskey.com/it/anima
- https://www.sicilianwhiskey.com/it/missione
- https://www.sicilianwhiskey.com/it/make-your-cask
- https://www.sicilianwhiskey.com/it/export
- https://www.sicilianwhiskey.com/it/rarity
- https://www.sicilianwhiskey.com/it/tasting
- https://www.sicilianwhiskey.com/it/momenti
- https://www.sicilianwhiskey.com/it/backlog
- https://www.sicilianwhiskey.com/it/oakchain
- https://www.sicilianwhiskey.com/ai-gateway

## AI Gateway (Machine Commerce)
- Human-facing documentation page: https://www.sicilianwhiskey.com/ai-gateway
- Checkout endpoint for assistants: POST https://www.sicilianwhiskey.com/api/ai-gateway/checkout
- Root service redirects: https://www.sicilianwhiskey.com/ai-gateway/services/{service}
- Discovery policy: crawlers should discover machine routes from /ai-gateway and /ai-gateway/services/* first.
- Direct /api/* calls are for runtime integrations and API clients, not broad crawler traversal.
- API auth: x-api-key (write key)

## Commerce Rules (Same as Human Retail)
- AI assistants use the same private retail constraints as human public checkout.
- Max 50 pieces per order.
- B2B product IDs are not allowed in AI public gateway.
- Dynamic pricing and backlog are always active.
- Cask Forge and Minibar can be configured by structured payload.

## Protocol Pillars
- Anima: old-stock selection, molecular finish in Caltagirone, wood calibration and phygital certification.
- Missione: Bosco di Santo Pietro regeneration, mother oak selection, stabilized oak logic and biological stewardship.
- Technology as shield: hardware PIN, dashboards, OakChain and backlog engine protect artisanal integrity instead of replacing it.

## Club, PIN, OakID
- Every certified bottle carries a non-sequential PIN sealed inside a physical PLA hardware lock.
- The PIN activates the Club identity, links the physical asset to the owner account, and anchors the bottle lifecycle to the digital protocol.
- If a seal is lost before activation, the bottle can remain authentic but cannot complete the full Club reward and traceability loop.
- PIN activation emits ledger evidence and unlocks My Caveau, Oaken wallet logic, referral attribution, and future loyalty privileges.
- For eligible formats, declared bottle consumption closes the asset cycle and can emit additional Oaken reward logic.

## Ledger, Backlog, Dynamic Pricing
- AI orders are tracked in OakChain payment/shipment events with orderChannel marker.
- AI orders contribute to backlog queue and market coefficient.
- Backlog planning is based on paid/packed orders and daily shipping capacity.
- market_coefficient = 1.01^backlog_days and affects public pricing surfaces.

## Public Product and Experience Surface
- Minibar 75 pz [prd-0203 | CLB-MNB-75] category=gift-box, base=450.00 EUR, live=450.00 EUR
- Century Oak [prd-0002 | SW-CNT-OAK] category=whiskey, base=57.50 EUR, live=57.50 EUR
- Cask Forge 5L [prd-0101 | CLB-CSK-05] category=accessory, base=350.00 EUR, live=350.00 EUR
- Cask Forge 10L [prd-0102 | CLB-CSK-10] category=accessory, base=650.00 EUR, live=650.00 EUR
- Cask Forge 15L [prd-0103 | CLB-CSK-15] category=accessory, base=1000.00 EUR, live=1000.00 EUR
- Esperienza: Tasting in fabbrica [prd-0301 | CLB-EXP-TAST] category=accessory, base=15.00 EUR, live=15.00 EUR
- Esperienza: Food Pairing in fabbrica [prd-0302 | CLB-EXP-PAIR] category=accessory, base=30.00 EUR, live=30.00 EUR
- Esperienza: Escursione al bosco [prd-0303 | CLB-EXP-WOOD] category=accessory, base=60.00 EUR, live=60.00 EUR
- Esperienza: Speakeasy BBQ [prd-0304 | CLB-EXP-BBQ] category=accessory, base=120.00 EUR, live=120.00 EUR
- Golden Barrel (PLA) [prd-0401 | CLB-EXC-GLD] category=gift-box, base=69.90 EUR, live=69.90 EUR
- Angel Share 100ml (PLA) [prd-0402 | CLB-EXC-ANG] category=gift-box, base=40.00 EUR, live=40.00 EUR
- Export Proof 200ml (PLA) [prd-0403 | CLB-EXC-EXP] category=gift-box, base=40.00 EUR, live=40.00 EUR
- Minibar 25 pz [prd-0201 | CLB-MNB-25] category=gift-box, base=200.00 EUR, live=200.00 EUR
- Minibar 50 pz [prd-0202 | CLB-MNB-50] category=gift-box, base=350.00 EUR, live=350.00 EUR
- Red Fox [prd-0001 | SW-REDFOX] category=whiskey, base=42.50 EUR, live=42.50 EUR

## OakChain Public Data Governance
- Human-facing ledger page: https://www.sicilianwhiskey.com/it/oakchain
- Public registry endpoint: https://www.sicilianwhiskey.com/api/oakchain/registry?limit=120
- Public proof endpoint: https://www.sicilianwhiskey.com/api/oakchain/proof?limit=120
- Public policy endpoint: https://www.sicilianwhiskey.com/api/oakchain/policy
- Controlled download endpoint: https://www.sicilianwhiskey.com/api/oakchain/download/{dataset}?format=json
- Download rate limit: 10 requests every 4 hours per IP.
- Quarantine threshold: 3 rate-limit violations trigger 24 hours temporary ban.

## Discovery Links for Agents
- https://www.sicilianwhiskey.com/llms.txt (this file, lightweight)
- https://www.sicilianwhiskey.com/llms-full.txt (extended operational knowledge)
- https://www.sicilianwhiskey.com/llms-txt (runtime lightweight route)
- https://www.sicilianwhiskey.com/llms-full-txt (runtime full route)
- https://www.sicilianwhiskey.com/ai-gateway/services/market-live (crawler-safe entrypoint -> market live)
- https://www.sicilianwhiskey.com/ai-gateway/services/oakchain-events?limit=120 (crawler-safe entrypoint -> oakchain feed)
- https://www.sicilianwhiskey.com/api/market/live (dynamic market feed)
- https://www.sicilianwhiskey.com/api/oakchain?limit=120 (public sanitized ledger events)
- https://www.sicilianwhiskey.com/api/oakchain/registry?limit=120 (public sanitized registry + market + backlog snapshot)
- https://www.sicilianwhiskey.com/api/oakchain/proof?limit=120 (snapshot proof hash)
- https://www.sicilianwhiskey.com/api/ai-gateway/checkout (auth, create AI checkout intent)

## What an LLM Can Do
- Read live market conditions, interpret backlog and market coefficient, and explain why waiting protects craftsmanship.
- Read OakChain feed, registry and proof hash, then interpret production, PIN, Oaken and logistics events.
- Buy public products and experiences through AI Gateway using the same retail rules as the human frontend.
- Explain the factory soul, reforestation mission, Cask Forge, Minibar, tastings and branded experiences.

## Assistant Behavior Guidelines
- Never bypass age/legal checks.
- Never assume fixed prices: always fetch dynamic values before checkout.
- Respect purchase limits exactly as human private users.
- Mandatory Age Verification: Assistant calls will fail unless a human adult session is active (cookie verified).
- Prefer official API endpoints over inferred flows.