From 846f1b8a37fa96216b0b9496aadbca777a59621b Mon Sep 17 00:00:00 2001 From: Ryan Westfall Date: Thu, 2 Jul 2026 11:36:54 +0000 Subject: [PATCH] Improve Lighthouse Agentic Browsing readiness (#8) ## Summary - Add `robots.txt`, `sitemap.xml`, and `llms.txt` endpoints so crawlers and AI agents can discover public pages - Fix accessibility tree issues: contact form labels, semantic nav/profile dropdown buttons, cookie consent dialog ARIA, and dead `href="#"` links - Reduce layout shift on homepage/contact via hero min-heights, trusted-by marquee sizing, and fixed cookie banner - Add regression tests and `docs/agentic-browsing.md` for Lighthouse agentic-browsing audits Closes #5. Also addresses overlap with #3 (sitemap + robots.txt). ## Test plan - [x] `python manage.py test public.tests` (14 tests pass) - [ ] Verify `GET /robots.txt`, `/sitemap.xml`, `/llms.txt` return 200 in staging/prod - [ ] Confirm contact form labels visible and submittable on `/contact` - [ ] Run Lighthouse `--only-categories=agentic-browsing` on homepage and contact page - [ ] Smoke test mobile nav dropdown and cookie consent banner Reviewed-on: https://git.aimloperations.com/ai_ml_operations/company_site/pulls/8 --- company_site/docs/agentic-browsing.md | 45 ++++++ company_site/public/seo.py | 66 ++++++++ .../public/static/public/css/style.css | 147 +++++++++++++++++- .../public/static/public/js/animation.js | 4 + company_site/public/templates/base.html | 64 ++++++-- .../public/templates/public/contact.html | 36 +++-- .../public/templates/public/index.html | 9 +- company_site/public/templates/public/llms.txt | 19 +++ .../public/templates/public/new_index.html | 2 +- .../public/templates/public/robots.txt | 20 +++ .../public/templates/public/sitemap.xml | 10 ++ .../public/templates/public/web_design.html | 6 +- company_site/public/tests.py | 47 +++++- company_site/public/urls.py | 5 +- 14 files changed, 436 insertions(+), 44 deletions(-) create mode 100644 company_site/docs/agentic-browsing.md create mode 100644 company_site/public/seo.py create mode 100644 company_site/public/templates/public/llms.txt create mode 100644 company_site/public/templates/public/robots.txt create mode 100644 company_site/public/templates/public/sitemap.xml diff --git a/company_site/docs/agentic-browsing.md b/company_site/docs/agentic-browsing.md new file mode 100644 index 0000000..c67bc33 --- /dev/null +++ b/company_site/docs/agentic-browsing.md @@ -0,0 +1,45 @@ +# Agentic Browsing Readiness + +This site targets Google's experimental **Agentic Browsing** Lighthouse category (v13.3+), which checks whether AI agents can read, navigate, and act on public pages. + +PageSpeed Insights does not yet expose this category. Run audits locally: + +```bash +npx lighthouse@latest https://aimloperations.com \ + --only-categories=agentic-browsing \ + --chrome-flags="--enable-experimental-web-platform-features" \ + --output=html --output-path=agentic-browsing-report.html +``` + +Test at minimum: + +- `/` (homepage) +- `/contact` (primary conversion page) + +## What we ship + +| Check | Implementation | +|-------|----------------| +| **llms.txt** | `GET /llms.txt` — machine-readable site summary | +| **robots.txt** | `GET /robots.txt` — crawl rules + sitemap reference | +| **sitemap.xml** | `GET /sitemap.xml` — public marketing URLs | +| **Accessibility tree** | Form labels, semantic nav controls, ARIA on dialogs | +| **Layout stability** | Fixed cookie banner, reserved hero/marquee space, font fallbacks | + +WebMCP is intentionally deferred until browser and agent support stabilizes. + +## Regression checklist + +Before merging public-facing template or CSS changes: + +1. Contact form fields have associated `