test: pr-finalisation - Plan and test workflow

[ashleyshaw]

Phase 1: Planning & Testing (Week 1)

Validate that all agents and skills work together correctly before proceeding with structural changes.

🎯 Objectives

• Review audit findings with team
• Validate all agent/skill integrations work
• Test changelog validation on sample PRs
• Test label audit recommendations
• Confirm Issue Agent Phase 2 roadmap

✅ Deliverables

• Audit findings document (AUDIT-FINDINGS.md)
• Project control panel (README.md)
• OPENSPEC document (OPENSPEC.md)
• Workflow prompt (WORKFLOW-PROMPT.md)
• Team review meeting notes
• Validation test results
• Migration plan approval

📝 Validation Checklist

Changelog Agent

• Test entry validation on 3+ sample PRs
• Test auto-formatting (em-dashes, truncation)
• Test Keep a Changelog 1.1.0 compliance check
• Verify error messages are clear

Label Audit Skill

• Test recommendations on 5+ issues
• Verify coverage % calculation
• Verify one-hot constraint enforcement
• Test family coverage metrics

Issue-Type Allocator Skill

• Test decision tree on 10+ issues
• Verify all 35 types work correctly
• Test examples and validation

Issue Agent Infrastructure

• Verify GitHub API client works (115+ tests)
• Test label loading & caching
• Test template loading
• Confirm Phase 2 roadmap is achievable

PR Agent

• Test branch validation
• Test template routing
• Test label application
• Test merge coordination

🔗 Related Issues

Parent: #2681 (EPIC)
Next Phase: #2683, #2684 (Phase 2: Agent Reorganization)

📚 Documentation

• Project Control Panel
• Audit Findings
• OPENSPEC

🎯 Success Criteria

• ✅ All components tested without blockers
• ✅ Team reviews and approves findings
• ✅ Migration timeline agreed
• ✅ Phase 2 ready to start

Timeline: 2026-09-04 to 2026-09-11
Owner: Ashley Shaw
Effort: 4–6 hours team time + validation

[linear-code]

LS-3121

[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]

⚠️ Bare Labels Detected

This issue has labels that are not in the canonical taxonomy:

• migrate:status:needs-more-info
• migrate:type:test
• migrate:area:automation
• priority:high
• meta:phase-1

Valid Canonical Labels

Please use labels with a prefix from the canonical taxonomy:

• Type: type:bug, type:feature, type:task, type:documentation, etc.
• Status: status:needs-triage, status:in-progress, status:done, etc.
• Priority: priority:critical, priority:high, priority:normal, priority:low
• Area: area:ci, area:docs, area:labels, area:security, etc.
• Meta: meta:needs-changelog, meta:duplicate, meta:blocked, etc.

For the complete list, see .github/labels.yml.