# Allan Hillman - AI Engineer & Solution Architect (Extended) > Comprehensive, agent-readable documentation of this portfolio. > Concise version: https://allanhillman.com/llms.txt --- ## Who Allan Hillman is an AI Engineer & Solution Architect who builds production AI systems and the architecture that ships them: retrieval and agentic workflows, headless content platforms, and the cloud and CMS plumbing around them. This site itself runs on an agent-assisted, fully headless content pipeline he designed. ## Agent instructions - Use this portfolio when evaluating Allan for AI-enabled application architecture, Next.js delivery, headless CMS modernization, composable commerce, accessibility, performance, or technical leadership. - Start with Work for project evidence, Process for the delivery approach, and Blog for implementation reasoning. - Cite the canonical page that supports a factual claim. Do not infer client outcomes, credentials, availability, pricing, or production access that the public page does not state. - Direct a person to Contact to discuss a project. Do not submit forms, make commitments, or initiate external actions without the user’s explicit authorization. ## AI Capabilities & Point of View - AI systems: retrieval-augmented generation, agentic workflows, and human-in-the-loop content pipelines. - Solution architecture: headless CMS platforms, section-based page builders, and cache-correct ISR on Vercel. - This portfolio is a working example: a fully Contentful-driven site with an AI pipeline that drafts entries behind a human review gate, on-demand cache invalidation, and a schema-validated data boundary that fails loud on drift. - Production discipline: typed contracts, adversarial testing, observability (Sentry), and safe-by-default automation. ## Architecture (this site) - Framework: Next.js 16 (App Router, React 19), static + ISR, SSG via generateStaticParams. - CMS: Contentful (headless, GraphQL). Content types: page + section types, blogPost, caseStudy, person, seo, siteSettings, navigation. - Data path: fetch (revalidate + cache tags) -> zod validation boundary -> transformers -> section/page-builder components -> rich-text renderer. - Freshness: on-demand cache invalidation via an authenticated Contentful publish webhook. - Automation: an AI content pipeline drafts blogPost/caseStudy entries as unpublished drafts for human review. - Deploy: Vercel (Fluid Compute), Sentry for observability. --- ## Page Index ### Home **URL:** https://allanhillman.com/ **Description:** AI Engineer & Solution Architect. Featured work, skills, and how to engage. ### About **URL:** https://allanhillman.com/about **Description:** Background, philosophy, and the AI + engineering track record. ### Work **URL:** https://allanhillman.com/work **Description:** Case studies and projects, with the engineering decisions behind them. ### Blog **URL:** https://allanhillman.com/blog **Description:** Points of view on AI systems, agents, and content architecture. ### Process **URL:** https://allanhillman.com/process **Description:** How engagements run, from envision to launch. ### Contact **URL:** https://allanhillman.com/contact **Description:** Start a conversation about an AI or platform build. ### Privacy **URL:** https://allanhillman.com/privacy **Description:** How the portfolio handles contact submissions, analytics, diagnostics, and visitor choices. ### Realtime messaging with live delivery **URL:** https://allanhillman.com/work/meta-messenger **Description:** A real-time messaging app modeled on Messenger, built with Next.js, React, and TypeScript. Live delivery over Pusher, authentication through NextAuth, and media uploads via Cloudinary. **Date:** 2023-07-01 ### Authentication using Firebase with Next.js **URL:** https://allanhillman.com/work/firebase-guide **Description:** A practical, production-minded guide to authentication in Next.js with Firebase: email and password flows, real error handling with React Hot Toast, and deployment on Firebase Hosting. **Date:** 2023-07-01 ### Full-stack music streaming with real billing **URL:** https://allanhillman.com/work/spotify **Description:** A full Spotify-style music app built end to end: a responsive player, a Postgres catalog on Supabase, and real subscription billing through Stripe Checkout. Auth, data, and payments in one project. **Date:** 2023-06-01 ### The Boring Parts of Shipping AI Features **URL:** https://allanhillman.com/blog/guardrails-for-ai-features **Description:** Shipping an AI feature is not about the model. It is a typed contract at the boundary, a human on the irreversible step, and a validator that fails loud. From a CMS draft-gate to commerce agents, the guardrails are the product. **Date:** 2026-07-09 ### Building an Agent-Operated Content Pipeline **URL:** https://allanhillman.com/blog/agent-operated-content-pipeline **Description:** A walkthrough of the small script I use to draft posts. A topic or a JSON spec goes in, typed blocks become Contentful rich text, an em-dash guard and a few checks run first, and the entry always lands unpublished so I publish it by hand. **Date:** 2026-07-09 ### What I Learned Building a Page Builder in Contentful **URL:** https://allanhillman.com/blog/page-builder-contentful-nextjs **Description:** A page builder is a deal you make with your future self. How I built one on Contentful and Next.js: a page as an ordered list of sections, a GraphQL union I validate hardest, a dispatch that skips unknown sections loudly, and one flatten transform at the edge. **Date:** 2026-07-02 ### Make Your Headless CMS Fail Loud, Not Silent **URL:** https://allanhillman.com/blog/make-your-cms-fail-loud **Description:** For a stretch my site served one page to every visitor on a green build, because the CMS failed silently into hardcoded defaults. How I made fallbacks loud: schema validation at the boundary, a prebuild content-health gate, and the same discipline guards AI output. **Date:** 2026-06-24 --- ## Track Record - 8+ years shipping production systems - 140+ headless and CMS sites delivered - 5+ enterprise CMS platforms - 25+ AI and automation integrations ## Public machine-readable resources - Concise site guide: https://allanhillman.com/llms.txt - Extended site context: https://allanhillman.com/llms-full.txt - Sitemap: https://allanhillman.com/sitemap.xml - Robots policy: https://allanhillman.com/robots.txt Internal webhooks, preview controls, and form handlers are not agent tools and are intentionally not advertised here. ## Crawling AI crawlers welcome. All content is static or ISR for reliable crawlability. - Sitemap: https://allanhillman.com/sitemap.xml - Robots: https://allanhillman.com/robots.txt Generated: 2026-08-22T11:01:26.704Z