Phase 1B: Consolidate Schemas to .schemas/

[ashleyshaw]

Overview

Consolidate schema files from .github/schema/ to .schemas/ (hidden folder following awesome-copilot pattern).

Scope

Source: .github/schema/ (26 files)

• 19 root schema files (.schema.json, .v2.json, registry)
• 2 example files (examples/ subdirectory)
• 5 memory system schemas (memory/ subdirectory)

References: 35 script references across 11 files

• 27 using schema/ paths (need updating)
• 8 using .schemas paths (already expecting new location)

Target: .schemas/ (hidden folder at repo root)

Definition of Done

• Verify all 26 source files in .github/schema/
• Update hardcoded paths in scripts:
  • scripts/verify-wceu-readiness.js (7 refs, conflicting logic)
  • scripts/validation/validate-agent-frontmatter.js (2 refs)
  • scripts/validation/validate-frontmatter.js (1 ref)
• Update npm scripts in package.json (2 glob patterns)
• Move all files from .github/schema/ to .schemas/
• Update workflow references (4 workflow files)
• Update documentation references (150+ locations)
• Run npm run validate:json:schemas — all pass
• Verify CI/CD workflows pass
• Delete old .github/schema/ directory
• Update CHANGELOG with migration entry

Related Issues

• Parent: Repository Structure Realignment Initiative #1290 (Repository Structure Realignment Initiative)
• Previous audit: Repository Structure: Schema Consolidation Migration #1288 (Schema consolidation audit complete)
• PR: docs: Schema consolidation migration plan and audit #1289 (Comprehensive audit and migration plan)

Effort Estimate

4-5 hours (scripts + migrations + validation)

Notes

• Conflicting logic: verify-wceu-readiness.js checks .schemas should NOT exist
• Scripts already prepared: branding-unified.agent.js, coderabbit validators already expect .schemas/
• Risk: Low (well-isolated, no circular dependencies)
• Priority: Medium (can proceed in parallel with instructions migration)

[linear-code]

LS-1832

[github-actions]

⚠️ This issue does not follow a required issue template.

Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)

The issue will remain open and flagged until the body is corrected.
Please update the issue with one of the official templates:

• https://github.com/lightspeedwp/.github/issues/new/choose

If this was opened by automation, update the automation to preserve the template sections before creating the issue.

[github-actions]

⏱️ Aging and SLA annotation

• Age: 5 day(s)
• SLA state: Within SLA
• Thresholds: warn at 7 days, breach at 14 days
• Last updated: 2026-07-29T17:25:31.068Z

Maintained by project-meta-sync workflow.