AI Readiness

AI Readiness audits your Drupal content for machine readability, semantic structure, and readiness for AI tools and modern search. It helps site builders and content teams identify gaps that make content harder for AI systems, search engines, and assistive technologies to understand—without sending any data to external AI services.

Features

**Basic functionality**
AI Readiness samples content from each content type and runs a set of deterministic checks. It then produces a clear administrative report with a 0–100 readiness score and specific findings for each piece of content.

**Unique features**
- Plugin-based check system – new checks can be added without changing the core analyzer
- Configurable sampling (how many nodes per content type to audit)
- Individual checks can be enabled or disabled
- Deterministic scoring – no external AI API calls, no telemetry, no third-party data transfer
- Works on both Drupal 10 and Drupal 11

**Built-in checks (MVP)**
- Descriptive title quality
- Presence of a usable summary / description
- Image alternative text completeness
- Taxonomy classification
- Entity relationships
- Body content structure (detects very long unstructured text blocks)

**When and why to use it**
- Preparing a site for AI-powered search, chatbots, or content recommendation
- Improving content quality and accessibility at the same time
- Auditing large content repositories before migration or redesign
- Establishing a baseline for “AI-ready” content standards across an organization

**Typical use cases**
- Content audits before launching an AI assistant or semantic search
- Regular quality checks by content editors or site administrators
- Agencies delivering “AI readiness” assessments to clients
- Organizations that want machine-readable content without relying on external AI providers

Post-Installation

1. Enable the module (`drush en ai_readiness` or via the Extend page).
2. Go to **Configuration → System → AI Readiness** (`/admin/config/system/ai-readiness`).
3. Set the maximum number of nodes to sample per content type (default: 20).
4. Choose which checks should run.
5. View the report at **Reports → AI Readiness** (`/admin/reports/ai-readiness`).

The report groups results by content type and shows each node’s individual check scores, severity, and findings. No new content types or text formats are created—the module only reads existing content.

**Permission required**: “Administer AI readiness”

Additional Requirements

- Drupal 10 or Drupal 11 (`core_version_requirement: ^10 || ^11`)
- Node module (part of Drupal core)
- PHP version required by the installed Drupal core (PHP 8.1+ for Drupal 10, PHP 8.3+ for Drupal 11)

No external libraries, APIs, or third-party services are required.

Recommended modules/libraries

- **Metatag** – improves structured metadata that complements AI readiness
- **Schema.org Metatag** or **JSON-LD** modules – for richer structured data (future checks may integrate with these)
- **Pathauto** – clean, descriptive URLs help both users and machines
- **Editoria11y** or other accessibility tools – alt-text and structure checks overlap with accessibility goals

Similar projects

Most existing modules focus on SEO scoring, accessibility auditing, or content quality in general. AI Readiness is specifically designed around **machine readability and AI/search readiness**:

- It uses a plugin architecture so the community can contribute new AI-oriented checks.
- It deliberately stays offline and deterministic (no external AI providers).
- It produces a single readiness score focused on semantic and structural signals rather than traditional SEO keywords.

If you already use SEO or accessibility modules, AI Readiness can sit alongside them as a complementary diagnostic tool.

Supporting this Module

Development is currently maintained by the module author. Community contributions (bug reports, new checks, documentation, and patches) are very welcome via the Drupal.org issue queue.

If you would like to support continued development financially, please contact the maintainer through the project issue queue or Drupal.org contact form.

Community Documentation

- Full README included with the module
- Issue queue on Drupal.org for bug reports and feature requests
- Planned future documentation and demo site (DrupalPod) once the module is published

**Roadmap highlights** (from the module’s README):
- JSON:API readiness checks
- Schema.org / structured-data checks
- Orphan and duplicate content detection
- Content editor integration
- Drush audit command
- CSV/JSON report export
- Optional AI-provider integrations (as a separate extension)