Issue Description

Labels: enhancement, agents, size: medium

Epic: #63 - Engineering Agents Integration

Related Issues: Part of breaking down #63 into focused implementation tasks

Epic Context

This issue is part of the larger Engineering Agents Integration epic (#63), which aims to integrate 6 collaborative engineering agents from the engineering-team-agents repository into HVE Core. The epic provides multi-platform support (GitHub Copilot + Claude Code + AGENTS.md) while enhancing the existing research → plan → implement workflow with quality gates at strategic points.

This specific issue focuses on the pre-research validation phase, adding Product Manager and UX Designer agents that validate user needs and design workflows before @task-researcher begins work.

Overview

Integrate the Product Manager Advisor and UX Designer agents to add pre-research quality gates that validate user needs and design workflows before development begins.

User Story

As a developer on the HVE Core team, I want question-first requirements validation and user journey mapping, so that I build the right features with validated user needs before starting research or implementation.

Context

• Current Gap: No validation of "should we build this?" before research begins
• Problem: Teams often research and build features without validating actual user needs or mapping user workflows
• Value Add: 30-50% faster research with targeted requirements, prevents building unwanted features
• Integration Point: Pre-gate for existing @task-researcher agent

Source Repository

• Engineering Team Agents: https://github.com/niksacdev/engineering-team-agents
• Product Manager Agent: https://github.com/niksacdev/engineering-team-agents/blob/main/.claude/agents/product-manager-advisor.md
• UX Designer Agent: https://github.com/niksacdev/engineering-team-agents/blob/main/.claude/agents/ux-ui-designer.md
• Original Proposal: feat(agents): Engineering Agents Integration #63

Acceptance Criteria

• Product Manager Advisor agent works in Claude Code (.claude/agents/)
• Product Manager Advisor agent works in GitHub Copilot (.github/agents/ and .github/chatmodes/)
• UX Designer agent works in Claude Code (.claude/agents/)
• UX Designer agent works in GitHub Copilot (.github/agents/ and .github/chatmodes/)
• AGENTS.md includes both agents in universal format
• Agents create structured documentation in docs/product/ and docs/ux/
• Documentation templates added to docs/templates/
• Product Manager can invoke UX Designer for user journey validation
• Both agents follow HVE Core conventions (comment policy, markdown standards)
• Agents reference existing .github/instructions/ for project standards
• All existing HVE Core tests pass (backward compatibility)

Technical Requirements

• Platform Support: Claude Code, GitHub Copilot (native + chatmodes), universal AGENTS.md
• Documentation Structure:
  • docs/product/[feature-name]-requirements.md
  • docs/ux/[feature-name]-journey.md
  • docs/templates/github-issue-template.md
  • docs/templates/user-journey-template.md
• Token Efficiency: File path references instead of content duplication
• Conventions: Follow HVE Core separation of concerns (agents don't mix phases)

Implementation Phases

Phase 1: Port Agents

1. Adapt product-manager-advisor.md from source repository
2. Adapt ux-ui-designer.md from source repository
3. Create Claude versions (.claude/agents/)
4. Create GitHub native versions (.github/agents/)
5. Create GitHub chatmode versions (.github/chatmodes/)
6. Add both agents to AGENTS.md

Phase 2: Documentation Setup

1. Create docs/product/ directory
2. Create docs/ux/ directory
3. Port documentation templates
4. Add cross-references to existing .github/instructions/

Phase 3: Integration & Testing

1. Test agent invocation in Claude Code
2. Test agent invocation in GitHub Copilot
3. Validate cross-agent collaboration (PM → UX)
4. Verify documentation creation workflow
5. Validate backward compatibility

Definition of Done

• Agents work in all three formats (Claude, GitHub native, GitHub chatmodes)
• Documentation templates tested and validated
• Cross-agent collaboration working (Product Manager can consult UX Designer)
• Integration with @task-researcher documented
• README.md updated with new workflow examples
• All existing tests pass
• No breaking changes to existing chatmodes

Dependencies

• None (independent implementation)

Related Documentation

• Source Repository: https://github.com/niksacdev/engineering-team-agents
• Issue feat(agents): Engineering Agents Integration #63: feat(agents): Engineering Agents Integration #63

Additional Context

No response