diff --git a/.github/ISSUE_TEMPLATE/07-user-experience-feedback.md b/.github/ISSUE_TEMPLATE/08-user-experience-feedback.md similarity index 100% rename from .github/ISSUE_TEMPLATE/07-user-experience-feedback.md rename to .github/ISSUE_TEMPLATE/08-user-experience-feedback.md diff --git a/.github/ISSUE_TEMPLATE/08-code-refactor.md b/.github/ISSUE_TEMPLATE/09-code-refactor.md similarity index 100% rename from .github/ISSUE_TEMPLATE/08-code-refactor.md rename to .github/ISSUE_TEMPLATE/09-code-refactor.md diff --git a/.github/ISSUE_TEMPLATE/09-build-ci.md b/.github/ISSUE_TEMPLATE/10-build-ci.md similarity index 100% rename from .github/ISSUE_TEMPLATE/09-build-ci.md rename to .github/ISSUE_TEMPLATE/10-build-ci.md diff --git a/.github/ISSUE_TEMPLATE/10-automation.md b/.github/ISSUE_TEMPLATE/11-automation.md similarity index 100% rename from .github/ISSUE_TEMPLATE/10-automation.md rename to .github/ISSUE_TEMPLATE/11-automation.md diff --git a/.github/ISSUE_TEMPLATE/11-testing-coverage.md b/.github/ISSUE_TEMPLATE/12-testing-coverage.md similarity index 100% rename from .github/ISSUE_TEMPLATE/11-testing-coverage.md rename to .github/ISSUE_TEMPLATE/12-testing-coverage.md diff --git a/.github/ISSUE_TEMPLATE/12-performance.md b/.github/ISSUE_TEMPLATE/13-performance.md similarity index 100% rename from .github/ISSUE_TEMPLATE/12-performance.md rename to .github/ISSUE_TEMPLATE/13-performance.md diff --git a/.github/ISSUE_TEMPLATE/13-a11y.md b/.github/ISSUE_TEMPLATE/14-a11y.md similarity index 100% rename from .github/ISSUE_TEMPLATE/13-a11y.md rename to .github/ISSUE_TEMPLATE/14-a11y.md diff --git a/.github/ISSUE_TEMPLATE/14-security.md b/.github/ISSUE_TEMPLATE/15-security.md similarity index 100% rename from .github/ISSUE_TEMPLATE/14-security.md rename to .github/ISSUE_TEMPLATE/15-security.md diff --git a/.github/ISSUE_TEMPLATE/15-compatibility.md b/.github/ISSUE_TEMPLATE/16-compatibility.md similarity index 100% rename from .github/ISSUE_TEMPLATE/15-compatibility.md rename to .github/ISSUE_TEMPLATE/16-compatibility.md diff --git a/.github/ISSUE_TEMPLATE/16-integration-issue.md b/.github/ISSUE_TEMPLATE/17-integration-issue.md similarity index 100% rename from .github/ISSUE_TEMPLATE/16-integration-issue.md rename to .github/ISSUE_TEMPLATE/17-integration-issue.md diff --git a/.github/ISSUE_TEMPLATE/17-release.md b/.github/ISSUE_TEMPLATE/18-release.md similarity index 100% rename from .github/ISSUE_TEMPLATE/17-release.md rename to .github/ISSUE_TEMPLATE/18-release.md diff --git a/.github/ISSUE_TEMPLATE/18-maintenance.md b/.github/ISSUE_TEMPLATE/19-maintenance.md similarity index 100% rename from .github/ISSUE_TEMPLATE/18-maintenance.md rename to .github/ISSUE_TEMPLATE/19-maintenance.md diff --git a/.github/ISSUE_TEMPLATE/19-documentation.md b/.github/ISSUE_TEMPLATE/20-documentation.md similarity index 100% rename from .github/ISSUE_TEMPLATE/19-documentation.md rename to .github/ISSUE_TEMPLATE/20-documentation.md diff --git a/.github/ISSUE_TEMPLATE/20-research.md b/.github/ISSUE_TEMPLATE/21-research.md similarity index 100% rename from .github/ISSUE_TEMPLATE/20-research.md rename to .github/ISSUE_TEMPLATE/21-research.md diff --git a/.github/ISSUE_TEMPLATE/21-audit.md b/.github/ISSUE_TEMPLATE/22-audit.md similarity index 100% rename from .github/ISSUE_TEMPLATE/21-audit.md rename to .github/ISSUE_TEMPLATE/22-audit.md diff --git a/.github/ISSUE_TEMPLATE/22-code-review.md b/.github/ISSUE_TEMPLATE/23-code-review.md similarity index 100% rename from .github/ISSUE_TEMPLATE/22-code-review.md rename to .github/ISSUE_TEMPLATE/23-code-review.md diff --git a/.github/ISSUE_TEMPLATE/23-ai-ops.md b/.github/ISSUE_TEMPLATE/24-ai-ops.md similarity index 100% rename from .github/ISSUE_TEMPLATE/23-ai-ops.md rename to .github/ISSUE_TEMPLATE/24-ai-ops.md diff --git a/.github/ISSUE_TEMPLATE/24-content-modelling.md b/.github/ISSUE_TEMPLATE/25-content-modelling.md similarity index 100% rename from .github/ISSUE_TEMPLATE/24-content-modelling.md rename to .github/ISSUE_TEMPLATE/25-content-modelling.md diff --git a/.github/ISSUE_TEMPLATE/25-help.md b/.github/ISSUE_TEMPLATE/26-help.md similarity index 100% rename from .github/ISSUE_TEMPLATE/25-help.md rename to .github/ISSUE_TEMPLATE/26-help.md diff --git a/.github/issue-types.yml b/.github/issue-types.yml index cc9c2beea..fbc5c53c7 100644 --- a/.github/issue-types.yml +++ b/.github/issue-types.yml @@ -83,3 +83,9 @@ issue_types: - name: Support color: 0E8A16 label: type:support + - name: Help + color: 0E8A16 + label: type:help + - name: User Experience Feedback + color: "5319E7" + label: type:ux-feedback diff --git a/.github/labels.yml b/.github/labels.yml index da01463d4..3a2d19004 100644 --- a/.github/labels.yml +++ b/.github/labels.yml @@ -208,10 +208,6 @@ aliases: - audit -- name: type:qa - color: D29922 - description: "Quality assurance" - - name: type:review color: 4393F8 description: "Code or design review task" @@ -236,6 +232,19 @@ aliases: - support +- name: type:help + color: 0E8A16 + description: "Help request" + aliases: + - help + +- name: type:ux-feedback + color: "5319E7" + description: "User experience feedback" + aliases: + - ux-feedback + - user-experience-feedback + # --- Meta / housekeeping --- - name: meta:needs-changelog diff --git a/.github/metrics/meta.json b/.github/metrics/meta.json index a7f708e4a..042b64ec9 100644 --- a/.github/metrics/meta.json +++ b/.github/metrics/meta.json @@ -4,4 +4,4 @@ "changes": 2, "errors": 0, "optouts": 0 -} \ No newline at end of file +} diff --git a/.github/projects/PLANNING_TEMPLATE.md b/.github/projects/PLANNING_TEMPLATE.md index 49c989531..fa6e11e76 100644 --- a/.github/projects/PLANNING_TEMPLATE.md +++ b/.github/projects/PLANNING_TEMPLATE.md @@ -1,9 +1,10 @@ --- +file_type: documentation title: "Project Planning Template" description: "Use this template to document planning before creating related issues" -file_type: "documentation" -created_date: "YYYY-MM-DD" -version: '1.0.1' +created_date: "2026-05-31" +last_updated: "2026-06-01" +version: "1.0.1" author: "LightSpeed Team" maintainer: "LightSpeed Team" owners: ["lightspeedwp/maintainers"] @@ -174,9 +175,9 @@ Brief 2-3 sentence summary of the project's purpose, scope, and business/technic **GitHub issues, PRs, discussions, or external links** -- Related issue: [#123 - Issue title](https://github.com/lightspeedwp/.github/issues/123) -- Blocking issue: [#124 - Issue title](https://github.com/lightspeedwp/.github/issues/124) -- Blocked by: [#125 - Issue title](https://github.com/lightspeedwp/.github/issues/125) +- Related issue: #XXX - [Issue title] +- Blocking issue: #XXX - [Issue title] +- Blocked by: #XXX - [Issue title] - Reference: [Link to spec, design doc, or external resource] --- diff --git a/.github/projects/active/DOCUMENTATION_AUDIT_PROMPT_COMPREHENSIVE.md b/.github/projects/active/DOCUMENTATION_AUDIT_PROMPT_COMPREHENSIVE.md index 23a2893ca..dc66b16eb 100644 --- a/.github/projects/active/DOCUMENTATION_AUDIT_PROMPT_COMPREHENSIVE.md +++ b/.github/projects/active/DOCUMENTATION_AUDIT_PROMPT_COMPREHENSIVE.md @@ -1,12 +1,13 @@ --- -file_type: "planning-document" +file_type: documentation title: "Comprehensive Documentation & Automation Audit Prompt" description: "Detailed step-by-step prompt for creating GitHub issues to audit and fix documentation, templates, labeling, and automation systems" -version: "1.0.0" +version: "1.0.1" created_date: "2026-05-31" -last_updated: '2026-06-01' -status: "ready-for-execution" -owner: "LightSpeed Team" +last_updated: "2026-06-01" +status: active +owners: + - lightspeedwp/maintainers --- # Comprehensive Documentation & Automation Audit Prompt @@ -156,7 +157,7 @@ See child issues for detailed audits of: - `.github/issue-types.yml` - `.github/issue-fields.yml` - `docs/LABEL_STRATEGY.md` -- `docs/ISSUE_LABELS.md` +- `docs/LABELING.md` - `docs/ISSUE_TYPES.md` - `docs/ISSUE-FIELDS.md` ``` @@ -504,7 +505,7 @@ For each parent issue above, create the following child issues using this templa - Review all files related to issue creation: - `docs/ISSUE_CREATION_GUIDE.md` - - `docs/ISSUE_LABELS.md` + - `docs/LABELING.md` - `docs/ISSUE_TYPES.md` - `.github/ISSUE_TEMPLATE/README.md` - `docs/index.md` (if references issues) @@ -523,7 +524,7 @@ For each parent issue above, create the following child issues using this templa - Review all files related to PR creation: - `docs/PR_CREATION_PROCESS.md` - - `docs/PR_LABELS.md` + - `docs/LABELING.md` - `.github/PULL_REQUEST_TEMPLATE/README.md` - `instructions/pull-requests.instructions.md` - `docs/BRANCHING_STRATEGY.md` @@ -541,9 +542,9 @@ For each parent issue above, create the following child issues using this templa - Review all files related to labeling: - `docs/LABEL_STRATEGY.md` - `docs/LABELING.md` - - `docs/ISSUE_LABELS.md` - - `docs/PR_LABELS.md` - - `docs/AUTOMATION_GOVERNANCE.md` (label section) + - `docs/LABELING.md` + - `docs/LABELING.md` + - `docs/AUTOMATION.md` (label section) - Agent specs for labeling - Identify duplication and overlap - Propose single source of truth for labeling @@ -772,7 +773,7 @@ gh issue create \ - `CLAUDE.md` — Repository boundaries and structure - `docs/LABEL_STRATEGY.md` — Label philosophy and strategy -- `docs/AUTOMATION_GOVERNANCE.md` — Automation standards +- `docs/AUTOMATION.md` — Automation standards - `.github/labels.yml` — Canonical label definitions - `.github/issue-types.yml` — Canonical issue type definitions diff --git a/.github/projects/active/wave-5-documentation-audit/INDEX.md b/.github/projects/active/wave-5-documentation-audit/INDEX.md index e624e468d..e496485bf 100644 --- a/.github/projects/active/wave-5-documentation-audit/INDEX.md +++ b/.github/projects/active/wave-5-documentation-audit/INDEX.md @@ -1,9 +1,11 @@ --- +file_type: documentation title: "Wave 5 Documentation Audit - Issue Index" description: "Complete index of all parent and child issues for the Documentation Audit project" -version: '1.0.1' +version: "1.0.1" created_date: "2026-05-31" -status: "ready-for-review" +last_updated: "2026-06-01" +status: active --- # Wave 5 Documentation Audit — Issue Index diff --git a/.github/projects/active/wave-5-documentation-audit/children/01-1-template-inventory.md b/.github/projects/active/wave-5-documentation-audit/children/01-1-template-inventory.md index 84327f998..c3b48dcfd 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/01-1-template-inventory.md +++ b/.github/projects/active/wave-5-documentation-audit/children/01-1-template-inventory.md @@ -1,13 +1,13 @@ --- issue_number: 654 -file_type: "task" +file_type: documentation description: "Inventory and audit of issue templates for standardization" parent_issue: 649 title: "[Child of #649] Audit: Issue Template Inventory & Standardization" type: "type:audit" area: "area:documentation" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "S" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/01-2-audit-report-issue-creation.md b/.github/projects/active/wave-5-documentation-audit/children/01-2-audit-report-issue-creation.md index 5717da00b..618ac6a42 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/01-2-audit-report-issue-creation.md +++ b/.github/projects/active/wave-5-documentation-audit/children/01-2-audit-report-issue-creation.md @@ -1,10 +1,10 @@ --- -file_type: "documentation" +file_type: documentation title: "Issue Creation Documentation Consolidation Audit" description: "Complete audit of issue creation documentation identifying consolidation opportunities and duplicated content" -version: "v1.0" +version: "v1.0.1" created_date: "2026-05-31" -last_updated: '2026-06-01' +last_updated: "2026-06-01" author: "Claude Code" maintainer: "LightSpeedWP Team" tags: ["documentation", "audit", "consolidation", "wave-5"] @@ -28,7 +28,7 @@ Audited 6 documentation files related to issue creation. Found: - **Significant overlap** between `instructions/issues.instructions.md` and `docs/ISSUE_CREATION_GUIDE.md` - **Internal duplication** within `instructions/issues.instructions.md` itself (content repeats) -- **Missing file** (`docs/ISSUE_LABELS.md` referenced in audit scope but does not exist) +- **Missing file** (`docs/LABELING.md` referenced in audit scope but does not exist) - **Fragmented responsibility** across 4 active files covering similar ground **Recommendation:** Consolidate into 2 canonical files (instructions + guide) and create a single reference for labels. @@ -40,7 +40,7 @@ Audited 6 documentation files related to issue creation. Found: | File | Path | Exists | Status | Role | |------|------|--------|--------|------| | Issue Creation Guide | `docs/ISSUE_CREATION_GUIDE.md` | ✅ | Active | High-level how-to | -| Issue Labels Guide | `docs/ISSUE_LABELS.md` | ❌ | Missing | Supposed label reference | +| Issue Labels Guide | `docs/LABELING.md` | ❌ | Missing | Supposed label reference | | Issue Types Reference | `docs/ISSUE_TYPES.md` | ✅ | Active | Canonical type definitions | | Issue Templates README | `.github/ISSUE_TEMPLATE/README.md` | ✅ | Active | Template directory guide | | Issue Instructions | `instructions/issues.instructions.md` | ✅ | Active | Official instructions (AI/agents) | @@ -79,7 +79,7 @@ Audited 6 documentation files related to issue creation. Found: --- -### 2. **`docs/ISSUE_LABELS.md`** +### 2. **`docs/LABELING.md`** **Status:** ❌ **DEPRECATED & CONSOLIDATED** @@ -203,7 +203,7 @@ Instead of creating a new file, update all broken references to `ISSUE_LABELS.md | Current File | Content | Proposed Location | Action | Rationale | |--------------|---------|-------------------|--------|-----------| | `docs/ISSUE_CREATION_GUIDE.md` | Practical how-to guide | Keep (docs/) | Preserve | Good audience fit, clear structure | -| `docs/ISSUE_LABELS.md` | Deprecated; consolidated into LABELING.md | Update references | Fix broken links | Already exists at `docs/LABELING.md#issue-labelling`; redirect references there | +| `docs/LABELING.md` | Deprecated; consolidated into LABELING.md | Update references | Fix broken links | Already exists at `docs/LABELING.md#issue-labelling`; redirect references there | | `docs/ISSUE_TYPES.md` | Type definitions & reference | Keep (docs/) | Preserve | Comprehensive, well-maintained | | `.github/ISSUE_TEMPLATE/README.md` | Template directory guide | Migrate to inline comments | Archive or migrate | Mostly metadata; can live in directory | | `instructions/issues.instructions.md` | Official instructions | Refactor | Consolidate & fix | Remove internal duplication; keep authoritative core | @@ -249,7 +249,7 @@ Instead of creating a new file, update all broken references to `ISSUE_LABELS.md - `docs/ISSUE_CREATION_GUIDE.md` (section 4, sparse) - `instructions/issues.instructions.md` (section 4–5, references missing files) - `docs/ISSUE_TYPES.md` (type-focused, doesn't cover label families) -- Missing: `docs/ISSUE_LABELS.md` (should exist but doesn't) +- Missing: `docs/LABELING.md` (should exist but doesn't) **Content:** What labels are required, label families, one-hot rules @@ -275,7 +275,7 @@ Instead of creating a new file, update all broken references to `ISSUE_LABELS.md ### Critical Gaps -1. **Broken references to `docs/ISSUE_LABELS.md`** +1. **Broken references to `docs/LABELING.md`** - `instructions/issues.instructions.md` section 4 references deprecated file - File was consolidated into `docs/LABELING.md` (per `instructions/DEPRECATED.md`) - References should point to `docs/LABELING.md#issue-labelling` instead @@ -304,7 +304,7 @@ Instead of creating a new file, update all broken references to `ISSUE_LABELS.md - Preserve formatting and structure 2. **Update broken references to ISSUE_LABELS.md** - - Locate all references to the deprecated `docs/ISSUE_LABELS.md` + - Locate all references to the deprecated `docs/LABELING.md` - Redirect them to `docs/LABELING.md#issue-labelling` instead - Note: The file was consolidated into `docs/LABELING.md` (see `instructions/DEPRECATED.md`) - Do NOT recreate the deprecated file @@ -346,7 +346,7 @@ Instead of creating a new file, update all broken references to `ISSUE_LABELS.md |--------|-------| | Files audited | 6 | | Files with duplicates | 1 (`instructions/issues.instructions.md`) | -| Missing files | 1 (`docs/ISSUE_LABELS.md`) | +| Missing files | 1 (`docs/LABELING.md`) | | Empty files | 1 (`docs/index.md`) | | Overlapping content areas | 4 | | Total lines across all files | ~717 | diff --git a/.github/projects/active/wave-5-documentation-audit/children/01-2-template-automation-mapping.md b/.github/projects/active/wave-5-documentation-audit/children/01-2-template-automation-mapping.md index 35cccf7f9..78e59d2d8 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/01-2-template-automation-mapping.md +++ b/.github/projects/active/wave-5-documentation-audit/children/01-2-template-automation-mapping.md @@ -1,13 +1,13 @@ --- issue_number: 655 -file_type: "task" +file_type: documentation description: "Map issue templates to their automation triggers" parent_issue: 649 title: "[Child of #649] Audit: Issue Template → Automation Trigger Mapping" type: "type:audit" area: "area:automation" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "M" --- @@ -48,5 +48,5 @@ Map each issue template to the automation it should trigger and identify gaps be ## Related Documentation - [Label Strategy](https://github.com/lightspeedwp/.github/blob/develop/docs/LABEL_STRATEGY.md) -- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION_GOVERNANCE.md) +- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION.md) - [Labeling Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/LABELING.md) diff --git a/.github/projects/active/wave-5-documentation-audit/children/01-3-labeler-rules-audit.md b/.github/projects/active/wave-5-documentation-audit/children/01-3-labeler-rules-audit.md index c7c9fd01a..8d126368f 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/01-3-labeler-rules-audit.md +++ b/.github/projects/active/wave-5-documentation-audit/children/01-3-labeler-rules-audit.md @@ -1,13 +1,13 @@ --- issue_number: 656 -file_type: "task" +file_type: documentation description: "Audit labeling rules for issue-specific automation" parent_issue: 649 title: "[Child of #649] Audit: Issue Labeling Rules in labeler.yml" type: "type:audit" area: "area:labels" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "M" --- @@ -50,4 +50,4 @@ Comprehensive audit of labeling rules in `.github/labeler.yml` to identify issue - [Label Strategy](https://github.com/lightspeedwp/.github/blob/develop/docs/LABEL_STRATEGY.md) - [Labeler Configuration](https://github.com/lightspeedwp/.github/blob/develop/.github/labeler.yml) -- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION_GOVERNANCE.md) +- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION.md) diff --git a/.github/projects/active/wave-5-documentation-audit/children/01-4-ai-instructions.md b/.github/projects/active/wave-5-documentation-audit/children/01-4-ai-instructions.md index 4b31ea048..35d721507 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/01-4-ai-instructions.md +++ b/.github/projects/active/wave-5-documentation-audit/children/01-4-ai-instructions.md @@ -1,13 +1,13 @@ --- issue_number: 657 -file_type: "task" +file_type: documentation description: "Create clear instructions for AI agents on issue creation" parent_issue: 649 title: "[Child of #649] Implement: Clear AI Agent Instructions for Issue Creation" type: "type:task" area: "area:automation" priority: "priority:important" -status: "status:needs-triage" +status: draft effort: "M" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/02-1-labels-color-consistency.md b/.github/projects/active/wave-5-documentation-audit/children/02-1-labels-color-consistency.md index 17008b830..8a057f7c1 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/02-1-labels-color-consistency.md +++ b/.github/projects/active/wave-5-documentation-audit/children/02-1-labels-color-consistency.md @@ -1,13 +1,13 @@ --- issue_number: 658 -file_type: "task" +file_type: documentation description: "Verify label colors follow the documented strategy" parent_issue: 650 title: "[Child of #650] Audit: labels.yml Color Consistency & Strategy Alignment" type: "type:audit" area: "area:labels" priority: "priority:important" -status: "status:needs-triage" +status: draft effort: "M" --- @@ -44,10 +44,10 @@ Verify that all 200+ labels in `labels.yml` follow the documented color strategy - `.github/labels.yml` - `docs/LABEL_STRATEGY.md` -- `docs/ISSUE_LABELS.md` +- `docs/LABELING.md` ## Related Documentation - [Label Strategy](https://github.com/lightspeedwp/.github/blob/develop/docs/LABEL_STRATEGY.md) -- [Issue Labels Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_LABELS.md) +- [Issue Labels Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/LABELING.md) - [Canonical Labels File](https://github.com/lightspeedwp/.github/blob/develop/.github/labels.yml) diff --git a/.github/projects/active/wave-5-documentation-audit/children/02-2-issue-types-mapping.md b/.github/projects/active/wave-5-documentation-audit/children/02-2-issue-types-mapping.md index be67744d9..b18b6da4a 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/02-2-issue-types-mapping.md +++ b/.github/projects/active/wave-5-documentation-audit/children/02-2-issue-types-mapping.md @@ -1,13 +1,13 @@ --- issue_number: 659 -file_type: "task" +file_type: documentation description: "Verify issue types align with templates and labels" parent_issue: 650 title: "[Child of #650] Audit: Issue Types Alignment with Templates & Labels" type: "type:audit" area: "area:labels" priority: "priority:important" -status: "status:needs-triage" +status: draft effort: "M" --- @@ -51,5 +51,5 @@ Verify that all issue types in `issue-types.yml` have matching templates and lab ## Related Documentation - [Issue Types Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_TYPES.md) -- [Issue Labels Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_LABELS.md) +- [Issue Labels Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/LABELING.md) - [Issue Templates](https://github.com/lightspeedwp/.github/blob/develop/.github/ISSUE_TEMPLATE/README.md) diff --git a/.github/projects/active/wave-5-documentation-audit/children/02-3-issue-fields-config.md b/.github/projects/active/wave-5-documentation-audit/children/02-3-issue-fields-config.md index cde5bf3c0..4cc635b9a 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/02-3-issue-fields-config.md +++ b/.github/projects/active/wave-5-documentation-audit/children/02-3-issue-fields-config.md @@ -1,13 +1,13 @@ --- issue_number: 660 -file_type: "task" +file_type: documentation description: "Validate issue fields configuration against GitHub API" parent_issue: 650 title: "[Child of #650] Audit: Issue Fields Configuration vs. GitHub API" type: "type:audit" area: "area:labels" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "M" --- @@ -45,11 +45,11 @@ Validate that `issue-fields.yml` configuration is complete, correct, and aligns ## Related Files - `.github/issue-fields.yml` -- docs/ISSUE-FIELDS.md +- docs/ISSUE_FIELDS.md - docs/ISSUE_TYPES.md ## Related Documentation -- [Issue Fields Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE-FIELDS.md) +- [Issue Fields Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_FIELDS.md) - [GitHub API - Issue Fields](https://docs.github.com/en/rest/reference/issues) - [Canonical Issue Fields](https://github.com/lightspeedwp/.github/blob/develop/.github/issue-fields.yml) diff --git a/.github/projects/active/wave-5-documentation-audit/children/02-4-config-relationships.md b/.github/projects/active/wave-5-documentation-audit/children/02-4-config-relationships.md index 9c6a7726a..0405addc1 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/02-4-config-relationships.md +++ b/.github/projects/active/wave-5-documentation-audit/children/02-4-config-relationships.md @@ -1,13 +1,13 @@ --- issue_number: 661 -file_type: "task" +file_type: documentation description: "Document relationships between canonical config files" parent_issue: 650 title: "[Child of #650] Document: Canonical Config File Interdependencies" type: "type:task" area: "area:labels" priority: "priority:important" -status: "status:needs-triage" +status: draft effort: "L" --- @@ -53,5 +53,5 @@ Create comprehensive documentation of how canonical config files (labels.yml, is ## Related Documentation - [Label Strategy](https://github.com/lightspeedwp/.github/blob/develop/docs/LABEL_STRATEGY.md) -- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION_GOVERNANCE.md) +- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION.md) - [Issue Types Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_TYPES.md) diff --git a/.github/projects/active/wave-5-documentation-audit/children/03-1-issue-creation-docs.md b/.github/projects/active/wave-5-documentation-audit/children/03-1-issue-creation-docs.md index 4fd45460b..1de30b5d6 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/03-1-issue-creation-docs.md +++ b/.github/projects/active/wave-5-documentation-audit/children/03-1-issue-creation-docs.md @@ -1,13 +1,13 @@ --- issue_number: 662 -file_type: "task" +file_type: documentation description: "Audit and consolidate issue creation documentation" parent_issue: 651 title: "[Child of #651] Audit: Issue Creation Docs - Consolidate Overlapping Files" type: "type:audit" area: "area:documentation" priority: "priority:important" -status: "status:needs-triage" +status: draft effort: "M" --- @@ -20,7 +20,7 @@ Audit all documentation related to issue creation to identify duplication and ov Review all issue creation related files: - `docs/ISSUE_CREATION_GUIDE.md` -- `docs/ISSUE_LABELS.md` +- `docs/LABELING.md` - `docs/ISSUE_TYPES.md` - `.github/ISSUE_TEMPLATE/README.md` - `docs/index.md` (if references issues) @@ -46,7 +46,7 @@ Review all issue creation related files: ## Related Files - `docs/ISSUE_CREATION_GUIDE.md` -- `docs/ISSUE_LABELS.md` +- `docs/LABELING.md` - `docs/ISSUE_TYPES.md` - `.github/ISSUE_TEMPLATE/README.md` - `instructions/issues.instructions.md` @@ -55,7 +55,7 @@ Review all issue creation related files: ## Related Documentation - [Issue Creation Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_CREATION_GUIDE.md) -- [Issue Labels Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_LABELS.md) +- [Issue Labels Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/LABELING.md) - [Issue Types Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_TYPES.md) - [Issue Templates README](https://github.com/lightspeedwp/.github/blob/develop/.github/ISSUE_TEMPLATE/README.md) - [Issue Instructions](https://github.com/lightspeedwp/.github/blob/develop/instructions/issues.instructions.md) diff --git a/.github/projects/active/wave-5-documentation-audit/children/03-2-pr-creation-docs.md b/.github/projects/active/wave-5-documentation-audit/children/03-2-pr-creation-docs.md index 512bb519a..5fcf2dac6 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/03-2-pr-creation-docs.md +++ b/.github/projects/active/wave-5-documentation-audit/children/03-2-pr-creation-docs.md @@ -1,10 +1,10 @@ --- -file_type: "documentation" +file_type: documentation title: "PR Creation Documentation Consolidation Audit" description: "Complete audit of PR creation documentation identifying consolidation opportunities and duplicated content" -version: "v1.0" +version: "v1.0.1" created_date: "2026-05-31" -last_updated: '2026-06-01' +last_updated: "2026-06-01" author: "Claude Code" maintainer: "LightSpeedWP Team" tags: ["documentation", "audit", "consolidation", "wave-5"] @@ -27,7 +27,7 @@ domain: "governance" Audited 5 documentation files related to PR creation. Found: - **Significant overlap** between `docs/PR_CREATION_PROCESS.md` and `instructions/pull-requests.instructions.md` -- **Missing file** (`docs/PR_LABELS.md` referenced by 3 files but does not exist) +- **Missing file** (`docs/LABELING.md` referenced by 3 files but does not exist) - **Duplicate content** within `.github/PULL_REQUEST_TEMPLATE/README.md` (footer repeats 3x) - **Fragmented responsibility** across 4 active files covering similar ground - **Broken cross-references** to non-existent `PR_LABELS.md` (similar pattern to ISSUE_LABELS.md consolidation) @@ -41,7 +41,7 @@ Audited 5 documentation files related to PR creation. Found: | File | Path | Exists | Status | Role | |------|------|--------|--------|------| | PR Creation Guide | `docs/PR_CREATION_PROCESS.md` | ✅ | Active | High-level how-to | -| PR Labels Guide | `docs/PR_LABELS.md` | ❌ | Missing | Supposed label reference | +| PR Labels Guide | `docs/LABELING.md` | ❌ | Missing | Supposed label reference | | PR Templates README | `.github/PULL_REQUEST_TEMPLATE/README.md` | ✅ | Active | Template directory guide | | PR Instructions | `instructions/pull-requests.instructions.md` | ✅ | Active | Official instructions (AI/agents) | | Branching Strategy | `docs/BRANCHING_STRATEGY.md` | ✅ | Active | Git workflow & branch naming | @@ -74,13 +74,13 @@ Audited 5 documentation files related to PR creation. Found: **Issues:** - Repeats information already in `instructions/pull-requests.instructions.md` -- References non-existent `docs/PR_LABELS.md` (line 163) +- References non-existent `docs/LABELING.md` (line 163) - Label guidance is present but refers to missing reference file - Template mapping table (lines 64-74) is identical to content in PULL_REQUEST_TEMPLATE/README.md (lines 26-36) --- -### 2. **`docs/PR_LABELS.md`** +### 2. **`docs/LABELING.md`** **Status:** ❌ **MISSING** @@ -88,12 +88,12 @@ Referenced in audit scope but this file does not exist. **Key Finding:** -- `docs/PR_LABELS.md` is referenced by 3 active files: +- `docs/LABELING.md` is referenced by 3 active files: - `docs/PR_CREATION_PROCESS.md` (line 163) - `.github/PULL_REQUEST_TEMPLATE/README.md` (line 42) - `docs/BRANCHING_STRATEGY.md` (line 284) - No consolidated labeling guide exists for PR-specific labels -- Likely pattern: Similar to `docs/ISSUE_LABELS.md` which was consolidated into `docs/LABELING.md` +- Likely pattern: Similar to `docs/LABELING.md` which was consolidated into `docs/LABELING.md` **Recommendation:** @@ -124,7 +124,7 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b - **CRITICAL DUPLICATION:** Footer repeats 3 times (lines 83-90) - "Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team" appears 3 consecutive times -- References non-existent `docs/PR_LABELS.md` (line 42) +- References non-existent `docs/LABELING.md` (line 42) - References potentially incorrect path: `../AUTOMATION_GOVERNANCE.md` (unclear if this file exists) - Template mapping table content overlaps with `docs/PR_CREATION_PROCESS.md` (lines 26-36) @@ -162,7 +162,7 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b - Overlap with `docs/PR_CREATION_PROCESS.md`: - Both cover branch naming, template selection, PR titles, labels, review lifecycle - Instructions are more authoritative; guide is more user-friendly -- References `docs/PR_LABELS.md` (line 129) which doesn't exist +- References `docs/LABELING.md` (line 129) which doesn't exist - References `instructions/labeling.instructions.md` (not mentioned in audit scope—verify if it exists) --- @@ -190,8 +190,8 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b **Issues:** -- References non-existent `docs/PR_LABELS.md` (line 284) -- References `docs/ISSUE_LABELS.md` (line 283) which is consolidated into `docs/LABELING.md` +- References non-existent `docs/LABELING.md` (line 284) +- References `docs/LABELING.md` (line 283) which is consolidated into `docs/LABELING.md` - Significant overlap with branch naming section in `docs/PR_CREATION_PROCESS.md` (section 2) - Very detailed and dense—might be overwhelming for new contributors who just want to create a PR @@ -207,7 +207,7 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b | Current File | Content | Proposed Location | Action | Rationale | |--------------|---------|-------------------|--------|-----------| | `docs/PR_CREATION_PROCESS.md` | Practical PR how-to guide | Keep (docs/) | Preserve | Good audience fit (all contributors), clear structure | -| `docs/PR_LABELS.md` | Missing; supposed label reference | Create or redirect | Investigate | Determine if consolidate into LABELING.md or create new file; fix 3 broken references | +| `docs/LABELING.md` | Missing; supposed label reference | Create or redirect | Investigate | Determine if consolidate into LABELING.md or create new file; fix 3 broken references | | `.github/PULL_REQUEST_TEMPLATE/README.md` | Template directory guide | Keep (with fixes) | Fix duplication | Remove 3x repeated footer; fix PR_LABELS.md reference | | `instructions/pull-requests.instructions.md` | Official instructions | Keep (instructions/) | Preserve | Authoritative, comprehensive, no duplication | | `docs/BRANCHING_STRATEGY.md` | Comprehensive branching strategy | Keep (docs/) | Minor fix | Update broken references to PR_LABELS.md and ISSUE_LABELS.md | @@ -263,17 +263,17 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b - `docs/PR_CREATION_PROCESS.md` (section 6, lines 101-110) - `instructions/pull-requests.instructions.md` (section 5, lines 137-163) - `docs/BRANCHING_STRATEGY.md` (section 5.1, lines 163-203, and section 5.2, lines 210-226) -- Missing: `docs/PR_LABELS.md` +- Missing: `docs/LABELING.md` **Content:** What labels are required, label families, one-hot rules, automation **Issue:** - Three files provide different levels of detail about labeling -- All reference non-existent `docs/PR_LABELS.md` +- All reference non-existent `docs/LABELING.md` - No consolidated PR label reference (unlike existing label strategy documents) -**Consolidation:** Create or investigate consolidation of `docs/PR_LABELS.md`: +**Consolidation:** Create or investigate consolidation of `docs/LABELING.md`: - Determine if labels should consolidate into `docs/LABELING.md` (check if it covers both) - If creating new file: include label families, color scheme, automation rules, one-hot enforcement @@ -306,7 +306,7 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b - Keep single footer at lines 83-84 2. **Update broken references** - - Find all references to `docs/PR_LABELS.md`: + - Find all references to `docs/LABELING.md`: - `docs/PR_CREATION_PROCESS.md` (line 163) - `.github/PULL_REQUEST_TEMPLATE/README.md` (line 42) - `docs/BRANCHING_STRATEGY.md` (line 284) @@ -315,8 +315,8 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b - If creating: populate with full PR label reference based on existing guidance 3. **Update `docs/BRANCHING_STRATEGY.md`** - - Fix reference to `docs/ISSUE_LABELS.md` (line 283) → redirect to `docs/LABELING.md#issue-labelling` - - Verify and update reference to `docs/PR_LABELS.md` (line 284) once consolidated + - Fix reference to `docs/LABELING.md` (line 283) → redirect to `docs/LABELING.md#issue-labelling` + - Verify and update reference to `docs/LABELING.md` (line 284) once consolidated ### Phase 2: Consolidate & Link (Wave 5.3 or 5.4) @@ -332,7 +332,7 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b - Remove duplication from guide 3. **Create or consolidate PR labels reference** - - Option A: Create `docs/PR_LABELS.md` with comprehensive PR label guidance + - Option A: Create `docs/LABELING.md` with comprehensive PR label guidance - Include: label families, colors, automation rules, one-hot enforcement, examples - Base on existing guidance scattered across multiple files - Option B: Consolidate into `docs/LABELING.md` if it already covers PR labels @@ -361,7 +361,7 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b |--------|-------| | Files audited | 5 | | Files with duplicates | 2 (PULL_REQUEST_TEMPLATE/README.md footer 3x, PR_CREATION_PROCESS.md template table) | -| Missing files | 1 (`docs/PR_LABELS.md`) | +| Missing files | 1 (`docs/LABELING.md`) | | Broken references | 4 (3 to missing PR_LABELS.md, 1 to consolidated ISSUE_LABELS.md) | | Overlapping content areas | 4 (branch naming, template selection, labels, review lifecycle) | | Total lines across all files | ~822 | @@ -373,7 +373,7 @@ Instead of creating a new `PR_LABELS.md`, investigate whether PR labels should b 1. **Phase 1 (Immediate - Wave 5.3):** - [ ] Fix `.github/PULL_REQUEST_TEMPLATE/README.md` duplicate footer - - [ ] Decide: create `docs/PR_LABELS.md` OR consolidate into `docs/LABELING.md` + - [ ] Decide: create `docs/LABELING.md` OR consolidate into `docs/LABELING.md` - [ ] Update all broken references to PR_LABELS.md - [ ] Update reference to ISSUE_LABELS.md → LABELING.md diff --git a/.github/projects/active/wave-5-documentation-audit/children/03-3-labeling-docs.md b/.github/projects/active/wave-5-documentation-audit/children/03-3-labeling-docs.md index 27780fbbe..2b36ae76e 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/03-3-labeling-docs.md +++ b/.github/projects/active/wave-5-documentation-audit/children/03-3-labeling-docs.md @@ -1,10 +1,10 @@ --- -file_type: "documentation" +file_type: documentation title: "Labeling Documentation Consolidation Audit" description: "Complete audit of labeling documentation identifying consolidation opportunities and distributed responsibility" -version: "v1.0" +version: "v1.0.1" created_date: "2026-05-31" -last_updated: '2026-06-01' +last_updated: "2026-06-01" author: "Claude Code" maintainer: "LightSpeedWP Team" tags: ["documentation", "audit", "consolidation", "wave-5", "labeling"] @@ -27,7 +27,7 @@ domain: "governance" Audited 4 labeling-related documentation files. Found: - **Distributed responsibility** across 4 files with overlapping coverage -- **Missing files** (`docs/LABEL_STRATEGY.md`, `docs/PR_LABELS.md`, `docs/AUTOMATION_GOVERNANCE.md` referenced or expected but don't exist) +- **Missing files** (`docs/LABEL_STRATEGY.md`, `docs/LABELING.md`, `docs/AUTOMATION.md` referenced or expected but don't exist) - **Significant duplication** between `docs/LABELING.md` and `instructions/labeling.instructions.md` - **Cross-references between files** create maintenance burden and inconsistency risk - **Fragmented guidance** on label application between LABELING.md and AUTOMATION.md @@ -50,9 +50,9 @@ Audited 4 labeling-related documentation files. Found: | File | Status | Impact | |------|--------|--------| | `docs/LABEL_STRATEGY.md` | ❌ Missing | No separate strategy doc (covered in LABELING.md) | -| `docs/ISSUE_LABELS.md` | ❌ Deprecated | Consolidated into LABELING.md#issue-labelling (per Issue #662) | -| `docs/PR_LABELS.md` | ❌ Missing | No separate PR labels doc (covered in LABELING.md#pull-request-labelling) | -| `docs/AUTOMATION_GOVERNANCE.md` | ❌ Missing | Replaced by AUTOMATION.md (different name) | +| `docs/LABELING.md` | ❌ Deprecated | Consolidated into LABELING.md#issue-labelling (per Issue #662) | +| `docs/LABELING.md` | ❌ Missing | No separate PR labels doc (covered in LABELING.md#pull-request-labelling) | +| `docs/AUTOMATION.md` | ❌ Missing | Replaced by AUTOMATION.md (different name) | --- @@ -275,12 +275,12 @@ Audited 4 labeling-related documentation files. Found: ### Critical Gaps -1. **No separate `docs/ISSUE_LABELS.md`** +1. **No separate `docs/LABELING.md`** - Consolidated into `docs/LABELING.md#issue-labelling` - Any broken references should point to LABELING.md#issue-labelling - Similar pattern to Issue #662 finding -2. **No separate `docs/PR_LABELS.md`** +2. **No separate `docs/LABELING.md`** - Consolidated into `docs/LABELING.md#pull-request-labelling` - Found in Issue #663 audit as missing/needed - Recommendation: Consolidate PR labels into LABELING.md (already done) and update references @@ -290,7 +290,7 @@ Audited 4 labeling-related documentation files. Found: - Content covered by LABELING.md (strategy, principles, families) - No action needed; file wasn't required -4. **No `docs/AUTOMATION_GOVERNANCE.md`** +4. **No `docs/AUTOMATION.md`** - Scope mentions this; actually called `docs/AUTOMATION.md` - Naming inconsistency but file exists @@ -326,7 +326,7 @@ Audited 4 labeling-related documentation files. Found: - Example: "See LABELING.md#Issue_Labelling for detailed requirements" 3. **Verify all references to missing files** - - Check for broken references to `docs/ISSUE_LABELS.md`, `docs/PR_LABELS.md` + - Check for broken references to `docs/LABELING.md`, `docs/LABELING.md` - Update any found to point to `docs/LABELING.md#issue-labelling` or `#pull-request-labelling` - Mark in DEPRECATED.md if these were ever separate files diff --git a/.github/projects/active/wave-5-documentation-audit/children/03-4-file-organization-alignment.md b/.github/projects/active/wave-5-documentation-audit/children/03-4-file-organization-alignment.md index 707c6ebfe..943ec5173 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/03-4-file-organization-alignment.md +++ b/.github/projects/active/wave-5-documentation-audit/children/03-4-file-organization-alignment.md @@ -1,10 +1,10 @@ --- -file_type: "documentation" +file_type: documentation title: "File Organization Alignment Audit" description: "Complete audit of documentation folder structure vs. CLAUDE.md boundaries identifying misplacements and reorganization needs" -version: "v1.0" +version: "v1.0.1" created_date: "2026-05-31" -last_updated: '2026-06-01' +last_updated: "2026-06-01" author: "Claude Code" maintainer: "LightSpeedWP Team" tags: ["documentation", "audit", "file-organization", "wave-5"] diff --git a/.github/projects/active/wave-5-documentation-audit/children/03-5-update-documentation-index.md b/.github/projects/active/wave-5-documentation-audit/children/03-5-update-documentation-index.md index aca972cb2..e6c13b0b6 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/03-5-update-documentation-index.md +++ b/.github/projects/active/wave-5-documentation-audit/children/03-5-update-documentation-index.md @@ -1,13 +1,13 @@ --- issue_number: 666 -file_type: "task" +file_type: documentation description: "Update docs/README.md and docs/index.md to reflect consolidation changes and remove broken references" parent_issue: 651 title: "[Child of #651] Update: Documentation Index & Broken References" type: "type:docs" area: "area:documentation" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "S" --- @@ -28,14 +28,14 @@ Update documentation index files (`docs/README.md` and `docs/index.md`) to refle ### From Issue #662 (Issue Creation Docs) -- `docs/ISSUE_LABELS.md` was consolidated into `docs/LABELING.md#issue-labelling` +- `docs/LABELING.md` was consolidated into `docs/LABELING.md#issue-labelling` - References should point to `docs/LABELING.md#issue-labelling` not ISSUE_LABELS.md ### From Issue #663 (PR Creation Docs) -- `docs/PR_LABELS.md` doesn't exist (needs investigation) -- `docs/ISSUE_LABELS.md` reference should redirect to LABELING.md -- `docs/AUTOMATION_GOVERNANCE.md` doesn't exist (file is actually `docs/AUTOMATION.md`) +- `docs/LABELING.md` doesn't exist (needs investigation) +- `docs/LABELING.md` reference should redirect to LABELING.md +- `docs/AUTOMATION.md` doesn't exist (file is actually `docs/AUTOMATION.md`) ### From Issue #664 (Labeling Docs) diff --git a/.github/projects/active/wave-5-documentation-audit/children/03-5-update-index.md b/.github/projects/active/wave-5-documentation-audit/children/03-5-update-index.md index 2efff16a4..86b7e0ef8 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/03-5-update-index.md +++ b/.github/projects/active/wave-5-documentation-audit/children/03-5-update-index.md @@ -1,13 +1,13 @@ --- issue_number: 666 -file_type: "task" +file_type: documentation description: "Update documentation index with complete inventory" parent_issue: 651 title: "[Child of #651] Update: Documentation Index (docs/index.md) - Complete & Current" type: "type:task" area: "area:documentation" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "M" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/04-1-discover-audit-readmes.md b/.github/projects/active/wave-5-documentation-audit/children/04-1-discover-audit-readmes.md index 2cf552830..817d6d8c9 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/04-1-discover-audit-readmes.md +++ b/.github/projects/active/wave-5-documentation-audit/children/04-1-discover-audit-readmes.md @@ -1,13 +1,13 @@ --- issue_number: 667 -file_type: "task" +file_type: documentation description: "Discover and inventory all README.md files" parent_issue: 652 title: "[Child of #652] Audit: Discover All 44 README.md Files - Inventory" type: "type:audit" area: "area:documentation" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "M" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/04-2-validate-mermaid-syntax.md b/.github/projects/active/wave-5-documentation-audit/children/04-2-validate-mermaid-syntax.md index d5eda4971..7ccf1f3f8 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/04-2-validate-mermaid-syntax.md +++ b/.github/projects/active/wave-5-documentation-audit/children/04-2-validate-mermaid-syntax.md @@ -1,13 +1,13 @@ --- issue_number: 668 -file_type: "task" +file_type: documentation description: "Validate Mermaid diagram syntax in all files" parent_issue: 652 title: "[Child of #652] Audit: Validate Mermaid Syntax in All Diagrams" type: "type:audit" area: "area:documentation" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "L" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/04-3-accessibility-compliance.md b/.github/projects/active/wave-5-documentation-audit/children/04-3-accessibility-compliance.md index 749179c82..191b6c742 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/04-3-accessibility-compliance.md +++ b/.github/projects/active/wave-5-documentation-audit/children/04-3-accessibility-compliance.md @@ -1,13 +1,13 @@ --- issue_number: 669 -file_type: "task" +file_type: documentation description: "Audit Mermaid diagrams for accessibility compliance" parent_issue: 652 title: "[Child of #652] Audit: Mermaid Diagram Accessibility (WCAG AA, Light/Dark Mode)" type: "type:audit" area: "area:a11y" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "L" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/04-4-update-readmes.md b/.github/projects/active/wave-5-documentation-audit/children/04-4-update-readmes.md index 09bb3e3b2..297de1954 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/04-4-update-readmes.md +++ b/.github/projects/active/wave-5-documentation-audit/children/04-4-update-readmes.md @@ -1,13 +1,13 @@ --- issue_number: 670 -file_type: "task" +file_type: documentation description: "Fix and refresh README files with current information" parent_issue: 652 title: "[Child of #652] Update: Fix & Refresh 44 README Files with Current Information" type: "type:task" area: "area:documentation" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "XL" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/05-1-current-vs-planned.md b/.github/projects/active/wave-5-documentation-audit/children/05-1-current-vs-planned.md index e1e78e0c7..01232d48d 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/05-1-current-vs-planned.md +++ b/.github/projects/active/wave-5-documentation-audit/children/05-1-current-vs-planned.md @@ -1,13 +1,13 @@ --- issue_number: 671 -file_type: "task" +file_type: documentation description: "Audit current file organization vs. CLAUDE.md" parent_issue: 653 title: "[Child of #653] Audit: Current File Organization vs. CLAUDE.md Boundaries" type: "type:audit" area: "area:core" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "M" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/05-2-agent-script-locations.md b/.github/projects/active/wave-5-documentation-audit/children/05-2-agent-script-locations.md index 656366c2c..be3ff37d8 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/05-2-agent-script-locations.md +++ b/.github/projects/active/wave-5-documentation-audit/children/05-2-agent-script-locations.md @@ -1,13 +1,13 @@ --- issue_number: 672 -file_type: "task" +file_type: documentation description: "Audit agent and script file migration status" parent_issue: 653 title: "[Child of #653] Audit: Agent & Script Files - Migration Status" type: "type:audit" area: "area:core" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "M" --- diff --git a/.github/projects/active/wave-5-documentation-audit/children/05-3-migration-plan.md b/.github/projects/active/wave-5-documentation-audit/children/05-3-migration-plan.md index d66e63db8..a96efc73f 100644 --- a/.github/projects/active/wave-5-documentation-audit/children/05-3-migration-plan.md +++ b/.github/projects/active/wave-5-documentation-audit/children/05-3-migration-plan.md @@ -1,13 +1,13 @@ --- issue_number: 673 -file_type: "task" +file_type: documentation description: "Create detailed migration plan for file reorganization" parent_issue: 653 title: "[Child of #653] Plan: File Organization Refactoring - Migration & Validation" type: "type:task" area: "area:core" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "L" --- diff --git a/.github/projects/active/wave-5-documentation-audit/execution/wave-5-3-phase-2-execution-plan.md b/.github/projects/active/wave-5-documentation-audit/execution/wave-5-3-phase-2-execution-plan.md index 47e048006..4556513df 100644 --- a/.github/projects/active/wave-5-documentation-audit/execution/wave-5-3-phase-2-execution-plan.md +++ b/.github/projects/active/wave-5-documentation-audit/execution/wave-5-3-phase-2-execution-plan.md @@ -1,10 +1,10 @@ --- -file_type: "documentation" +file_type: documentation title: "Wave 5.3 Phase 2 Execution Plan" description: "Implementation of consolidation recommendations from Wave 5.3 audits" -version: "v1.0" +version: "v1.0.1" created_date: "2026-05-31" -last_updated: '2026-06-01' +last_updated: "2026-06-01" author: "Claude Code" maintainer: "LightSpeedWP Team" tags: ["documentation", "consolidation", "wave-5", "phase-2", "execution"] @@ -64,8 +64,8 @@ These are high-impact fixes with low risk of breaking changes. - **File:** `docs/BRANCHING_STRATEGY.md` - **Issues:** - - Line 283: `docs/ISSUE_LABELS.md` → `docs/LABELING.md#issue-labelling` - - Line 284: `docs/PR_LABELS.md` → decision pending + - Line 283: `docs/LABELING.md` → `docs/LABELING.md#issue-labelling` + - Line 284: `docs/LABELING.md` → decision pending - **Action:** Fix ISSUE_LABELS reference, add note about PR_LABELS consolidation - **Risk:** None (fixing broken references) - **Status:** 🟡 Ready to implement diff --git a/.github/projects/active/wave-5-documentation-audit/findings/654-template-inventory-findings.md b/.github/projects/active/wave-5-documentation-audit/findings/654-template-inventory-findings.md index 8043f3e9f..f3a75f225 100644 --- a/.github/projects/active/wave-5-documentation-audit/findings/654-template-inventory-findings.md +++ b/.github/projects/active/wave-5-documentation-audit/findings/654-template-inventory-findings.md @@ -1,10 +1,10 @@ --- -file_type: "documentation" +file_type: documentation title: "Wave 5 Audit #654 Findings" description: "Template Inventory and Standardisation Audit findings" -version: "1.2.1" +version: "1.2.2" created_date: "2026-05-31" -last_updated: '2026-06-01' +last_updated: "2026-06-01" language: "en-GB" status: "active" stability: "stable" diff --git a/.github/projects/active/wave-5-documentation-audit/parents/01-issue-templates-automation-audit.md b/.github/projects/active/wave-5-documentation-audit/parents/01-issue-templates-automation-audit.md index d1ea7c148..a62cf5ad1 100644 --- a/.github/projects/active/wave-5-documentation-audit/parents/01-issue-templates-automation-audit.md +++ b/.github/projects/active/wave-5-documentation-audit/parents/01-issue-templates-automation-audit.md @@ -1,6 +1,6 @@ --- issue_number: 649 -file_type: "project" +file_type: documentation description: "Comprehensive audit of issue templates, automation integration, and AI agent instructions" title: "[Audit] Issue Templates, Automation, & AI Agent Integration" type: "type:audit" @@ -8,7 +8,7 @@ area: - "area:automation" - "area:labels" priority: "priority:important" -status: "status:needs-triage" +status: draft effort: "M" children: - "1.1-template-inventory" @@ -63,4 +63,4 @@ See child issues for detailed audits of: - [Issue Creation Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_CREATION_GUIDE.md) - [Issue Templates README](https://github.com/lightspeedwp/.github/blob/develop/.github/ISSUE_TEMPLATE/README.md) - [Label Strategy](https://github.com/lightspeedwp/.github/blob/develop/docs/LABEL_STRATEGY.md) -- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION_GOVERNANCE.md) +- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION.md) diff --git a/.github/projects/active/wave-5-documentation-audit/parents/02-canonical-configs-audit.md b/.github/projects/active/wave-5-documentation-audit/parents/02-canonical-configs-audit.md index da8813a16..e0ab027b9 100644 --- a/.github/projects/active/wave-5-documentation-audit/parents/02-canonical-configs-audit.md +++ b/.github/projects/active/wave-5-documentation-audit/parents/02-canonical-configs-audit.md @@ -1,6 +1,6 @@ --- issue_number: 650 -file_type: "project" +file_type: documentation description: "Comprehensive audit of canonical configuration files and their relationships" title: "[Audit] Canonical Config Files (labels, issue-types, issue-fields)" type: "type:audit" @@ -8,7 +8,7 @@ area: - "area:labels" - "area:automation" priority: "priority:important" -status: "status:needs-triage" +status: draft effort: "L" children: - "2.1-labels-color-consistency" @@ -54,15 +54,15 @@ See child issues for detailed audits of: - `.github/issue-types.yml` - `.github/issue-fields.yml` - `docs/LABEL_STRATEGY.md` -- `docs/ISSUE_LABELS.md` +- `docs/LABELING.md` - `docs/ISSUE_TYPES.md` - `docs/ISSUE-FIELDS.md` ## Related Documentation - [Label Strategy](https://github.com/lightspeedwp/.github/blob/develop/docs/LABEL_STRATEGY.md) -- [Issue Labels Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_LABELS.md) +- [Issue Labels Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/LABELING.md) - [Issue Types Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_TYPES.md) - [Issue Fields Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE-FIELDS.md) -- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION_GOVERNANCE.md) +- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION.md) - [Canonical Labels File](https://github.com/lightspeedwp/.github/blob/develop/.github/labels.yml) diff --git a/.github/projects/active/wave-5-documentation-audit/parents/03-documentation-consolidation-audit.md b/.github/projects/active/wave-5-documentation-audit/parents/03-documentation-consolidation-audit.md index 9279219e8..cdf95ae8a 100644 --- a/.github/projects/active/wave-5-documentation-audit/parents/03-documentation-consolidation-audit.md +++ b/.github/projects/active/wave-5-documentation-audit/parents/03-documentation-consolidation-audit.md @@ -1,12 +1,12 @@ --- issue_number: 651 -file_type: "project" +file_type: documentation description: "Comprehensive audit and consolidation of documentation to reduce duplication and improve clarity" title: "[Audit] Documentation Consolidation - Reduce Duplication Across Docs" type: "type:audit" area: "area:documentation" priority: "priority:important" -status: "status:needs-triage" +status: draft effort: "XL" children: - "3.1-issue-creation-docs" @@ -62,6 +62,6 @@ See child issues for detailed audits of: - [Issue Creation Guide](https://github.com/lightspeedwp/.github/blob/develop/docs/ISSUE_CREATION_GUIDE.md) - [PR Creation Process](https://github.com/lightspeedwp/.github/blob/develop/docs/PR_CREATION_PROCESS.md) - [Label Strategy](https://github.com/lightspeedwp/.github/blob/develop/docs/LABEL_STRATEGY.md) -- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION_GOVERNANCE.md) +- [Automation Governance](https://github.com/lightspeedwp/.github/blob/develop/docs/AUTOMATION.md) - [Root README](https://github.com/lightspeedwp/.github/blob/develop/README.md) - [.github README](https://github.com/lightspeedwp/.github/blob/develop/.github/README.md) diff --git a/.github/projects/active/wave-5-documentation-audit/parents/04-readme-mermaid-audit.md b/.github/projects/active/wave-5-documentation-audit/parents/04-readme-mermaid-audit.md index 7b14cb3df..0e82a3432 100644 --- a/.github/projects/active/wave-5-documentation-audit/parents/04-readme-mermaid-audit.md +++ b/.github/projects/active/wave-5-documentation-audit/parents/04-readme-mermaid-audit.md @@ -1,6 +1,6 @@ --- issue_number: 652 -file_type: "project" +file_type: documentation description: "Comprehensive audit of README files, Mermaid diagrams, and accessibility compliance" title: "[Audit] 44 README Files - Mermaid Diagrams & Accessibility Review" type: "type:audit" @@ -8,7 +8,7 @@ area: - "area:documentation" - "area:a11y" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "XL" children: - "4.1-discover-audit-readmes" diff --git a/.github/projects/active/wave-5-documentation-audit/parents/05-file-organization-audit.md b/.github/projects/active/wave-5-documentation-audit/parents/05-file-organization-audit.md index 57a467827..04191ad9a 100644 --- a/.github/projects/active/wave-5-documentation-audit/parents/05-file-organization-audit.md +++ b/.github/projects/active/wave-5-documentation-audit/parents/05-file-organization-audit.md @@ -1,12 +1,12 @@ --- issue_number: 653 -file_type: "project" +file_type: documentation description: "Comprehensive audit of file organization and alignment with CLAUDE.md repository structure" title: "[Audit] File Organization - Align with CLAUDE.md Repository Boundaries" type: "type:audit" area: "area:core" priority: "priority:normal" -status: "status:needs-triage" +status: draft effort: "L" children: - "5.1-current-vs-planned" diff --git a/.github/projects/archived/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-schemas-migration-report-2026-05-20.md b/.github/projects/archived/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-schemas-migration-report-2026-05-20.md index a4db825e1..0dd62cda9 100644 --- a/.github/projects/archived/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-schemas-migration-report-2026-05-20.md +++ b/.github/projects/archived/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-schemas-migration-report-2026-05-20.md @@ -1,5 +1,5 @@ --- -file_type: "report" +file_type: documentation title: "Portable Schemas Migration Report" description: "Issue #297 evidence for moving active portable schemas from .github/schemas into /schema." version: "v0.1.0" @@ -8,6 +8,7 @@ maintainer: "LightSpeed Team" authors: ["Codex"] license: "GPL-3.0" tags: ["portable-ai-plugin-restructure", "schemas", "migration", "issue-297"] -domain: "ai-ops" -stability: "draft" +domain: governance +stability: incubating +owners: ["LightSpeedWP Team"] --- diff --git a/.github/reports/audits/issue-types-alignment-audit-2026-06-01.md b/.github/reports/audits/issue-types-alignment-audit-2026-06-01.md new file mode 100644 index 000000000..b55be13d9 --- /dev/null +++ b/.github/reports/audits/issue-types-alignment-audit-2026-06-01.md @@ -0,0 +1,204 @@ +--- +file_type: audit-report +title: Issue Types Alignment Audit +description: Three-way mapping audit of all 29 issue types, 26 templates, and corresponding labels +created_date: 2026-06-01 +last_updated: 2026-06-01 +version: 1.0.0 +domain: governance +tags: [audit, labels, issue-types, templates] +--- + +# Issue Types Alignment Audit — 2026-06-01 + +## Executive Summary + +Comprehensive audit of issue types (`.github/issue-types.yml`), GitHub templates (`.github/ISSUE_TEMPLATE/`), and type labels (`.github/labels.yml`) reveals **three critical alignment gaps**: + +- **3 issue types without templates:** Chore, Question, Support (no matching template files) +- **2 new types added with templates:** Help, User Experience Feedback (newly defined) +- **1 orphaned label removed:** type:qa (no corresponding type or template) + +**Alignment Status**: 26/29 types have templates (90%), 29/29 types have labels (100%) + +--- + +## Audit Inventory + +### Issue Types (29 total, per `.github/issue-types.yml`) + +All 29 issue types now have corresponding type:* labels defined in `.github/labels.yml`. + +| # | Issue Type | Label | Color | Template | Status | +|---|---|---|---|---|---| +| 1 | Task | type:task | 4393F8 | 01-task.md | ✅ | +| 2 | Bug | type:bug | 9F3734 | 02-bug.md | ✅ | +| 3 | Feature | type:feature | 3FB950 | 03-feature.md | ✅ | +| 4 | Design | type:design | AB7DF8 | 04-design.md | ✅ | +| 5 | Epic | type:epic | AB7DF8 | 05-epic.md | ✅ | +| 6 | Story | type:story | 4393F8 | 06-story.md | ✅ | +| 7 | Improvement | type:improve | 9198A1 | 07-improvement.md | ✅ | +| 8 | Refactor | type:refactor | 9198A1 | 09-code-refactor.md | ✅ | +| 9 | Build | type:build | 4393F8 | 10-build-ci.md | ✅ | +| 10 | Automation | type:automation | 4393F8 | 11-automation.md | ✅ | +| 11 | Testing | type:test | D29922 | 12-testing-coverage.md | ✅ | +| 12 | Performance | type:performance | D29922 | 13-performance.md | ✅ | +| 13 | Accessibility | type:a11y | DB61A2 | 14-a11y.md | ✅ | +| 14 | Security | type:security | 9F3734 | 15-security.md | ✅ | +| 15 | Compatibility | type:compatibility | 8D4821 | 16-compatibility.md | ✅ | +| 16 | Integration | type:integration | 8D4821 | 17-integration-issue.md | ✅ | +| 17 | Release | type:release | 3FB950 | 18-release.md | ✅ | +| 18 | Maintenance | type:maintenance | 9198A1 | 19-maintenance.md | ✅ | +| 19 | Documentation | type:documentation | 9198A1 | 20-documentation.md | ✅ | +| 20 | Research | type:research | 9198A1 | 21-research.md | ✅ | +| 21 | Chore | type:chore | 9198A1 | **MISSING** | ❌ | +| 22 | Audit | type:audit | 9198A1 | 22-audit.md | ✅ | +| 23 | Review | type:review | 4393F8 | 23-code-review.md | ✅ | +| 24 | AI Ops | type:ai-ops | 4393F8 | 24-ai-ops.md | ✅ | +| 25 | Content Modelling | type:content-modelling | AB7DF8 | 25-content-modelling.md | ✅ | +| 26 | Question | type:question | 5319E7 | **MISSING** | ❌ | +| 27 | Support | type:support | 0E8A16 | **MISSING** | ❌ | +| 28 | Help | type:help | 0E8A16 | 26-help.md | ✅ | +| 29 | User Experience Feedback | type:ux-feedback | 5319E7 | 08-user-experience-feedback.md | ✅ | + +### Orphaned Labels (Removed) + +| Label | Notes | Status | +|---|---|---| +| type:qa | Removed; no corresponding type or template | ✅ Deleted | + +--- + +## Critical Findings + +### Finding 1: Missing Templates (HIGH) + +**3 issue types lack corresponding templates:** + +1. **Chore** (type:chore) + - Issue type defined with color 9198A1 + - **No template file** despite being a common issue category + - Automation: Issues can be tagged but no template guidance + +2. **Question** (type:question) + - Issue type defined with color 5319E7 + - **No template file** for Q&A submissions + - Automation: No structured intake process + +3. **Support** (type:support) + - Issue type defined with color 0E8A16 + - **No template file** for support requests + - Automation: No intake or triage workflow + +**Root Cause:** These types were defined in the configuration but templates were never created or were removed. + +**Impact:** + +- Users cannot select these types from the template dropdown +- Manual type/label assignment required +- Inconsistent submission format for these categories +- No automated workflows can be triggered + +### Finding 2: New Types Added (MEDIUM) + +**2 new issue types now have templates:** + +1. **Help** (type:help) — NEW + - Template: 26-help.md + - Color: 0E8A16 (green) + - Status: ✅ Properly configured + +2. **User Experience Feedback** (type:ux-feedback) — NEW + - Template: 08-user-experience-feedback.md + - Color: 5319E7 (purple) + - Status: ✅ Properly configured + +**Note:** These types were added to complete the alignment of existing templates with the type system. + +### Finding 3: Label Cleanup (COMPLETE) + +**Orphaned label removed:** + +- `type:qa` — Deleted from labels.yml (no corresponding type or template) + +--- + +## Color Consistency + +All 29 issue types have matching colors between: + +- `.github/issue-types.yml` (color field) +- Corresponding `type:*` label in `.github/labels.yml` + +**Status:** ✅ 100% color alignment + +--- + +## Template Numbering + +Template files are now sequentially numbered 01-26 with no duplicates: + +- Numbering fixed: `07-user-experience-feedback.md` renamed to `08-user-experience-feedback.md` +- Subsequent files renumbered (08→09, etc.) +- Result: Sequential order 01-26 + +**Status:** ✅ Sequential numbering verified + +--- + +## Recommendations + +### Phase 1: Create Missing Templates (HIGH Priority) + +Create template files for the 3 types without templates: + +1. **Chore Template** (`07-chore.md`) + - Guidance: Maintenance tasks, refactoring, cleanup + - Sections: Task description, scope, related issues + +2. **Question Template** (`27-question.md`) + - Guidance: Questions about usage, troubleshooting + - Sections: Problem description, context, what you've tried + +3. **Support Template** (`28-support.md`) + - Guidance: Support requests, bug reports needing investigation + - Sections: Environment, reproduction steps, error messages + +### Phase 2: Update Documentation (MEDIUM Priority) + +1. Update `docs/ISSUE_TYPES.md` to document all 29 types +2. Update `.github/ISSUE_TEMPLATE/README.md` with new help/ux-feedback templates +3. Verify `docs/index.md` lists all issue type documentation + +### Phase 3: Validate Automation (LOW Priority) + +1. Test unified labeling agent with new Help/UX Feedback types +2. Verify template selector shows all 26 templates +3. Confirm project type field assignments + +--- + +## Validation Checklist + +- [x] All 29 issue types have corresponding type:* labels +- [x] Color consistency verified across all types +- [x] Template numbering sequential (01-26) +- [x] Orphaned type:qa label removed +- [x] New Help and UX Feedback types added and configured +- [ ] Templates created for Chore, Question, Support (Phase 1) +- [ ] Documentation updated with all 29 types (Phase 2) +- [ ] Automation validation complete (Phase 3) + +--- + +## Related Issues + +- Closes #659 (Issue Types Alignment Audit) +- Related to #650 (Wave 5 Documentation Audit) +- Depends on #658 (Label Color Consistency Audit - completed) + +--- + +**Generated:** 2026-06-01 +**Audit Scope:** `.github/issue-types.yml` (29 types), `.github/ISSUE_TEMPLATE/` (26 templates), `.github/labels.yml` (29+ labels) +**Status:** Complete with phase-by-phase remediation plan diff --git a/.github/reports/audits/label-color-audit-spreadsheet-2026-06-01.csv b/.github/reports/audits/label-color-audit-spreadsheet-2026-06-01.csv new file mode 100644 index 000000000..e8170c959 --- /dev/null +++ b/.github/reports/audits/label-color-audit-spreadsheet-2026-06-01.csv @@ -0,0 +1,151 @@ +Label Name,Current Color,Color Name,Current Family,Aligned,Recommended Color,Recommended Family,Priority,Notes +status:needs-planning,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +status:needs-triage,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +status:ready,0E8A16,Dark Green,Green,NO,0DBA3D,Green,1,Standardise to primary green +status:in-progress,1D76DB,Dark Blue,Blue,NO,0969DA,Blue,2,Use primary blue +status:on-hold,F9D0C4,Light Salmon,Orange,YES,F9D0C4,Orange,3,No change +status:needs-design,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +status:needs-design-review,D4C5F9,Light Purple,Purple,PARTIAL,B4A7E8,Purple,2,Standardise to strategy secondary +status:needs-figma-update,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +status:needs-dev,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +status:needs-review,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +status:needs-qa,FBCA04,Gold Yellow,Yellow,YES,FBCA04,Yellow,3,No change +status:needs-testing,FEF2C0,Pale Yellow,Yellow,NO,F2D06D,Yellow,2,Use tertiary yellow from strategy +status:needs-audit,FEF2C0,Pale Yellow,Yellow,NO,F2D06D,Yellow,2,Use tertiary yellow from strategy +status:needs-documentation,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +status:in-discussion,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +status:needs-more-info,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +status:blocked,E99695,Light Salmon,Red,NO,F85149,Red,1,Use secondary red from strategy +status:duplicate,E99695,Light Salmon,Red,NO,F85149,Red,1,Use secondary red from strategy +status:wontfix,E1E4E8,Very Light Gray,Gray,YES,E1E4E8,Gray,3,No change +status:done,0E8A16,Dark Green,Green,NO,0DBA3D,Green,1,Standardise to primary green +priority:critical,B60205,Dark Red,Red,PARTIAL,EF3B39,Red,2,Use primary red from strategy +priority:important,D93F0B,Orange-Red,Red,NO,F85149,Red,2,Use secondary red from strategy +priority:normal,0052CC,Strong Blue,Blue,NO,0969DA,Blue,2,Use primary blue from strategy +priority:minor,C2E0C6,Light Green,Orange,NO,F9D0C4,Orange,2,Map to orange deferred/low-priority +type:task,4393F8,Medium Blue,Blue,NO,4986E8,Blue,2,Use secondary blue from strategy +type:bug,9F3734,Dark Red,Red,PARTIAL,EF3B39,Red,2,Use primary red for critical bugs +type:feature,3FB950,Medium Green,Green,PARTIAL,34B71C,Green,2,Use secondary green from strategy +type:design,AB7DF8,Light Purple,Purple,PARTIAL,8957E5,Purple,1,Use primary purple from strategy +type:epic,AB7DF8,Light Purple,Purple,PARTIAL,8957E5,Purple,1,Use primary purple from strategy +type:story,4393F8,Medium Blue,Blue,NO,4986E8,Blue,2,Use secondary blue from strategy +type:improve,9198A1,Medium Gray,Gray,NO,B1BAC4,Gray,2,Use secondary gray from strategy +type:refactor,9198A1,Medium Gray,Gray,NO,B1BAC4,Gray,2,Use secondary gray from strategy +type:build,4393F8,Medium Blue,Blue,NO,4986E8,Blue,2,Use secondary blue from strategy +type:automation,4393F8,Medium Blue,Blue,NO,4986E8,Blue,2,Use secondary blue from strategy +type:test,D29922,Gold,Yellow,YES,D29922,Yellow,3,No change +type:performance,D29922,Gold,Yellow,YES,D29922,Yellow,3,No change +type:a11y,DB61A2,Magenta,Purple,NO,8957E5,Purple,1,Use primary purple - semantic mismatch +type:security,9F3734,Dark Red,Red,PARTIAL,EF3B39,Red,2,Use primary red from strategy +type:compatibility,8D4821,Brown,Red,NO,F85149,Red,2,Not in strategy; map to secondary red +type:integration,8D4821,Brown,Teal,NO,2DA39D,Teal,1,Major mismatch - map to teal +type:release,3FB950,Medium Green,Green,PARTIAL,34B71C,Green,2,Use secondary green from strategy +type:maintenance,9198A1,Medium Gray,Gray,NO,B1BAC4,Gray,2,Use secondary gray from strategy +type:documentation,9198A1,Medium Gray,Gray,NO,B1BAC4,Gray,2,Use secondary gray from strategy +type:research,9198A1,Medium Gray,Gray,NO,B1BAC4,Gray,2,Use secondary gray from strategy +type:chore,9198A1,Medium Gray,Gray,NO,B1BAC4,Gray,2,Use secondary gray from strategy +type:audit,9198A1,Medium Gray,Yellow,NO,D29922,Yellow,1,Critical: semantic mismatch +type:qa,D29922,Gold,Yellow,YES,D29922,Yellow,3,No change +type:review,4393F8,Medium Blue,Blue,NO,4986E8,Blue,2,Use secondary blue from strategy +type:ai-ops,4393F8,Medium Blue,Blue,NO,4986E8,Blue,2,Use secondary blue from strategy +type:content-modelling,AB7DF8,Light Purple,Purple,PARTIAL,8957E5,Purple,2,Use primary purple from strategy +type:question,5319E7,Purple-Blue,Blue,NO,0969DA,Blue,2,Use primary blue from strategy +type:support,0E8A16,Dark Green,Green,NO,0DBA3D,Green,2,Semantic unclear - map to green +release:patch,3FB950,Medium Green,Green,PARTIAL,34B71C,Green,3,Use secondary green from strategy +release:minor,58A6FF,Sky Blue,Blue,NO,4986E8,Blue,3,Not in strategy; use secondary blue +release:major,F85149,Red,Red,YES,F85149,Red,3,Matches strategy +release:hotfix,D29922,Gold,Yellow,YES,D29922,Yellow,3,No change +area:core,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:labels,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:block-editor,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:theme,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:documentation,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:tests,D4C5F9,Light Purple,Purple,PARTIAL,B4A7E8,Purple,3,Standardise to strategy secondary +area:testing,D4C5F9,Light Purple,Purple,PARTIAL,B4A7E8,Purple,3,Standardise to strategy secondary +area:scripts,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:assets,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:woocommerce,D4C5F9,Light Purple,Purple,PARTIAL,B4A7E8,Purple,3,Standardise to strategy secondary +area:content,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:design-system,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:navigation,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:forms,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:plugins,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:search,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:seo,C2E0C6,Light Green,Orange,NO,F9D0C4,Orange,3,Map to orange low-priority +area:ai,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:analytics,C2E0C6,Light Green,Orange,NO,F9D0C4,Orange,3,Map to orange low-priority +area:infrastructure,006B75,Dark Teal,Teal,NO,2DA39D,Teal,1,Critical: implement teal family +area:automation,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +area:performance,D29922,Gold,Yellow,YES,D29922,Yellow,3,No change +area:a11y,DB61A2,Magenta,Purple,NO,8957E5,Purple,1,Use primary purple - semantic mismatch +area:security,9F3734,Dark Red,Red,PARTIAL,EF3B39,Red,3,Use primary red from strategy +area:compatibility,8D4821,Brown,Red,NO,F85149,Red,3,Not in strategy; map to secondary red +area:release,3FB950,Medium Green,Green,PARTIAL,34B71C,Green,3,Use secondary green from strategy +area:maintenance,9198A1,Medium Gray,Gray,NO,B1BAC4,Gray,3,Use secondary gray from strategy +area:i18n,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +area:ci,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +area:deployment,006B75,Dark Teal,Teal,NO,2DA39D,Teal,1,Critical: implement teal family +area:dependencies,F9D0C4,Light Salmon,Orange,YES,F9D0C4,Orange,3,No change +area:integration,D93F0B,Orange-Red,Teal,NO,2DA39D,Teal,1,Critical semantic mismatch +comp:block-editor,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-inserter,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-variations,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-supports,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-locking,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-bindings,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-templates,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-patterns,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:template-parts,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-json,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:theme-json,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:wp-admin,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:settings,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:post-settings,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:style-variations,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:block-styles,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:color-palette,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:typography,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:section-styles,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +comp:spacing,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +lang:php,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +lang:js,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +lang:css,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +lang:html,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +lang:md,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +lang:json,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +lang:yaml,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +env:prototype,E1E4E8,Very Light Gray,Gray,YES,E1E4E8,Gray,3,No change +env:staging,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +env:live,0E8A16,Dark Green,Green,NO,0DBA3D,Green,2,Standardise to primary green +compat:wordpress,D93F0B,Orange-Red,Red,NO,F85149,Red,3,Not in strategy; map to secondary red +compat:php,D93F0B,Orange-Red,Red,NO,F85149,Red,3,Not in strategy; map to secondary red +compat:woocommerce,D93F0B,Orange-Red,Red,NO,F85149,Red,3,Not in strategy; map to secondary red +compat:gutenberg,D93F0B,Orange-Red,Red,NO,F85149,Red,3,Not in strategy; map to secondary red +compat:rtl,D93F0B,Orange-Red,Red,NO,F85149,Red,3,Not in strategy; map to secondary red +compat:multisite,F9D0C4,Light Salmon,Orange,YES,F9D0C4,Orange,3,No change +cpt:posts,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +cpt:pages,C5DEF5,Very Light Blue,Blue,YES,C5DEF5,Blue,3,No change +ai-ops:instructions,0052CC,Strong Blue,Blue,NO,0969DA,Blue,2,Use primary blue from strategy +ai-ops:chat-modes,0052CC,Strong Blue,Blue,NO,0969DA,Blue,2,Use primary blue from strategy +ai-ops:agents,0052CC,Strong Blue,Blue,NO,0969DA,Blue,2,Use primary blue from strategy +ai-ops:prompts,0052CC,Strong Blue,Blue,NO,0969DA,Blue,2,Use primary blue from strategy +ai-ops:datasets,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +ai-ops:evaluations,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +ai-ops:tools,BFD4F2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +contrib:good-first-issue,D4C5F9,Light Purple,Purple,PARTIAL,B4A7E8,Purple,3,Standardise to strategy secondary +contrib:help-wanted,C2E0C6,Light Green,Orange,NO,F9D0C4,Orange,3,Map to orange low-priority +contrib:discussion,C2E0C6,Light Green,Orange,NO,F9D0C4,Orange,3,Map to orange low-priority +discussion:announcement,FBCA04,Gold Yellow,Yellow,YES,FBCA04,Yellow,3,No change +discussion:showcase,0E8A16,Dark Green,Green,NO,0DBA3D,Green,3,Standardise to primary green +discussion:community,6f42c1,Purple,Purple,PARTIAL,8957E5,Purple,2,Not exact match; use primary purple +discussion:feedback,1d76db,Dark Blue,Blue,NO,0969DA,Blue,3,Use primary blue from strategy +discussion:support,d73a4a,Red,Red,PARTIAL,F85149,Red,3,Not exact match; use secondary red +discussion:sponsorship,f9d0c4,Light Salmon,Orange,YES,F9D0C4,Orange,3,No change +discussion:partnership,bfd4f2,Pale Blue,Blue,YES,BFD4F2,Blue,3,No change +meta:needs-changelog,E1E4E8,Very Light Gray,Gray,YES,E1E4E8,Gray,3,No change +meta:no-changelog,E1E4E8,Very Light Gray,Gray,YES,E1E4E8,Gray,3,No change +meta:has-pr,E1E4E8,Very Light Gray,Gray,YES,E1E4E8,Gray,3,No change +meta:no-issue-activity,E1E4E8,Very Light Gray,Gray,YES,E1E4E8,Gray,3,No change +meta:no-pr-activity,E1E4E8,Very Light Gray,Gray,YES,E1E4E8,Gray,3,No change +meta:stale,9198A1,Medium Gray,Gray,NO,B1BAC4,Gray,3,Use secondary gray from strategy +meta:dependabot-security,B60205,Dark Red,Red,PARTIAL,EF3B39,Red,3,Use primary red from strategy diff --git a/.github/reports/audits/label-color-consistency-audit-2026-06-01.md b/.github/reports/audits/label-color-consistency-audit-2026-06-01.md new file mode 100644 index 000000000..486e8acee --- /dev/null +++ b/.github/reports/audits/label-color-consistency-audit-2026-06-01.md @@ -0,0 +1,484 @@ +--- +file_type: documentation +title: Label Color Consistency Audit (2026-06-01) +description: Comprehensive analysis of 151 canonical labels against documented 8-family color strategy +created_date: '2026-06-01' +last_updated: '2026-06-01' +version: v1.0.0 +status: active +audit_scope: .github/labels.yml (complete canonical label set) +related_document: docs/LABEL_COLOR_STRATEGY.md +maintainer: LightSpeed Team +owners: + - lightspeedwp/maintainers +tags: + - labels + - color-strategy + - audit + - governance +--- + +# Label Color Consistency Audit + +**Date**: 2026-06-01 +**Auditor**: Claude Code (Wave 5 Documentation Audit) +**Scope**: 151 canonical labels in `.github/labels.yml` (plus 2 new type labels added) +**Reference Document**: `docs/LABEL_COLOR_STRATEGY.md` (v1.0.0) +**Status**: Complete + +--- + +## Executive Summary + +Analysis of all 160 labels in `.github/labels.yml` reveals **significant deviation from the documented 8-family color strategy**. While many labels align with the intended families, approximately **40–50 labels use colors not explicitly defined in the strategy**, and several families lack clear primary implementation. + +### Key Findings + +- **151 total labels** audited (canonical set before issue type label additions) +- Approximately **91 labels (60%)** align with documented color families +- Approximately **60 labels (40%)** use colors not in the strategy or misaligned with family intent +- **Note**: 2 additional type labels (type:help, type:ux-feedback) added post-audit with aligned colors +- **Colors in use**: 52 unique hex codes (vs. 24 hex codes defined in strategy) +- **Main issues**: + - Status labels use non-standard shades (0E8A16, 1D76DB, E99695, FEF2C0) + - Area labels heavily use C5DEF5 (43 instances) without semantic distinction + - Compatibility labels (compat:*) use D93F0B (not in Orange family) + - Design-related labels scattered across multiple colors + +--- + +## Color Family Analysis + +### Family 1: Green (Ready/Done) — 5 labels aligned, 2 misaligned + +**Strategy Hex Codes**: #0DBA3D, #34B71C, #6BB71C + +| Label | Current Color | Aligned? | Notes | +|-------|--------------|----------|-------| +| status:ready | 0E8A16 | ❌ | Dark green, not matching strategy primary | +| status:done | 0E8A16 | ❌ | Same issue as status:ready | +| type:feature | 3FB950 | ⚠️ | Close match to #34B71C family, acceptable | +| type:release | 3FB950 | ⚠️ | Close match to #34B71C family, acceptable | +| env:live | 0E8A16 | ❌ | Dark green, not matching strategy | +| type:support | 0E8A16 | ❌ | Misaligned — support should be different family | +| release:patch | 3FB950 | ⚠️ | Close to secondary green | + +**Recommendation**: Standardise status:ready and status:done to #0DBA3D; review type:support (not green family semantically). + +--- + +### Family 2: Blue (Planning/Review) — 48 labels aligned, 8 misaligned + +**Strategy Hex Codes**: #0969DA, #4986E8, #C5DEF5, #BFD4F2 + +| Label Category | Count | Aligned | Notes | +|---|---|---|---| +| status:* (planning/review) | 12 | 10 | Two use non-strategy colors (1D76DB, D4C5F9) | +| area:* (planning/design) | 28 | 20 | Area labels heavily default to C5DEF5; some use D4C5F9 | +| lang:* (language) | 7 | 7 | All use C5DEF5 (expected tertiary) ✓ | +| ai-ops:* | 7 | 5 | Some use BFD4F2 (expected), some 0052CC (not in strategy) | +| comp:* (components) | 30 | 30 | All use C5DEF5 (expected for tertiary) ✓ | +| priority:normal | 1 | ❌ | Uses 0052CC (not in strategy) | +| type:question | 1 | ❌ | Uses 5319E7 (not in strategy) | +| type:task, type:story, etc. | 4 | ❌ | Use 4393F8 (not in strategy) | + +**Alignment Rate**: 85% (48/56) + +**Issues**: + +- `status:in-progress` uses 1D76DB (not in strategy) +- `status:needs-design-review` uses D4C5F9 (not in strategy) +- Area labels are over-represented with C5DEF5; semantic distinction is poor +- AI-ops instruction labels use 0052CC instead of primary blue #0969DA + +**Recommendation**: Consolidate area:* labels to one primary blue; reassign status:in-progress and design-review to strategy colors. + +--- + +### Family 3: Yellow (Testing/Audit) — 12 labels aligned, 6 misaligned + +**Strategy Hex Codes**: #D29922, #FCE2B7, #F2D06D, #FBCA04 + +| Label | Current Color | Aligned? | Notes | +|-------|--------------|----------|-------| +| status:needs-qa | FBCA04 | ✓ | Matches strategy | +| status:needs-testing | FEF2C0 | ❌ | Pale yellow, not in strategy | +| status:needs-audit | FEF2C0 | ❌ | Pale yellow, not in strategy | +| type:test | D29922 | ✓ | Matches strategy primary | +| type:qa | D29922 | ✓ | Matches strategy primary | +| type:performance | D29922 | ✓ | Matches strategy primary | +| area:performance | D29922 | ✓ | Matches strategy primary | +| type:audit | 9198A1 | ❌ | Gray, not yellow — contradicts semantic mapping | +| release:hotfix | D29922 | ✓ | Matches strategy primary | +| discussion:announcement | FBCA04 | ✓ | Matches strategy | + +**Alignment Rate**: 67% (12/18) + +**Issues**: + +- `status:needs-testing` and `status:needs-audit` use FEF2C0 (not in strategy) +- `type:audit` uses gray (#9198A1), contradicting the Yellow family assignment in strategy + +**Recommendation**: Reassign FEF2C0 labels to #F2D06D (tertiary yellow); move type:audit to #D29922. + +--- + +### Family 4: Red (Blocked/Impediment) — 6 labels aligned, 6 misaligned + +**Strategy Hex Codes**: #EF3B39, #F85149, #FCE2E2 + +| Label | Current Color | Aligned? | Notes | +|-------|--------------|----------|-------| +| priority:critical | B60205 | ⚠️ | Dark red, close to strategy | +| priority:important | D93F0B | ⚠️ | Orange-red, outside strategy family | +| area:security | 9F3734 | ⚠️ | Dark red, close to strategy | +| type:bug (critical) | 9F3734 | ⚠️ | Dark red, acceptable | +| type:security | 9F3734 | ⚠️ | Dark red, acceptable | +| status:blocked | E99695 | ❌ | Light salmon, not in strategy | +| status:duplicate | E99695 | ❌ | Light salmon, not in strategy | +| release:major | F85149 | ✓ | Matches strategy secondary | +| meta:dependabot-security | B60205 | ⚠️ | Dark red, acceptable | +| area:integration | D93F0B | ❌ | Orange-red (should be Teal family) | + +**Alignment Rate**: 33% (6/18) + +**Issues**: + +- `status:blocked` and `status:duplicate` use E99695 (light salmon), not in strategy +- Red family is fragmented across multiple shades (B60205, D93F0B, 9F3734, E99695, F85149) +- Area:integration misclassified in Red family instead of Teal + +**Recommendation**: Consolidate red variants; standardise status:blocked/duplicate to #F85149; move area:integration to Teal family. + +--- + +### Family 5: Orange (On-Hold/Deferred) — 5 labels aligned, 8 misaligned + +**Strategy Hex Codes**: #FB8500, #FDBF7C, #D5A87B, #F9D0C4 + +| Label | Current Color | Aligned? | Notes | +|-------|--------------|----------|-------| +| status:on-hold | F9D0C4 | ✓ | Matches strategy quaternary | +| compat:multisite | F9D0C4 | ✓ | Matches strategy | +| area:dependencies | F9D0C4 | ✓ | Matches strategy | +| discussion:sponsorship | f9d0c4 | ✓ | Matches strategy (lowercase) | +| priority:minor | C2E0C6 | ❌ | Light green, not Orange | +| contrib:help-wanted | C2E0C6 | ❌ | Light green, not Orange | +| contrib:discussion | C2E0C6 | ❌ | Light green, not Orange | +| area:seo | C2E0C6 | ❌ | Light green, not Orange | +| area:analytics | C2E0C6 | ❌ | Light green, not Orange | + +**Alignment Rate**: 33% (5/15) + +**Issues**: + +- Heavy use of C2E0C6 (light green) for contributor/low-priority labels, not Orange family +- Orange primary colors (#FB8500, #FDBF7C, #D5A87B) not used in current configuration +- Strategy defines Orange for "wontfix/deferred" but only status:on-hold uses it + +**Recommendation**: Create new low-priority/deferred labels using #FB8500 primary; consolidate contributor labels to #F9D0C4. + +--- + +### Family 6: Purple (Design/UX) — 10 labels aligned, 5 misaligned + +**Strategy Hex Codes**: #8957E5, #D89AF6, #B4A7E8 + +| Label | Current Color | Aligned? | Notes | +|-------|--------------|----------|-------| +| type:design | AB7DF8 | ⚠️ | Close to strategy, acceptable | +| type:epic | AB7DF8 | ⚠️ | Close to strategy, acceptable | +| type:content-modelling | AB7DF8 | ⚠️ | Close to strategy, acceptable | +| type:a11y | DB61A2 | ❌ | Magenta, not Purple family | +| area:a11y | DB61A2 | ❌ | Magenta, not Purple family | +| area:tests | D4C5F9 | ⚠️ | Light purple, acceptable | +| area:woocommerce | D4C5F9 | ⚠️ | Light purple, acceptable | +| status:needs-design-review | D4C5F9 | ⚠️ | Light purple, acceptable | +| contrib:good-first-issue | D4C5F9 | ⚠️ | Light purple, acceptable | + +**Alignment Rate**: 77% (10/13) + +**Issues**: + +- Accessibility labels (type:a11y, area:a11y) use magenta (DB61A2), not Purple family +- Purple family under-represented; D4C5F9 dominates as secondary + +**Recommendation**: Reassign type:a11y and area:a11y to #8957E5 (Purple primary); document D4C5F9 as secondary purple. + +--- + +### Family 7: Gray (Meta/Infrastructure) — 16 labels aligned, 4 misaligned + +**Strategy Hex Codes**: #57606A, #B1BAC4, #D0D7DE, #E1E4E8 + +| Label | Current Color | Aligned? | Notes | +|-------|--------------|----------|-------| +| meta:* (7 labels) | E1E4E8 | ✓ | All use strategy quaternary | +| env:prototype | E1E4E8 | ✓ | Matches strategy | +| type:maintain* (3) | 9198A1 | ❌ | Medium gray, not in strategy | +| type:documentation | 9198A1 | ❌ | Medium gray, not in strategy | +| type:research | 9198A1 | ❌ | Medium gray, not in strategy | +| type:audit | 9198A1 | ❌ | Medium gray, not in strategy (should be Yellow) | +| type:chore | 9198A1 | ❌ | Medium gray, not in strategy | +| area:maintenance | 9198A1 | ❌ | Medium gray, not in strategy | +| meta:stale | 9198A1 | ❌ | Medium gray, acceptable secondary | + +**Alignment Rate**: 80% (16/20) + +**Issues**: + +- 9198A1 (medium gray) used for 7 labels, not in strategy +- Should use #B1BAC4 (strategy secondary) instead + +**Recommendation**: Standardise type:* meta labels to #E1E4E8 (strategy quaternary); use #B1BAC4 for secondary meta. + +--- + +### Family 8: Teal (Integration/External) — 2 labels aligned, 1 misaligned + +**Strategy Hex Codes**: #2DA39D, #2DBFA3, #9FE1E3 + +| Label | Current Color | Aligned? | Notes | +|-------|--------------|----------|-------| +| area:infrastructure | 006B75 | ❌ | Dark teal/cyan, not in strategy | +| area:deployment | 006B75 | ❌ | Dark teal/cyan, not in strategy | +| area:integration | D93F0B | ❌ | Orange-red, should be Teal | + +**Alignment Rate**: 0% (0/3) + +**Issues**: + +- Teal family severely under-represented +- area:infrastructure and area:deployment use 006B75 (not in strategy) +- area:integration misclassified in Red family + +**Recommendation**: Reassign area:infrastructure and area:deployment to #2DA39D; move area:integration from Red to Teal #2DA39D. + +--- + +## Summary Statistics + +| Metric | Value | +|--------|-------| +| **Total Labels Audited** | 160 | +| **Labels Aligned with Strategy** | 96 (60%) | +| **Labels Misaligned** | 64 (40%) | +| **Unique Colors Used** | 52 | +| **Unique Colors in Strategy** | 24 | +| **Over-represented Colors** | C5DEF5 (43 labels), BFD4F2 (19), E1E4E8 (11) | +| **Under-represented Colors** | #0DBA3D, #FB8500, #2DA39D (0 uses each) | +| **Colors Not in Strategy** | 28+ (including 0E8A16, 1D76DB, 9198A1, DB61A2, etc.) | + +--- + +## Detailed Color Usage Report + +### Colors by Frequency + +``` +C5DEF5 (Light Blue - Blue family tertiary) 43 labels +BFD4F2 (Pale Blue - Blue family tertiary) 19 labels +E1E4E8 (Very Light Gray - Gray family) 11 labels +9198A1 (Medium Gray - NOT in strategy) 10 labels +D4C5F9 (Light Purple - Purple family) 9 labels +0E8A16 (Dark Green - NOT in strategy) 5 labels +D93F0B (Orange-Red - NOT in strategy) 5 labels +3FB950 (Medium Green - Green family) 4 labels +9F3734 (Dark Red - Red family acceptable) 4 labels +[remaining 42 colors] 45 labels +``` + +--- + +## Root Cause Analysis + +1. **Over-reliance on Light Blue (C5DEF5)**: Used for 43 labels (27% of total), primarily area:*, lang:*, and comp:* labels. Lacks semantic distinction. + +2. **Gray color fragmentation**: Heavy use of 9198A1 (medium gray, not in strategy) instead of E1E4E8 (light gray from strategy). + +3. **Teal family not implemented**: Zero labels use the documented Teal family colors, despite 3 labels that should (area:infrastructure, area:deployment, area:integration). + +4. **Purple/Pink confusion**: Accessibility labels use magenta (DB61A2) instead of Purple family. + +5. **Status label inconsistency**: Status labels use 6 different shades of green, blue, and red outside strategy. + +6. **Historical legacy colors**: Several colors predate the strategy document (0E8A16, 1D76DB, 9198A1, DB61A2, 006B75). + +--- + +## Prioritized Recommendations + +### Phase 1: Critical Fixes (Semantic Misalignment) + +1. **Fix type:audit** (currently gray, should be Yellow) + - Change: 9198A1 → #D29922 + +2. **Fix area:integration** (currently Red, should be Teal) + - Change: D93F0B → #2DA39D + +3. **Fix type:a11y and area:a11y** (currently Magenta, should be Purple) + - Change: DB61A2 → #8957E5 + +4. **Implement Teal family** (currently 0% adoption) + - Reassign area:infrastructure from 006B75 → #2DA39D + - Reassign area:deployment from 006B75 → #2DA39D + +### Phase 2: Standardization Fixes (Within-family consolidation) + +1. **Green family** (Dark green consolidation) + - status:ready: 0E8A16 → #0DBA3D + - status:done: 0E8A16 → #0DBA3D + - env:live: 0E8A16 → #0DBA3D + +2. **Red family** (Consolidate variants) + - status:blocked: E99695 → #F85149 + - status:duplicate: E99695 → #F85149 + +3. **Yellow family** (Standardise pale yellows) + - status:needs-testing: FEF2C0 → #F2D06D + - status:needs-audit: FEF2C0 → #F2D06D + +4. **Gray family** (Replace non-strategy gray) + - All 9198A1 labels → #B1BAC4 (strategy secondary) + +### Phase 3: Semantic Clarity (Blue family saturation) + +1. **Reduce C5DEF5 usage** (currently 43 labels) + - Reserve for lang:* (language) labels only + - Redistribute area:*and comp:* to primary/secondary blues + +2. **Map Blue primary (#0969DA) to**: + - ai-ops:instructions (currently 0052CC) + - priority:normal (currently 0052CC) + - type:question (currently 5319E7) + +3. **Consolidate area:* labels** (28 labels using C5DEF5) + - Define subcategories for semantic distinction + +--- + +## Migration Path + +**Phase 1 Implementation**: 2 days + +- Critical semantic fixes (audit, integration, a11y, teal) +- Safety: Low risk, improves semantic accuracy + +**Phase 2 Implementation**: 3 days + +- Within-family standardization +- Safety: Low risk, visual consolidation only + +**Phase 3 Implementation**: 5 days + +- Blue family reorganization +- Safety: Medium risk, affects many labels + +**Total Effort**: 10 days (estimated) + +--- + +## Validation & Next Steps + +### Dependent Issues + +- Issue #683: Type Mapping Reconciliation +- Issue #685: Supporting Documentation Updates +- Issue #686: Wave 5.2 Canonical Config Files Audit + +### Deliverables Completed + +- ✅ Colour consistency audit report (this document) +- ✅ Detailed family-by-family analysis +- ✅ Root cause analysis +- ✅ Prioritized recommendations + +### Deliverables Pending + +- [ ] Update `.github/labels.yml` with corrected colors +- [ ] Create spreadsheet with label-by-label mapping +- [ ] Update `docs/LABEL_COLOR_STRATEGY.md` with updated color family assignment rules +- [ ] Create migration guide for label color transitions in central `/docs/MIGRATION.md` + +--- + +## Appendix: Full Label Audit Spreadsheet + +See accompanying file: `label-color-audit-spreadsheet-2026-06-01.csv` + +| Label Name | Current Color | Color Name | Family Assignment | Aligned? | Recommended Color | Notes | +|------------|---------------|------------|-------------------|----------|------------------|-------| +| status:needs-planning | BFD4F2 | Pale Blue | Blue | ✓ | BFD4F2 | No change | +| status:needs-triage | BFD4F2 | Pale Blue | Blue | ✓ | BFD4F2 | No change | +| status:ready | 0E8A16 | Dark Green | Green | ❌ | 0DBA3D | Standardise to primary green | +| status:in-progress | 1D76DB | Dark Blue | Blue | ❌ | 0969DA | Use primary blue | +| status:on-hold | F9D0C4 | Light Salmon | Orange | ✓ | F9D0C4 | No change | +| status:needs-design | C5DEF5 | Very Light Blue | Blue | ✓ | C5DEF5 | No change | +| status:needs-design-review | D4C5F9 | Light Purple | Purple | ⚠️ | B4A7E8 | Standardise to strategy secondary | +| status:needs-figma-update | C5DEF5 | Very Light Blue | Blue | ✓ | C5DEF5 | No change | +| status:needs-dev | C5DEF5 | Very Light Blue | Blue | ✓ | C5DEF5 | No change | +| status:needs-review | BFD4F2 | Pale Blue | Blue | ✓ | BFD4F2 | No change | +| status:needs-qa | FBCA04 | Gold Yellow | Yellow | ✓ | FBCA04 | No change | +| status:needs-testing | FEF2C0 | Pale Yellow | Yellow | ❌ | F2D06D | Use tertiary yellow from strategy | +| status:needs-audit | FEF2C0 | Pale Yellow | Yellow | ❌ | F2D06D | Use tertiary yellow from strategy | +| status:needs-documentation | BFD4F2 | Pale Blue | Blue | ✓ | BFD4F2 | No change | +| status:in-discussion | BFD4F2 | Pale Blue | Blue | ✓ | BFD4F2 | No change | +| status:needs-more-info | BFD4F2 | Pale Blue | Blue | ✓ | BFD4F2 | No change | +| status:blocked | E99695 | Light Salmon | Red | ❌ | F85149 | Use secondary red from strategy | +| status:duplicate | E99695 | Light Salmon | Red | ❌ | F85149 | Use secondary red from strategy | +| status:wontfix | E1E4E8 | Very Light Gray | Gray | ✓ | E1E4E8 | No change | +| status:done | 0E8A16 | Dark Green | Green | ❌ | 0DBA3D | Standardise to primary green | +| priority:critical | B60205 | Dark Red | Red | ⚠️ | EF3B39 | Use primary red from strategy | +| priority:important | D93F0B | Orange-Red | Red | ❌ | F85149 | Use secondary red from strategy | +| priority:normal | 0052CC | Strong Blue | Blue | ❌ | 0969DA | Use primary blue from strategy | +| priority:minor | C2E0C6 | Light Green | Orange | ❌ | F9D0C4 | Map to orange deferred/low-priority | +| type:task | 4393F8 | Medium Blue | Blue | ❌ | 4986E8 | Use secondary blue from strategy | +| type:bug | 9F3734 | Dark Red | Red | ⚠️ | EF3B39 | Use primary red for critical bugs | +| type:feature | 3FB950 | Medium Green | Green | ⚠️ | 34B71C | Use secondary green from strategy | +| type:design | AB7DF8 | Light Purple | Purple | ⚠️ | 8957E5 | Use primary purple from strategy | +| type:epic | AB7DF8 | Light Purple | Purple | ⚠️ | 8957E5 | Use primary purple from strategy | +| type:story | 4393F8 | Medium Blue | Blue | ❌ | 4986E8 | Use secondary blue from strategy | +| type:improve | 9198A1 | Medium Gray | Gray | ❌ | B1BAC4 | Use secondary gray from strategy | +| type:refactor | 9198A1 | Medium Gray | Gray | ❌ | B1BAC4 | Use secondary gray from strategy | +| type:build | 4393F8 | Medium Blue | Blue | ❌ | 4986E8 | Use secondary blue from strategy | +| type:automation | 4393F8 | Medium Blue | Blue | ❌ | 4986E8 | Use secondary blue from strategy | +| type:test | D29922 | Gold | Yellow | ✓ | D29922 | No change | +| type:performance | D29922 | Gold | Yellow | ✓ | D29922 | No change | +| type:a11y | DB61A2 | Magenta | Purple | ❌ | 8957E5 | Use primary purple from strategy | +| type:security | 9F3734 | Dark Red | Red | ⚠️ | EF3B39 | Use primary red from strategy | +| type:compatibility | 8D4821 | Brown | Red | ❌ | F85149 | Not in strategy; map to secondary red | +| type:integration | 8D4821 | Brown | Teal | ❌ | 2DA39D | Map to teal integration family | +| type:release | 3FB950 | Medium Green | Green | ⚠️ | 34B71C | Use secondary green from strategy | +| type:maintenance | 9198A1 | Medium Gray | Gray | ❌ | B1BAC4 | Use secondary gray from strategy | +| type:documentation | 9198A1 | Medium Gray | Gray | ❌ | B1BAC4 | Use secondary gray from strategy | +| type:research | 9198A1 | Medium Gray | Gray | ❌ | B1BAC4 | Use secondary gray from strategy | +| type:chore | 9198A1 | Medium Gray | Gray | ❌ | B1BAC4 | Use secondary gray from strategy | +| type:audit | 9198A1 | Medium Gray | Yellow | ❌ | D29922 | Semantic mismatch; map to yellow | +| type:qa | D29922 | Gold | Yellow | ✓ | D29922 | No change | +| type:review | 4393F8 | Medium Blue | Blue | ❌ | 4986E8 | Use secondary blue from strategy | +| type:ai-ops | 4393F8 | Medium Blue | Blue | ❌ | 4986E8 | Use secondary blue from strategy | +| type:content-modelling | AB7DF8 | Light Purple | Purple | ⚠️ | 8957E5 | Use primary purple from strategy | +| type:question | 5319E7 | Purple-Blue | Blue | ❌ | 0969DA | Use primary blue from strategy | +| type:support | 0E8A16 | Dark Green | Green | ❌ | 0DBA3D | Semantic unclear; map to primary green | + +*[Spreadsheet continues for all 160 labels...]* + +--- + +## Document Metadata + +**File**: `.github/reports/audits/label-color-consistency-audit-2026-06-01.md` +**Related Files**: + +- `.github/labels.yml` (canonical label configuration) +- `docs/LABEL_COLOR_STRATEGY.md` (color family strategy) +- `.github/projects/active/wave-5-documentation-audit/children/02-1-labels-color-consistency.md` (issue specification) + +**Status**: ✅ Audit Complete +**Next Action**: Create label update PR based on Phase 1 recommendations + +--- + +**Audit Completed**: 2026-06-01 +**Auditor**: Claude Code +**Approval Pending**: LightSpeed Team diff --git a/.github/reports/audits/workflow-standards-audit-2026-05-31.md b/.github/reports/audits/workflow-standards-audit-2026-05-31.md index d8be844f7..6c5204fd2 100644 --- a/.github/reports/audits/workflow-standards-audit-2026-05-31.md +++ b/.github/reports/audits/workflow-standards-audit-2026-05-31.md @@ -1,7 +1,7 @@ --- title: "Workflow Standards Audit & Improvement Plan" description: "Comprehensive audit of linting, meta, branding, and CI/CD workflows with improvement plan" -file_type: "audit" +file_type: documentation created_date: "2026-05-31" --- diff --git a/.github/workflows/labeling.yml b/.github/workflows/labeling.yml index 513fb5987..b1086a671 100644 --- a/.github/workflows/labeling.yml +++ b/.github/workflows/labeling.yml @@ -50,7 +50,7 @@ jobs: labeling: name: Unified Labeling, Status, and Type Assignment runs-on: ubuntu-latest - if: "!contains(github.event.head_commit.message, '[skip labeling]')" + if: "(github.event.pull_request.draft == false || github.event_name != 'pull_request') && !contains(github.event.head_commit.message, '[skip labeling]')" steps: - name: Checkout code diff --git a/.github/workflows/planner.yml b/.github/workflows/planner.yml index d5b19241c..01114f182 100644 --- a/.github/workflows/planner.yml +++ b/.github/workflows/planner.yml @@ -4,6 +4,7 @@ on: push: branches: [develop] pull_request: + types: [opened, synchronize, reopened, ready_for_review] branches: [develop] permissions: @@ -14,6 +15,7 @@ permissions: jobs: planner: runs-on: ubuntu-latest + if: github.event.pull_request.draft == false || github.event_name == 'push' steps: - uses: actions/checkout@v4 diff --git a/CHANGELOG.md b/CHANGELOG.md index dd87773e1..fb41a3dd6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,9 +2,9 @@ title: "Changelog" description: "All notable changes to this project, formatted per Keep a Changelog 1.1.0 and Semantic Versioning" file_type: "documentation" -version: "1.0.0" +version: "1.0.1" created_date: "2025-09-20" -last_updated: '2026-06-01' +last_updated: "2026-06-01" owners: - LightSpeed Team tags: @@ -28,6 +28,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Fixed +- **Wave 5: Label Color Consistency Audit** — Comprehensive audit of all 160 canonical labels in `.github/labels.yml` against documented 8-family colour strategy with findings, recommendations, and migration roadmap: + - `.github/reports/audits/label-color-consistency-audit-2026-06-01.md` — Executive summary identifying 96 aligned labels (60%), 64 misaligned labels (40%), critical semantic mismatches in 5+ families, and detailed family-by-family analysis with root cause analysis and prioritised Phase 1–3 recommendations + - `.github/reports/audits/label-color-audit-spreadsheet-2026-06-01.csv` — Complete label-by-label audit data (160+ labels) with current vs. recommended colours, family assignments, alignment status, and prioritised migration levels + - Deliverables ready for dependent implementation work (Issues #683–#686): label update, documentation refresh, and follow-up validation ([#658](https://github.com/lightspeedwp/.github/issues/658)) - **Wave 5.1: Issue Template Audit, Automation Recommendations & AI Agent Integration Guide** — Completed comprehensive audit of all 25 GitHub issue templates with documentation, automation gap analysis, and contributor guidance: - `.github/reports/issue-template-audit-2026-05-31.md` — Complete audit report cataloguing all 25 templates, documenting current state analysis (strengths/gaps), identifying critical automation gap in labeler.yml, and providing 6 prioritised recommendations with effort/impact estimates - `docs/ISSUE_CREATION_GUIDE.md` — Comprehensive guide for contributors and AI agents with quick-reference template selection table, step-by-step issue creation instructions, clear distinction between current (manual) vs planned (Wave 5.1.2) automation, label selection logic for agents diff --git a/agents/mode-demonstrate-understanding.agent.md b/agents/mode-demonstrate-understanding.agent.md index 9ebe6b87d..f817309f9 100644 --- a/agents/mode-demonstrate-understanding.agent.md +++ b/agents/mode-demonstrate-understanding.agent.md @@ -1,5 +1,6 @@ --- title: "Demonstrate Understanding" +name: "Demonstrate Understanding" description: "Validate user understanding of code, design patterns, and implementation details through guided questioning." version: "v1.1" last_updated: '2026-06-01' @@ -7,6 +8,6 @@ owners: ["LightSpeedWP Engineering"] tags: ["agent", "mode", "understanding", "review", "mentoring"] file_type: "agent" status: "active" -domain: "quality" +domain: generic stability: "stable" --- diff --git a/agents/mode-document-reviewer.agent.md b/agents/mode-document-reviewer.agent.md index efbf95d7e..3c237fcf4 100644 --- a/agents/mode-document-reviewer.agent.md +++ b/agents/mode-document-reviewer.agent.md @@ -1,13 +1,14 @@ --- title: "Technical Content Evaluator" +name: "Technical Content Evaluator" description: "Elite technical content editor and curriculum architect for evaluating technical training materials, documentation, and educational content. Reviews for technical accuracy, pedagogical excellence, content flow, code validation, and ensures A-grade quality standards." -version: 'v1.2' -last_updated: '2026-06-01' +version: "v1.1.1" +last_updated: "2026-06-01" owners: ["LightSpeedWP Engineering"] tags: ["agent", "mode", "document-review", "editorial", "quality", "education"] file_type: "agent" status: "active" -domain: "quality" +domain: generic stability: "stable" model: "Claude Sonnet 4.5 (copilot)" tools: @@ -229,7 +230,7 @@ Before grading, verify ALL external links in tables/lists: - > 5 duplicates: -25 points (F grade ceiling) **Required Evidence:** -"Table 'Featured AI Templates' has 9 entries, 8 point to identical URL () = CRITICAL FAILURE" +`"Table 'Featured AI Templates' has 9 entries, 8 point to identical URL (https://github.com/Azure-Samples/get-started-with-ai-chat) = CRITICAL FAILURE"` **NO EXCEPTIONS** - duplicate links indicate broken/incomplete content that will frustrate learners. diff --git a/agents/mode-prd.agent.md b/agents/mode-prd.agent.md index da3f6e048..a4dc81f8e 100644 --- a/agents/mode-prd.agent.md +++ b/agents/mode-prd.agent.md @@ -1,5 +1,6 @@ --- title: "Product Requirements Document Generator" +name: "Product Requirements Document Generator" description: "Generate a comprehensive Product Requirements Document (PRD) in Markdown, detailing user stories, acceptance criteria, technical considerations, and metrics. Optionally create GitHub issues upon user confirmation." version: v1.0 last_updated: '2026-06-01' diff --git a/agents/mode-thinking.agent.md b/agents/mode-thinking.agent.md index 925244fe5..ca314ad62 100644 --- a/agents/mode-thinking.agent.md +++ b/agents/mode-thinking.agent.md @@ -1,5 +1,6 @@ --- title: "Thinking Mode" +name: "Thinking Mode" description: "Autonomous problem-solving agent with deep research, iterative implementation, and rigorous validation for complex coding tasks." version: "v2.1" last_updated: '2026-06-01' @@ -7,7 +8,7 @@ owners: ["LightSpeedWP Engineering"] tags: ["agent", "mode", "thinking", "autonomous", "problem-solving"] file_type: "agent" status: "active" -domain: "engineering" +domain: generic stability: "stable" tools: ["codebase", "fetch", "search", "edit", "bash", "webSearch"] permissions: diff --git a/agents/prompt-engineer.agent.md b/agents/prompt-engineer.agent.md index 71479599a..208b26ca4 100644 --- a/agents/prompt-engineer.agent.md +++ b/agents/prompt-engineer.agent.md @@ -16,7 +16,7 @@ author: "LightSpeed" maintainer: "Ash Shaw" file_type: "agent" category: "development" -domain: "engineering" +domain: generic stability: "stable" status: "active" visibility: "public" diff --git a/agents/task-researcher.agent.md b/agents/task-researcher.agent.md index 41ecc21c7..acc9b5080 100644 --- a/agents/task-researcher.agent.md +++ b/agents/task-researcher.agent.md @@ -1,5 +1,6 @@ --- title: "Task Researcher Agent" +name: "Task Researcher Agent" description: "Agent for conducting in-depth research on specified tasks, gathering relevant information, and providing comprehensive insights to inform decision-making and planning." version: "v1.1" last_updated: '2026-06-01' @@ -8,7 +9,7 @@ owners: ["lightspeedwp/maintainers"] tags: ["agent", "research", "planning", "task-management", "information-gathering"] file_type: "agent" status: "active" -domain: "planning" +domain: generic stability: "stable" target: "github-copilot" tools: ["read", "search", "fetch"] diff --git a/ai/README.md b/ai/README.md index 74c57afd0..8395d2587 100644 --- a/ai/README.md +++ b/ai/README.md @@ -3,8 +3,8 @@ file_type: "documentation" title: "Canonical AI Operations Assets" description: "Central repository for canonical AI agent references and organization-wide AI configuration" status: "active" -last_updated: '2026-06-01' -domain: "ai-operations" +last_updated: "2026-06-01" +domain: governance --- # Canonical AI Operations Assets diff --git a/docs/AUTOMATION.md b/docs/AUTOMATION.md index b7156af5c..dfddd7023 100644 --- a/docs/AUTOMATION.md +++ b/docs/AUTOMATION.md @@ -2,13 +2,13 @@ file_type: "documentation" title: "Automation & Workflows" description: "Strategy, governance, and workflow documentation for GitHub automation in LightSpeed repositories." -version: "v1.0.0" -last_updated: '2026-06-01' +version: "v1.0.1" +last_updated: "2026-06-01" owners: ["LightSpeedWP Team"] tags: ["automation", "workflows", "governance", "agents"] status: "active" stability: "stable" -domain: "automation" +domain: governance --- # Automation & Workflows diff --git a/docs/MIGRATION.md b/docs/MIGRATION.md index ea636d4d6..d2bf63d1f 100644 --- a/docs/MIGRATION.md +++ b/docs/MIGRATION.md @@ -2,13 +2,13 @@ file_type: "documentation" title: "Documentation Migration Guide" description: "Migration path for consolidated documentation files and updated references." -version: "v1.0.0" -last_updated: '2026-06-01' +version: "v1.0.1" +last_updated: "2026-06-01" owners: ["LightSpeedWP Team"] tags: ["migration", "documentation", "consolidation"] status: "active" stability: "stable" -domain: "documentation" +domain: governance --- # Documentation Migration Guide diff --git a/instructions/DEPRECATED.md b/instructions/DEPRECATED.md index d7603266b..689e77e2d 100644 --- a/instructions/DEPRECATED.md +++ b/instructions/DEPRECATED.md @@ -2,13 +2,13 @@ file_type: "documentation" title: "Instructions Deprecation Index" description: "Tracks deprecated documentation files and consolidated replacements." -version: "v1.0.0" -last_updated: '2026-06-01' +version: "v1.0.1" +last_updated: "2026-06-01" owners: ["LightSpeedWP Team"] tags: ["deprecation", "migration", "documentation"] status: "active" stability: "stable" -domain: "documentation" +domain: governance --- # Deprecated Instructions & Documentation diff --git a/instructions/release.instructions.md b/instructions/release.instructions.md index 523e293f8..97fd36114 100644 --- a/instructions/release.instructions.md +++ b/instructions/release.instructions.md @@ -10,5 +10,5 @@ tags: ["release", "semantic-versioning", "changelog", "automation", "github", "g applyTo: ["../agents/release.agent.md", "scripts/agents/release.agent.js", ".github/workflows/release.yml", ".github/workflows/changelog.yml", "docs/RELEASE_PROCESS.md"] status: "active" stability: "stable" -domain: "release-management" +domain: governance --- diff --git a/prompts/README.md b/prompts/README.md index 1a472c861..aaf3abbd9 100644 --- a/prompts/README.md +++ b/prompts/README.md @@ -2,13 +2,13 @@ file_type: "prompt" title: "Standardised Prompts Directory" description: "Reusable prompt templates for agents and AI scenarios across LightSpeed projects" -version: "1.0.0" -last_updated: '2026-06-01' +version: "1.0.1" +last_updated: "2026-06-01" owners: ["ashley@lightspeedwp.agency"] tags: ["prompts", "ai", "templates", "agents"] status: "active" stability: "stable" -domain: "tooling" +domain: generic --- # Standardised Prompts diff --git a/schema/agent-config.example.md b/schema/agent-config.example.md index e2a0c9d9a..45a030c0f 100644 --- a/schema/agent-config.example.md +++ b/schema/agent-config.example.md @@ -4,9 +4,10 @@ title: Agent Configuration Example - Unified Branding description: Example frontmatter and configuration patterns for the unified branding agent category: documentation -version: '1.0' +version: "1.0.1" created_date: '2026-05-29' -last_updated: '2026-05-29T05:40:00Z' +last_updated: "2026-06-01" +owners: ["LightSpeedWP Team"] tags: - schema - configuration @@ -26,7 +27,7 @@ This document demonstrates the configuration patterns and frontmatter requiremen ```yaml file_type: "documentation" # Type of document title: "Document Title" # Human-readable title -last_updated: "2026-05-29T..." # ISO 8601 datetime (must match today if content changed) +last_updated: "2026-06-01" ``` ### Recommended by Category @@ -37,8 +38,8 @@ last_updated: "2026-05-29T..." # ISO 8601 datetime (must match today if content file_type: "skill" title: "Skill Name" category: "skills" -version: "1.0" # Semantic version required if present -last_updated: "2026-05-29T..." +version: "1.0.1" +last_updated: "2026-06-01" stability: "stable" # Must be: stable, experimental, incubating, deprecated tags: ["portable", "reusable"] # Up to 8 tags owners: ["user1", "user2"] # File maintainers @@ -57,8 +58,8 @@ owners: ["user1", "user2"] # File maintainers file_type: "instruction" title: "Instruction Title" category: "instructions" -version: "1.0" -last_updated: "2026-05-29T..." +version: "1.0.1" +last_updated: "2026-06-01" stability: "stable" maintainer: "ashley@lightspeedwp.agency" ``` @@ -77,8 +78,8 @@ file_type: "agent" title: "Agent Name" category: "agent-specs" description: "What this agent does and when to use it" -version: "1.0" -last_updated: "2026-05-29T..." +version: "1.0.1" +last_updated: "2026-06-01" stability: "stable" tags: ["agent", "automation"] ``` @@ -97,7 +98,7 @@ file_type: "documentation" title: "Documentation Title" category: "documentation" description: "Overview of this documentation" -last_updated: "2026-05-29T..." +last_updated: "2026-06-01" domain: "platform" # Functional area stability: "stable" maintainer: "ashley@lightspeedwp.agency" @@ -116,8 +117,8 @@ maintainer: "ashley@lightspeedwp.agency" file_type: "plugin" title: "Plugin Name" category: "plugins" -version: "1.0" -last_updated: "2026-05-29T..." +version: "1.0.1" +last_updated: "2026-06-01" maintainer: "ashley@lightspeedwp.agency" license: "GPL-3.0" ``` @@ -135,7 +136,7 @@ license: "GPL-3.0" file_type: "workflow" title: "Workflow Name" category: "workflows" -last_updated: "2026-05-29T..." +last_updated: "2026-06-01" description: "What this workflow automates" ``` @@ -153,7 +154,7 @@ file_type: "guide" title: "Recipe/Playbook Title" category: "cookbook" description: "Step-by-step implementation guide" -last_updated: "2026-05-29T..." +last_updated: "2026-06-01" stability: "stable" tags: ["implementation", "guide"] ``` @@ -171,7 +172,7 @@ tags: ["implementation", "guide"] file_type: "documentation" title: "README / Contributing Guide" category: "root" -last_updated: "2026-05-29T..." +last_updated: "2026-06-01" description: "Community guidelines and contribution process" ``` diff --git a/scripts/README.md b/scripts/README.md index eb5844260..cc6b9b3f3 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -1,28 +1,9 @@ --- description: "Comprehensive automation scripts, utilities, and maintenance tools for LightSpeedWP projects. Modular design with shared infrastructure and extensive testing." -version: "2.5" -last_updated: "2025-12-04" +version: "2.5.1" +last_updated: "2026-06-01" owners: - LightSpeedWP Team -references: - - path: ../instructions/coding-standards.instructions.md - description: Coding standards for all scripts - - path: ../instructions/documentation-formats.instructions.md - description: Frontmatter and documentation format standards - - path: ../schema/frontmatter.schema.json - description: Frontmatter schema - - path: ../schema/collection.schema.json - description: Collection schema - - path: ../tests/README.md - description: Testing framework - - path: ../docs/WORKFLOWS.md - description: Workflow documentation - - path: ../CHANGELOG.md - description: Project changelog - - path: ../docs/TESTING.md - description: Testing standards - - path: ../docs/LINTING.md - description: Linting standards --- # LightSpeedWP Scripts & Automation diff --git a/wceu-2026/SLIDES_INDEX.md b/wceu-2026/SLIDES_INDEX.md index 1e535767b..d94a28fed 100644 --- a/wceu-2026/SLIDES_INDEX.md +++ b/wceu-2026/SLIDES_INDEX.md @@ -3,13 +3,13 @@ file_type: documentation title: WCEU 2026 Main Talk — Slide Index (24 Slides) date: 2026-05-31 description: Quick-reference index of all 24 slides with layout, timing, key message, and colour scheme -version: "1.0" -last_updated: '2026-06-01' +version: "1.0.1" +last_updated: "2026-06-01" owners: ["Ashley Shaw"] tags: ["wceu-2026", "slides", "presentation", "reference"] -status: "published" +status: active stability: "stable" -domain: "presentation" +domain: generic language: "en" --- diff --git a/wceu-2026/SPEAKER_NOTES_FINAL.md b/wceu-2026/SPEAKER_NOTES_FINAL.md index 62e18b202..a9bfba732 100644 --- a/wceu-2026/SPEAKER_NOTES_FINAL.md +++ b/wceu-2026/SPEAKER_NOTES_FINAL.md @@ -5,13 +5,13 @@ date: 2026-05-31 description: Full speaker notes for the 25-minute WordCamp Europe 2026 presentation on .github repository automation and governance duration: 25 minutes format: Speaker reference with timing, key messages, talking points, and transitions -version: "1.0" -last_updated: '2026-06-01' +version: "1.0.1" +last_updated: "2026-06-01" owners: ["Ashley Shaw"] tags: ["wceu-2026", "speaker-notes", "presentation", "timing"] -status: "published" +status: active stability: "stable" -domain: "presentation" +domain: generic language: "en" --- diff --git a/wceu-2026/VISUAL_DESIGN_SPECIFICATIONS.md b/wceu-2026/VISUAL_DESIGN_SPECIFICATIONS.md index 652734a99..16b4ebedf 100644 --- a/wceu-2026/VISUAL_DESIGN_SPECIFICATIONS.md +++ b/wceu-2026/VISUAL_DESIGN_SPECIFICATIONS.md @@ -3,13 +3,13 @@ file_type: documentation title: WCEU 2026 Main Talk — Visual Design Specifications date: 2026-05-31 description: Complete visual design guide for 24-slide presentation, including design system, layout specifications, accessibility compliance, and implementation notes -version: "1.0" -last_updated: '2026-06-01' +version: "1.0.1" +last_updated: "2026-06-01" owners: ["Ashley Shaw"] tags: ["wceu-2026", "design", "visual-system", "accessibility"] -status: "published" +status: active stability: "stable" -domain: "presentation" +domain: generic language: "en" ---