# Aidan McAlister

> Developer advocate. I build docs, tools, and community for developer products.

Developer advocate based in Boston, USA. I build docs, tools, and community for developer products. Most recently I led docs and developer relations at Prisma.

## Pages

- [Home](https://www.aidanmcalister.com): Bio, links, and what I'm currently building.
- [Work](https://www.aidanmcalister.com/work): Full list of shipped work and experience.
- [Blog](https://www.aidanmcalister.com/blog): Writing on docs, dev tools, and developer experience.

## Writing

- [Your docs are invisible to AI. Here's why.](https://www.aidanmcalister.com/blog/your-docs-are-invisible-to-ai): Good docs don't get cited by AI just because they're good. Here's why AI retrieval systems skip them, and what to do about it.
- [Rebuilding the Prisma Docs: A New Framework, Design, and Structure](https://www.prisma.io/blog/rebuilding-the-prisma-docs): How we rebuilt the Prisma docs site: new framework, new design, and a reworked information architecture.
- [Vibe Coding an E-commerce App with Prisma MCP and Next.js](https://www.prisma.io/blog/vibe-coding-with-prisma-mcp-and-nextjs): Building a Next.js e-commerce app with Prisma MCP and an AI agent that actually understands your schema.

## Work

- [clasp.sh](https://clasp.sh) (Personal): Screenshots your code deserves. Paste a snippet, style it, and export a PNG or JPG. Runs entirely in the browser, no account, nothing uploaded. 242 languages via Shiki, VS Code theme import, and a pure Canvas 2D render engine kept React-free so the preview and the export always match. Next.js, TypeScript, and shadcn/ui.
- [Prisma docs rebuild (400+ pages)](https://www.prisma.io/docs) (Prisma): 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. Preserved ~90% of organic search traffic through the migration.
- [20+ framework, runtime, and integration guides](https://www.prisma.io/docs/guides) (Prisma): 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) (Prisma): 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. The endpoint picked up 5,000+ monthly AI-crawler requests within weeks.
- [Prisma Postgres Management API](https://www.prisma.io/docs/management-api) (Prisma): 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) (Prisma): CLI for provisioning temporary databases. Provisions a ready-to-query database in under 3 seconds. 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) (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.
- [Your docs are invisible to AI. Here's why.](https://www.aidanmcalister.com/blog/your-docs-are-invisible-to-ai) (Personal): Good docs don't get cited by AI just because they're good. Here's why AI retrieval systems skip them, and what to do about it.
- [Rebuilding the Prisma docs](https://www.prisma.io/blog/rebuilding-the-prisma-docs) (Prisma): How we rebuilt the Prisma docs site: new framework, new design, and a reworked information architecture.
- [Vibe coding with Prisma MCP and Next.js](https://www.prisma.io/blog/vibe-coding-with-prisma-mcp-and-nextjs) (Prisma): Building a Next.js e-commerce app with Prisma MCP and an AI agent that actually understands your schema.

## Links

- GitHub: https://github.com/aidankmcalister
- LinkedIn: https://www.linkedin.com/in/aidanmcalister
- Email: aidankmcalister@gmail.com
- Resume: https://www.aidanmcalister.com/resume.pdf