microsoft/hve-core
Publicmirrored fromhttps://github.com/microsoft/hve-coreAvailable
docs/hve-guide/README.md
100lines · modecode
| 1 | --- |
| 2 | title: HVE Guide |
| 3 | description: Role-specific guides and the AI-assisted project lifecycle for engineering teams using HVE Core |
| 4 | sidebar_position: 1 |
| 5 | author: Microsoft |
| 6 | ms.date: 2026-02-18 |
| 7 | ms.topic: overview |
| 8 | keywords: |
| 9 | - hve guide |
| 10 | - roles |
| 11 | - ai-assisted project lifecycle |
| 12 | - engineering guide |
| 13 | estimated_reading_time: 3 |
| 14 | --- |
| 15 | |
| 16 | ## Overview |
| 17 | |
| 18 | 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. |
| 19 | |
| 20 | ## Sections |
| 21 | |
| 22 | ### AI-Assisted Project Lifecycle |
| 23 | |
| 24 | 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. |
| 25 | |
| 26 | ```mermaid |
| 27 | flowchart LR |
| 28 | S1["1 · Setup"] --> S2["2 · Discovery"] |
| 29 | S2 --> S3["3 · Product Definition"] |
| 30 | S3 --> S4["4 · Decomposition"] |
| 31 | S4 --> S5["5 · Sprint Planning"] |
| 32 | S5 --> S6["6 · Implementation"] |
| 33 | S6 --> S7["7 · Review"] |
| 34 | S7 --> S8["8 · Delivery"] |
| 35 | S8 --> S9["9 · Operations"] |
| 36 | S7 -.->|"rework"| S6 |
| 37 | S8 -.->|"next sprint"| S6 |
| 38 | S9 -.->|"hotfix"| S6 |
| 39 | S9 -.->|"next iteration"| S2 |
| 40 | ``` |
| 41 | |
| 42 | > [!TIP] |
| 43 | > [Design Thinking](../design-thinking/using-together.md) can feed into this lifecycle at three exit points. See the [DT-RPI integration guide](../design-thinking/dt-rpi-integration.md) for details. |
| 44 | |
| 45 | | Stage | Name | Key Tools | |
| 46 | |---------|--------------------|-----------------------------------------------------------------------------------------------------------------------| |
| 47 | | Stage 1 | Setup | hve-core-installer (skill), memory | |
| 48 | | Stage 2 | Discovery | task-researcher, brd-builder, security-planner, dt-coach, sssc-planner, rai-planner | |
| 49 | | Stage 3 | Product Definition | prd-builder, product-manager-advisor, adr-creation, arch-diagram-builder, security-planner, sssc-planner, rai-planner | |
| 50 | | Stage 4 | Decomposition | ado-prd-to-wit, github-backlog-manager | |
| 51 | | Stage 5 | Sprint Planning | github-backlog-manager, agile-coach | |
| 52 | | Stage 6 | Implementation | task-researcher, task-planner, task-implementor, task-reviewer, rpi-agent, prompt-builder, coding-standards | |
| 53 | | Stage 7 | Review | task-reviewer, pr-review | |
| 54 | | Stage 8 | Delivery | pull-request, git-commit, git-merge, ado-get-build-info | |
| 55 | | Stage 9 | Operations | doc-ops, doc-ops-update, incident-response | |
| 56 | |
| 57 | > Cross-cutting: memory is available at every stage and is not tied to any single phase. |
| 58 | |
| 59 | **[AI-Assisted Project Lifecycle Overview →](lifecycle/)** |
| 60 | |
| 61 | ### Role Guides |
| 62 | |
| 63 | Nine role-specific guides covering recommended collections, stage walkthroughs, starter prompts, and collaboration patterns tailored to how you work. |
| 64 | |
| 65 | | Role | Primary Stages | Guide | |
| 66 | |--------------------------|---------------------------------------------|---------------------------------------------------------------| |
| 67 | | Engineer | Stage 2, Stage 3, Stage 6, Stage 7, Stage 8 | [Engineer](roles/engineer.md) | |
| 68 | | TPM | Stage 2, Stage 3, Stage 4, Stage 5, Stage 8 | [TPM](roles/tpm.md) | |
| 69 | | Tech Lead / Architect | Stage 2, Stage 3, Stage 6, Stage 7, Stage 9 | [Tech Lead](roles/tech-lead.md) | |
| 70 | | Security Architect | Stage 2, Stage 3, Stage 7, Stage 9 | [Security Architect](roles/security-architect.md) | |
| 71 | | Data Scientist | Stage 2, Stage 3, Stage 6, Stage 7, Stage 8 | [Data Scientist](roles/data-scientist.md) | |
| 72 | | SRE / Operations | Stage 1, Stage 3, Stage 6, Stage 8, Stage 9 | [SRE / Operations](roles/sre-operations.md) | |
| 73 | | Business Program Manager | Stage 2, Stage 3, Stage 4, Stage 5 | [Business Program Manager](roles/business-program-manager.md) | |
| 74 | | New Contributor | Stage 1, Stage 2, Stage 6, Stage 7 | [New Contributor](roles/new-contributor.md) | |
| 75 | | UX Designer | Stage 2, Stage 3, Stage 6, Stage 7 | [UX Designer](roles/ux-designer.md) | |
| 76 | | Utility | All | [Utility](roles/utility.md) | |
| 77 | |
| 78 | **[Browse All Role Guides →](roles/)** |
| 79 | |
| 80 | ## Where to Start |
| 81 | |
| 82 | ```mermaid |
| 83 | flowchart TD |
| 84 | START{Where to Start?} -->|Understand the workflow| LC[Lifecycle Overview] |
| 85 | START -->|Find tools for my phase| SN[Stage Navigator] |
| 86 | START -->|Get my role guide| RF[Role Finder] |
| 87 | START -->|Install collections| CQ[Collection Quick Reference] |
| 88 | ``` |
| 89 | |
| 90 | | I want to... | Go Here | |
| 91 | |-----------------------------------------|----------------------------------------------------| |
| 92 | | Understand the full project workflow | [Lifecycle Overview](lifecycle/) | |
| 93 | | Find tools for my current project phase | [Stage Navigator](lifecycle/#where-are-you) | |
| 94 | | Get my role-specific guide | [Role Finder](roles/#find-your-role) | |
| 95 | | Install collections for my role | [Collection Quick Reference](roles/#role-overview) | |
| 96 | |
| 97 | <!-- markdownlint-disable MD036 --> |
| 98 | *🤖 Crafted with precision by ✨Copilot following brilliant human instruction, |
| 99 | then carefully refined by our team of discerning human reviewers.* |
| 100 | <!-- markdownlint-enable MD036 --> |