lightspeedwp · ashleyshaw · Jun 1, 2026 · May 31, 2026 · May 31, 2026 · Jun 1, 2026
@@ -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

@@ -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! -->
@@ -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! -->
@@ -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

@@ -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.*
@@ -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)