TidyFactor · alwkala · Sep 10, 2026
diff --git a/.tidyfactor b/.tidyfactor
@@ -2,7 +2,7 @@
   "ecosystem": "tidyfactor",
   "track": "html",
   "name": "tidyfactor-html",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "npmPackage": "@alwkala/tidyfactor-html",
   "github": "https://github.com/TidyFactor/HTML",
   "skillFile": "../tidyfactor-html-v1.1.0.skill",

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,18 @@
 
 All notable changes to the **[@tidyfactor/html](https://www.npmjs.com/package/@tidyfactor/html)** package will be documented in this file.
 
+## [1.3.0] - 2026-09-10
+
+### Added — Agentic Browsing Readiness & llms.txt Discovery
+- **SEO & Machine Discovery Command Update (`references/commands/seo.md`)**:
+  - Injected standard `<link rel="alternate" type="text/markdown" href="/llms.txt" title="LLM Overview" />` discovery tag into `<head>`.
+  - Added deterministic check for AI-agent-friendly semantic HTML controls and non-blocking `robots.txt` configuration for `GPTBot` and `ClaudeBot`.
+- **Quality Gate Expansion (`references/memory/quality-bar.md`)**:
+  - Expanded Axis S to enforce Agentic Browsing readiness, accessible names for interactive nodes, and `/llms.txt` discovery tags.
+  - Added CLS threshold (≤ 0.05) to Axis V to prevent autonomous agent click targeting failures.
+
+---
+
 ## [1.2.0] - 2026-08-29
 
 ### Added - Global Multi-Tier & Multi-Language Documentation Architecture

diff --git a/README.ar.md b/README.ar.md
@@ -1,7 +1,7 @@
 <div align="center" dir="rtl">
 
-# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.2.0`
-### محرك المواقع الثابتة بنسبة 100% ومكونات الويب Web Components لوكلاء الذكاء الاصطناعي
+# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.3.0`
+### محرك المواقع الثابتة بنسبة 100%، مكونات الويب، وجاهزية تصفح الوكلاء (Agentic Browsing)
 
 [![npm version](https://img.shields.io/npm/v/@tidyfactor/html.svg?style=for-the-badge&color=E34F26&logo=npm)](https://www.npmjs.com/package/@tidyfactor/html)
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE)

diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 <div align="center">
 
-# 🌐 TidyFactor HTML `v1.2.0`
-### 100% Static Platform Starter, Web Components & Contextual Decision Engine
+# 🌐 TidyFactor HTML `v1.3.0`
+### 100% Static Platform Starter, Web Components, Agentic Browsing & Contextual Decision Engine
 
 **The official static web engineering track within the TidyFactor Architecture Ecosystem.**
 

diff --git a/brand.json b/brand.json
@@ -1,6 +1,6 @@
 {
   "name": "TidyFactor HTML",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "schemaVersion": "brand-core-v2",
   "meta": {
     "product": "TidyFactor HTML",

diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tidyfactor/html",
-  "version": "1.2.0",
-  "description": "TidyFactor HTML track — 100% static HTML/CSS/JS platform starter with Contextual Decision Layer (CDL)",
+  "version": "1.3.0",
+  "description": "TidyFactor HTML track — 100% static HTML/CSS/JS platform starter with Contextual Decision Layer (CDL) & Agentic Browsing Readiness",
   "main": "SKILL.md",
   "bin": {
     "tidyfactor-html": "bin/add-skill.js",

diff --git a/references/commands/seo.md b/references/commands/seo.md
@@ -26,16 +26,18 @@ sitemap, robots.
 4. Structured data (JSON-LD) where it clearly applies (Article, Product,
    Organization, BreadcrumbList) — don't force schema types that don't fit
    the content.
-5. Generate/update `sitemap.xml` by walking the final `/dist` (or source)
-   page tree, and `robots.txt` pointing to it.
-6. Bilingual mode: cross-reference `i18n.md`'s `hreflang` requirement —
+5. AI Agent & LLM Discovery: Add `<link rel="alternate" type="text/markdown" href="/llms.txt" title="LLM Overview" />`
+   to `<head>` of main layout/index to enable seamless agentic ingestion.
+6. Generate/update `sitemap.xml` by walking the final `/dist` (or source)
+   page tree, and `robots.txt` pointing to it (ensuring AI bots like GPTBot/ClaudeBot are not blanket blocked).
+7. Bilingual mode: cross-reference `i18n.md`'s `hreflang` requirement —
    `seo` is what actually adds it if `i18n` hasn't run yet.
 
 ## Output convention
 ```
 /dist/sitemap.xml   (or /sitemap.xml in runtime mode)
 /dist/robots.txt
-Per-page: <title>, <meta description>, og:*, twitter:*, canonical, JSON-LD
+Per-page: <title>, <meta description>, og:*, twitter:*, canonical, JSON-LD, llms.txt discovery
 ```
 
 ## Checklist
@@ -44,3 +46,5 @@ Per-page: <title>, <meta description>, og:*, twitter:*, canonical, JSON-LD
 - [ ] `sitemap.xml` matches the actual final page tree, no stale entries
 - [ ] `robots.txt` present and correctly points to the sitemap
 - [ ] Canonical URLs match the structure `pages.md` established
+- [ ] `llms.txt` discovery tag included in HTML `<head>`
+- [ ] All interactive buttons/links declare semantic tags and accessible names for AI agents
diff --git a/references/memory/quality-bar.md b/references/memory/quality-bar.md
@@ -14,7 +14,7 @@ Every generated static page, component, or config must be stamped:
 | **P** | **Philosophy & Zero Runtime** | Requires Node runtime, SSR, or backend server to view. | 100% static HTML/CSS/JS; runs by double-clicking or uploading to cPanel. |
 | **H** | **HTML5 Semantics & Structure** | `<div>` soup; missing `main`, `header`, `nav`, `section`, `footer`. | Semantic HTML5 structure with proper heading hierarchy (`h1` -> `h2` -> `h3`). |
 | **E** | **Encapsulation & Links** | Absolute workstation paths (`file:///C:/...`) or broken relative links. | Clean relative links (`./css/style.css`, `../assets/icon.svg`). |
-| **S** | **SEO & Metadata Integrity** | Missing OpenGraph tags, meta description, or viewport meta tag. | Complete OpenGraph, Twitter Cards, canonical URL, and favicon links. |
+| **S** | **SEO & Agentic Readiness** | Missing OpenGraph tags, no `llms.txt` discovery, non-semantic div-buttons causing agent click failures. | Complete OpenGraph, Twitter Cards, canonical URL, `/llms.txt` discovery tag, and accessible semantic controls for AI agents. |
 | **R** | **RTL & Internationalization** | Hardcoded text in markup preventing localization; broken RTL. | `dir="rtl"` / `lang="ar"` support with CSS logical properties (`margin-inline`). |
-| **V** | **Velocity & Asset Hygiene** | Uncompressed 5MB hero images; blocking render scripts. | Optimized SVGs, WebP images with explicit width/height, deferred scripts. |
+| **V** | **Velocity & Asset Hygiene** | Uncompressed 5MB hero images; blocking render scripts; layout shifts (CLS > 0.1). | Optimized SVGs, WebP images with explicit width/height (CLS ≤ 0.05), deferred scripts. |
 | **D** | **Decision Alignment** | Inconsistent foundation ignoring `.tidyfactor/html-brief.md`. | 100% compliant with confirmed Component Model and CSS strategy. |