diff --git a/.github/DISCUSSION_TEMPLATE/README.md b/.github/DISCUSSION_TEMPLATE/README.md
index 04b524c2d..5098013f5 100644
--- a/.github/DISCUSSION_TEMPLATE/README.md
+++ b/.github/DISCUSSION_TEMPLATE/README.md
@@ -1,11 +1,17 @@
 ---
-file_type: "discussion-template"
-name: "Discussion Templates Directory"
-description: "Standardized discussion templates for community engagement in LightSpeedWP"
-version: 'v1.1'
-last_updated: '2026-06-01'
-maintainer: "LightSpeed Engineering"
-tags: ["templates", "discussions", "community", "engagement"]
+title: "Discussion Templates Directory"
+description: "Standardized discussion templates for community engagement in LightSpeedWP. Templates for ideas, Q&A, announcements, architecture, documentation, feedback, and community discussions."
+name: "Discussion Templates"
+file_type: documentation
+version: v1.1
+last_updated: "2026-05-31"
+created_date: "2025-10-24"
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
+license: "GPL-3.0"
+tags: ["templates", "discussions", "community", "engagement", "governance"]
+domain: "governance"
+stability: "stable"
 ---
 
 # 💭 Discussion Templates Directory
diff --git a/.github/ISSUE_TEMPLATE/README.md b/.github/ISSUE_TEMPLATE/README.md
index 39faf5d73..b97d24100 100644
--- a/.github/ISSUE_TEMPLATE/README.md
+++ b/.github/ISSUE_TEMPLATE/README.md
@@ -1,9 +1,17 @@
 ---
-file_type: "issue-template"
-name: "Issue Templates Directory"
-description: "Standardized issue templates for consistent issue creation"
-version: '1.0.1'
-last_updated: '2026-06-01'
+title: "Issue Templates Directory"
+description: "Standardized issue templates for the LightSpeedWP organization. Templates for bugs, features, documentation, and custom issues with automation integration."
+name: "Issue Templates"
+file_type: documentation
+version: v1.2
+last_updated: "2026-05-31"
+created_date: "2025-10-20"
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
+license: "GPL-3.0"
+tags: ["templates", "issues", "governance", "automation"]
+domain: "governance"
+stability: "stable"
 ---
 
 # 📋 Issue Templates Directory
