diff --git a/.github/README.md b/.github/README.md
index 7e016089c..a3ae93e97 100644
--- a/.github/README.md
+++ b/.github/README.md
@@ -2,6 +2,7 @@
 description: "Central hub for all shared GitHub templates, Copilot instructions, workflow automation, labeling systems, and community health files across the LightSpeed WordPress organisation"
 version: "3.0"
 last_updated: "2025-10-24"
+file_type: "documentation"
 owners:
 - LightSpeed Team
 tags:
@@ -13,16 +14,26 @@ tags:
 - labeling
 - ai
 references:
-- ./custom-instructions.md
-- ./agents/agent.md
-- ./prompts/prompts.md
-- ./chatmodes/chatmodes.md
-- ../AGENTS.md
-- ./automation/AUTOMATION_GOVERNANCE.md
-- ./automation/labels.yml
-- ./automation/labeler.yml
-- ./instructions/coding-standards.instructions.md
-- ../CONTRIBUTING.md
+  - path: ./custom-instructions.md
+    description: Custom instructions for AI agents
+  - path: ./agents/agent.md
+    description: Main agents index
+  - path: ./prompts/prompts.md
+    description: Prompts index
+  - path: ./chatmodes/chatmodes.md
+    description: Chatmodes index
+  - path: ../AGENTS.md
+    description: Organization-wide agents documentation
+  - path: ./automation/AUTOMATION_GOVERNANCE.md
+    description: Automation governance policies
+  - path: ./automation/labels.yml
+    description: Label definitions
+  - path: ./automation/labeler.yml
+    description: Labeler configuration
+  - path: ./instructions/coding-standards.instructions.md
+    description: Coding standards instructions
+  - path: ../CONTRIBUTING.md
+    description: Contribution guidelines
 ---
 LightSpeed Organisation .github Community Health Repository
 ==========================================================
diff --git a/.github/agents/README.md b/.github/agents/README.md
index e9cf835be..f58fc9210 100644
--- a/.github/agents/README.md
+++ b/.github/agents/README.md
@@ -6,7 +6,7 @@ author: "LightSpeed"
 maintainer: "Ash Shaw"
 description: "Comprehensive directory of all GitHub automation agents, their workflows, tests, and related resources."
 tags: ["lightspeed","agents","automation","workflows","github-actions"]
-type: "documentation"
+file_type: "documentation"
 ---
 
 ## 🚀 Quick Start
diff --git a/.github/reporting/README.md b/.github/reporting/README.md
index 97a779037..8a521bf8b 100644
--- a/.github/reporting/README.md
+++ b/.github/reporting/README.md
@@ -6,13 +6,17 @@ author: 'LightSpeed'
 maintainer: 'Ash Shaw'
 description: 'Central location for generated reports, metrics outputs, and analytics artifacts across LightSpeed repositories.'
 tags: ['reporting', 'metrics', 'analytics', 'artifacts', 'automation']
-type: 'documentation'
+file_type: 'documentation'
 category: 'infrastructure'
 references:
-    - '../metrics/README.md'
-    - '../metrics/metrics.config.json'
-    - '../agents/metrics.agent.md'
-    - '../../docs/BRANDING.md'
+    - path: '../metrics/README.md'
+      description: 'Metrics collection configuration and documentation'
+    - path: '../metrics/metrics.config.json'
+      description: 'Master configuration for metrics collection'
+    - path: '../agents/metrics.agent.md'
+      description: 'Metrics agent specification'
+    - path: '../../docs/BRANDING.md'
+      description: 'Branding guidelines and automation'
 ---
 
 # LightSpeed Reporting Directory
diff --git a/.gitignore b/.gitignore
index aba56ac81..abea2bd55 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,5 @@
 # Dependencies
-/node_modules
+node_modules/
 /vendor
 
 # Build directories
diff --git a/README.md b/README.md
index a670c45ba..1c8c65913 100644
--- a/README.md
+++ b/README.md
@@ -3,19 +3,28 @@ title: "LightSpeed Community Health & Automation Repository"
 description: "Central hub for LightSpeed organization's community health files, automation standards, label management, governance documentation, and org-wide resources for GitHub usage and contribution."
 version: "2.0"
 last_updated: "2025-10-24"
+file_type: "documentation"
 maintainer: "LightSpeed Team"
 tags: ["community-health", "automation", "governance", "labels", "workflows", "ai", "copilot"]
-ai_references:
-  - ".github/custom-instructions.md"
-  - ".github/agents/agent.md"
-  - ".github/prompts/prompts.md"
-  - ".github/chatmodes/chatmodes.md"
-  - "AGENTS.md"
-related_docs:
-  - "DOCS.md"
-  - "CONTRIBUTING.md"
-  - "GOVERNANCE.md"
-  - "AUTOMATION_GOVERNANCE.md"
+references:
+  - path: ".github/custom-instructions.md"
+    description: "Custom instructions for AI agents"
+  - path: ".github/agents/agent.md"
+    description: "Main agents index"
+  - path: ".github/prompts/prompts.md"
+    description: "Prompts index"
+  - path: ".github/chatmodes/chatmodes.md"
+    description: "Chatmodes index"
+  - path: "AGENTS.md"
+    description: "Organization-wide agents documentation"
+  - path: "DOCS.md"
+    description: "Documentation index"
+  - path: "CONTRIBUTING.md"
+    description: "Contribution guidelines"
+  - path: "GOVERNANCE.md"
+    description: "Governance policies"
+  - path: "AUTOMATION_GOVERNANCE.md"
+    description: "Automation governance policies"
 ---
 
 # 🏠 LightSpeed Community Health & Automation Repository
diff --git a/docs/BRANDING.md b/docs/BRANDING.md
index 43a067deb..690a44be2 100644
--- a/docs/BRANDING.md
+++ b/docs/BRANDING.md
@@ -10,12 +10,18 @@ tags: ['branding', 'automation', 'documentation', 'badges', 'emojis', 'workflows
 file_type: 'documentation'
 category: 'docs'
 references:
-    - '../.github/automation/badges.schema.yml'
-    - '../.github/automation/emoji.schema.yml'
-    - '../.github/automation/footers.yml'
-    - '../.github/automation/front-matter.schema.json'
-    - '../.github/workflows/branding.yml'
-    - '../.github/agents/branding.agent.js'
+    - path: '../.github/automation/badges.schema.yml'
+      description: 'Badge schema configuration'
+    - path: '../.github/automation/emoji.schema.yml'
+      description: 'Emoji schema configuration'
+    - path: '../.github/automation/footers.yml'
+      description: 'Footer templates configuration'
+    - path: '../.github/automation/front-matter.schema.json'
+      description: 'Frontmatter schema definition'
+    - path: '../.github/workflows/branding.yml'
+      description: 'Branding automation workflow'
+    - path: '../.github/agents/branding.agent.js'
+      description: 'Branding agent implementation'
 ---
 
 # Branding Agent — Spec (develop)