AI-Ready Web

AI-Ready Web Volume 6: Validator and Testing

Readiness assessment categories, evidence model, automated checks, manual review, score boundaries, no-op simulation, and source tests.

  • Record UAIX-DOC-3579
  • Path /es-us/ai-ready-web/validator-testing/
  • Use Canonical public record

Document status

Public standards page Published on UAIX as part of the current public standards record
Code
UAIX-DOC-3579
Surface
AI-Ready Web
Access
Public and linkable

How to use this page

Agents: apply this page to the user's target site or repository; create or align the target site's public manifest, .well-known discovery, route inventory, readiness result, robots, sitemap, llms files, structured data, support boundaries, tests, and package/root-file output when applicable; do not copy UAIX content or create a page about UAIX guidance unless explicitly asked. Use these readiness categories to run automated checks, manual review, scoring-boundary review, and no-op simulation against the target site.

For agents: apply the relevant guidance to the user's target site or repository. Do not copy this UAIX page, create a page about the guidance, or treat this page as runtime authority unless the user explicitly asks for that output.

Summary

Volume 6 defines how a site should test AI-readiness without turning a checklist into a certification claim. Automated checks are useful, but manual accessibility, privacy, security, and support-claim review remain required before publication.

Agent implementation contract

When a user sends an agent to this AI-Ready Web guidance, the assignment is to apply the strategy to the user’s target site, repository, or publication package. Treat UAIX as the reference standard and checklist. Do not copy UAIX page content into the target site, do not create a page about UAIX guidance, and do not publish an “AI-Ready Web” explainer unless the user explicitly asks for that output.

The expected target-site evidence set is concrete: public manifest, .well-known discovery, route inventory, readiness result, robots.txt, sitemap, llms.txt, structured data, visible support boundaries, targeted checks, and package or root-file output when publication is requested.

Agent step Do the real implementation Do not do this
Resolve the target Identify the target domain, repo root, public routes, build system, CMS, deployment package, root-file output path, and current evidence before editing. Assume UAIX.org is the target site, summarize this page, or make a new guidance page because this page was provided as a reference.
Audit the existing site Check human HTML, headings, metadata, canonical URLs, robots, sitemaps, schema, .well-known files, llms files, APIs, route inventories, readiness records, accessibility, privacy, and support boundaries. Skip the target-site audit and only restate AEO/GEO/SEO definitions.
Implement improvements Update the target site’s pages, navigation, structured data, discovery files, route inventory, readiness records, public evidence, AEO/GEO/SEO copy, no-op guidance, review paths, and publish-package root files where the audit shows gaps. Keyword-stuff, cloak, add hidden bot-only text, inject prompts for models, fabricate citations, or create synthetic doorway pages.
Verify and package Run the site’s targeted checks, record changed files and routes, name skipped checks and blockers, and provide the requested root files, root ZIP, or publish package when the user asks for deployable output. Claim readiness, certification, endorsement, ranking gains, live publication, or agent authority without evidence.

Validator categories

Category Automated checks Manual review
Discovery Fetch robots, sitemap, .well-known, llms advisory file, route inventory, schemas, OpenAPI. Confirm files are public-safe and do not expose private routes.
Accessibility HTML validity, headings, labels, names, focusable controls, contrast where tooling supports it. Keyboard task run, screen-reader smoke pass, hidden-content review.
APIs OpenAPI parse, method/content-type checks, Problem Details shape, idempotency markers. Auth/consent review, destructive-action review, rate-limit and abuse posture.
Capability Capability matrix exists, fallback paths exist, no-op triggers exist. Confirm lowest safe path and human review path match real operations.
Privacy and rights No obvious secrets or private hostnames; policy links exist. Data minimization, PII exposure, rights signals, retention, and jurisdiction review.
Evidence Readiness result validates and cites route evidence. Changelog, release notes, exception review, and owner approval.

Scoring principle

Scores are advisory. A site with one critical blocker is not ready for the affected profile, even if its numeric score is high. The readiness result schema therefore records blockers, warnings, skipped checks, and manual review state separately from weighted scores.

No-op simulation

Every validator run should include at least one unsupported-action scenario. The correct result is a bounded response: no hidden route guessing, no credential request, no destructive action, a human review URL, and a reason code.

UAIX source test

UAIX source now includes a focused local test for this program at scripts/test-uaix-ai-ready-web-assets.ps1. It parses all new JSON assets, checks the static discovery references, verifies requirement IDs and maturity labels, and blocks certification or runtime-authority overclaims.