google-search-ai-optimization

Build and audit web experiences for Google Search generative AI features using Google's official guidance as the baseline.

Match the scope to the request. A title fix, schema question, or content edit does not require a full audit. Use only the references and tools needed to resolve the task; ordinary layout, section order, and content length remain design choices, not Google eligibility rules.

Decision Tree

What are you doing?

• Implementing SEO/GEO in a codebase

  • Read references/technical-implementation.md when the change needs crawl, render, metadata, or schema details.
  • Use scripts/audit_page.py when static page evidence helps. Add --expect-indexable only when the target is intended to be indexed, never for an intentional noindex page.

• Planning or editing content for AI Overviews, AI Mode, or query fan-out

  • Read references/content-and-entity-patterns.md for content choices, or references/google-guidance.md when the policy rationale is needed.

• Working on ecommerce, local business, or agentic user journeys

  • Read references/ecommerce-local-agentic.md