microsoft/hve-core

Public

mirrored fromhttps://github.com/microsoft/hve-coreAvailable

CodeCommitsIssuesPull requestsActionsInsightsSecurity
hve-core-v3.3.1

Branches

Tags

  • No tags available.
0Branches0Tags
Go to file
Add file
Code

Clone

HTTPS

Download ZIP

docs/hve-guide/roles/README.md

88lines · modepreview

---
title: Role Guides
description: Find your role-specific guide for AI-assisted engineering with HVE Core tooling
sidebar_position: 1
author: Microsoft
ms.date: 2026-02-18
ms.topic: concept
keywords:
  - roles
  - guides
  - AI-assisted engineering
  - collections
estimated_reading_time: 5
---

HVE Core provides role-specific tooling through collections of agents, prompts, instructions, and skills. Each role guide covers recommended collections, stage walkthroughs, starter prompts, and collaboration patterns tailored to how you work.

## Role Overview

| Role                     | Dedicated Assets | Total Addressable | Primary Stages                              | Guide                                                   |
|--------------------------|------------------|-------------------|---------------------------------------------|---------------------------------------------------------|
| Engineer                 | 26               | 28+               | Stage 2, Stage 3, Stage 6, Stage 7, Stage 8 | [Engineer](engineer.md)                                 |
| TPM                      | 24               | 32+               | Stage 2, Stage 3, Stage 4, Stage 5, Stage 8 | [TPM](tpm.md)                                           |
| Tech Lead / Architect    | 19               | 23+               | Stage 2, Stage 3, Stage 6, Stage 7, Stage 9 | [Tech Lead](tech-lead.md)                               |
| Security Architect       | 3                | 9                 | Stage 2, Stage 3, Stage 7, Stage 9          | [Security Architect](security-architect.md)             |
| Data Scientist           | 6                | 13                | Stage 2, Stage 3, Stage 6, Stage 7, Stage 8 | [Data Scientist](data-scientist.md)                     |
| UX Designer              | 58               | 63+               | Stage 2, Stage 3, Stage 6, Stage 7, Stage 9 | [UX Designer](ux-designer.md)                           |
| SRE / Operations         | 8                | 13+               | Stage 1, Stage 3, Stage 6, Stage 8, Stage 9 | [SRE / Operations](sre-operations.md)                   |
| Business Program Manager | N/A              | N/A               | Stage 2, Stage 3, Stage 4, Stage 5          | [Business Program Manager](business-program-manager.md) |
| New Contributor          | 2                | 10                | Stage 1, Stage 2, Stage 6, Stage 7          | [New Contributor](new-contributor.md)                   |
| Utility                  | N/A              | 13                | All                                         | [Utility](utility.md)                                   |

> **Dedicated Assets** count agents, prompts, instructions, and skills built specifically for a role's primary workflow. **Total Addressable** adds cross-cutting tools (memory, Git prompts, auto-activated instructions) and shared collection assets. The **+** suffix indicates additional auto-activated assets not individually enumerated.

## Find Your Role

| I want to...                                                  | Recommended Role Guide                                  |
|---------------------------------------------------------------|---------------------------------------------------------|
| Write code, implement features, or fix bugs                   | [Engineer](engineer.md)                                 |
| Plan projects, manage requirements, or track work             | [TPM](tpm.md)                                           |
| Design architecture, review code, or set standards            | [Tech Lead](tech-lead.md)                               |
| Assess security, create security models, or review compliance | [Security Architect](security-architect.md)             |
| Analyze data, build notebooks, or create dashboards           | [Data Scientist](data-scientist.md)                     |
| Run DT workshops, design user experiences, or test prototypes | [UX Designer](ux-designer.md)                           |
| Manage infrastructure, handle incidents, or deploy            | [SRE / Operations](sre-operations.md)                   |
| Define business outcomes or manage stakeholder alignment      | [Business Program Manager](business-program-manager.md) |
| Get started contributing to the project                       | [New Contributor](new-contributor.md)                   |
| Use cross-cutting utilities (memory, docs, media)             | [Utility](utility.md)                                   |

## Collaboration Patterns

Roles frequently collaborate across workflows. These scenarios illustrate common multi-role interactions:

* Engineers and tech leads collaborate on feature development with architecture review, coding standards enforcement, and implementation guidance. See the [Engineer](engineer.md) and [Tech Lead](tech-lead.md) guides.
* TPMs and security architects coordinate secure product launches combining requirements gathering, security model analysis, and compliance verification. See the [TPM](tpm.md) and [Security Architect](security-architect.md) guides.
* Data scientists and engineers bridge analytics pipeline development with data specification, notebook prototyping, and production integration. See the [Data Scientist](data-scientist.md) and [Engineer](engineer.md) guides.
* New contributors progress to engineers through onboarding from guided workflows to full autonomous engineering. See the [New Contributor](new-contributor.md) and [Engineer](engineer.md) guides.
* UX designers and engineers connect validated Design Thinking concepts to RPI implementation workflows, bridging user research to engineering sprints. See the [UX Designer](ux-designer.md) and [Engineer](engineer.md) guides.

## Coverage Notes

Each role intersects with 9 lifecycle stages, producing 81 role-stage pairs. Coverage levels across those pairs:

| Level    | Role-Stage Pairs | Percent |
|----------|-----------------:|--------:|
| Strong   |               13 |     16% |
| Moderate |               18 |     22% |
| Thin     |               18 |     22% |
| None     |               32 |     40% |

Strongest coverage: Engineer at Stages 6-7 (implementation and review), TPM at Stages 2-5 (requirements through sprint planning), SRE at Stage 9 (operations), UX Designer at Stages 2-3 (discovery and design via Design Thinking).

Thinnest roles: Security Architect (3 dedicated assets, 6 of 9 stages at None or Thin) and Business Program Manager (beta, all tooling borrowed from shared collections).

Least-covered stage: Stage 4 Decomposition: 8 of 9 roles have no dedicated tooling. Only TPM has strong coverage at this stage.

> [!NOTE]
> Gaps represent contribution opportunities. See the [lifecycle stage guides](../lifecycle/) for per-stage details and [Contributing](../../contributing/) for guidance on creating new agents, prompts, and instructions.

## Next Steps

> [!TIP]
> See the full project lifecycle at [AI-Assisted Project Lifecycle](../lifecycle/) to understand how stages connect across roles. Each stage guide maps available HVE Core tools and role-specific guidance for that phase of work.

<!-- markdownlint-disable MD036 -->
*🤖 Crafted with precision by ✨Copilot following brilliant human instruction,
then carefully refined by our team of discerning human reviewers.*
<!-- markdownlint-enable MD036 -->