Repository Audit: Fix frontmatter validation errors and standardize file structure

[ashleyshaw]

Overview

Comprehensive audit and remediation of the lightspeedwp/.github repository to identify and fix files with errors, missing contents, stub content, duplicated footers, and frontmatter violations.

Work Completed

Saved Replies Files (74 files)

• Added file_type: "saved-reply" to all saved replies files
• Removed references: field from all saved replies (CLAUDE.md compliance)
• Files processed across subdirectories:
  • community/ (5 files)
  • issues/ (22 files)
  • pull-requests/ (18 files)
  • technical/ (9 files)
  • workflow/ (20 files)

Templates (36 files)

• Fixed issue templates: Changed title: to name: field per schema requirements
• Fixed PR templates: Added proper file_type: "pr-template" field
• Added missing description field to issue templates

Project Files & Artifacts

• Changed file_type: "project" to file_type: "documentation" across all project files (142 files)
• Fixed stability field values:
  • Changed "draft" → "experimental"
  • Changed "active" → "stable"
  • Changed "archived" → "stable"
  • Changed "completed" → "stable"

Boundary Files

• Fixed .github/agents/README.md: Changed file_type: "index" to file_type: "agent-index"
• Fixed .github/instructions/README.md: Changed file_type: "index" to file_type: "instructions"
• Converted references field to inline links per CLAUDE.md rules

Mergify Configuration

• Fixed Mergify configuration: Changed author=app/dependabot to author=dependabot (invalid GitHub login correction)

Content Files (13 files enriched)

• cookbook/project-planning-and-prd-playbook.md: Added 300+ lines
• cookbook/spec-driven-workflow-example.md: Added 300+ lines
• cookbook/wordpress-plugin-checklist.md: Added 150+ lines
• workflows/release-readiness-validation.md: Added 200+ lines
• workflows/weekly-governance-sync.md: Added 180+ lines
• workflows/wordpress-project-onboarding.md: Added 200+ lines
• workflows/wordpress-spec-to-implementation.md: Added 250+ lines
• docs/ARCHITECTURE.md: Added 150+ lines
• docs/AWESOME_ALIGNMENT.md: Added 150+ lines
• docs/CONFIGS.md: Added 200+ lines
• docs/CROSS_PLATFORM_SKILL_YAML_SPEC.md: Added 150+ lines
• docs/PLUGIN_INSTALLATION_GUIDE.md: Added 100+ lines
• docs/PLUGIN_PACK_ROADMAP.md: Added 100+ lines

Validation Results

• Initial Errors: 345 frontmatter validation errors
• Current Errors: 207 frontmatter validation errors
• Progress: 40% error reduction

Remaining Work

The remaining 207 validation errors are primarily in:

1. Project issue specification files in .github/projects/archived/ that don't fit standard schema
2. Report files that may need content review and proper frontmatter
3. Files that may need manual review to determine correct file_type classification

Acceptance Criteria

• Removed all references: fields from frontmatter per CLAUDE.md rules
• Added missing file_type fields across all template categories
• Fixed stability field values to match schema enums
• Fixed file_type values for agents, instructions, and projects directories
• Corrected Mergify configuration syntax
• Enriched 13 stub content files with substantive documentation

Related Files

• Branch: claude/gracious-edison-ACzNn
• PR: fix: add substantive content to stub files and remediate footer duplication #574
• CLAUDE.md: Root governance rules
• Schema: .schemas/frontmatter.schema.json

Notes

This audit identified and corrected widespread frontmatter inconsistencies across the repository. The systematic fixes ensure better schema compliance and cleaner organization of governance artifacts.

[linear-code]

LS-776