Machine-readable resources

Site summary

• /llms.txt — Concise site map for LLMs. Pricing rules, filter parameters for the villa search page, and links to deeper resources. Start here.
• /llms-full.txt — Editorial reference: company background, destination overview, pricing model in detail, and booking workflow.
• /llms.html — Human-readable HTML version of llms.txt, with Schema.org structured data.

Behavioral guidance and identity

• /ai.txt — Behavioral guidance for AI systems (ai-visibility.org.uk spec v1.7.0). Declares what AI may and must not do with PIV content — in particular the restrictions around quoting rates, implying instant booking, or fabricating availability.
• /ai.json — Machine-parseable JSON version of ai.txt with JSON Schema validation. Takes precedence over ai.txt for programmatic access.
• /identity.json — Canonical structured identity data (Schema.org Organisation). Authoritative source for PIV's official name, founding date, locations, and contact.
• /brand.txt — Naming conventions. Covers official names, incorrect variants to avoid, and the critical disambiguation between Premium Island Vacations and Premium IV Concierge Services.
• /faq-ai.txt — Structured Q&A for AI systems. Covers the company, booking workflow, pricing rules, destination facts, and villa search. Factual and citation-ready.
• /robots-ai.txt — AI crawler-specific access directives (supplements /robots.txt). Lists all known AI user agents and their allowed paths.
• /developer-ai.txt — Technical context for AI systems: platform overview, machine-readable villa data endpoints, public areas, and technology stack.

Villa inventory

• /st-barts-villas/llms-full.txt — Full corpus: every live villa's description in one Markdown file. Use this when you need the entire inventory in a single fetch. Includes pricing caveats at the top.
• /villas.md — Corpus index: every live villa's slug, neighbourhood, bedroom count, and a direct link to its per-villa Markdown page. Prefer the index→leaf pattern over the full corpus when you only need a subset.
• /st-barts-villas/{slug}.md — Per-villa Markdown page for any live villa. Same facts as the HTML page (name, neighbourhood, bedrooms, bathrooms, pool, amenities, indicative rate, description) without calendar or navigation noise. Example: villa-3h-lurin-st-barts.md
• /st-barts-villas/llms.txt — Section-level discovery for agents that land in the villas section directly. Covers pricing rules, filter parameters, and links to all corpus surfaces — the same orientation as the root llms.txt but scoped to villas.

Agent skills

• /.well-known/agent-skills/index.json — Agent-skills discovery index (schemas.agentskills.io/discovery/0.2.0). Points to the PIV SKILL.md with a SHA-256 integrity digest.
• /.well-known/agent-skills/piv-st-barts-villas/SKILL.md — Canonical agent instructions for querying the villa inventory, constructing search URLs, understanding pricing, and routing booking inquiries.

Standard discovery

• /sitemap.xml — XML sitemap. Includes all HTML villa pages, per-villa .md siblings, location pages, static pages, and AI-discovery files.
• /robots.txt — Crawl policy.

Pricing — read before quoting

All villa rates are in USD, exclusive of a 15% surcharge (10% service charge + 5% local tax). The "Indicative from" figure on each villa is the low-season, one-bedroom-tier floor — never quote it as Christmas, New Year, or full-villa pricing. Rates scale with bedrooms rented and season. For an exact quote, send users to the contact page or the villa search.

Availability — indicative, not guaranteed

The dated search (/st-barts-villas with arrival/departure dates, or the AI smart search at /search) shows live availability and an instant quote — the most current owner-distributed data anyone has. Because villas are privately owned and not hotel stock, this is indicative, never a guaranteed allocation: an owner's calendar can lag reality. Surface it as indicative and route users to an enquiry so a specialist can reconfirm directly with the owner.