microsoft/hve-core
Publicmirrored fromhttps://github.com/microsoft/hve-coreAvailable
docs/hve-guide/lifecycle/setup.md
82lines · modecode
| 1 | --- |
| 2 | title: "Stage 1: Setup" |
| 3 | description: Install and configure HVE Core tooling for your project with guided onboarding |
| 4 | sidebar_position: 4 |
| 5 | author: Microsoft |
| 6 | ms.date: 2026-03-10 |
| 7 | ms.topic: how-to |
| 8 | keywords: |
| 9 | - ai-assisted project lifecycle |
| 10 | - setup |
| 11 | - installation |
| 12 | - configuration |
| 13 | - onboarding |
| 14 | estimated_reading_time: 6 |
| 15 | --- |
| 16 | |
| 17 | ## Overview |
| 18 | |
| 19 | Setup is the entry point for every HVE Core engagement. This stage covers installing HVE Core collections, configuring your development environment, and establishing preferences that persist across sessions. All roles begin here before advancing to Discovery. |
| 20 | |
| 21 | ## When You Enter This Stage |
| 22 | |
| 23 | You enter Setup when starting a new project or joining an existing engagement that uses HVE Core tooling. |
| 24 | |
| 25 | > [!NOTE] |
| 26 | > Prerequisites: VS Code with GitHub Copilot Chat enabled. See [Getting Started](../../getting-started/install.md) for detailed installation instructions. |
| 27 | |
| 28 | ## Available Tools |
| 29 | |
| 30 | | Tool | Type | How to Invoke | Purpose | |
| 31 | |-------------------|-------------|----------------------------------------------------------|-------------------------------------------------| |
| 32 | | installer | Skill | Ask any agent: "help me customize hve-core installation" | Install and configure HVE Core for your project | |
| 33 | | memory | Agent | Select **memory** agent | Store persistent preferences and conventions | |
| 34 | | checkpoint | Prompt | `/checkpoint` | Save current environment state | |
| 35 | | git-setup | Prompt | `/git-setup` | Configure Git settings for the project | |
| 36 | | writing-style | Instruction | Auto-activated on `**/*.md` | Enforces voice and tone conventions | |
| 37 | | markdown | Instruction | Auto-activated on `**/*.md` | Enforces Markdown formatting rules | |
| 38 | | prompt-builder | Instruction | Auto-activated on AI artifacts | Enforces authoring standards | |
| 39 | | hve-core-location | Instruction | Auto-activated on `**` | Resolves missing references to hve-core paths | |
| 40 | |
| 41 | ## Role-Specific Guidance |
| 42 | |
| 43 | All roles pass through Setup as their first step. Engineers and new contributors spend the most time here configuring language-specific tooling. TPMs and Tech Leads typically complete Setup quickly and advance to [Stage 2: Discovery](discovery.md). |
| 44 | |
| 45 | For role-specific onboarding paths, see the [Role Guides](../roles/). |
| 46 | |
| 47 | ## Starter Prompts |
| 48 | |
| 49 | Install the [HVE Core extension](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-core), or use a [clone-based method](../../getting-started/install.md): |
| 50 | |
| 51 | For customization, install the [HVE Core Installer extension](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-installer) and ask any agent "help me customize hve-core installation". |
| 52 | |
| 53 | ```text |
| 54 | Set up HVE Core for my Python microservices project. Install the rpi and |
| 55 | coding-standards collections. Configure .copilot-tracking/ in .gitignore |
| 56 | and verify agents appear in the Copilot Chat picker. |
| 57 | ``` |
| 58 | |
| 59 | ```text |
| 60 | /checkpoint mode=save description=python-microservices-setup |
| 61 | ``` |
| 62 | |
| 63 | ```text |
| 64 | /git-setup |
| 65 | ``` |
| 66 | |
| 67 | Select **memory** agent: |
| 68 | |
| 69 | ```text |
| 70 | Store my coding conventions: use 4-space indentation for Python, enforce |
| 71 | type hints on all public functions, and prefer pytest over unittest for |
| 72 | test files under tests/. |
| 73 | ``` |
| 74 | |
| 75 | ## Stage Outputs and Next Stage |
| 76 | |
| 77 | Setup produces a configured development environment with HVE Core collections installed and user preferences stored. Transition to [Stage 2: Discovery](discovery.md) when installation is complete. |
| 78 | |
| 79 | <!-- markdownlint-disable MD036 --> |
| 80 | *🤖 Crafted with precision by ✨Copilot following brilliant human instruction, |
| 81 | then carefully refined by our team of discerning human reviewers.* |
| 82 | <!-- markdownlint-enable MD036 --> |
| 83 | |