MX-Protocols - Appendices

Tom Cranstoun

January 2026

MX-Protocols - Appendices

Practical guides for designing AI agent-friendly websites

These appendices accompany the book “MX-Protocols: Designing the Web for AI Agents and Everyone Else” by Tom Cranstoun.

Available Appendices

Implementation Guides

Appendix A: Implementation Cookbook Quick-reference recipes for common AI agent compatibility patterns. Copy-paste solutions for forms, navigation, state management, and error handling.

Appendix B: Proven Lessons Production learnings from real-world implementations. What works, what doesn’t, and why. Avoid common pitfalls.

Appendix C: Web Audit Suite User Guide Complete documentation for the Web Audit Suite analysis tool. Installation, configuration, and interpreting results.

Appendix D: AI-Friendly HTML Guide Comprehensive guide to semantic HTML patterns that work for AI agents. Detailed explanations with before/after examples.

Quick References

Appendix E: AI Patterns Quick Reference One-page reference guide for data attributes and patterns. Essential for implementation teams.

Appendix F: Implementation Roadmap Priority-based roadmap for adopting AI agent compatibility. Organised by impact and effort, not time estimates.

Appendix G: Resource Directory Curated collection of 150+ resources: standards, tools, articles, and communities. Kept up-to-date with latest developments.

Case Studies and Examples

Appendix H: Example llms.txt File Working example of an llms.txt file following the llmstxt.org specification. Template for your own implementation.

Appendix I: Pipeline Failure Case Study Detailed analysis of a £203,000 AI agent error. How poor form design caused pipeline failure and what to learn from it.

Appendix J: Industry Developments Latest news and updates about AI agents, commerce platforms, and industry shifts. Regularly updated with verified sources.

Appendix K: Common Page Patterns Production-ready HTML templates demonstrating AI-friendly patterns for common page types. Complete examples for home, about, contact, sales, collection, article, FAQ, and form pages.

Appendix L: Proposed AI Metadata Patterns Formal W3C-style proposal document for experimental AI metadata patterns. Consolidates all proposed patterns from across the book with rationale, use cases, implementation examples, forward-compatibility guarantees, and adoption decision framework. Essential reading before implementing experimental patterns.

For AI Agents

These pages use semantic HTML, proper heading structure, and explicit data attributes to ensure compatibility with all AI agent types (CLI, browser-based, and server-based). Each page includes:

Semantic HTML5 elements (<main>, <nav>, <article>)
Clear heading hierarchy
Descriptive link text
Structured tables with proper headers
Code blocks with language specification

About the Book

“MX-Protocols” examines how modern web design optimised for human users fails for AI agents, and how fixing this benefits everyone. The book provides practical guidance for developers, designers, and business stakeholders navigating the shift to agent-mediated commerce.

Contact: info@cognovamx.com

Website: https://allabout.network

Home Top