Aidan McAlister

Developer advocate. I build docs, tools, and community for developer products. Most recently I led a 400+ page docs rebuild and shipped create-db at Prisma.

Work

all →

Led all three rounds: content architecture, the production 301 redirect map, custom 404, and a Sentry + PostHog pipeline that pages the team in Slack when docs go down.

Authored most of the Prisma guides section: frameworks (Next.js, Astro, Nuxt, SvelteKit, SolidStart, TanStack Start), runtimes (Bun, Deno), auth (Clerk, Better Auth, Auth.js), deployment (Cloudflare Workers), and integrations (Vercel AI SDK, Shopify).

llms.txt sub-indexes, content negotiation, .md aliases on every docs route, and a markdown 404 handler. Prisma's GEO architecture for ChatGPT, Claude, and Perplexity.

Programmatically provision and manage Prisma Postgres databases. Endpoints, auth, and the SDK that wraps it. Docs entirely generated from the Swagger spec.

CLI for provisioning temporary databases. Shortens time-to-first-query for new users. Tracked down a 700-database creation spike, added Cloudflare rate limiting, moved everything into a Turborepo monorepo.

Writing

all →

Good documentation doesn't automatically get cited by AI. Here's why retrieval systems skip well-written content, and what to do about it.

How we rebuilt the Prisma documentation site from the ground up with a new framework, design, and information architecture.

Building an e-commerce app using Prisma MCP and Next.js by collaborating with AI.