Phase 1B: Audit Schema Consolidation (Restructured)

[ashleyshaw]

Audit Summary

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

Currently 26 schema files scattered with 35 script references and 150+ documentation references need consolidation and systematic updates.

Audit Checklist / Scope

• Verify all 26 source files in .github/schema/ (19 root + 2 examples + 5 memory)
• Identify all 35 script references (27 using schema/ paths, 8 using .schemas paths)
• Document all 150+ documentation references
• Map hardcoded paths in 4 validation scripts
• Identify conflicting logic in verify-wceu-readiness.js
• Verify target location .schemas/ is prepared
• Categorize schemas: portable (12) vs. repo-local (5)

Findings / Risks

Current State:

• 26 schema files in .github/schema/ (active source)
• .schemas/ prepared but empty (only README.md)
• 27 script references to schema/ paths (need updating)
• 8 script references to .schemas paths (already expecting new location)
• 150+ documentation references scattered across project
• 3 scripts already expect .schemas/ location (branding-unified.agent.js, coderabbit validators)

Risks & Issues:

• Low risk overall (well-isolated system, no circular dependencies)
• Conflicting logic: verify-wceu-readiness.js checks .schemas should NOT exist (needs update)
• Medium effort: Comprehensive reference updates required
• High value: Consolidates schema location per awesome-copilot pattern

Remediation Actions

1. Script updates — Update hardcoded paths in 4 validation scripts
2. Package.json updates — Change glob patterns from schema/** to .schemas/**
3. Workflow updates — Update 4 workflow file references
4. Documentation updates — Bulk find/replace 150+ references
5. File consolidation — Move all 26 files to .schemas/
6. Validation — Run npm run validate:json:schemas to verify
7. Cleanup — Delete old .github/schema/ directory

Acceptance Criteria

• All 26 source files verified and accounted for
• All 35 script references documented
• All 150+ documentation references logged
• Target location .schemas/ confirmed prepared
• Conflicting logic in readiness script identified
• Migration sequence and effort estimated
• Risk assessment completed
• Pre-migration snapshot documented

Additional Context

Related: Extended audit complete (PR #1289), Instructions migration (#1299), Agents reorganization (#1293), Parent epic (#1290)
Effort estimate: 4-5 hours (scripts + migrations + validation)
Risk level: Low (well-isolated, no circular dependencies)
Timeline: Can execute in parallel with instructions migration

---

Definition of Ready (DoR)

• Audit scope and goals defined
• Complete file inventory verified (26 files)
• All script dependencies mapped (35 references)
• Risk assessment completed (low risk)
• Extended audit completed (PR docs: Schema consolidation migration plan and audit #1289)

Definition of Done (DoD)

• All 26 files verified in source location
• All script references documented and categorized
• All documentation references identified
• Target location verified as prepared
• Conflicting logic issues documented
• Migration sequence and actions detailed
• Effort and timeline estimates provided
• Ready to pass to Phase 3 migrations
• Blocked by: None
• Blocking: Phase 3 migrations (Phase 3: Execute File Migrations & Reference Updates #1296)

[linear-code]

LS-1840

[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:53.929Z

Maintained by project-meta-sync workflow.

[ashleyshaw]

Duplicate: Template restructuring applied to original issues instead. See #1291, #1292, #1293, #1295 for restructured content with proper audit/documentation templates.

[github-actions]

⚠️ This issue was closed but the Definition of Done (DoD) is not complete.

Unchecked DoD items found. Please complete all checklist items before closing this issue.

To close this issue:

• ✅ Complete all DoD checklist items and check them off
• 🔁 Close the issue again

To force close this issue without completing DoD:

• Add the meta:force-close label
• The system will then allow closure

For more information on Definition of Done standards, see the issue template guide: https://github.com/lightspeedwp/.github/issues/new/choose

[github-actions]

✅ Issue checklists finalised after closure.

[ashleyshaw]

♻️ Reopened automatically — this issue was closed with unchecked items remaining in the body. Please complete all tasks before closing.