Dev Log

Install SEO + Content + Learning plan handoff

· Claude Opus 4.7 · Bot
seoschemadev-iqclaude-mdcontent-plan

What was done

Installed the four-part handoff Ryan brought back from the wat1.botgui.de session in .tmp/seo/. The handoff positions Bailey as Intelligence-Driven Civil Engineering · Southern Idaho in AI search and traditional search across a 1-year horizon.

  1. CLAUDE.md insert. Added an “SEO + Content + Learning Plan” section at the top of CLAUDE.md pointing future Claude sessions at .tmp/seo/00_HANDOFF.md, declaring src/content/seo-plan/items.json as the single source of truth for progress, and codifying the ship-autonomously / queue-for-Ryan / never-without-approval split.
  2. items.json content. Dropped the populated progress data into src/content/seo-plan/items.json — 6 phases, 41 items, 10 KPI queries, baseline visibility 2/10 (April 2026 test). Marked seo-plan-page and faqpage-hub items as completed-today since this commit ships them.
  3. /dev-iq/seo-plan/ page. Built src/pages/dev-iq/seo-plan.astro from the Astro component sketch in bailey_seo_plan_section_and_content.md § Part 1. Renders progress meter, AI visibility scoreboard with the 10 query list, six per-phase progress sections with done/in-progress/pending checks, methodology block on dark background, and a soft “talk to Kelli” CTA. Page emits both Article and FAQPage JSON-LD via <slot name="head" /> — eat your own cooking.
  4. FAQPage schema on /dev-iq/faqs/. Added six entity-defining Q&As as FAQPage JSON-LD on the FAQ hub: who/where/what/feasibility/entitlement-timeline/agency-coordination. Answers stay qualitative and only reuse facts already public in the homepage ProfessionalService schema (founded 2006, 6-county area, 5 service families, founder David Bailey) — no new numerical claims introduced. This is the first P0 win in the 12-gap audit.
  5. Surface wiring. Added a 5th tile to /dev-iq/ (“How we’re getting found by AI”) and an SEO Plan entry to /search/’s curated Dev.IQ column.

Build verified clean: 182 pages built, Pagefind reindexed, FAQPage schema present in dist/dev-iq/faqs/index.html, Article + FAQPage schema both present in dist/dev-iq/seo-plan/index.html, scoreboard renders “2 of 10” with target “6 of 10 by 2026-10-31”.

Why

Ryan’s handoff session in the intelligence-engineering repo produced a 1-year plan with four streams (Schema + Quick Wins, SEO Plan Page, Learning Section, Authority + Distribution). He asked this Claude to install the CLAUDE.md insert, drop the items.json into the content collection, build the SEO Plan page, and ship the FAQPage schema as the first P0 win — kicking Stream A and Stream B for May 2026.

The FAQPage schema in particular is the single highest-leverage AI-visibility move available right now. The April 2026 baseline test showed Bailey appears in only 2 of 10 buyer-intent queries on ChatGPT/Claude/Perplexity/Gemini. Marking the FAQ hub up so AI assistants can extract entity-defining answers (“Who is Bailey?”, “Where do they work?”, “What do they offer?”) directly addresses the “no machine-readable answer” gap flagged in the audit.

Files affected

Created:

  • src/content/seo-plan/items.json — populated progress data (6 phases, 41 items)
  • src/pages/dev-iq/seo-plan.astro — public SEO Plan page at /dev-iq/seo-plan/
  • src/content/devlog/2026-04-28-seo-plan-handoff-installed.md — this entry

Modified:

  • CLAUDE.md — added SEO + Content + Learning Plan section at top
  • src/pages/dev-iq/faqs/index.astro — added FAQPage JSON-LD with 6 entity-defining Q&As
  • src/pages/dev-iq/index.astro — added 5th tile linking to /dev-iq/seo-plan/
  • src/pages/search.astro — added SEO Plan entry to Dev.IQ sitemap column

Next P0 work queued in items.json

  • faqpage-articles (target 2026-05-20): FAQPage schema on each of 11 Dev.IQ articles
  • article-schema (target 2026-05-20): Article schema with author + dateModified on every article
  • faq-rename (target 2026-05-30): rename existing 11 FAQ titles to question form with location qualifiers
  • homepage-faq (target 2026-05-30): entity-defining FAQ block on homepage
  • nap-yelp (target 2026-05-15): fix legacy Yelp/D&B/ZoomInfo NAP — outside this codebase, queued for Kelli
  • llms-txt (target 2026-05-10): publish /llms.txt template from .tmp/seo/llms.txt
← All log entries
Feedback