Skip to content

Meta

Making my docs readable by AI agents

My documentation hub has always been built for humans: MkDocs, a clean theme, one navigable page per concept. That works well — until you ask an AI agent to find something in it. An agent doesn't browse; it retrieves. And plain HTML pages are a poor retrieval target. This post describes how I made the same knowledge base work for both audiences, running entirely on a Raspberry Pi 5.