# JSON Server Field Guide AI Discovery File
# This file describes how AI agents and automated tools can interact with this documentation site.

Site-Name: JSON Server Field Guide
Site-Description: An unofficial, example-driven companion for json-server@1.0.0-beta.15. Every claim is backed by a recorded fixture.
Site-URL: https://json-server-field-guide.vercel.app
Docs-Format: application/json, application/ld+json, text/markdown
Docs-API: https://json-server-field-guide.vercel.app/api/docs/{slug}
Docs-Index: https://json-server-field-guide.vercel.app/api/docs-index
Docs-LLMs: https://json-server-field-guide.vercel.app/llms.txt
Docs-LLMs-Full: https://json-server-field-guide.vercel.app/llms-full.txt
Docs-Skill: https://json-server-field-guide.vercel.app/skill.md
Docs-Agent-Guidance: https://json-server-field-guide.vercel.app/AGENTS.md
Docs-Search: https://json-server-field-guide.vercel.app/api/search?q={query}
Docs-Agent-Readiness: https://json-server-field-guide.vercel.app/api/agent-readiness
Docs-MCP: https://json-server-field-guide.vercel.app/api/mcp
Docs-OpenAPI: https://json-server-field-guide.vercel.app/openapi.yaml
Docs-Locale-Default: en
Docs-Repository: https://github.com/Ebendttl/json-server-field-guide

# Content negotiation
# Accept: application/json       → structured JSON payload (title, headings, nav, code blocks)
# Accept: application/ld+json    → schema.org JSON-LD (TechArticle + BreadcrumbList)
# Accept: text/markdown          → Markdown with YAML frontmatter
# ?format=json                   → explicit JSON override
# ?format=ldjson                 → explicit JSON-LD override
# ?format=md                     → explicit Markdown override

# Agent operating instructions
# Search or read the index before selecting pages.
# Cite canonical page URLs and distinguish documented facts from inference.
# Read /AGENTS.md before editing. The public /api/mcp endpoint is read-only.

Allow: /
Allow: /llms.txt
Allow: /llms-full.txt
Allow: /skill.md
Allow: /AGENTS.md
Allow: /api/docs/
Allow: /api/docs-index
Allow: /api/search
Allow: /api/agent-readiness
Allow: /api/mcp
Disallow: /api/chat
Disallow: /api/feedback
Disallow: /api/try-it
Crawl-Delay: 1