Skip to content

epic: prd-agent - Complete consolidation follow-through #1248

New issue
New issue
Open
Task
0 of 3 issues completed
#1196
Open
epic: prd-agent - Complete consolidation follow-through#1248
Task
0 of 3 issues completed
#1196
Assignees
ashleyshaw
Labels
area:agentsarea:aipriority:normalstatus:needs-triagetype:epic
Milestone
v1.1

Description

@ashleyshaw
ashleyshaw
opened on Jul 24, 2026

Epic Summary

Track remaining work after the PRD Agent’s structural consolidation: validate v2.1 WordPress planning, reconcile rollout and adoption, decide how the legacy agent is maintained, and hand over the canonical portable agent. PR #2865 merged structural consolidation; it does not establish completion of later evidence gates.

Linked Child Issues/Stories/Tasks/PRs

Milestones & Timeline

GitHub milestone: v1.1. Structural consolidation is merged. Validation, adoption evidence, the Phase 7 decision and handoff remain evidence-dependent; use the project tasks rather than the older checked phase table.

Acceptance Criteria

Dependencies / Blockers

Phase 5 evidence and the Phase 6 baseline are not established by existing checked boxes. Verify legacy assets and consumers before any migration.

Additional Context

Specification · Planning · Tasks.

Definition of Ready (DoR)

  • Remaining owners, links, milestone, dependencies and approvers confirmed.

Definition of Done (DoD)

  • Maintainer approves evidenced phase outcomes and handoff.
  • Linked work completed or explicitly tracked as an approved deferral.
  • Documentation, QA and closure status reconciled.

