This directory contains the active GitHub Actions workflows for this repository. Previous consolidation (2026-09-11) archived 71 superseded workflows under archived/ and removed 7 placeholder stubs in Sep 2026.

• branch-name-validation.yml - Enforces the {type}/{scope}-{title} branch naming strategy on push
• branch-validation-metrics-aggregator.yml - Aggregates branch validation metrics hourly and on validation completion
• pr-template-routing.yml - Routes PR templates and applies labels from the branch name

• changelog-management.yml - Gates PRs on develop for CHANGELOG updates and syncs entries on merge
• changelog-validation.yml - Scores CHANGELOG entry quality on PRs touching CHANGELOG.md

• documentation.yml - Regenerates impacted READMEs on PR/push to develop; audit and maintenance via manual dispatch
• validate-specifications.yml - Audits .github/specs/, validates the catalog, lints changed markdown, runs Bats tests

• qodo-pr-agent-trigger.yml - Unprivileged half of the Qodo PR-Agent pilot: runs on non-draft PRs (opened, reopened, ready for review) and maintainer comment commands, holds no secret, and publishes a request hint
• qodo-pr-agent.yml - Privileged half of the Qodo PR-Agent pilot: a workflow_run and workflow_dispatch receiver that re-derives each request from the API, and the only pilot execution workflow that reads its model key
• qodo-pr-agent-reusable.yml - Organisation-standard Qodo PR-Agent run definition (workflow_call), which other repositories can call. Unlike the pilot receiver it is not limited to the pilot's key: it supplies MODEL_CREDENTIAL from the environment its caller selects. It resolves the triggering maintainer comment by the comment_id the caller passes, not by taking the newest comment carrying the same command. See docs/QODO_PR_AGENT.md
• qodo-pr-agent-report.yml - Daily Qodo PR-Agent pilot report (runs, outcomes, estimated spend) on a schedule and by manual dispatch

Superseded workflows are preserved under archived/2026-09-11/ with a manifest and restoration procedures. See archived/INDEX.md.

Workflows are triggered by:

1. Pull Request Events - Code quality checks on PR creation/update
2. Push Events - Validation and automation on push to branches
3. Schedule - Periodic metrics collection
4. Manual Dispatch - On-demand workflow execution via GitHub UI

Workflow behavior is configured via:

• ../labeler.yml - Label matching rules
• ../metrics/README.md - Metrics collection and reporting

• Keep workflow files in source control
• Use workflow permissions minimally (read-only by default)
• Leverage reusable workflow blocks to reduce duplication
• Test workflows locally with act before committing
• Document non-obvious workflow logic inline

Maintained with ❤️ by the 🚀 LightSpeedWP Automation Team Org Profile