📖 AIRD (AI-Ready Documentation) - Site Map

Welcome to the official documentation for the AI-Ready Documentation (AIRD) Standard. This project provides the specifications, tools, and templates needed to make your documentation “AI-native.”

🗺️ Quick Navigation

📜 Core Specification

• AIRD SPEC v1.2: The definitive guide to the 5 layers of AI-ready docs (L1-L5).
• L5 Agentic Guide: Specialized guide for implementing the Actionable Layer and Evolutionary Loops.
• Feedback Workflow: How to operationalize the L4 evolution loop.

🛠️ Tools & Automation

• AIRD Linter (v5): The official tool to measure and validate your documentation’s AI-readiness.

📚 Templates & Examples

• Examples Gallery:
  • Python Library Template
  • System Architecture Template
  • Agent SOP Template

🧪 AI Model Benchmarks

A collection of documentation tailored for the strengths and weaknesses of specific LLMs:

• GPT-5.5
• Claude Opus 4.8
• Gemini Omni Flash
• (See more in the root directory)

---

🎯 Which path should you take?

If you are…	Start here $\rightarrow$
New to AIRD	README.md $\rightarrow$ AIRD_SPEC.md
Updating an existing project	L5 Agentic Guide
Building an AI Agent	L5 Agentic Guide $\rightarrow$ Feedback Workflow
Auditing your docs	Run aird_lint_v5.py

---

AIRD v1.2: From Information Retrieval to Autonomous Execution.