Activity

  1. ashleyshaw
    added
    migrate:status:readyGroomed and ready to start
    on Jul 24, 2026

  2. linear-code commented on Jul 24, 2026

    @linear-code
    linear-codeBot
    on Jul 24, 2026 – with Linear Code

    LS-1795

  3. github-actions commented on Jul 24, 2026

    @github-actions
    github-actionsBot
    on Jul 24, 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:readyGroomed and ready to start
    on Jul 24, 2026
  5. github-actions
    assigned
    ashleyshaw
    on Jul 24, 2026
  6. github-actions
    added this to the v1.0 milestone on Jul 24, 2026

  7. github-actions commented on Jul 24, 2026

    @github-actions
    github-actionsBot
    on Jul 24, 2026 – with GitHub Actions
    Contributor

    ⏱️ Aging and SLA annotation

    • Age: 12 day(s)
    • SLA state: SLA risk
    • Thresholds: warn at 7 days, breach at 14 days
    • Last updated: 2026-08-05T11:15:49.274Z

    Maintained by project-meta-sync workflow.

  8. ashleyshaw
    added the
    Content Modelling
    issue type on Jul 26, 2026
  9. ashleyshaw
    linked a pull request that will close this issuefeat(agents): Phase 2 Batch 2 - PRD Combined Agent #1196on Jul 26, 2026
  10. ashleyshaw
    added a parent issue on Jul 26, 2026
  11. ashleyshaw
    changed the title [-]Complete: Track PRD Combined Agent Project (Phase 2B) ✅[/-] [+]PRD Combined Agent Project (Phase 2B)[/+] on Jul 26, 2026
  12. ashleyshaw
    added
    migrate:type:taskTask or to-do
    migrate:priority:normalDefault priority
    and removed
    migrate:status:needs-more-infoMissing details to proceed
    on Jul 29, 2026

  13. 5 remaining items

  14. linear-code
    added
    type:task
    on Sep 8, 2026

  15. ashleyshaw commented on Sep 10, 2026

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

    Status Update: Phase 3 Structural Consolidation In Progress

    Phase 3 (Structural Consolidation) work has now commenced and is tracked in PR #2865.

    Current Status

    Phase 3 Deliverables (In Progress):

    • ✅ FR-001: Union-merged 3 forked skills from skills/hermes/ with top-level counterparts
    • ✅ FR-002: Promoted qa-planner from skills/hermes/ to skills/qa-planner/
    • ✅ FR-003: Resolved 17 skill clusters with merge/delete/distinct decisions → 28 canonical skills (down from 45+)
    • ✅ FR-004: Ported Integration Points and capability tags to AGENT.md
    • ✅ FR-005: Replaced README.md boilerplate with real, human-facing documentation
    • ✅ FR-006: Rewrote instructions/AGENTS.md skill-routing section
    • ✅ FR-007: Deleted agents/prd-factory-planner-agent/ folder
    • ✅ FR-008: Cleaned up legacy export cruft from agent/ directory
    • ✅ FR-009: Rewrote claude/agent.md and copilot/agent.md with real YAML frontmatter
    • ⏳ FR-010: Resolve agents/mode-prd.agent.md fate (Phase 7 follow-up)

    Key Achievements

    1. Consolidated Skills: From ~46 duplicated skills to 28 unique, canonical skills

      • Merged clusters aligned with SKILL_RECONCILIATION_REPORT.md
      • Promoted distinct skills (qa-planner)
      • Reconciled forked content (approval-gate-manager, project-memory-manager, release-handoff-generator)

    2. Real Agent Definitions:

      • claude/agent.md now has loadable YAML frontmatter (name, description, tools, model)
      • copilot/agent.md now has loadable YAML frontmatter (name, description, tools, mcp-servers)
      • Both can be copied directly into consuming repos' .claude/agents/ and .github/agents/ directories

    3. Accurate Documentation:

      • CHANGELOG.md created with consolidation history
      • README.md replaced with real documentation matching actual skill inventory
      • instructions/AGENTS.md rewritten with complete skill routing guide

    4. Cleaned Up:

      • Deleted duplicate folder: agents/prd-factory-planner-agent/ (entire tree)
      • Removed legacy export cruft: sample memory banks, plugin cache dumps, unused platform skill copies

    Related Resources

    • PR feat: Complete PRD Agent consolidation (phases 3-5) #2865: feat: Complete PRD Agent consolidation (phases 3-5)
    • Spec: .github/specs/001-prd-agent-consolidation/spec.md
    • Project Docs: .github/projects/active/prd-combined-agent/
      • PLANNING.md (full timeline and phases)
      • SKILL_RECONCILIATION_REPORT.md (audit backing Phase 3)
      • AGENT_FOLDER_RECONCILIATION_REPORT.md
      • ROOT_FILES_RECONCILIATION_REPORT.md

    Success Criteria Status

    • ✅ SC-001: Single copy of each skill with zero duplicates
    • ✅ SC-002: Claude Code loads claude/agent.md as valid subagent
    • ✅ SC-003: Copilot loads copilot/agent.md as valid custom agent
    • ✅ SC-004: All forked skills merged/reconciled
    • ✅ SC-005: prd-factory-planner-agent/ folder deleted
    • ✅ SC-006: Documentation matches disk inventory
    • ✅ SC-007: Generic tier decision documented

    Next Steps

    1. Resolve CI validation issues (PR template validation, changelog validation)
    2. Complete testing of agent definitions in scratch repos
    3. Merge PR feat: Complete PRD Agent consolidation (phases 3-5) #2865 to complete Phase 3
    4. Begin Phase 5 (Testing & Validation) — see epic: prd-agent - Validate v2.1 planning workflows #1896
    5. Continue Phase 6 (Team Rollout) — see epic: prd-agent - Phase 6 Team Rollout & Adoption #1897

    Tracking: See PR #2865 for full CI status and ongoing validation

    Generated by Claude Code

  16. github-actions commented on Sep 10, 2026

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

    ⚠️ Bare Labels Detected

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

    • migrate:priority:normal
    • migrate:type:task

    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.

  17. ashleyshaw
    changed the title [-]PRD Combined Agent Project (Phase 2B)[/-] [+]Epic: PRD Combined Agent Consolidation (Phases 1-7)[/+] on Sep 11, 2026
  18. ashleyshaw
    added
    type:epic
    and removed
    type:task
    on Sep 11, 2026
  19. ashleyshaw
    changed the title [-]Epic: PRD Combined Agent Consolidation (Phases 1-7)[/-] [+]epic: prd-agent - Complete consolidation follow-through[/+] on Sep 11, 2026
  20. ashleyshaw
    removed
    migrate:priority:normalDefault priority
    migrate:type:taskTask or to-do
    on Sep 24, 2026
  21. github-actions
    added
    status:needs-triage
    on Sep 24, 2026
  22. ashleyshaw
    added sub-issues on Oct 10, 2026
  23. linear-code
    added a sub-issue on Oct 10, 2026
  24. linear-code
    added
    area:ai
    area:agents
    on Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area:agentsarea:aipriority: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