@@ -38,10 +46,6 @@ For advanced usage, see the [Issue Template Index](./ISSUE_TEMPLATE/README.md) a
 ## 🗂️ Issue Template Workflow
 
 ```mermaid
----
-accTitle: Issue Template Workflow
-accDescr: Flowchart showing the complete issue template workflow from user creation through automation agents, with template selection branching to Bug, Feature, Documentation, or Custom templates, all leading to auto-populated fields, issue creation, and agent processing including labeling, type assignment, project board assignment, and notification routing
----
 flowchart TD
     A[User Creates Issue] --> B{Select Template}
     B -->|Bug Report| C[Bug Template]
@@ -112,5 +116,4 @@ These templates integrate with:
 
 ---
 
-*Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team*
-[Org Profile](https://github.com/lightspeedwp/.github/tree/main/profile)
+<!-- RANDOM FOOTER: 🚀 Consistent templates, efficient workflows! -->
diff --git a/.github/PULL_REQUEST_TEMPLATE/README.md b/.github/PULL_REQUEST_TEMPLATE/README.md
index 742f72be0..caac8b400 100644
--- a/.github/PULL_REQUEST_TEMPLATE/README.md
+++ b/.github/PULL_REQUEST_TEMPLATE/README.md
@@ -1,17 +1,16 @@
 ---
-file_type: "documentation"
 title: "Pull Request Templates Directory"
-description: "Standardized pull request templates for the LightSpeedWP organization"
-version: 'v1.3'
+description: "Standardized pull request templates for the LightSpeedWP organization. Templates for bugs, features, chores, documentation, releases, and refactoring with automation integration."
+file_type: documentation
+version: v1.2
+last_updated: "2026-05-31"
 created_date: "2025-10-20"
-last_updated: '2026-06-01'
-author: "LightSpeed Team"
-maintainer: "Ash Shaw"
-owners: ["lightspeedwp/maintainers"]
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
 license: "GPL-3.0"
+tags: ["templates", "pull-requests", "governance", "automation"]
 domain: "governance"
 stability: "stable"
-tags: ["templates", "pull-requests", "governance", "automation"]
 ---
 
 # 🔀 Pull Request Templates Directory
@@ -80,5 +79,4 @@ These templates integrate with:
 
 ---
 
-*Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team*
-[Org Profile](https://github.com/lightspeedwp/.github/tree/main/profile)
+<!-- RANDOM FOOTER: 🔀 Streamlined PRs, seamless integration! -->
diff --git a/.github/SAVED_REPLIES/README.md b/.github/SAVED_REPLIES/README.md
index 744bb889d..239cac9b3 100644
--- a/.github/SAVED_REPLIES/README.md
+++ b/.github/SAVED_REPLIES/README.md
@@ -1,11 +1,16 @@
 ---
-file_type: "documentation"
 title: "Saved Replies Directory"
-description: "Organized saved replies for consistent GitHub interactions across LightSpeedWP"
-version: 'v1.1'
-last_updated: '2026-06-01'
-maintainer: "LightSpeed Engineering"
+description: "Organized saved replies for consistent GitHub interactions across LightSpeedWP. Community, issue, and pull request response templates."
+file_type: documentation
+version: v1.1
+last_updated: "2026-05-31"
+created_date: "2025-10-24"
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
+license: "GPL-3.0"
 tags: ["saved-replies", "communication", "automation", "community"]
+domain: "governance"
+stability: "stable"
 ---
 
 # 💬 Saved Replies Directory
diff --git a/.github/instructions/.archive/README.md b/.github/instructions/.archive/README.md
index 014b3572d..7428fb472 100644
--- a/.github/instructions/.archive/README.md
+++ b/.github/instructions/.archive/README.md
@@ -1,73 +1,115 @@
 ---
-file_type: "documentation"
-title: "Archived Instructions"
-description: "Deprecated and archived instruction files from consolidation efforts"
-status: "archived"
-last_updated: '2026-06-01'
+title: "Archive Directory"
+description: "Contains outdated or superseded documentation files preserved for historical reference. Archives deprecated instruction files, migration guides, and backup files."
+file_type: documentation
+version: v1.1
+last_updated: "2026-06-01"
+created_date: "2025-12-08"
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
+license: "GPL-3.0"
+tags: ["archive", "documentation", "historical"]
 domain: "governance"
+stability: "incubating"
 ---
 
-# Archived Instructions
+# Archive Directory
 
-This directory contains deprecated and consolidated instruction files preserved for historical reference. Files in this archive have been superseded by consolidation efforts during Wave 5 documentation audits.
+This directory contains documentation files that are outdated, superseded, or no longer actively maintained but preserved for historical reference.
 
-## Archive Contents
+## Contents
 
-### Archived Instruction Files (18 total) - Wave 5 Consolidation
+### Migration Guides (Archived December 8, 2025)
 
-The following files were consolidated during Wave 5.3 documentation audit (May 2026):
+**INSTRUCTION_CONSOLIDATION_MIGRATION.md** (394 lines)
 
-| File | Status | Consolidation Target |
-|------|--------|----------------------|
-| `agents.instructions.md` | Archived | Portable `instructions/` files |
-| `file-management.instructions.md` | Archived | `instructions/file-organisation.instructions.md` |
-| `file-organisation.instructions.md` | Archived | `instructions/file-organisation.instructions.md` |
-| `frontmatter.instructions.md` | Archived | `docs/FRONTMATTER_SCHEMA.md` |
-| `javascript.instructions.md` | Archived | `instructions/coding-standards.instructions.md` |
-| `jest.instructions.md` | Archived | `instructions/testing.instructions.md` |
-| `jsdoc.instructions.md` | Archived | `instructions/coding-standards.instructions.md` |
-| `json.instructions.md` | Archived | `instructions/coding-standards.instructions.md` |
-| `markdown.instructions.md` | Archived | `instructions/documentation-formats.instructions.md` |
-| `naming-conventions.instructions.md` | Archived | `instructions/coding-standards.instructions.md` |
-| `reporting.instructions.md` | Archived | `.github/reports/` folder structure |
-| `reviewer.instructions.md` | Archived | `docs/PR_CREATION_PROCESS.md` |
-| `saved-replies.instructions.md` | Archived | `.github/SAVED_REPLIES/` folder |
-| `testing.instructions.md` | Archived | `instructions/testing.instructions.md` |
-| `tests.instructions.md` | Archived | `instructions/testing.instructions.md` |
-| `yaml.instructions.md` | Archived | `instructions/documentation-formats.instructions.md` |
-| `CONSOLIDATION_MIGRATION_GUIDE.md` | Archived | Wave 5 Phase 2 execution plan |
-| `INSTRUCTION_CONSOLIDATION_MIGRATION.md` | Archived | Wave 5 Phase 2 execution plan |
+- **Status:** Superseded by `/MIGRATION_GUIDE.md`
+- **Purpose:** Documented the December 7, 2025 consolidation of 22 instruction files → 5
+- **Reason for archival:** Duplicate content; canonical version exists at repository root
+- **Estimated token savings:** ~1,970 tokens
 
-### Archival Timeline
+**CONSOLIDATION_MIGRATION_GUIDE.md** (387 lines)
 
-- **Wave 5.3 (May 2026):** Consolidated 18 instruction files into canonical portable instructions and documentation
-- **Retention period:** Files retained for 60 days or until all references updated
-- **Removal decision:** Scheduled for review in Wave 5.4
+- **Status:** Superseded by `/MIGRATION_GUIDE.md`
+- **Purpose:** Migration map for instruction file consolidation
+- **Reason for archival:** Duplicate content; canonical version exists at repository root
+- **Estimated token savings:** ~1,935 tokens
 
-## How to Use This Archive
+### Consolidated Instruction Files (Archived December 8, 2025)
 
-### If You Find a Reference to an Archived File
+**21 legacy instruction files consolidated on December 7, 2025:**
 
-1. Locate the consolidation target in the table above
-2. Update your reference to point to the canonical location
-3. File an issue if content is missing from the new location
+These files were the original pre-consolidation instruction files, superseded by 5 new consolidated files:
 
-### If You Need Old Guidance
+- agents.instructions.md (480 lines, ~2,400 tokens)
+- file-management.instructions.md (387 lines, ~1,935 tokens)
+- frontmatter.instructions.md (368 lines, ~1,840 tokens)
+- javascript.instructions.md (86 lines, ~430 tokens)
+- jest.instructions.md (47 lines, ~235 tokens)
+- jsdoc.instructions.md (550 lines, ~2,750 tokens)
+- json.instructions.md (97 lines, ~485 tokens)
+- markdown.instructions.md (186 lines, ~930 tokens)
+- mermaid.instructions.md (371 lines, ~1,855 tokens)
+- metrics.instructions.md (53 lines, ~265 tokens)
+- naming-conventions.instructions.md (46 lines, ~230 tokens)
+- planner.instructions.md (61 lines, ~305 tokens)
+- project-meta-sync.instructions.md (50 lines, ~250 tokens)
+- readme.instructions.md (160 lines, ~800 tokens)
+- release.instructions.md (218 lines, ~1,090 tokens)
+- reporting.instructions.md (297 lines, ~1,485 tokens)
+- reviewer.instructions.md (76 lines, ~380 tokens)
+- saved-replies.instructions.md (90 lines, ~450 tokens)
+- testing.instructions.md (203 lines, ~1,015 tokens)
+- tests.instructions.md (273 lines, ~1,365 tokens)
+- yaml.instructions.md (84 lines, ~420 tokens)
 
-1. Check the replacement file/location first
-2. If content is missing, file an issue requesting it be restored
-3. Do not rely on archived files as sources of truth
+**Total legacy instructions:** 4,161 lines, ~20,805 tokens
 
-## Canonical References
+**Superseded by:**
 
-For current instruction files, see:
+- `.github/instructions/languages.instructions.md` (consolidated: javascript, jsdoc, json, yaml)
+- `.github/instructions/documentation-formats.instructions.md` (consolidated: markdown, frontmatter, mermaid)
+- `.github/instructions/quality-assurance.instructions.md` (consolidated: testing, tests, jest)
+- `.github/instructions/automation.instructions.md` (consolidated: agents, metrics, planner, project-meta-sync, release, reporting, reviewer)
+- `.github/instructions/community-standards.instructions.md` (consolidated: file-management, naming-conventions, readme, saved-replies)
 
-- **Portable instructions:** `/instructions/` (top-level)
-- **Documentation:** `/docs/` (human-facing reference)
-- **Repo-local instructions:** `./.github/instructions/` (this repo only)
+### Backup Files (Archived December 8, 2025)
+
+**FRONTMATTER_SCHEMA.md.backup** (989 lines)
+
+- **Purpose:** Backup before Phase 6.2 duplicate section removal
+- **Estimated token savings:** ~4,945 tokens
+
+**ISSUE_TYPES.md.backup** (952 lines)
+
+- **Purpose:** Backup before Phase 6.1 consolidation
+- **Estimated token savings:** ~4,760 tokens
+
+**WORKFLOWS.md.backup** (657 lines)
+
+- **Purpose:** Backup before Phase 6.4 title clarification
+- **Estimated token savings:** ~3,285 tokens
+
+**Total Phase 5 Archival:** 3,379 lines, ~16,895 tokens saved
+
+---
+
+## Accessing Archived Files
+
+Archived files remain in the repository for historical reference. To access:
+
+```bash
+cd docs/.archive
+cat FILENAME.md
+```
+
+## Canonical Versions
+
+For current documentation, always reference:
+
+- **Migration Guide:** `/MIGRATION_GUIDE.md` (canonical version)
+- **All Instructions:** `.github/instructions/*.instructions.md` (consolidated files)
 
 ---
 
-**Archive Created:** May 2026 (Wave 5.3 Consolidation)  
-**Last Updated:** 2026-05-31  
-**Archiver:** Claude Code (Wave 5.3 Phase 2 Execution)
+*This archive was created as part of Phase 5 context reduction efforts (December 2025) to reduce repository token count from ~922K to <500K target.*
diff --git a/.github/metrics/README.md b/.github/metrics/README.md
index 72fb70c0a..6a8f558c6 100644
--- a/.github/metrics/README.md
+++ b/.github/metrics/README.md
@@ -1,16 +1,16 @@
 ---
 title: "LightSpeed Metrics Directory"
-version: "v1.2"
-last_updated: "2026-06-01"
-author: "LightSpeed"
-maintainer: "Ash Shaw"
-description: "Metrics collection scripts, configuration, and automation for tracking repository health, documentation quality, and project activity."
+description: "Metrics collection scripts, configuration, and automation for tracking repository health, documentation quality, and project activity across the LightSpeed organization."
+file_type: documentation
+version: v1.1
+last_updated: "2026-05-31"
+created_date: "2025-12-04"
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
+license: "GPL-3.0"
 tags: ["metrics", "analytics", "automation", "monitoring", "quality"]
-file_type: "documentation"
-owners: ["LightSpeed Team"]
 domain: "governance"
 stability: "stable"
-status: "active"
 ---
 
 # LightSpeed Metrics Directory
@@ -380,6 +380,3 @@ To contribute new metrics or improvements:
 ---
 
 Made with ❤️ by the LightSpeed team.
-
-*Have questions? Ping us on GitHub! 🐙 Made with 💚 by LightSpeedWP*
-[Contact](https://lightspeedwp.agency/contact)
diff --git a/.github/projects/README.md b/.github/projects/README.md
index 792e71a4a..77debf201 100644
--- a/.github/projects/README.md
+++ b/.github/projects/README.md
@@ -1,82 +1,83 @@
 ---
-file_type: "documentation"
 title: "Projects Directory"
-description: "Task tracking files, project planning documents, implementation roadmaps, and progress tracking for active and completed projects."
-version: "1.2"
-last_updated: "2026-06-01"
-owners: ["LightSpeed Engineering"]
-tags: ["projects", "documentation", "governance"]
+description: "Project planning documents, task tracking files, implementation roadmaps, and progress tracking for LightSpeed initiatives. Includes active projects, completed archives, and planning documents."
+file_type: documentation
+version: v1.1
+last_updated: "2026-05-31"
+created_date: "2025-12-08"
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
+license: "GPL-3.0"
+tags: ["projects", "planning", "tracking", "governance", "documentation"]
+domain: "governance"
+stability: "stable"
 ---
 
 # Projects Directory
 
-This directory contains all task tracking files, project planning documents, implementation roadmaps, and progress tracking.
+This directory contains all task tracking files, project planning documents, implementation roadmaps, and progress tracking for LightSpeed initiatives.
 
 ## Purpose
 
-Centralize and organise all project-related files, from early planning through completion. Each subdirectory serves a specific lifecycle phase.
+- Store all project planning and tracking files
+- Centralize task lists and implementation plans
+- Maintain organized project documentation
+- Track active, in-progress, and completed projects
 
 ## Directory Structure
 
 ```
 .github/projects/
-├── active/       # Current active projects and ongoing work
-├── archived/     # Archived projects and historical records
-├── completed/    # Finished projects ready for reference
-└── PLANNING_TEMPLATE.md  # Template for starting new projects
+├── active/          # Current active projects and work-in-progress
+└── archived/        # Completed and inactive projects
 ```
 
 ## Subdirectory Purposes
 
-### `active/` – Current Active Projects
+### active/
+
+**Current Active Projects**
 
 - Work-in-progress project files
 - Active sprint plans and task tracking
 - Current implementation roadmaps
 - Files actively being updated and referenced
-- **Move files here** when a project transitions from planning to active development
+- **When to move here:** When a project moves from planning to active development
+
+### archived/
 
-### `completed/` – Finished Project Archives
+**Finished and Inactive Projects**
 
 - Completed project documentation for reference
 - Archived task lists from finished initiatives
 - Historical planning documents
 - Successfully implemented project records
-- **Move files here** when all tasks are done, PRs merged, and objectives achieved
-
-### `archived/` – Long-term Archives
-
-- Projects superseded by newer initiatives
-- Deprecated planning documents
-- Historical reference materials
-- Files preserved for audit trails
+- **When to move here:** When all tasks are done, PRs merged, and objectives achieved
 
 ## File Naming Convention
 
-Use descriptive project names with type indicators:
+Use descriptive project names:
 
 ```
 {project-name}-{type}.md
-```
 
 Examples:
-
-- `context-reduction-tasks.md`
-- `instruction-consolidation-guide.md`
-- `labeling-system-roadmap.md`
-- `phase-6-planning.md`
+context-reduction-tasks.md
+instruction-consolidation-guide.md
+labeling-system-roadmap.md
+phase6-planning-suite-consolidation.md
+```
 
 ## Guidelines
 
 ✅ **DO:**
 
-- Create all project tracking files in this directory
+- Create all project tracking files in this directory or appropriate subdirectory
 - Use descriptive project names
-- Include frontmatter for metadata (created_date, status, owners, etc.)
+- Include frontmatter for metadata (created_date, status, owner, etc.)
 - Update files as work progresses
-- Start new projects at the root level of `.github/projects/`
-- Move to `active/` when work begins
-- Move completed projects to `completed/` when finished
+- Create new projects directly in `active/` subdirectory
+- Move completed projects to `archived/` subdirectory
 - Add completion date to frontmatter when archiving
 
 ❌ **DON'T:**
@@ -85,22 +86,16 @@ Examples:
 - Create project files in `docs/` folder
 - Create project files in `.github/agents/` or `.github/instructions/`
 - Use generic names like `tasks.md` or `todo.md`
-- Leave projects in `active/` after completion
-
-## Current Projects
-
-- [context-reduction-tasks.md](./context-reduction-tasks.md) – Token optimisation task tracking
-- [instruction-consolidation-guide.md](./instruction-consolidation-guide.md) – File consolidation migration guide
-- [PLANNING_TEMPLATE.md](./PLANNING_TEMPLATE.md) – Template for new project planning
 
 ## Related Documentation
 
 - [File Organisation Instructions](../instructions/file-organisation.instructions.md)
 - [Community Standards](../instructions/community-standards.instructions.md)
+- [Reports Directory](../reports/README.md) — Generated reports and audit outputs
 - [Roadmap](../../docs/ROADMAP.md)
 
 ---
 
 *For questions about project file organisation, see [file-organisation.instructions.md](../instructions/file-organisation.instructions.md)*
 
-*Docs signed by 🤖 Copilot for LightSpeedWP – always fresh!*
+*This directory is managed by project teams. Please follow the guidelines when creating new project tracking files.*
diff --git a/.github/projects/active/template-enforcement-governance/ISSUES.md b/.github/projects/active/template-enforcement-governance/ISSUES.md
index fdf4a21b5..5f105f187 100644
--- a/.github/projects/active/template-enforcement-governance/ISSUES.md
+++ b/.github/projects/active/template-enforcement-governance/ISSUES.md
@@ -88,7 +88,7 @@ test/ → pr_test.md
 perf/ → pr_perf.md
 ci/ → pr_ci.md
 build/ → pr_ci.md
-deps/ → pr_deps.md (if exists) or pr_chore.md
+deps/ → pr_dep_update.md
 security/ → pr_security.md (if exists) or pr_chore.md
 design/ → pr_design.md (if exists) or pr_feature.md
 a11y/ → pr_a11y.md (if exists) or pr_improve.md
@@ -539,13 +539,13 @@ Update BRANCHING_STRATEGY.md with PR template mapping table and governance notes
 
 ## Related Documents
 
-- [AGENT.md](../AGENT.md) — Canonical governance rules (once updated)
-- [CLAUDE.md](../CLAUDE.md) — Claude-specific guidance (once updated)
-- [docs/BRANCHING_STRATEGY.md](../docs/BRANCHING_STRATEGY.md) — Branch naming (once updated)
-- [instructions/pr-templates.instructions.md](../instructions/pr-templates.instructions.md) — Full PR template guide (once created)
-- [instructions/issue-templates.instructions.md](../instructions/issue-templates.instructions.md) — Full issue template guide (once created)
-- [.github/issue-types.yml](./.github/issue-types.yml) — Canonical issue type definitions
-- [.github/PULL_REQUEST_TEMPLATE/config.yml](./.github/PULL_REQUEST_TEMPLATE/config.yml) — PR template routing (once created)
+- [AGENTS.md](../../../../AGENTS.md) — Canonical governance rules (once updated)
+- [CLAUDE.md](../../../../CLAUDE.md) — Claude-specific guidance (once updated)
+- [docs/BRANCHING_STRATEGY.md](../../../../docs/BRANCHING_STRATEGY.md) — Branch naming (once updated)
+- [instructions/pr-templates.instructions.md](../../../../instructions/pr-templates.instructions.md) — Full PR template guide (once created)
+- [instructions/issue-templates.instructions.md](../../../../instructions/issue-templates.instructions.md) — Full issue template guide (once created)
+- [.github/issue-types.yml](../../../issue-types.yml) — Canonical issue type definitions
+- [.github/PULL_REQUEST_TEMPLATE/config.yml](../../../PULL_REQUEST_TEMPLATE/config.yml) — PR template routing (once created)
 
 ---
 
diff --git a/.github/prompts/README.md b/.github/prompts/README.md
index c175d03ea..0251a8ee4 100644
--- a/.github/prompts/README.md
+++ b/.github/prompts/README.md
@@ -1,106 +1,44 @@
 ---
-file_type: "documentation"
-title: ".github Prompts Directory"
-description: "AI prompt templates and guidelines for automation, code review, and documentation generation"
-version: "v1.0"
-last_updated: '2026-06-01'
+title: "Prompts Directory"
+description: "Reusable AI prompts and templates for LightSpeed automation, agents, and governance workflows. Includes system prompts, context builders, and instruction templates."
+file_type: documentation
+version: v0.1.0
+last_updated: "2026-05-31"
+created_date: "2025-11-27"
+authors: ["LightSpeed Team"]
 maintainer: "LightSpeed Team"
-tags: ["prompts", "ai", "automation", "templates"]
+license: "GPL-3.0"
+tags: ["prompts", "automation", "AI", "templates"]
+domain: "governance"
+stability: "experimental"
 ---
 
-# .github Prompts Directory
+# Prompts Directory
 
-This directory contains reusable AI prompt templates designed for automation agents, code review, documentation generation, and AI-powered workflows across the LightSpeed organization.
+This directory contains reusable AI prompts, system instructions, and context builders for LightSpeed automation workflows and agents.
 
-## Prompt Categories
+## Purpose
 
-### Code Review & Quality
+- **Agent Prompts**: System prompts and behavior guidance for LightSpeed agents
+- **Context Builders**: Prompt templates for generating contextual information
+- **Instruction Templates**: Reusable instruction sets for automation
+- **AI Governance**: Standardized prompting patterns aligned with LightSpeed values
 
-- **code-review.prompt.md** - Automated code quality assessment and feedback
-- **accessibility-review.prompt.md** - WCAG 2.2 AA compliance validation
-- **security-review.prompt.md** - Security vulnerability and OWASP analysis
-- **performance-review.prompt.md** - Performance optimization recommendations
+## Contents
 
-### Documentation & Content
+This folder contains scripts and templates for automation, including:
 
-- **documentation.prompt.md** - Documentation generation and standardization
-- **markdown-validation.prompt.md** - Markdown syntax and structure validation
-- **frontmatter-guidance.prompt.md** - Frontmatter metadata generation
-
-### Automation & Workflows
-
-- **labeling.prompt.md** - Issue and PR label suggestions
-- **triage.prompt.md** - Issue categorization and routing
-- **release-notes.prompt.md** - Release documentation generation
-
-### Pattern & Template Generation
-
-- **pattern-generation.prompt.md** - Code pattern and template creation
-- **architecture-review.prompt.md** - Architecture documentation and analysis
-- **testing-guidance.prompt.md** - Test case and coverage recommendations
-
-## Usage
-
-### With Copilot / Claude
-
-1. Copy the relevant prompt template
-2. Paste into your AI assistant chat
-3. Provide repository context or specific code
-4. Follow the prompt structure for best results
-
-### With Custom Agents
-
-1. Load prompts from this directory in agent specifications
-2. Combine with runtime context (files, diffs, issues)
-3. Use responses for automated workflows
-4. Log results for quality metrics
-
-### With Automation Workflows
-
-1. Reference prompts in workflow files (e.g., `.github/workflows/*.yml`)
-2. Pass relevant context via environment variables
-3. Parse responses and take action
-4. Track metrics and feedback
-
-## Prompt Structure
-
-Each prompt includes:
-
-- **Role & Context** - The AI's role and the problem domain
-- **Objective** - Specific goals and success criteria
-- **Input Specifications** - What information will be provided
-- **Output Format** - Expected response structure and format
-- **Quality Standards** - Accuracy, completeness, and style requirements
-- **Examples** - Sample inputs and expected outputs
-- **Edge Cases** - Known limitations and special handling
-
-## Best Practices
-
-- **Versioning**: Update version field when prompt logic changes significantly
-- **Context**: Provide sufficient context for accurate responses
-- **Iteration**: Refine prompts based on feedback and results
-- **Documentation**: Keep prompt purpose and limitations documented
-- **Testing**: Validate prompt outputs before relying on them in automation
-- **Accessibility**: Ensure prompts produce accessible, standards-compliant content
+- AI agent system prompts
+- Context and instruction generation templates
+- Governance-aligned prompting patterns
+- Automation workflow helpers
 
 ## Related Resources
 
-- [Automation Governance](../../docs/AUTOMATION_GOVERNANCE.md) - Prompt usage policies
-- [Agents Directory](../agents/README.md) - Agent specifications using these prompts
-- [Instructions](../instructions/README.md) - Development standards referenced by prompts
-- [Custom Instructions](../custom-instructions.md) - Organization-wide Copilot settings
-
-## Contributing
-
-To add or improve prompts:
-
-1. Follow the standardized prompt structure above
-2. Include clear examples and edge cases
-3. Document the prompt's purpose and limitations
-4. Test with multiple inputs before submitting
-5. Update this README with new prompt entries
+- [Agents Directory](../agents/README.md) — Agent specifications and implementations
+- [Instructions Directory](../instructions/README.md) — Comprehensive instruction sets
+- [Automation Governance](../../docs/AUTOMATION_GOVERNANCE.md) — Governance policies for automation
 
 ---
 
-*Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team*
-[Org Profile](https://github.com/lightspeedwp/.github/tree/main/profile)
+*Prompts are a critical component of LightSpeed's AI automation strategy. See [AGENTS.md](../../AGENTS.md) for complete AI governance guidance.*
diff --git a/.github/reports/README.md b/.github/reports/README.md
index 9c06bb25c..fb8554231 100644
--- a/.github/reports/README.md
+++ b/.github/reports/README.md
@@ -1,37 +1,20 @@
 ---
-file_type: "documentation"
 title: "Reports Directory"
-description: "Central repository for generated reports, analysis outputs, audit files, and agent execution summaries"
-version: "v1.0.0"
-created_date: "2026-01-01"
-last_updated: '2026-06-01'
+description: "Repository for all generated reports, analysis outputs, audit files, and agent execution summaries. Includes analysis, audits, implementation tracking, migration reports, and metrics."
+file_type: documentation
+version: v1.1
+last_updated: "2026-05-31"
+created_date: "2026-05-01"
+authors: ["LightSpeed Team"]
 maintainer: "LightSpeed Team"
-tags: ["reports", "audits", "metrics", "analysis"]
-status: "active"
+license: "GPL-3.0"
+tags: ["reports", "audits", "analytics", "documentation", "governance"]
+domain: "governance"
+stability: "stable"
 ---
 
 # Reports Directory
 
-<!-- BADGES-START -->
-[![changelog-validate](https://github.com/lightspeedwp/.github/actions/workflows/changelog-validate.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/changelog-validate.yml)
-[![dependabot-security-label](https://github.com/lightspeedwp/.github/actions/workflows/dependabot-security-label.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/dependabot-security-label.yml)
-[![issue-close-label-hygiene](https://github.com/lightspeedwp/.github/actions/workflows/issue-close-label-hygiene.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/issue-close-label-hygiene.yml)
-[![issues](https://github.com/lightspeedwp/.github/actions/workflows/issues.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/issues.yml)
-[![labeling](https://github.com/lightspeedwp/.github/actions/workflows/labeling.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/labeling.yml)
-[![linting](https://github.com/lightspeedwp/.github/actions/workflows/linting.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/linting.yml)
-[![meta](https://github.com/lightspeedwp/.github/actions/workflows/meta.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/meta.yml)
-[![metrics](https://github.com/lightspeedwp/.github/actions/workflows/metrics.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/metrics.yml)
-[![planner](https://github.com/lightspeedwp/.github/actions/workflows/planner.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/planner.yml)
-[![project-meta-sync](https://github.com/lightspeedwp/.github/actions/workflows/project-meta-sync.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/project-meta-sync.yml)
-[![readme-audit](https://github.com/lightspeedwp/.github/actions/workflows/readme-audit.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/readme-audit.yml)
-[![readme-regen](https://github.com/lightspeedwp/.github/actions/workflows/readme-regen.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/readme-regen.yml)
-[![readme-update](https://github.com/lightspeedwp/.github/actions/workflows/readme-update.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/readme-update.yml)
-[![release](https://github.com/lightspeedwp/.github/actions/workflows/release.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/release.yml)
-[![reporting](https://github.com/lightspeedwp/.github/actions/workflows/reporting.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/reporting.yml)
-[![reviewer](https://github.com/lightspeedwp/.github/actions/workflows/reviewer.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/reviewer.yml)
-[![testing](https://github.com/lightspeedwp/.github/actions/workflows/testing.yml/badge.svg?branch=develop)](https://github.com/lightspeedwp/.github/actions/workflows/testing.yml)
-<!-- BADGES-END -->
-
 This directory contains all generated reports, analysis outputs, audit files, and agent execution summaries.
 
 ## Purpose
@@ -264,6 +247,3 @@ progress/weekly-summary-2025-w50.md
 ---
 
 *For questions about report organisation, see [file-organisation.instructions.md](../instructions/file-organisation.instructions.md)*
-
-*Have questions? Ping us on GitHub! 🐙 Made with 💚 by LightSpeedWP*
-[Contact](https://lightspeedwp.agency/contact)
diff --git a/.github/schemas/README.md b/.github/schemas/README.md
index 7aaa2549d..f32125604 100644
--- a/.github/schemas/README.md
+++ b/.github/schemas/README.md
@@ -1,20 +1,47 @@
 ---
-file_type: "agents-index"
 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-06-01'
+description: "Repo-local index for schemas that remain under the .github control-plane boundary. Separates portable schemas in .schemas/ from repo-local schema assets."
+file_type: documentation
+version: v0.3.0
+last_updated: "2026-05-31"
+created_date: "2026-05-20"
+authors: ["LightSpeed Team"]
 maintainer: "LightSpeed Team"
-authors: ["Codex"]
 license: "GPL-3.0"
-tags: ["schemas", "github-boundary", "ai-ops"]
+tags: ["schemas", "github-boundary", "ai-ops", "governance"]
 domain: "governance"
-stability: "draft"
+stability: "stable"
 ---
 
-*Built by 🧱 LightSpeedWP with ☕, 🚀, and open-source spirit!*
+# .github Schemas Boundary
+
+Active portable schemas now live in [`../../.schemas/`](../../.schemas/).
+This folder is reserved for repo-local schema assets that only make sense under
+the LightSpeed `.github` control-plane repository.
+
+## Scope
+
+| Path | Purpose |
+| --- | --- |
+| `.github/schemas/README.md` | This repo-local boundary index. |
+| `.schemas/` | Portable schemas used by active validators and reusable assets. |
+
+## Migration Rules
+
+- Add new portable schemas under `.schemas/`.
+- Keep repo-only schemas here only when a validator or GitHub-native feature
+  cannot consume the portable schema path.
+- Do not restore moved schemas into `.github/schemas/` without a migration-map
+  update and linked issue.
+
+## Validation
+
+- Run `npm run validate:json:schemas` after changing active JSON schemas.
+- Run Markdown linting for schema README changes.
+- Run `npm run validate:structure` after changing the portable source-folder
+  model.
 
 ## References
 
-- [Portable schema library index](../../schema/README.md)
-- [Issue #297 local source draft](../projects/archived/portable-ai-plugin-restructure/issues/children/batch-02-portable-migration/02-05-refactor-move-active-schemas-to-root-schemas.md)
+- [Portable schema library](../../.schemas/)
+- [Portable AI plugin restructure PRD](../projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md)
diff --git a/plugins/lightspeed-github-ops/README.md b/plugins/lightspeed-github-ops/README.md
index a9c9f0ba8..162fde464 100644
--- a/plugins/lightspeed-github-ops/README.md
+++ b/plugins/lightspeed-github-ops/README.md
@@ -1,12 +1,31 @@
 ---
-title: "lightspeed-github-ops"
-description: "Pilot plugin bundle for LightSpeed GitHub governance and AI operations workflows."
-version: "v0.1.1"
-last_updated: "2026-05-28"
+title: "lightspeed-github-ops Plugin"
+description: "Pilot plugin bundle for LightSpeed GitHub governance and AI operations workflows. Includes governance agents, skills, and hooks."
+file_type: documentation
+version: v0.2.0
+last_updated: "2026-05-31"
+created_date: "2026-01-15"
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
+license: "GPL-3.0"
+tags: ["plugin", "governance", "operations", "AI", "workflows"]
+domain: "governance"
+stability: "experimental"
 ---
 
-*Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team*
-[Org Profile](https://github.com/lightspeedwp/.github/tree/main/profile)
+# lightspeed-github-ops
 
-*Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team*
-[Org Profile](https://github.com/lightspeedwp/.github/tree/main/profile)
+Pilot plugin for reusable governance operations in LightSpeed repositories.
+
+## Contents
+
+- `agents/` packaged governance agent specs.
+- `skills/` packaged P0 governance skills.
+- `hooks/` optional plugin-local guardrails.
+- `.codex-plugin/plugin.json` Codex manifest.
+- `.claude-plugin/plugin.json` Claude Code manifest.
+- `copilot-plugin.json` Copilot metadata manifest.
+
+## Scope
+
+This pilot excludes block theme and block plugin guidance.
diff --git a/plugins/lightspeed-github-ops/hooks/README.md b/plugins/lightspeed-github-ops/hooks/README.md
index 88fb40d65..4e1b063f9 100644
--- a/plugins/lightspeed-github-ops/hooks/README.md
+++ b/plugins/lightspeed-github-ops/hooks/README.md
@@ -1,11 +1,16 @@
 ---
-file_type: readme
 title: "Plugin Hooks"
-description: "Optional plugin-local hooks for lightspeed-github-ops"
-version: "1.0"
-last_updated: '2026-06-01'
-maintainer: "LightSpeed Engineering"
-tags: ["hooks", "plugins", "github-ops"]
+description: "Optional plugin-local hooks for the lightspeed-github-ops plugin. Defines guardrails and validation hooks for governance workflows."
+file_type: documentation
+version: v0.1.0
+last_updated: "2026-05-31"
+created_date: "2026-01-15"
+authors: ["LightSpeed Team"]
+maintainer: "LightSpeed Team"
+license: "GPL-3.0"
+tags: ["hooks", "plugin", "guardrails", "validation"]
+domain: "governance"
+stability: "experimental"
 ---
 
 # Plugin Hooks