From 875b43aab528026e07e682048704d4e5d429b5c0 Mon Sep 17 00:00:00 2001
From: Clawdio <abd-clawdio@autonomoustech.ca>
Date: Thu, 5 Mar 2026 20:53:52 +0000
Subject: [PATCH] seo: improve meta description and add structured data
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Update site description to keyword-rich value prop (was 'Personal site of Abdullah Abid')
- Add keyword-rich homepage title (appends '— Engineering, AI Systems & Agentic Development')
- Add Person + WebSite JSON-LD schema to homepage for AI search and entity recognition
- Enhance BlogPosting schema with publisher field and linked Person entity
- Improves traditional SEO, AI Overview eligibility, and LLM citation readiness
---
 components/PageHead.tsx | 60 +++++++++++++++++++++++++++++++++++++++--
 site.config.ts          |  3 ++-
 2 files changed, 60 insertions(+), 3 deletions(-)

diff --git a/components/PageHead.tsx b/components/PageHead.tsx
index 0ede51ff20..f662b91a3b 100644
--- a/components/PageHead.tsx
+++ b/components/PageHead.tsx
@@ -21,7 +21,13 @@ export function PageHead({
 }) {
   const rssFeedUrl = `${config.host}/feed`
 
+  const isHomePage = url === config.host || url === `${config.host}/`
+
   title = title ?? site?.name
+  // Use a keyword-rich title for the homepage
+  if (isHomePage && title === site?.name) {
+    title = `${site?.name} — Engineering, AI Systems & Agentic Development`
+  }
   description = description ?? site?.description
 
   const socialImageUrl = getSocialImageUrl(pageId) || image
@@ -102,7 +108,49 @@ export function PageHead({
       <meta name='twitter:title' content={title} />
       <title>{title}</title>
 
-      {/* Better SEO for the blog posts */}
+      {/* Person + WebSite schema for homepage */}
+      {isHomePage && (
+        <script type='application/ld+json'>
+          {JSON.stringify({
+            '@context': 'https://schema.org',
+            '@graph': [
+              {
+                '@type': 'Person',
+                '@id': `${config.host}/#person`,
+                name: config.author,
+                url: config.host,
+                jobTitle: 'Founder & CTO',
+                worksFor: {
+                  '@type': 'Organization',
+                  name: 'Autonomous',
+                  url: 'https://autonomoustech.ca'
+                },
+                sameAs: [
+                  config.twitter
+                    ? `https://twitter.com/${config.twitter}`
+                    : null,
+                  config.github
+                    ? `https://github.com/${config.github}`
+                    : null,
+                  config.linkedin
+                    ? `https://linkedin.com/in/${config.linkedin}`
+                    : null
+                ].filter(Boolean)
+              },
+              {
+                '@type': 'WebSite',
+                '@id': `${config.host}/#website`,
+                url: config.host,
+                name: site?.name,
+                description: site?.description,
+                author: { '@id': `${config.host}/#person` }
+              }
+            ]
+          })}
+        </script>
+      )}
+
+      {/* Article schema for blog posts */}
       {isBlogPost && (
         <script type='application/ld+json'>
           {JSON.stringify({
@@ -116,7 +164,15 @@ export function PageHead({
             description,
             author: {
               '@type': 'Person',
-              name: config.author
+              '@id': `${config.host}/#person`,
+              name: config.author,
+              url: config.host
+            },
+            publisher: {
+              '@type': 'Person',
+              '@id': `${config.host}/#person`,
+              name: config.author,
+              url: config.host
             },
             image: socialImageUrl
           })}
diff --git a/site.config.ts b/site.config.ts
index a41bc23d12..52758d3aff 100644
--- a/site.config.ts
+++ b/site.config.ts
@@ -14,7 +14,8 @@ export default siteConfig({
   author: 'Abdullah Abid',
 
   // open graph metadata (optional)
-  description: 'Personal site of Abdullah Abid',
+  description:
+    'Abdullah Abid writes about software engineering, AI agents, and building with LLMs. Founder at Autonomous. Practical insights from real-world agentic systems.',
 
   // social usernames (optional)
   twitter: 'mabdullahabid_',