microsoft/hve-core

Public

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

CodeCommitsIssuesPull requestsActionsInsightsSecurity
dabed001c8ac7da3f2e4368ae1f279080c627cbd

Branches

Tags

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

Clone

HTTPS

Download ZIP

docs/hve-guide/lifecycle/README.md

102lines · modecode

1---
2title: AI-Assisted Project Lifecycle Overview
3description: Navigate the full AI-assisted engineering lifecycle from setup through operations with HVE Core tooling
4author: Microsoft
5ms.date: 2026-02-18
6ms.topic: concept
7keywords:
8 - ai-assisted project lifecycle
9 - lifecycle
10 - stages
11 - workflow
12 - AI-assisted engineering
13estimated_reading_time: 8
14---
15
16## Overview
17
18HVE Core supports a 9-stage project 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 and reduce friction. Use this guide to navigate the full lifecycle and find the right tools for your current project phase.
19
20## Stage Overview
21
22| Stage | Name | Asset Count | Key Tools | Guide |
23|---------|--------------------|-------------|-------------------------------------------------------------------------------------------|---------------------------------------------|
24| Stage 1 | Setup | 4 | hve-core-installer, memory | [Setup](setup.md) |
25| Stage 2 | Discovery | 14 | task-researcher, brd-builder, security-plan-creator | [Discovery](discovery.md) |
26| Stage 3 | Product Definition | 6 | prd-builder, product-manager-advisor, adr-creation | [Product Definition](product-definition.md) |
27| Stage 4 | Decomposition | 5 | ado-prd-to-wit, github-backlog-manager | [Decomposition](decomposition.md) |
28| Stage 5 | Sprint Planning | 9 | github-backlog-manager, agile-coach | [Sprint Planning](sprint-planning.md) |
29| Stage 6 | Implementation | 30 | task-researcher, task-planner, task-implementor, task-reviewer, rpi-agent, prompt-builder | [Implementation](implementation.md) |
30| Stage 7 | Review | 11 | task-reviewer, pr-review | [Review](review.md) |
31| Stage 8 | Delivery | 9 | git-merge, ado-get-build-info | [Delivery](delivery.md) |
32| Stage 9 | Operations | 11 | doc-ops, prompt-builder, incident-response | [Operations](operations.md) |
33
34## Where Are You?
35
36Use this navigator to jump directly to the stage matching your current need.
37
38| I want to... | Start Here |
39|------------------------------------------------|------------------------------------------------------|
40| Set up HVE Core for the first time | [Stage 1: Setup](setup.md) |
41| Understand requirements or research a topic | [Stage 2: Discovery](discovery.md) |
42| Create a product spec or architecture decision | [Stage 3: Product Definition](product-definition.md) |
43| Break work into tasks or work items | [Stage 4: Decomposition](decomposition.md) |
44| Plan a sprint or manage my backlog | [Stage 5: Sprint Planning](sprint-planning.md) |
45| Write code, build features, or create content | [Stage 6: Implementation](implementation.md) |
46| Review code or get PR feedback | [Stage 7: Review](review.md) |
47| Merge, release, or deploy | [Stage 8: Delivery](delivery.md) |
48| Monitor, maintain, or respond to incidents | [Stage 9: Operations](operations.md) |
49
50## Lifecycle Flow
51
52```mermaid
53flowchart LR
54 S1["Setup"] --> S2["Discovery"]
55 S2 --> S3["Product Definition"]
56 S3 --> S4["Decomposition"]
57 S4 --> S5["Sprint Planning"]
58 S5 --> S6["Implementation"]
59 S6 --> S7["Review"]
60 S7 --> S8["Delivery"]
61 S8 --> S9["Operations"]
62 S7 -.->|"rework"| S6
63 S8 -.->|"next sprint"| S6
64 S9 -.->|"hotfix"| S6
65```
66
67> [!TIP]
68> [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.
69
70## Stage Transition Rules
71
721. Design Thinking Exit 1 to Stage 2: Problem statement complete (Methods 1-3) feeds Task Researcher in Discovery
732. Design Thinking Exit 2 to Stage 2: Validated concept (Methods 4-6) feeds Task Researcher in Discovery
743. Design Thinking Exit 3 to Stage 2: Implementation spec (Methods 7-9) feeds Task Researcher in Discovery
754. Stage 1 to Stage 2: Installation complete
765. Stage 2 to Stage 3: BRD complete, handoff at `docs/brds/`
776. Stage 2 to Stage 4: TPMs skip PRD when BRD is sufficient
787. Stage 3 to Stage 4: PRD and ADRs finalized
798. Stage 4 to Stage 5: Work items created
809. Stage 5 to Stage 6: Sprint planned
8110. Stage 6 to Stage 7: Implementation complete, `/clear` context
8211. Stage 7 to Stage 8: PR approved
8312. Stage 7 to Stage 6: Rework needed
8413. Stage 8 to Stage 6: Next sprint
8514. Stage 8 to Stage 9: Final sprint complete
8615. Stage 9 to Stage 6: Hotfix needed
87
88## Coverage Notes
89
90Stage 6 Implementation carries the highest asset density with 30 assets, representing roughly 35% of all stage assignments. Stage 8 Delivery has zero agents and operates entirely through prompts and auto-activated instructions. Stage 1 Setup has minimal coverage with only 4 assets, reflecting its narrow scope as a one-time onboarding step.
91
92Each stage page follows a consistent structure covering purpose, key activities, AI-assisted workflow, and cross-references. This format lets you navigate directly to the stage relevant to your current work and find both manual checklists and AI agent commands. Stages with fewer tools (Stage 1 through Stage 5) use flat tables, while stages with more tools (Stage 6 through Stage 9) use categorized subsections for navigability.
93
94## Next Steps
95
96> [!TIP]
97> Find your role-specific guide at [Role Guides](../roles/) to see which stages matter most for your work.
98
99<!-- markdownlint-disable MD036 -->
100*🤖 Crafted with precision by ✨Copilot following brilliant human instruction,
101then carefully refined by our team of discerning human reviewers.*
102<!-- markdownlint-enable MD036 -->
103