Kiragu Maina · the architect's working fileStudio companion → home.alkenacode.dev
Kiragu Maina
Index
§ DISPATCH NO. 003 ·2024–2026 · live

pSEO Engine.

A programmatic-SEO engine that ships static editions, ranks them, and ports the pattern to any vertical -- proved end-to-end on myphotoai.alkenacode.dev and agents.alkenacode.dev.

Stack
NodeHandlebarsPostgreSQLRedisGSC APIIndexNowSitemapHunter

The problem on file

Most engineers wait for recruiters to find a PDF resume. The pSEO engine is the inversion of that loop: every system the studio ships also ships static HTML editions, archive pages, structured data, sitemap entries, and IndexNow pings, so the work itself becomes the lead-gen layer. The engine is the same across deployments; the slug strategy and the templates change per vertical.

This dispatch documents the engine. The two live deployments below are the evidence.

What it is, in numbers

Live deployments
2
Verticals (Agents)
8
Edition strategy
Static
Typical time-to-index
Hours
Structured data
JSON-LD
Push protocol
IndexNow
Exhibit ACaptured 2026-05-21 08:54 UTCSource myphotoai.alkenacode.devlive
MyPhotoAI pSEO case study
Fig.myphotoai.alkenacode.dev. The site is itself the case study: each section in the column on the right (Architecture, Slug strategy, Image pipeline, Sitemap mechanics, Results) describes a part of the engine, links to the live editions it produced, and lets a sceptical visitor verify the claim in one click.

The marquee piece, the publish loop

Every system the engine touches has the same publish loop, regardless of vertical. The vertical-specific bits are isolated to the slug strategy and the Handlebars template; the rest of the loop is shared infrastructure that publishes, validates, pings, and traces.

tspackages/pseo/publish.ts
async function publishEdition(input: EditionInput) {
const slugs = slugStrategy(input);                 // per-vertical
const html  = renderTemplate(input, slugs);        // per-vertical
await writeStaticEditions(slugs, html);            // shared
await rebuildSitemap({ stripEmpty: true, stripErrorAi: true });
await pingIndexNow(slugs.map(slugToUrl));
await tracePublish(input.id, slugs, Date.now());
return slugs;
}
Listing.The publish loop, condensed. Same five steps on MyPhotoAI and on AlkenaCode Agents -- only the slug strategy and template per-vertical change. Sitemap integrity runs AFTER write so a broken edition cannot poison the index.

The sitemap-integrity step is the load-bearing piece. Empty slugs, AI-error artefacts, and spam slugs are stripped before the sitemap is published, so a broken run never leaks into Google's view of the site.

The second instance, the same engine

The same engine reuses templates per vertical to ship eight WhatsApp receptionist demos for Kenyan SMEs on a single deploy. The verticals are not separate sites; they are eight slug subtrees produced by the same publish loop, with their own Handlebars partials and structured-data annotations.

Exhibit BCaptured 2026-05-21 08:54 UTCSource agents.alkenacode.devlive
AlkenaCode Agents -- AI customer-service agents for Kenyan SMEs
Fig.agents.alkenacode.dev. Surface for the same engine -- different slug strategy (vertical / persona), different Handlebars template, same publish loop, same sitemap integrity, same IndexNow ping. The 'Read the pSEO case study' link at the bottom of the page is the path back to the engine's documentation on myphotoai.

The hidden ninety percent

Distribution as part of the product

The growth-worker is a separate service. It listens for publish:complete on Redis pub/sub, regenerates the sitemap, validates its integrity (no orphan slugs, no error-AI articles, no junk), and pings IndexNow. The same growth-worker pattern powers Shellwire's editorial pipeline ([[shellwire]] DISPATCH NO. 001) -- they share the publish-and-distribute contract.

In production

In production
  • 01Two live deployments: myphotoai.alkenacode.dev (open case study) and agents.alkenacode.dev (commercial wedge into Kenyan SMEs, eight verticals).
  • 02Per-vertical isolation is one template directory plus one slug strategy function. Adding a ninth vertical to AlkenaCode Agents is a config commit, not a project.
  • 03Sitemap integrity has caught and stripped broken editions on every deploy since the pattern was extracted -- zero broken slugs reached Google.
  • 04IndexNow lag from publish to first impression is measured in hours, not days, on both sites.
  • 05The architecture is the cost control. No paid SEO tooling, no paid backlink-discovery service, no separate CMS to maintain.
Take away

The website is the publication. The publication is the lead-gen. Distribution belongs in the same commit as the feature.

Next dispatchDISPATCH NO. 004

A2UI free

A free-tier deployment of Google's agent UI protocol, running on 92 live LLMs nobody pays for.