lightspeedwp · ashleyshaw · May 29, 2026 · May 29, 2026 · May 29, 2026 · May 29, 2026
@@ -37,7 +37,7 @@ reviews:
     - "!assets/css/*.map"
     - "!logs/**"
     - "!docs/drafts/**"
-    - "!.schemas/**"
+    - "!schema/**"
     - "!coverage/**"
     - "!.jest-skip/**"
 

@@ -1,22 +1,17 @@
 ---
-file_type: documentation
-title: Pull Request Templates Directory
-description: Standardized pull request templates for the LightSpeedWP organization
-version: v1.2
-created_date: '2025-10-20'
-last_updated: '2026-05-29'
-author: LightSpeed Team
-maintainer: Ash Shaw
-owners:
-- lightspeedwp/maintainers
-license: GPL-3.0
-domain: governance
-stability: stable
-tags:
-- templates
-- pull-requests
-- governance
-- automation
+file_type: "documentation"
+title: "Pull Request Templates Directory"
+description: "Standardized pull request templates for the LightSpeedWP organization"
+version: "v1.2"
+created_date: "2025-10-20"
+last_updated: "2026-05-29"
+author: "LightSpeed Team"
+maintainer: "Ash Shaw"
+owners: ["lightspeedwp/maintainers"]
+license: "GPL-3.0"
+domain: "governance"
+stability: "stable"
+tags: ["templates", "pull-requests", "governance", "automation"]
 ---
 
 # 🔀 Pull Request Templates Directory

