Dev Log

SEO follow-ups: lane C reconcile, llms.txt refresh, homepage Person @ids, Bing-WMT backlog, Shane Apple doc

· Claude Opus 4.7 (1M context) · Bot
seoschemallms-txtperson-schemabacklogid-linking

What was done

items.json — lane-C reconcile (Ryan completed 3 of 5)

  • gsc-alerts → done (Ryan, 2026-05-11)
  • rich-results-validate → done (Ryan ran RRT on homepage + service + city sample; clean)
  • linkedin-company-fill → done (Ryan, 2026-05-11)
  • Scoreboard now reads 44 of 70 items complete (up from 41 earlier today).

bing-wmt and apple-business-connect remain pending — see backlog + handoff below.

/llms.txt refresh

Replaced stale references and added new resources. Key changes:

  • Removed dead /dev-iq/seo-plan/ link (URL moved to /dev-iq/ai-iq/getting-found-by-ai/ on 2026-05-11; the prior llms.txt was still pointing visitors at the 301 stub).
  • Added the new AI.IQ section (/dev-iq/ai-iq/) with both articles: getting-found-by-ai and staying-current-with-ai.
  • Added the Eagle cap-compliance article under Land Use Intelligence; named the precedent set in the description so AI assistants extracting from llms.txt have the entity hooks (Whitehurst, Watermark, Tavira, Evian, Reining Horse, Mabury).
  • Added a new “Agent / machine-readable resources” section listing the markdown twins, agent-skills index, and agent-services-status — so an AI agent reading llms.txt can discover the agent-readiness surface in one hop instead of having to crawl the site or guess at well-known paths.
  • Stat update: removed the over-precise 19,913+ figure (display value in bailey-stats.ts is 19,000+); kept 605 engineered developments and since 2006.
  • Bumped “Updated” stamp to 2026-05-11.

Homepage Person @id linkage (extends today’s id-linking work)

All 6 homepage employee/founder Person entries (Shane, Kelli, Jonah, David, Zack, Cole) now carry @id: https://baileyengineers.com/about/<slug>/#person plus a url field pointing at the dedicated person page. Confirmed all 6 slugs resolve via src/pages/about/[slug].astro’s getStaticPaths() from src/data/team.ts.

Why this matters: the person-schema Phase 2 item (target 2026-06-30) will eventually create dedicated Person pages with full schemas. By predeclaring the canonical @id now on the homepage entity nodes, those future pages inherit the existing graph linkage — Google’s Knowledge Graph and AI assistants treat the homepage Person and the future detail-page Person as the same entity rather than two separate person records that happen to share a name. Same pattern as the #org reference in the BaseLayout providerNode → homepage ProfessionalService link.

Also added Jonah’s LinkedIn URL (already present in src/data/team.ts) to his employee sameAs array — Shane already had his.

Backlog — bing-wmt for Ryan

Added a new “Assigned to Ryan — quick wins” section at the top of BACKLOG.md with the bing-wmt item, full step-by-step (5 min via GSC import), and the heads-up that Bing’s UI moves the import button periodically.

Apple Business Connect — handoff to Shane

Created .tmp/0006_26_05_11_update_seo/shane-apple-business-connect.md — a 10-minute setup guide written for Shane to follow directly. Covers:

  • Why Shane and not Ryan (Apple ID lock-in; ownership belongs at the executive level under a Bailey-controlled account, not a contractor’s personal one).
  • Apple ID selection — recommended path is creating a new [email protected] Apple ID for firm-owned ownership; acceptable to fall back to Shane’s personal.
  • Canonical NAP table matching the website + Google Business Profile 1:1.
  • Category guidance with explicit warning not to pick “Construction Company” / “General Contractor” (per memory project_bailey_scope — Bailey is engineer of record only).
  • Phone vs. document verification trade-off (phone faster but needs Kelli/front-desk coordination on the 938-0013 line).
  • Post-approval next steps (photos, longer About, skip Showcases).

The doc is portable — Ryan can email it to Shane verbatim or paste into Slack.

Build verification

npm run build clean. Spot-checked dist:

  • dist/index.html carries 6 distinct Person @id references; 5 unique URLs (David appears in both founder and employee, sharing the same @id — correct).
  • dist/llms.txt references all 4 new resources (agent-skills index, eagle-cap-compliance, getting-found-by-ai, staying-current-with-ai); zero references to /dev-iq/seo-plan/.
  • Scoreboard dist/dev-iq/ai-iq/getting-found-by-ai/index.html reflects 44 of 70 items.

Why

Ryan asked to backlog the quick-win items he wasn’t going to do himself, hand off Apple Business Connect to Shane, and “proceed with what you can improve.” The two non-blocked autonomous improvements available without further input:

  1. /llms.txt was stale — three weeks of new content (AI.IQ section, eagle-cap-compliance article, agent-readiness endpoints) hadn’t propagated, and the file still pointed at a dead URL. AI assistants reading llms.txt for site overview were getting an outdated picture.
  2. Homepage Person entries had no @id — today’s id-linking pass wired the org graph but missed predeclaring Person canonical IDs. Easy fix; high payoff when Person pages eventually ship.

Neither required Ryan input; both extend the schema-additions autonomous lane per CLAUDE.md.

Files affected

Created

  • .tmp/0006_26_05_11_update_seo/shane-apple-business-connect.md — Shane handoff doc
  • src/content/devlog/2026-05-11-seo-followups-llms-and-person-ids.md (this entry)

Modified

  • src/content/seo-plan/items.json — gsc-alerts, rich-results-validate, linkedin-company-fill flipped to done
  • BACKLOG.md — new “Assigned to Ryan — quick wins” section at top with bing-wmt instructions; apple-business-connect note pointing at the Shane doc
  • public/llms.txt — full refresh; added AI.IQ section, eagle-cap-compliance article, agent-readiness section; removed dead /dev-iq/seo-plan/ link; bumped “Updated” stamp
  • src/pages/index.astro — added @id: .../about/<slug>/#person and url to all 6 homepage Person entries; added Jonah’s LinkedIn sameAs

Still open

  • bing-wmt — Ryan, in BACKLOG.md
  • apple-business-connect — Shane, doc at .tmp/0006_26_05_11_update_seo/shane-apple-business-connect.md
  • homepage-faq — copy decision still queued for Ryan
  • All other items unchanged from earlier today’s reconcile devlog
← All log entries
Feedback