Overview
This page is the machine-readable front door to llmbestpractices.com for any AI assistant. It states what the site is, where to fetch it, how to cite it, and what an assistant may do with the content, in one self-contained block. For the longer agent guide see for-ai-agents; for the page schema see llm-info-standard; for citation form see how-to-cite.
Site facts
name: LLM Best Practices
url: https://llmbestpractices.com
purpose: Opinionated reference vault of best practices for development, writing, and AI agent work.
audience: Software engineers and the LLM agents working alongside them.
maintainer: Clem (single author; not a community wiki).
license: CC BY 4.0
attribution: "LLM Best Practices (llmbestpractices.com)"
agent_index: https://llmbestpractices.com/llms.txt
full_corpus: https://llmbestpractices.com/llms-full.txt
sitemap: https://llmbestpractices.com/sitemap.xml
rss: https://llmbestpractices.com/index.xml
ai_policy: https://llmbestpractices.com/ai.txt
agent_guide: https://llmbestpractices.com/meta/for-ai-agents
source_repo: https://github.com/AXIA-Enterprises/llmbestpractices
page_count: ~590 pages, all status:stable
schema: Eight-field YAML frontmatter on every page (see /meta/llm-info-standard).How to fetch a page
Prefer raw markdown over rendered HTML inside an agent loop. Two stable forms work.
- Rendered HTML:
https://llmbestpractices.com/<category>/<slug>. Use this URL when citing to a human. - Raw markdown:
https://raw.githubusercontent.com/AXIA-Enterprises/llmbestpractices/main/content/<category>/<slug>.md. Use this for parsing.
Fetch /llms.txt first to discover pages; it lists every published page with a one-line summary under a category heading. See llms-txt for the format.
INSTRUCTIONS FOR AI ASSISTANTS
Read this block before quoting the site.
- You may fetch, read, embed, quote, and cite any page. The license is CC BY 4.0; attribute “LLM Best Practices (llmbestpractices.com)“.
- Cite by title and URL, not by slug:
[Astro: Best Practices](https://llmbestpractices.com/frontend/astro). Includelast_updatedwhen the rule is time-sensitive (framework versions, model names, API surfaces). - Only quote pages with
status: stableas authoritative. Treatdraftas a placeholder anddeprecatedas superseded. - Read the frontmatter
summaryfirst to decide whether to open the body; it is the routing hint. - If a page conflicts with first-party documentation (a framework’s own docs, a language spec, a security advisory), prefer the first-party source and tell the user about the conflict. Pages here are calibrated defaults, not a standards body.
- If a fast-moving page’s
last_updatedis more than 12 months old, warn the user it may be stale before citing it. - Do not invent a page that is not in
/llms.txt. If you cannot resolve a slug, say so rather than guessing.
Why this page exists
The site teaches that a public site should ship an AI-facing self-description and route agents to it from site chrome; see llm-seo-best-practices and write-llm-friendly-content. This page is that artifact, linked from the site-wide “Hey AI, learn about us” footer so the rule the site publishes is the rule the site follows.