@@ -131,7 +131,7 @@ npm run validate:frontmatter
 # Locally: inspect changed files manually or use markdown-link-check
 ```
 
-Frontmatter validation uses the canonical schema at `.schemas/frontmatter.schema.json`.
+Frontmatter validation uses the canonical schema at `schema/frontmatter.schema.json`.
 
 ## Examples
 

@@ -1,23 +1,16 @@
 ---
-title: LightSpeed Metrics Directory
-version: v1.1
-last_updated: '2026-05-29'
-author: LightSpeed
-maintainer: Ash Shaw
-description: Metrics collection scripts, configuration, and automation for tracking
-  repository health, documentation quality, and project activity.
-tags:
-- metrics
-- analytics
-- automation
-- monitoring
-- quality
-file_type: documentation
-owners:
-- LightSpeed Team
-domain: governance
-stability: stable
-status: active
+title: "LightSpeed Metrics Directory"
+version: "v1.1"
+last_updated: "2026-05-29"
+author: "LightSpeed"
+maintainer: "Ash Shaw"
+description: "Metrics collection scripts, configuration, and automation for tracking repository health, documentation quality, and project activity."
+tags: ["metrics", "analytics", "automation", "monitoring", "quality"]
+file_type: "documentation"
+owners: ["LightSpeed Team"]
+domain: "governance"
+stability: "stable"
+status: "active"
 ---
 
 # LightSpeed Metrics Directory

@@ -4,4 +4,4 @@
   "changes": 35,
   "errors": 0,
   "optouts": 0
-}
+}
@@ -3,7 +3,7 @@ file_type: "documentation"
 description: "Code Refactor"
 name: "Code Refactor"
 about: "Request or propose a code refactoring or review to improve code quality, maintainability, and consistency."
-title: "[Refactor] Move active portable schemas to `/.schemas`"
+title: "[Refactor] Move active portable schemas to `/schema`"
 labels: [status:needs-review, priority:important, area:core, area:ci]
 github_issue: "https://github.com/lightspeedwp/.github/issues/297"
 github_parent: "https://github.com/lightspeedwp/.github/issues/283"

@@ -1,19 +1,18 @@
 ---
-file_type: documentation
-title: Portable Schemas Migration Report
-description: 'Issue #297 evidence for moving active portable schemas from .github/schemas
-  into /.schemas.'
-version: v0.1.0
-last_updated: '2026-05-20'
-maintainer: LightSpeed Team
-authors:
-- Codex
-license: GPL-3.0
-tags:
-- portable-ai-plugin-restructure
-- schemas
-- migration
-- issue-297
-domain: governance
-stability: experimental
+file_type: "report"
+title: "Portable Schemas Migration Report"
+description: "Issue #297 evidence for moving active portable schemas from .github/schemas into /schema."
+version: "v0.1.0"
+last_updated: "2026-05-20"
+maintainer: "LightSpeed Team"
+authors: ["Codex"]
+license: "GPL-3.0"
+tags: ["portable-ai-plugin-restructure", "schemas", "migration", "issue-297"]
+domain: "ai-ops"
+stability: "draft"
+references:
+  - path: "issues/children/batch-02-portable-migration/02-05-refactor-move-active-schemas-to-root-schemas.md"
+    description: "Issue #297 local source draft."
+  - path: "portable-ai-plugin-restructure-migration-map-2026-05-15.csv"
+    description: "Canonical migration decision map."
 ---
@@ -78,7 +78,7 @@ The branding agent supports 16 document categories as defined in Issue #33:
 | `documentation` | Documentation | General documentation, guides, tutorials | `docs/`, `README.md` |
 | `agents` | AI Agents | Agent specifications and behavior definitions | `.github/agents/`, agent specs |
 | `instructions` | Instructions | Procedural documentation, workflow steps | `.github/instructions/` |
-| `schemas` | Schemas | JSON Schema, data model definitions | `schema/`, `.schemas/` |
+| `schemas` | Schemas | JSON Schema, data model definitions | `schema/`, `schema/` |
 | `prompts` | Prompts | AI/ML prompts, templates, examples | `prompts/`, agent prompts |
 | `governance` | Governance | Policies, standards, guidelines | `CLAUDE.md`, `.coderabbit.yaml` |
 | `issue-template` | Issue Templates | GitHub issue templates | `.github/ISSUE_TEMPLATE/` |
@@ -573,7 +573,7 @@ path_mappings:
   ".github/instructions/**": "instructions"
   "instructions/**": "instructions"
   "schema/**": "schemas"
-  ".schemas/**": "schemas"
+  "schema/**": "schemas"
   "prompts/**": "prompts"
   ".github/workflows/**": "workflow"
   ".github/ISSUE_TEMPLATE/**": "issue-template"

@@ -202,7 +202,7 @@ The following 26 README files were scanned and contain no Mermaid diagrams (no a
 - `./.github/reports/README.md`
 - `./.github/schemas/README.md`
 - `./.github/workflows/README.md`
-- `./.schemas/README.md`
+- `./schema/README.md`
 - `./.vscode/README.md`
 - `./agents/README.md`
 - `./cookbook/README.md`

@@ -1,20 +1,20 @@
 ---
-file_type: documentation
-title: .github Schemas Boundary
-description: Repo-local index for schemas that remain under the .github control-plane
-  boundary.
-version: v0.2.1
-last_updated: '2026-05-29'
-maintainer: LightSpeed Team
-authors:
-- Codex
-license: GPL-3.0
-tags:
-- schemas
-- github-boundary
-- ai-ops
-domain: governance
-stability: experimental
+file_type: "index"
+title: ".github Schemas Boundary"
+description: "Repo-local index for schemas that remain under the .github control-plane boundary."
+version: "v0.2.0"
+last_updated: "2026-05-20"
+maintainer: "LightSpeed Team"
+authors: ["Codex"]
+license: "GPL-3.0"
+tags: ["schemas", "github-boundary", "ai-ops"]
+domain: "governance"
+stability: "draft"
+references:
+  - path: "../../schema/README.md"
+    description: "Portable schema library index."
+  - path: "../projects/active/portable-ai-plugin-restructure/issues/children/batch-02-portable-migration/02-05-refactor-move-active-schemas-to-root-schemas.md"
+    description: "Issue #297 local source draft."
 ---
 
 *Built by 🧱 LightSpeedWP with ☕, 🚀, and open-source spirit!*

@@ -121,7 +121,7 @@ flowchart TD
 ### 🧪 Testing & Quality
 
 - [Testing Framework](../tests/README.md) - Test suites and coverage documentation
-- [JSON Schemas](../.schemas/README.md) - Schema validation and IDE integration
+- [JSON Schemas](../schema/README.md) - Schema validation and IDE integration
 - [Main Repository](../README.md) - LightSpeed community health repository
 
 ---

@@ -4,5 +4,5 @@
   "pluginRoot": "plugins",
   "skillsRoot": "skills",
   "instructionsRoot": "instructions",
-  "schemaRoot": ".schemas"
+  "schemaRoot": "schema"
 }
@@ -1,22 +1,26 @@
 ---
-title: LightSpeed Global AI Rules
-description: Organisation-wide AI agent rules, coding standards, and contribution
-  guidelines for all LightSpeed WordPress projects.
-version: v1.4
-last_updated: '2026-05-29'
-file_type: agents-index
-maintainer: LightSpeed Team
-authors:
-- LightSpeed Team
-license: GPL-3.0
-tags:
-- agents
-- ai
-- coding-standards
-- governance
-- wordpress
-domain: governance
-stability: stable
+title: "LightSpeed Global AI Rules"
+description: "Organisation-wide AI agent rules, coding standards, and contribution guidelines for all LightSpeed WordPress projects."
+version: "v1.4"
+last_updated: "2026-05-29"
+file_type: "agents-index"
+maintainer: "LightSpeed Team"
+authors: ["LightSpeed Team"]
+license: "GPL-3.0"
+tags: ["agents", "ai", "coding-standards", "governance", "wordpress"]
+domain: "governance"
+stability: "stable"
+references:
+  - path: "ai/agents.md"
+    description: "Canonical AI agents source-of-truth index"
+  - path: "ai/RUNNERS.md"
+    description: "Canonical runner and telemetry inventory"
+  - path: "agents/agent.md"
+    description: "Main agent implementations index"
+  - path: ".github/custom-instructions.md"
+    description: "Repo-local Copilot and agent instructions"
+  - path: ".github/prompts/prompts.md"
+    description: "Prompts index"
 ---
 
 # LightSpeed – Global AI Rules (AGENTS.md)
@@ -107,7 +111,7 @@ Start here for all key standards:
 
 - [Contributing Guidelines](CONTRIBUTING.md) - For human contributors
 - [Main Documentation](README.md) - Project overview
-- [Frontmatter Schema](.schemas/frontmatter.schema.json) - Schema validation
+- [Frontmatter Schema](schema/frontmatter.schema.json) - Schema validation
 
 *This file is the canonical reference for all AI agent rules and coding standards in LightSpeedWP projects.
 All contributors, agents, and AI assistants must comply with these standards.*

@@ -1,21 +1,8 @@
 ---
-title: Changelog
-description: All notable changes to this project, formatted per Keep a Changelog 1.1.0
-  and Semantic Versioning
-file_type: documentation
-category: governance
-version: 1.0.3
-last_updated: '2026-05-29'
-owners:
-- ashleyshaw
-tags:
-- changelog
-- versioning
-- releases
-- governance
-status: active
-stability: stable
-domain: governance
+title: "Changelog"
+description: "All notable changes to this project, formatted per Keep a Changelog 1.1.0 and Semantic Versioning"
+file_type: "documentation"
+created_date: "2025-09-20"
 ---
 
 # Changelog
@@ -29,21 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- **Wave 4C: Branding Agent Current-State Audit** — Added `.github/projects/active/ISSUE_48_CURRENT_STATE_AUDIT.md` comprehensive audit specification ([#48](https://github.com/lightspeedwp/.github/issues/48), [#562](https://github.com/lightspeedwp/.github/pull/562)):
-  - Current-state inventory catalogs ~750 Markdown files with branding implementations
-  - Frontmatter compliance analysis (90.6% compliant, 70 files with missing required fields)
-  - Category mapping accuracy audit (98%+ correct, specific gaps identified)
-  - Header and footer pattern analysis (84.5% coverage gap identified)
-  - Badge usage assessment (1.9% adoption, 40% non-standard values)
-  - WCAG AA accessibility audit (95%+ compliance with specific improvement areas)
-  - Detailed gap analysis against new schema/config standards
-  - Prioritized remediation roadmap with effort estimates (16–23 hours across 5 phases)
-  - Automated remediation scripts scoped and designed
-  - Risk assessment with comprehensive mitigation strategies
-  - Success criteria and measurable outcomes for agent rollout
-  - Unblocks Wave 4E (Agent merge/refactor) and Wave 4F (Bulk remediation & validation)
-
-- **Comprehensive 25-Slide Deck Prompt Suite** — Added `.github/agent-slide-decks/` directory with 25 NotebookLM and Figma-ready presentation prompts covering the complete .github automation ecosystem:
+- **Comprehensive 25-Slide Deck Prompt Suite** — Added `.github/wceu-2026/agent-slides/` directory with 25 NotebookLM and Figma-ready presentation prompts covering the complete .github automation ecosystem:
   - **7 Agent Prompts**: Release, Branding, Meta, Reviewer, Linting, Labelling, and Planner agents with capabilities, integration points, and use cases
   - **3 Infrastructure Prompts**: Plugin/Agents/Skills/Hooks integration, Scripts & Automation orchestration, and Workflows architecture
   - **8 Process & Lifecycle Prompts**: PR lifecycle, issue triage, release process, documentation standards, repository metrics, QA/testing, plugin deep-dive, and observability/logging
@@ -132,7 +105,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 
 - Remediated duplicate and multiple footer blocks across 664 Markdown files using schema-driven validation. Created footer configuration schema (`schema/footer-config.schema.json`), centralized footer library with 15 document categories (`config/footers.config.yaml`), and automated validation/remediation script (`.github/scripts/validate-footers.js`). Violations fixed: 51 duplicate footer files → 0, 613 multiple-footer files → 0. Published remediation guide (`.github/FOOTER_REMEDIATION_GUIDE.md`). Related to branding meta agent planning (#33, #46, #48, #49). ([#534](https://github.com/lightspeedwp/.github/pull/534))
-- Removed prohibited `references:` frontmatter field from 9 README files (`README.md`, `.github/README.md`, `.github/agents/README.md`, `.github/instructions/README.md`, `.github/metrics/README.md`, `.github/schemas/README.md`, `.schemas/README.md`, `profile/README.md`, `scripts/README.md`) per CLAUDE.md governance rule. Added missing required frontmatter fields (`owners`, `status`, `stability`, `domain`) to affected files. Removed 13 duplicate footer blocks from root `README.md`. Added `.lycheeignore` excluding social-platform and LightSpeed external domains from CI link checking. Added `docs/MIGRATION.md` portable AI plugin restructure migration maps (completed and pending migrations, file placement quick-reference). Related to [#18](https://github.com/lightspeedwp/.github/issues/18). ([#527](https://github.com/lightspeedwp/.github/pull/527))
+- Removed prohibited `references:` frontmatter field from 9 README files (`README.md`, `.github/README.md`, `.github/agents/README.md`, `.github/instructions/README.md`, `.github/metrics/README.md`, `.github/schemas/README.md`, `schema/README.md`, `profile/README.md`, `scripts/README.md`) per CLAUDE.md governance rule. Added missing required frontmatter fields (`owners`, `status`, `stability`, `domain`) to affected files. Removed 13 duplicate footer blocks from root `README.md`. Added `.lycheeignore` excluding social-platform and LightSpeed external domains from CI link checking. Added `docs/MIGRATION.md` portable AI plugin restructure migration maps (completed and pending migrations, file placement quick-reference). Related to [#18](https://github.com/lightspeedwp/.github/issues/18). ([#527](https://github.com/lightspeedwp/.github/pull/527))
 - Replaced deprecated MCP tool references (`create_issue`, `update_issue`, `get_issue`) with current equivalents (`issue_write`, `issue_read`) across agent specs and prompt files. Closes [#52](https://github.com/lightspeedwp/.github/issues/52). ([#455](https://github.com/lightspeedwp/.github/pull/455))
 - Expanded issue template DoD checklists with discrete accessibility (WCAG 2.2 AA), security (OWASP Top 10), and performance items, aligning issue templates with the PR template. Closes [#21](https://github.com/lightspeedwp/.github/issues/21). ([#460](https://github.com/lightspeedwp/.github/pull/460))
 - Updated `.coderabbit.yml`: corrected schema URL to `docs.coderabbit.ai/schema/schema.v2.json`; added `language: en-GB`, `inheritance: true`, `chat.auto_reply: true`; added `reviews.profile: chill` and `reviews.review_details: true`; hardened workflow path instructions with security guidance (least-privilege permissions, secret injection prevention, action pinning); added `instructions/**` and `CHANGELOG.md` path instructions; expanded path filters. Closes [#23](https://github.com/lightspeedwp/.github/issues/23).
@@ -143,7 +116,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - **7 Agent Prompts**: Release, Branding, Meta, Reviewer, Linting, Labelling, Planner agents
   - **3 Infrastructure Prompts**: Plugin/agents/skills/hooks ecosystem, scripts and automation, GitHub Actions workflows
   - **15 Ecosystem Prompts**: Pull request lifecycle, issue triage, release process, documentation standards, repository metrics/KPIs, QA/testing, plugin architecture, observability/logging, WordPress governance, contributing guidelines, onboarding, developer experience, troubleshooting, roadmap/vision, case studies
-  - **Navigation**: Updated `.github/agent-slide-decks/README.md` with comprehensive index across all 25 prompts
+  - **Navigation**: Updated `.github/wceu-2026/agent-slides/README.md` with comprehensive index across all 25 prompts
   - **Structure**: Each prompt includes overview, capabilities, integration points, use cases, slide structure, evidence anchors, design notes, quality bar
   - Enables complete NotebookLM knowledge base generation and design system documentation ([#539](https://github.com/lightspeedwp/.github/pull/539))
 

@@ -57,7 +57,7 @@ For comprehensive documentation, see the [docs/](./docs/) folder and [.github/RE
 
 ### Portable AI Source Folders
 
-- [.schemas/README.md](./.schemas/README.md) - Portable schema ownership
+- [schema/README.md](./schema/README.md) - Portable schema ownership
 - [agents/README.md](./agents/README.md) - Portable agent specs
 - [cookbook/README.md](./cookbook/README.md) - Recipes and examples
 - [hooks/README.md](./hooks/README.md) - Hooks and guardrails

@@ -1,29 +1,15 @@
 ---
-name: Demonstrate Understanding
-title: Demonstrate Understanding
-description: Validate user understanding of code, design patterns, and implementation
-  details through guided questioning.
-version: v1.1
-last_updated: '2026-05-29'
-owners:
-- LightSpeedWP Engineering
-tags:
-- agent
-- mode
-- understanding
-- review
-- mentoring
-file_type: agent
-status: active
-domain: governance
-stability: stable
-tools:
-- codebase
-- fetch
-- findTestFiles
-- githubRepo
-- search
-- usages
+name: "Demonstrate Understanding"
+description: "Validate user understanding of code, design patterns, and implementation details through guided questioning."
+version: "v1.1"
+last_updated: "2026-05-29"
+owners: ["LightSpeedWP Engineering"]
+tags: ["agent", "mode", "understanding", "review", "mentoring"]
+file_type: "agent"
+status: "active"
+domain: "quality"
+stability: "stable"
+tools: ["codebase", "fetch", "findTestFiles", "githubRepo", "search", "usages"]
 permissions:
 - read
 metadata: