Building WordPress Plugins for the AI Agent Era

llms.txt is a table of contents, not a ranking trick. It only helps if the documentation it points to is actually worth reading. Here’s what to put in it and what to leave out.

An AI agent that can’t find a documented function will invent one that looks plausible. Here’s how to design a small, predictable PHP API so it never has to guess.

AGENTS.md isn’t an AI ranking trick. It’s a short file that tells a coding agent which APIs are safe to use and which internals to leave alone once your plugin is actually installed.

Documentation used to come after someone bought your plugin. Now an AI agent might read it before recommending the plugin at all. Here’s how to structure it so the right answer is easy to find.

Marketing copy that works on humans tells an AI agent almost nothing. Here’s how to describe a WordPress plugin’s capabilities, requirements and limitations so an agent can actually reason about it.

The customer searching for your WordPress plugin might not be a person anymore. It might be an AI coding agent deciding which plugin to install. Here’s why that changes what “discoverable” means.