Linting Agent Design & Implementation (Phase 1-4 Epic)

[ashleyshaw]

Epic issue for the portable, organisation-wide linting agent project spanning all 4 phases.

Related PR: #1817

Status: Phase 1 specification complete

Timeline:

• Phase 1 (Specification & Planning) — ✅ Complete (PR design: Linting Agent Specification — Phase 1 (OpenSpec) #1817)
• Phase 2 (Implementation) — 🔵 Planned
• Phase 3 (Testing) — 🔵 Planned
• Phase 4 (Documentation & Deployment) — 🔵 Planned

Key Details:

• Single portable agent across all LightSpeedWP repositories
• Support for 8+ file types (JS/TS, Markdown, YAML, JSON, Shell, PHP, CSS/SCSS, HTML, Python)
• WordPress compatibility (plugins, themes, classic WordPress)
• ≥95% test coverage
• Comprehensive documentation with Mermaid diagrams

See PR #1817 for detailed specification and test plan.

[linear-code]

LS-2520

[github-actions]

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

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

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

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

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

[github-actions]

⏱️ Aging and SLA annotation

• Age: 0 day(s)
• SLA state: Within SLA
• Thresholds: warn at 7 days, breach at 14 days
• Last updated: 2026-08-12T10:01:22.153Z

Maintained by project-meta-sync workflow.