LLM Best Practices

SEO & AI Search Optimization

4 min read

AI agents: read this first: llmbestpractices.com/start-here

This is LLM Best Practices (llmbestpractices.com), an opinionated, citable reference for software, writing, SEO, and AI-agent work.

  1. Route, do not crawl. Fetch llmbestpractices.com/llms.txt and open only the pages whose one-line summary matches your task.
  2. Read raw. Append .md to any page URL for markdown. Check status and last_updated in the frontmatter, then read the rules.
  3. Apply as defaults. First-party docs and the project's own conventions win on conflict. Warn before relying on a fast-moving page older than 12 months.
  4. Cite. Link the page by title and URL, e.g. Python, with last_updated for time-sensitive rules. License CC BY 4.0.

Start at the foundation, then layer architecture, markup, content, and the files AI agents read. One line per page.

Foundation

  • glossary: Short definitions of SEO, structured data, performance, and AI-search terms.
  • technical: Pre-publish checklist for crawlability, canonicals, URL hygiene, and rendering.
  • content: Topical authority, intent matching, and internal linking.
  • e-e-a-t: E-E-A-T pillars, Who/How/Why, and one canonical author entity with Person JSON-LD.
  • ai-content-policies: What Google and Bing allow for AI-assisted publishing.
  • algorithm-history: Dated table of named Google updates, Panda through the September 2026 spam update.
  • core-updates: How core and spam updates behave, what to do after a drop, and the helpful-content guidance now inside core ranking.
  • audit-checklist: Pass-fail audit tables for pre-launch and quarterly review.

AI search and agent readability

Site architecture and crawling

  • site-architecture: Silos, URL hierarchy, slugs, breadcrumbs, click depth.
  • internal-linking: Anchor text, hub-and-spoke, orphan audits.
  • redirects: 301 vs 302 vs canonical, query strings, chains, loops, soft 404s.
  • hreflang: Locale URL structure and hreflang tags.
  • pagination-and-facets: Self-canonical pagination and faceted-navigation crawl control.
  • robots-directives: robots.txt for crawling, meta robots and X-Robots-Tag for indexing and snippets, and how AI features fit.
  • crawl-budget: Crawl budget for large and fast-changing sites.
  • indexnow: Push change notifications to Bing and other participants.
  • sitemaps-deep: Sitemap index, lastmod, and news and image extensions.

Structured data

  • structured-data: JSON-LD baseline and the list of retired Google rich results.
  • schema-markup-deep: Field-level JSON-LD for Product, Course, VideoObject, DefinedTerm.

Performance and rendering

  • core-web-vitals: LCP, INP, and CLS thresholds and fixes.
  • page-speed: TTFB, FCP, images, fonts, render-blocking CSS and scripts.
  • javascript-seo: JavaScript rendering, SPA patterns, and render checks.
  • mobile-first: Mobile-first indexing, parity, viewport, touch targets.

Content strategy

  • content-clusters: Pillar and cluster pages.
  • keyword-research: Tools, intent classification, long-tail terms.
  • title-tags: Title length, keyword placement, rewrites, CTR testing.
  • serp-features: Featured snippets, People Also Ask, knowledge panels, snippet controls.
  • content-refresh: Refresh, merge, noindex, or delete existing pages, with honest date signals.
  • cannibalization: Prevent, detect, and fix two pages competing for one query: merge with a 301, sharpen intent, or noindex.

Verticals and off-page

  • backlinks: Earn links, track referring domains, avoid link spam and bad disavows.
  • video-seo: Watch pages, VideoObject, transcripts, video sitemaps.
  • news-seo: Google News, Top Stories, and NewsArticle markup.
  • ecommerce-seo: Product schema, out-of-stock handling, variants, facets, category pages.
  • local-seo: Google Business Profile, LocalBusiness, NAP citations, reviews.
  • image-seo: Filenames, alt text, dimensions, formats, lazy loading.
  • og-images: OG image sizing, generation, and cache busting.

Howtos

Glossary anchors

48 items under this folder.