Skip to content

epic: prd-agent - Validate v2.1 planning workflows #1896

New issue
New issue
Open
Task
0 of 4 issues completed
Open
epic: prd-agent - Validate v2.1 planning workflows#1896
Task
0 of 4 issues completed
Assignees
elesharashleyshaw
Labels
area:testingpriority:normalstatus:needs-triagetype:epic
Milestone
v1.1

Description

@ashleyshaw
ashleyshaw
opened on Aug 12, 2026

Epic Summary

Validate the WordPress-aware v2.1 PRD Agent on block-plugin, block-theme, hybrid and atypical repositories before treating rollout as verified. The prompt exists on develop, but PR #1894 closed without merging; establish its provenance rather than citing that PR as completed delivery.

Linked Child Issues/Stories/Tasks/PRs

Milestones & Timeline

GitHub milestone: v1.1. Complete the Phase 5 evidence gate before relying on validation claims for rollout or Phase 7.

Acceptance Criteria

  • Test plugin, theme, hybrid, non-standard and custom structures; publish cases, edge cases and measured detection accuracy against the >95% target.
  • Verify generated plugin, theme and shared PRD sections for relevance and completeness.
  • Check WordPress version guidance, release alignment, compatibility risks and testing buffers.
  • Review generated PRDs for WCAG 2.2 AA, accessibility risks and block-editor considerations.
  • Link tester feedback, critical blockers and a Phase 5 report; reconcile child work from evidence.
  • Complete applicable documentation, QA, changelog and label/type checks.

Dependencies / Blockers

Structural work merged in PR #2865, but prompt provenance, test evidence and four open children need reconciliation. Checked criteria in an older body are not a substitute for linked results.

Additional Context

Use the project tasks and specification. Record results rather than pre-marking success.

Definition of Ready (DoR)

  • Fixtures, scenarios, owner, dependencies and milestone scope confirmed.
  • Success measures and report location agreed.

Definition of Done (DoD)

  • Maintainer reviews linked Phase 5 results.
  • All four children are evidenced and reconciled.
  • QA and documentation complete; epic status reviewed before closure.

Activity

  1. ashleyshaw
    added
    migrate:status:in-progressWork in progress
    status:needs-testingTesting needed (manual/automated)
    on Aug 12, 2026

  2. linear-code commented on Aug 12, 2026

    @linear-code
    linear-codeBot
    on Aug 12, 2026 – with Linear Code

    LS-2573

  3. github-actions commented on Aug 12, 2026

    @github-actions
    github-actionsBot
    on Aug 12, 2026 – with GitHub Actions
    Contributor

    ✅ Template check passed after update. Thanks for fixing the issue body.

  4. github-actions
    added
    migrate:status:needs-more-infoMissing details to proceed
    and removed
    migrate:status:in-progressWork in progress
    status:needs-testingTesting needed (manual/automated)
    on Aug 12, 2026

  5. github-actions commented on Aug 12, 2026

    @github-actions
    github-actionsBot
    on Aug 12, 2026 – with GitHub Actions
    Contributor

    ⏱️ 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-13T03:33:52.857Z

    Maintained by project-meta-sync workflow.

  6. github-actions
    added
    migrate:priority:normalDefault priority
    on Aug 12, 2026
  7. ashleyshaw
    added 2 commits that reference this issue on Aug 12, 2026

    docs: Fix PRD Agent project frontmatter and issue links

    b2128b4

    docs: Fix PRD Agent project documentation (#1935)

    82fe283
  8. ashleyshaw
    added
    migrate:type:epicLarge multi-scope initiative
    and removed
    migrate:status:needs-more-infoMissing details to proceed
    on Aug 12, 2026
  9. github-actions
    added
    migrate:status:needs-triageNeeds triage
    on Aug 13, 2026
  10. ashleyshaw
    self-assigned this
    on Aug 29, 2026

  11. 5 remaining items

  12. github-actions commented on Sep 8, 2026

    @github-actions
    github-actionsBot
    on Sep 8, 2026 – with GitHub Actions
    Contributor

    ⚠️ Bare Labels Detected

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

    • migrate:type:epic

    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.

  13. ashleyshaw
    added
    area:testing
    on Sep 8, 2026
  14. ashleyshaw
    changed the title [-]Phase 2: PRD Agent v2.1 Testing & Validation[/-] [+]epic: prd-agent - Test and validate v2.1 in Phase 2[/+] on Sep 8, 2026
  15. ashleyshaw
    removed
    migrate:priority:normalDefault priority
    migrate:status:needs-triageNeeds triage
    migrate:type:epicLarge multi-scope initiative
    on Sep 9, 2026

  16. ashleyshaw commented on Sep 10, 2026

    @ashleyshaw
    ashleyshaw
    on Sep 10, 2026 – with Claude
    MemberAuthor

    Linked to Phase 3 Structural Consolidation

    Phase 3 (Structural Consolidation) is now complete and ready for Phase 5 (Testing & Validation).

    Phase 3 Status ✅ COMPLETE

    Phase 3 consolidation work has been completed in PR #2865. Key outcomes:

    • 28 canonical skills (consolidated from 45+ duplicates)
    • Real agent definitions with loadable YAML frontmatter for Claude and Copilot
    • Accurate documentation (README.md, AGENT.md, instructions/AGENTS.md, CHANGELOG.md)
    • Cleaned repository with duplicate folder deleted and export cruft removed

    Phase 5 Dependencies

    This testing phase is now unblocked and ready to proceed. The agent definitions in PR #2865 include:

    1. ✅ Claude agent definition (agents/prd-agent/claude/agent.md) — ready for testing
    2. ✅ Copilot agent definition (agents/prd-agent/copilot/agent.md) — ready for testing
    3. ✅ Complete skill inventory (28 canonical skills) — all documented and routable
    4. ✅ Integration Points section — documenting real, plugin-backed services (Linear, GitHub, Google Workspace)
    5. ✅ Capability tags — added resource-allocation and scope-definition

    Recommended Test Plan

    Given the Phase 3 completion, recommend starting Phase 5 testing immediately after PR #2865 merges:

    T2.1: Agent Loadability

    • Copy agents/prd-agent/claude/agent.md to scratch repo's .claude/agents/
    • Verify Claude Code recognizes it as valid subagent
    • Copy agents/prd-agent/copilot/agent.md to scratch repo's .github/agents/
    • Verify Copilot recognizes it as valid custom agent

    T2.2-T2.4: WordPress Auto-Detection & Prompting

    • Follow existing test checklists in PLANNING.md Phase 5 section (auto-detection, PRD sections, WordPress awareness, accessibility)

    Related Resources

    Recommendation: Unblock Phase 5 testing workflow — PR #2865 includes everything needed for comprehensive testing.

    Generated by Claude Code

  17. ashleyshaw
    changed the title [-]epic: prd-agent - Test and validate v2.1 in Phase 2[/-] [+]epic: prd-agent - Phase 5 Testing & Validation (Prompt v2.1)[/+] on Sep 11, 2026
  18. ashleyshaw
    added sub-issues on Sep 11, 2026
  19. ashleyshaw
    changed the title [-]epic: prd-agent - Phase 5 Testing & Validation (Prompt v2.1)[/-] [+]epic: prd-agent - Validate v2.1 planning workflows[/+] on Sep 11, 2026
  20. ashleyshaw
    assigned
    eleshar
    on Sep 25, 2026
  21. linear-code
    added a parent issue on Oct 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area:testingpriority:normalstatus:needs-triagetype:epic

Type

Task

Fields

Priority

None yet

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions