microsoft/hve-core

---
title: HVE Guide
description: Role-specific guides and the AI-assisted project lifecycle for engineering teams using HVE Core
author: Microsoft
ms.date: 2026-02-18
ms.topic: overview
keywords:
  - hve guide
  - roles
  - ai-assisted project lifecycle
  - engineering guide
estimated_reading_time: 3
---

## Overview

The HVE Guide combines two complementary perspectives on AI-assisted engineering: the project lifecycle that defines *what* happens at each stage of delivery, and the role guides that define *how* each team member participates. Together, they provide a complete map of HVE Core tooling organized by both workflow stage and team responsibility.

## Sections

### AI-Assisted Project Lifecycle

A 9-stage lifecycle from initial setup through ongoing operations, with AI-assisted tooling at each stage. Every stage maps to specific agents, prompts, instructions, and skills that accelerate your work.

```mermaid
flowchart TD
    subgraph onboard["Onboarding — New Contributor · SRE"]
        S1["1 · Setup<br/>install extension"]
    end

    subgraph requirements["Requirements — TPM · BPM · Tech Lead · Security Architect"]
        S2["2 · Discovery<br/>task-researcher · brd-builder<br/>security-plan-creator"]
        S3["3 · Product Definition<br/>prd-builder · adr-creation<br/>product-manager-advisor · arch-diagram-builder"]
    end

    subgraph planning["Planning — TPM"]
        S4["4 · Decomposition<br/>ado-prd-to-wit · github-backlog-manager"]
        S5["5 · Sprint Planning<br/>github-backlog-manager · agile-coach"]
    end

    subgraph engineering["Engineering — Engineer · Tech Lead · Data Scientist"]
        S6["6 · Implementation<br/>task-researcher · task-planner<br/>task-implementor · task-reviewer<br/>rpi-agent · prompt-builder · coding-standards"]
        S7["7 · Review<br/>task-reviewer · pr-review"]
        S8["8 · Delivery<br/>pull-request · git-commit<br/>git-merge · ado-get-build-info"]
    end

    subgraph operations["Operations — SRE · Tech Lead"]
        S9["9 · Operations<br/>doc-ops · incident-response"]
    end

    S1 -->|"environment ready"| S2
    S2 -->|"TPM approves BRD"| S3
    S3 -->|"TPM finalizes PRD"| S4
    S4 -->|"TPM creates work items"| S5
    S5 ==>|"TPM hands off to Engineers"| S6
    S6 -->|"Engineer submits PR"| S7
    S7 -->|"Tech Lead approves"| S8
    S7 -.->|"rework needed"| S6
    S8 -->|"SRE deploys"| S9
    S8 -.->|"next sprint"| S6
    S9 -.->|"hotfix"| S6
    S9 -.->|"next iteration"| S2
```

| Stage   | Name               | Key Tools                                                                                                   |
|---------|--------------------|-------------------------------------------------------------------------------------------------------------|
| Stage 1 | Setup              | hve-core-installer                                                                                          |
| Stage 2 | Discovery          | task-researcher, brd-builder, security-plan-creator                                                         |
| Stage 3 | Product Definition | prd-builder, product-manager-advisor, adr-creation, arch-diagram-builder                                    |
| Stage 4 | Decomposition      | ado-prd-to-wit, github-backlog-manager                                                                      |
| Stage 5 | Sprint Planning    | github-backlog-manager, agile-coach                                                                         |
| Stage 6 | Implementation     | task-researcher, task-planner, task-implementor, task-reviewer, rpi-agent, prompt-builder, coding-standards |
| Stage 7 | Review             | task-reviewer, pr-review                                                                                    |
| Stage 8 | Delivery           | pull-request, git-commit, git-merge, ado-get-build-info                                                     |
| Stage 9 | Operations         | doc-ops, doc-ops-update, incident-response                                                                  |

> **Cross-cutting**: memory is available at every stage and is not tied to any single phase.

**[AI-Assisted Project Lifecycle Overview →](lifecycle/README.md)**

### Role Guides

Nine role-specific guides covering recommended collections, stage walkthroughs, starter prompts, and collaboration patterns tailored to how you work.

| Role                     | Primary Stages                              | Guide                                                         |
|--------------------------|---------------------------------------------|---------------------------------------------------------------|
| Engineer                 | Stage 2, Stage 3, Stage 6, Stage 7, Stage 8 | [Engineer](roles/engineer.md)                                 |
| TPM                      | Stage 2, Stage 3, Stage 4, Stage 5, Stage 8 | [TPM](roles/tpm.md)                                           |
| Tech Lead / Architect    | Stage 2, Stage 3, Stage 6, Stage 7, Stage 9 | [Tech Lead](roles/tech-lead.md)                               |
| Security Architect       | Stage 2, Stage 3, Stage 7, Stage 9          | [Security Architect](roles/security-architect.md)             |
| Data Scientist           | Stage 2, Stage 3, Stage 6, Stage 7, Stage 8 | [Data Scientist](roles/data-scientist.md)                     |
| SRE / Operations         | Stage 1, Stage 3, Stage 6, Stage 8, Stage 9 | [SRE / Operations](roles/sre-operations.md)                   |
| Business Program Manager | Stage 2, Stage 3, Stage 4, Stage 5          | [Business Program Manager](roles/business-program-manager.md) |
| New Contributor          | Stage 1, Stage 2, Stage 6, Stage 7          | [New Contributor](roles/new-contributor.md)                   |
| Utility                  | All                                         | [Utility](roles/utility.md)                                   |

**[Browse All Role Guides →](roles/README.md)**

## Where to Start

```mermaid
flowchart TD
    START{Where to Start?} -->|Understand the workflow| LC[Lifecycle Overview]
    START -->|Find tools for my phase| SN[Stage Navigator]
    START -->|Get my role guide| RF[Role Finder]
    START -->|Install collections| CQ[Collection Quick Reference]
```

| I want to...                            | Go Here                                                                  |
|-----------------------------------------|--------------------------------------------------------------------------|
| Understand the full project workflow    | [Lifecycle Overview](lifecycle/README.md)                                |
| Find tools for my current project phase | [Stage Navigator](lifecycle/README.md#where-are-you)                     |
| Get my role-specific guide              | [Role Finder](roles/README.md#find-your-role)                            |
| Install collections for my role         | [Collection Quick Reference](roles/README.md#collection-quick-reference) |

<!-- 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 -->