# Aidan McAlister

> Developer advocate and technical writer focused on docs, dev tools, and developer experience. Previously at Prisma, where I led a 400+ page docs rebuild, built GEO infrastructure for AI discoverability, and shipped developer-facing tools.

## About

- [Home](https://www.aidanmcalister.com/): Overview, links, and experience
- [Work](https://www.aidanmcalister.com/work): Portfolio of docs, tools, OSS, and writing
- [Blog](https://www.aidanmcalister.com/blog): Posts on docs, dev tools, and AI visibility

## Blog

- [Your docs are invisible to AI. Here's why.](https://www.aidanmcalister.com/blog/your-docs-are-invisible-to-ai): Good documentation doesn't automatically get cited by AI. Here's why retrieval systems skip well-written content, and what to do about it.

## Work

- [Prisma docs rebuild (400+ pages)](https://www.prisma.io/docs): 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.
- [20+ framework, runtime, and integration guides](https://www.prisma.io/docs/guides): 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 and AI-agent discoverability](https://www.prisma.io/docs/llms.txt): 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.
- [Prisma Postgres Management API](https://www.prisma.io/docs/management-api): Programmatically provision and manage Prisma Postgres databases. Endpoints, auth, and the SDK that wraps it. Docs entirely generated from the Swagger spec.
- [create-db](https://create-db.prisma.io): 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.
- [Prisma Claude Code plugin](https://claude.com/plugins/prisma): Three skills (prisma-voice, blog-writing, guide-writing) packaged as a plugin and published to Anthropic's official listing. Used daily by the DevRel team.

## External posts

- [Rebuilding the Prisma docs](https://www.prisma.io/blog/rebuilding-the-prisma-docs): The story behind the 400+ page docs rebuild: what we kept, what we cut, and how we shipped it without breaking SEO.
- [Vibe coding with Prisma MCP and Next.js](https://www.prisma.io/blog/vibe-coding-with-prisma-mcp-and-nextjs): Building a Next.js app with the Prisma MCP server and an AI agent that actually understands your schema.

## Experience

- Prisma, Developer Advocate (Mar 2025 – May 2026): Lead docs, guides, and dev tools across the TypeScript ecosystem. Ran the 400+ page docs rebuild, shipped create-db, built Prisma's GEO and AI-citation pipeline, and grew the Discord past 10,000 members.
- Inner Armor, Front End (Jul 2024 – Mar 2025): Built a Remix + TypeScript admin dashboard to replace a legacy tool — hit 100% company-wide adoption. Added 10+ interactive graphs in Observable Plot and ShadCN for cross-period data analysis, plus reusable components with NextUI and AG Grid.
- Elevate Digital IO, Full Stack (Jan 2024 – Aug 2024): Led development of an advanced filter system in RedwoodJS and Tailwind for efficient information retrieval. Built 10+ specialized CRUD interactions in Prisma and GraphQL, each with 12+ fields, focused on query efficiency and data integrity.

## Optional

- [Full content](https://www.aidanmcalister.com/llms-full.txt): Complete text of all blog posts and work descriptions