agentic-readiness-guide

This repository is a practical guide for website owners who want their sites to work well when accessed by AI agents rather than human visitors. As AI-powered tools increasingly browse the web on behalf of users, websites need to be structured so these agents can find, read, understand, trust, and take action on them. The guide organizes this into five areas: being discoverable, comprehensible, trustworthy, actionable, and experiential.

The guide contains 25 individual guidelines spread across those five areas. Each guideline is a separate markdown file explaining what to do and why, how difficult it is to implement, what the benefit is, and concrete steps for making the change. A downloadable PDF version of the full guide is also linked.

Beyond the written guide, the repository includes an automated auditing tool built as a skill for Claude Code, an AI coding assistant. You install it by cloning the repository and creating a symbolic link in a specific folder. Once installed, you point it at any website and it runs a set of predefined checks against the site, scores each of the 25 guidelines as passing, partially passing, failing, or not applicable, and produces a written report. The report ranks which fixes would deliver the most value relative to their effort, and can optionally apply the fixes directly as code commits if you provide the site's source directory.

The audit output is a markdown file with a scorecard, a plain-language summary, a prioritized action plan, and a table showing what each check found. A machine-readable JSON file can also be generated for use in automated systems like continuous integration pipelines or dashboards.

The guide is published under a Creative Commons license that allows free use and adaptation with attribution to Forter, the company that produced it.