microsoft/hve-core

Public

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

CodeCommitsIssuesPull requestsActionsInsightsSecurity
173d558d015d9849174acf0e38bf43eb009e11ff

Branches

Tags

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

Clone

HTTPS

Download ZIP

docs/getting-started/collections.md

116lines · modecode

1---
2title: Collections Overview
3description: Explore the HVE collection system, compare available collections, and choose the right extension for your workflow
4sidebar_position: 3
5author: Microsoft
6ms.date: 2026-03-22
7ms.topic: overview
8---
9
10## How HVE Artifacts Are Organized
11
12HVE distributes agents, prompts, instructions, and skills through collections, which are curated bundles of related artifacts. Each collection targets a specific domain or workflow, so you can install exactly what you need.
13
14Two VS Code Marketplace extensions deliver these collections:
15
16### HVE Core All (`ise-hve-essentials.hve-core-all`)
17
18The complete bundle containing 221 artifacts across all domains. If you want access to everything without choosing individual collections, install this extension. It is the recommended starting point for most users.
19
20### HVE Installer (`ise-hve-essentials.hve-installer`)
21
22A selective deployment tool with 2 artifacts. Rather than installing the full bundle, the installer lets you choose specific collections and deploy them into your workspace. Use the installer when you want fine-grained control over which artifacts are available.
23
24## Collection Relationships
25
26Collections are additive, meaning installing multiple collections may include overlapping items, and that is expected. The `hve-core-all` extension is the superset bundle containing every artifact from every domain collection. Individual collections exist as independent units, so you can also install them separately through the installer.
27
28Items retain their maturity annotations regardless of how they are installed. For example, design-thinking artifacts are marked "preview" even when accessed through the `hve-core-all` bundle.
29
30The installer enables targeted deployment of specific collections into workspaces without requiring the full bundle. It is a separate tool, not a subset of `hve-core-all`.
31
32## Available Collections
33
34| Collection | Description | Agents | Prompts | Instructions | Skills | Maturity | Marketplace |
35|------------------|------------------------------------------------------------------------------------------------------------------------------------------------|--------|---------|--------------|--------|--------------|--------------------------------------------------------------------------------------------------------|
36| ado | Manage Azure DevOps work items, monitor builds, create pull requests, and convert requirements documents into structured work item hierarchies | 2 | 9 | 9 | 1 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-ado) |
37| coding-standards | Enforce language-specific coding conventions and best practices across your projects, with pre-PR code review agents | 3 | 2 | 15 | 1 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-coding-standards) |
38| data-science | Generate data specifications, Jupyter notebooks, and Streamlit dashboards from natural language descriptions | 6 | 3 | 10 | 0 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-data-science) |
39| design-thinking | AI-enhanced design thinking coaching across nine methods | 2 | 13 | 43 | 0 | Preview | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-design-thinking) |
40| experimental | Experimental and preview artifacts not yet promoted to stable collections | 3 | 0 | 3 | 2 | Experimental | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-experimental) |
41| github | Manage GitHub issue backlogs with agents for discovery, triage, sprint planning, and execution | 1 | 6 | 6 | 0 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-github) |
42| gitlab | Run GitLab merge request and pipeline workflows through a focused skill package | 0 | 0 | 1 | 1 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-gitlab) |
43| hve-core | Flagship collection: RPI (Research, Plan, Implement, Review) workflow for complex tasks with Git workflow prompts | 17 | 15 | 7 | 1 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-core) |
44| hve-core-all | Complete collection of all artifacts across all domains | 51 | 63 | 102 | 12 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-core-all) |
45| installer | Deploy HVE artifacts across workspace configurations with decision-driven setup | 0 | 0 | 1 | 1 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-installer) |
46| jira | Manage Jira backlogs, plan PRD-driven issue hierarchies, and execute issue operations | 2 | 4 | 6 | 1 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-jira) |
47| project-planning | Create architecture decision records, requirements documents, and diagrams through guided AI workflows | 18 | 11 | 20 | 0 | Stable | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-project-planning) |
48| rai-planning | Assess AI systems against Responsible AI standards and capture standards-aligned backlog work | 2 | 3 | 8 | 0 | Experimental | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-rai-planning) |
49| security | Security review, planning, incident response, risk assessment, and vulnerability analysis | 9 | 14 | 19 | 5 | Experimental | [Install](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-security) |
50
51## How Collections Fit Together
52
53The following diagram shows how the domain collections relate to the two marketplace extensions.
54
55```mermaid
56graph TD
57 HCA["hve#45;core#45;all<br/>(221 artifacts)"]
58 INS["installer<br/>(2 artifacts)"]
59
60 ADO["ado"]
61 CS["coding#45;standards"]
62 DS["data#45;science"]
63 DT["design#45;thinking"]
64 EXP["experimental"]
65 GH["github"]
66 GL["gitlab"]
67 HC["hve#45;core"]
68 JR["jira"]
69 PP["project#45;planning"]
70 RP["rai#45;planning"]
71 SP["security"]
72
73 HCA --> ADO
74 HCA --> CS
75 HCA --> DS
76 HCA --> DT
77 HCA --> EXP
78 HCA --> GH
79 HCA --> GL
80 HCA --> HC
81 HCA --> JR
82 HCA --> PP
83 HCA --> RP
84 HCA --> SP
85```
86
87`hve-core-all` bundles every domain collection into a single extension. The `installer` operates independently as a deployment tool for selecting and installing individual collections into workspaces.
88
89## Choosing Your Path
90
91If you are getting started and want the simplest setup, install `hve-core-all`. You get every artifact immediately and can explore at your own pace.
92
93If you prefer a leaner workspace or need to standardize which artifacts are available across a team, use the `installer` to deploy only the collections relevant to your workflow.
94
95> [!TIP]
96> You can always switch later. Start with `hve-core-all` to explore, then move to the installer approach when you know which collections your team needs.
97
98## After Installing a Collection
99
100Once a collection is installed, its artifacts activate automatically:
101
1021. Agents appear in the Copilot Chat agent picker (press `Ctrl+.` or use the dropdown).
1032. Prompts are available as slash commands (type `/` in Copilot Chat to see them).
1043. Instructions apply automatically to matching files based on their `applyTo` patterns.
1054. Skills extend agent capabilities without additional configuration.
106
107To verify installation, open Copilot Chat and check that collection-specific agents appear in the agent picker. For example, installing the `hve-core` collection adds Task Researcher, Task Planner, Task Implementor, and Memory agents.
108
109To add more collections later, search "HVE" in the VS Code Extensions marketplace or use the selective install commands from the table above.
110
111---
112
113<!-- markdownlint-disable MD036 -->
114*🤖 Crafted with precision by ✨Copilot following brilliant human instruction,
115then carefully refined by our team of discerning human reviewers.*
116<!-- markdownlint-enable MD036 -->
117