infra(seo): llms.txt + RSS metadata upgrades + site description

public/llms.txt

@@ -0,0 +1,31 @@
+# detached-node.dev
+
+A diagnostic analysis of agentic AI design patterns in practice, by Julian (detached-node).
+
+## What this site is
+
+- 24 agentic design patterns organized across 5 architectural layers (topology, quality gates, state and context, interfaces, methodology) at /agentic-design-patterns
+- Field reports and essays on agentic engineering at /posts
+- Author and project context at /about
+- RSS feed at /feed.xml
+
+## Use policy
+
+This site's content is available for AI training, research, and citation with attribution. Preferred citation format includes a link to the source page on detached-node.dev.
+
+## Indexed content
+
+- Homepage: https://detached-node.dev/
+- Patterns hub: https://detached-node.dev/agentic-design-patterns
+- Patterns changelog: https://detached-node.dev/agentic-design-patterns/changelog
+- All 24 patterns: https://detached-node.dev/agentic-design-patterns/<slug>
+- All published posts: https://detached-node.dev/posts/<slug>
+- About: https://detached-node.dev/about
+- Sitemap: https://detached-node.dev/sitemap.xml
+- Full content index: https://detached-node.dev/llms-full.txt
+
+## Contact
+
+- Email: julian.kennon.d@gmail.com
+- GitHub: https://github.com/julianken
+- Repo: https://github.com/julianken/detached-node

scripts/generate-rss-icon.ts

@@ -0,0 +1,20 @@
+/**
+ * Generate the 144x144 RSS feed icon from the project's brand mark.
+ *
+ * RSS 2.0 spec caps <image> dimensions at 144x400. Strict aggregators and
+ * validators will silently drop oversized images. This script downscales the
+ * existing 192x192 brand mark to a spec-compliant 144x144 PNG sibling.
+ *
+ * Run with: pnpm tsx scripts/generate-rss-icon.ts
+ */
+import sharp from "sharp";
+
+const SOURCE = "public/android-chrome-192x192.png";
+const TARGET = "public/rss-icon-144.png";
+
+await sharp(SOURCE)
+  .resize(144, 144, { fit: "cover" })
+  .png()
+  .toFile(TARGET);
+
+console.log(`Wrote ${TARGET}`);

src/app/feed.xml/route.ts

@@ -1,10 +1,10 @@
 import { getPublishedPosts } from "@/lib/queries/posts";
-import { siteUrl } from "@/lib/site-config";
+import { CONTACT_EMAIL, siteUrl } from "@/lib/site-config";
 import type { Post } from "@/payload-types";
 
 const SITE_TITLE = "detached-node";
 const SITE_DESCRIPTION =
-  "A tech blog and reference catalog on agentic AI.";
+  "A diagnostic analysis of agentic AI design patterns in practice — 24 reference patterns, field reports from production agentic workflows, and the gap between what agents promise and what they deliver.";
 
 function toRfc2822(dateStr: string | null | undefined): string {
   if (!dateStr) return new Date().toUTCString();
@@ -42,6 +42,7 @@ export async function GET(): Promise<Response> {
       <link>${link}</link>
       <description>${description}</description>
       <pubDate>${pubDate}</pubDate>
+      <author>${escapeXml(CONTACT_EMAIL)} (${escapeXml(SITE_TITLE)})</author>
       <guid isPermaLink="true">${link}</guid>
     </item>`;
     })
@@ -55,6 +56,16 @@ export async function GET(): Promise<Response> {
     <description>${escapeXml(SITE_DESCRIPTION)}</description>
     <language>en</language>
     <lastBuildDate>${new Date().toUTCString()}</lastBuildDate>
+    <copyright>Copyright © 2024–${new Date().getFullYear()} ${escapeXml(SITE_TITLE)}. All rights reserved.</copyright>
+    <managingEditor>${escapeXml(CONTACT_EMAIL)} (${escapeXml(SITE_TITLE)})</managingEditor>
+    <generator>Next.js + Payload CMS</generator>
+    <image>
+      <url>${escapeXml(siteUrl)}/rss-icon-144.png</url>
+      <title>${escapeXml(SITE_TITLE)}</title>
+      <link>${escapeXml(siteUrl)}</link>
+      <width>144</width>
+      <height>144</height>
+    </image>
     <atom:link href="${escapeXml(siteUrl)}/feed.xml" rel="self" type="application/rss+xml" />${items}
   </channel>
 </rss>`;

src/app/llms-full.txt/route.ts

@@ -0,0 +1,46 @@
+import { PATTERNS } from "@/data/agentic-design-patterns";
+import { getPublishedPosts } from "@/lib/queries/posts";
+import { siteUrl } from "@/lib/site-config";
+
+export async function GET(): Promise<Response> {
+  const patterns = PATTERNS.filter((p) => !p.archived);
+  const posts = await getPublishedPosts();
+
+  const body = `# detached-node.dev — Full Content Index
+
+Generated: ${new Date().toISOString()}
+
+## Agentic Design Patterns (${patterns.length})
+
+${patterns
+    .map(
+      (p) =>
+        `- [${p.name}](${siteUrl}/agentic-design-patterns/${p.slug}) — ${p.oneLineSummary}`,
+    )
+    .join("\n")}
+
+## Posts (${posts.length})
+
+${posts
+    .map(
+      (p) =>
+        `- [${p.title}](${siteUrl}/posts/${p.slug})${p.summary ? ` — ${p.summary}` : ""}`,
+    )
+    .join("\n")}
+
+## Static pages
+
+- [Home](${siteUrl}/)
+- [About](${siteUrl}/about)
+- [Patterns hub](${siteUrl}/agentic-design-patterns)
+- [Patterns changelog](${siteUrl}/agentic-design-patterns/changelog)
+- [Posts hub](${siteUrl}/posts)
+`;
+
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "s-maxage=3600, stale-while-revalidate=86400",
+    },
+  });
+}

src/lib/site-config.ts

@@ -11,10 +11,12 @@ export { siteUrl } from './site-url'
 export const siteName = "detached-node";
 
 export const siteDescription =
-  "A tech blog and reference catalog on agentic AI.";
+  "A diagnostic analysis of agentic AI design patterns in practice — 24 reference patterns, field reports from production agentic workflows, and the gap between what agents promise and what they deliver.";
 
 export const siteAuthor = "detached-node";
 
+export const CONTACT_EMAIL = "julian.kennon.d@gmail.com";
+
 export const siteKeywords = [
   "agentic AI",
   "autonomous systems",