diff --git a/.github/metrics/meta.json b/.github/metrics/meta.json
index c55c4b387..a41b26e97 100644
--- a/.github/metrics/meta.json
+++ b/.github/metrics/meta.json
@@ -4,4 +4,4 @@
   "changes": 2,
   "errors": 0,
   "optouts": 0
-}
\ No newline at end of file
+}
diff --git a/.github/reports/audits/readme-audit-2026-05-31.md b/.github/reports/audits/readme-audit-2026-05-31.md
index e5da9da36..51cdd280c 100644
--- a/.github/reports/audits/readme-audit-2026-05-31.md
+++ b/.github/reports/audits/readme-audit-2026-05-31.md
@@ -108,7 +108,18 @@ accDescr: Flowchart showing the VS Code configuration hierarchy with three main
 ---
 flowchart TD
     A[VS Code Workspace] --> B[Extensions]
-    ...
+    A --> C[Tasks]
+    A --> D[Settings]
+    B --> E[AI Agents]
+    C --> F[Build Automation]
+    D --> G[Linting Tools]
+    D --> H[Testing]
+    D --> I[EditorConfig]
+    D --> J[Keybindings]
+    G --> K[ESLint]
+    G --> L[Stylelint]
+    G --> M[Markdownlint]
+    H --> N[Jest]
 ```
 
 **Verification:** Accessibility attributes now present; compliant with WCAG 2.2 Level AA - 1.1.1 Non-text Content.
diff --git a/hooks/session-logger/README.md b/hooks/session-logger/README.md
index 51d640f04..296014462 100644
--- a/hooks/session-logger/README.md
+++ b/hooks/session-logger/README.md
@@ -1,11 +1,15 @@
 ---
-file_type: "documentation"
-title: "session-logger Hook"
-description: "Captures structured session activity events for audit and troubleshooting."
-version: "v0.1.0"
-last_updated: "2026-05-31"
-owners: ["LightSpeedWP Team"]
+file_type: readme
+title: session-logger hook
+description: Captures structured session activity events for audit and troubleshooting.
+version: v0.1.0
+last_updated: '2026-05-28'
+owners:
+- LightSpeedWP Team
 ---
 
 *Built by 🧱 LightSpeedWP with ☕, 🚀, and open-source spirit!*
 [Contributors](https://github.com/lightspeedwp/lsx-demo-theme/graphs/contributors)
+
+*Built by 🧱 LightSpeedWP with ☕, 🚀, and open-source spirit!*
+[Contributors](https://github.com/lightspeedwp/lsx-demo-theme/graphs/contributors)
diff --git a/hooks/tool-guardian/README.md b/hooks/tool-guardian/README.md
index 019b421c8..224c7641c 100644
--- a/hooks/tool-guardian/README.md
+++ b/hooks/tool-guardian/README.md
@@ -1,11 +1,15 @@
 ---
-file_type: "documentation"
-title: "tool-guardian Hook"
-description: "Prevents unsafe or disallowed tool operations based on configured guardrails."
-version: "v0.1.0"
-last_updated: "2026-05-31"
-owners: ["LightSpeedWP Team"]
+file_type: readme
+title: tool-guardian hook
+description: Prevents unsafe or disallowed tool operations based on configured guardrails.
+version: v0.1.0
+last_updated: '2026-05-28'
+owners:
+- LightSpeedWP Team
 ---
 
 *Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team*
 [Org Profile](https://github.com/lightspeedwp/.github/tree/main/profile)
+
+*Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team*
+[Org Profile](https://github.com/lightspeedwp/.github/tree/main/profile)
diff --git a/plugins/lightspeed-github-ops/hooks/README.md b/plugins/lightspeed-github-ops/hooks/README.md
index 5ee1f2b00..f2b069497 100644
--- a/plugins/lightspeed-github-ops/hooks/README.md
+++ b/plugins/lightspeed-github-ops/hooks/README.md
@@ -1,5 +1,5 @@
 ---
-file_type: "documentation"
+file_type: readme
 title: "Plugin Hooks"
 description: "Optional plugin-local hooks for lightspeed-github-ops"
 version: "1.0"
@@ -8,6 +8,6 @@ maintainer: "LightSpeed Engineering"
 tags: ["hooks", "plugins", "github-ops"]
 ---
 
-# hooks
+# Plugin Hooks
 
 Optional plugin-local hooks live here.
diff --git a/schema/frontmatter.schema.json b/schema/frontmatter.schema.json
index fc5d9b210..efed7c458 100644
--- a/schema/frontmatter.schema.json
+++ b/schema/frontmatter.schema.json
@@ -721,6 +721,64 @@
       },
       "required": ["file_type", "description"],
       "additionalProperties": true
+    },
+    {
+      "title": "README Files (README.md)",
+      "description": "Module and project README documentation files.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/commonFields"
+        }
+      ],
+      "properties": {
+        "file_type": {
+          "const": "readme"
+        },
+        "title": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        },
+        "last_updated": {
+          "type": "string"
+        },
+        "maintainer": {
+          "type": "string"
+        },
+        "authors": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "license": {
+          "type": "string"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "domain": {
+          "$ref": "#/definitions/commonFields/properties/domain"
+        },
+        "stability": {
+          "$ref": "#/definitions/commonFields/properties/stability"
+        },
+        "deprecated": {
+          "$ref": "#/definitions/commonFields/properties/deprecated"
+        },
+        "replacement": {
+          "$ref": "#/definitions/commonFields/properties/replacement"
+        }
+      },
+      "required": ["file_type", "title", "description"],
+      "additionalProperties": true
     }
   ],
   "examples": [
diff --git a/scripts/agents/includes/__tests__/README.md b/scripts/agents/includes/__tests__/README.md
index 4d001b35a..da87c0533 100644
--- a/scripts/agents/includes/__tests__/README.md
+++ b/scripts/agents/includes/__tests__/README.md
@@ -1,5 +1,5 @@
 ---
-file_type: "documentation"
+file_type: readme
 name: "Utility Module Test Suite"
 title: Utility Module Test Suite
 description: Comprehensive Jest tests for labelling agent utility modules
@@ -9,5 +9,7 @@ maintainer: "LightSpeed Engineering"
 tags: [testing, jest, utilities, labelling]
 ---
 
+# Utility Module Test Suite
+
 *Have questions? Ping us on GitHub! 🐙 Made with 💚 by LightSpeedWP*
 [Contact](https://lightspeedwp.agency/contact)
diff --git a/scripts/validation/README.md b/scripts/validation/README.md
index 98aafd5ff..6f0e65e4a 100644
--- a/scripts/validation/README.md
+++ b/scripts/validation/README.md
@@ -1,6 +1,6 @@
 ---
-file_type: documentation
-name: Frontmatter Validation
+file_type: readme
+title: Frontmatter Validation
 description: Comprehensive frontmatter validation scripts for LightSpeedWP .github
   repository ensuring schema compliance and consistency
 version: 1.0.1