microsoft/hve-core
Publicmirrored fromhttps://github.com/microsoft/hve-coreAvailable
docs/customization/README.md
106lines · modecode
| 1 | --- |
| 2 | title: Customizing HVE Core |
| 3 | description: Overview of customization approaches from lightweight settings to full fork-and-extend, with role-based entry points |
| 4 | author: Microsoft |
| 5 | ms.date: 2026-02-24 |
| 6 | ms.topic: overview |
| 7 | keywords: |
| 8 | - customization |
| 9 | - github copilot |
| 10 | - hve-core |
| 11 | - configuration |
| 12 | estimated_reading_time: 5 |
| 13 | --- |
| 14 | |
| 15 | ## Customization Spectrum |
| 16 | |
| 17 | HVE Core supports a range of customization depths. Start with the lightest option that meets your needs, then move deeper when the situation demands it. |
| 18 | |
| 19 | ```mermaid |
| 20 | graph LR |
| 21 | A["VS Code Settings"] --> B["Instructions"] |
| 22 | B --> C["Agents & Prompts"] |
| 23 | C --> D["Skills"] |
| 24 | D --> E["Collections"] |
| 25 | E --> F["Build System"] |
| 26 | F --> G["Fork & Extend"] |
| 27 | |
| 28 | style A fill:#e8f5e9 |
| 29 | style B fill:#c8e6c9 |
| 30 | style C fill:#a5d6a7 |
| 31 | style D fill:#81c784 |
| 32 | style E fill:#66bb6a |
| 33 | style F fill:#4caf50 |
| 34 | style G fill:#388e3c |
| 35 | ``` |
| 36 | |
| 37 | * **VS Code Settings** suit individual preferences like font size, theme, and editor behavior. No files to create or share. |
| 38 | * **Instructions** configure Copilot behavior through `.github/copilot-instructions.md` and `.instructions.md` files. Lowest effort with the highest return for shaping AI output. |
| 39 | * **Agents and Prompts** define specialized workflows: agents for multi-turn interactions, prompts for single-shot tasks. Both accept tool restrictions and delegation rules. |
| 40 | * **Skills** package domain knowledge into self-contained bundles with optional scripts. Use when instruction files alone cannot capture the depth of a domain. |
| 41 | * **Collections** bundle agents, prompts, instructions, and skills into distributable packages for team or organization adoption. |
| 42 | * **Build System** customization lets you add validation scripts, schema checks, and plugin generation pipelines. |
| 43 | * **Fork and Extend** gives full control over every artifact. Fork the repository when your changes diverge significantly from upstream. |
| 44 | |
| 45 | ## Choose Your Approach |
| 46 | |
| 47 | | Goal | Approach | Files Involved | Difficulty | |
| 48 | |--------------------------------------------|-----------------|-------------------------------------------------------|------------| |
| 49 | | Set coding standards for Copilot | Instructions | `.github/copilot-instructions.md`, `.instructions.md` | Low | |
| 50 | | Create a reusable workflow | Prompt | `.github/prompts/{collection}/name.prompt.md` | Low | |
| 51 | | Build a specialized Copilot assistant | Agent | `.github/agents/{collection}/name.agent.md` | Medium | |
| 52 | | Package domain expertise | Skill | `.github/skills/{collection}/{skill}/SKILL.md` | Medium | |
| 53 | | Share curated bundles across teams | Collection | `collections/*.collection.yml` | Medium | |
| 54 | | Add custom validation or plugin generation | Build System | `scripts/`, `package.json` | High | |
| 55 | | Diverge from upstream entirely | Fork and Extend | Full repository | High | |
| 56 | |
| 57 | ## Authoring with Prompt Builder |
| 58 | |
| 59 | The [Prompt Builder](../../.github/agents/hve-core/prompt-builder.agent.md) agent streamlines creation, evaluation, and refinement of all artifact types. Three commands cover the full authoring workflow: |
| 60 | |
| 61 | | Command | Purpose | |
| 62 | |--------------------|-----------------------------------------------------------------| |
| 63 | | `/prompt-build` | Create new artifacts or improve existing ones | |
| 64 | | `/prompt-analyze` | Evaluate quality and produce a structured assessment report | |
| 65 | | `/prompt-refactor` | Consolidate, deduplicate, or restructure related artifact files | |
| 66 | |
| 67 | Each artifact guide below includes an "Accelerating with Prompt Builder" section with type-specific examples and sample invocations. |
| 68 | |
| 69 | ## Role-Based Entry Points |
| 70 | |
| 71 | Each HVE role benefits from different customization techniques. The table below maps the nine roles to the guides most relevant to their workflow. |
| 72 | |
| 73 | | Role | Recommended Guides | Rationale | |
| 74 | |--------------------------|---------------------------------------------------------------------------|---------------------------------------------------------------------------------| |
| 75 | | Engineer | [Instructions](instructions.md), [Agents](agents.md) | Coding standards and specialized review agents accelerate daily development | |
| 76 | | TPM | [Prompts](prompts.md), [Collections](collections.md) | Reusable planning prompts and curated bundles standardize project workflows | |
| 77 | | Tech Lead / Architect | [Instructions](instructions.md), [Agents](agents.md), [Skills](skills.md) | Standards enforcement, architecture review agents, and deep domain knowledge | |
| 78 | | Security Architect | [Skills](skills.md), [Instructions](instructions.md) | Compliance knowledge packages and security-focused coding conventions | |
| 79 | | Data Scientist | [Skills](skills.md), [Prompts](prompts.md) | Analytical domain bundles and repeatable notebook workflows | |
| 80 | | SRE / Operations | [Instructions](instructions.md), [Environment](environment.md) | Infrastructure conventions and DevContainer tuning | |
| 81 | | Business Program Manager | [Prompts](prompts.md), [Team Adoption](team-adoption.md) | Sprint-planning prompts and governance patterns for stakeholder alignment | |
| 82 | | New Contributor | [Instructions](instructions.md), [Environment](environment.md) | Quick onboarding through conventions and a ready-to-use development environment | |
| 83 | | Utility | [Collections](collections.md), [Build System](build-system.md) | Cross-cutting tooling assembly and validation pipeline customization | |
| 84 | |
| 85 | ## File Index |
| 86 | |
| 87 | 1. [Customizing with Instructions](instructions.md): Configure Copilot with `copilot-instructions.md` and instruction files |
| 88 | 2. [Creating Custom Agents](agents.md): Build specialized agents with tool restrictions and subagent delegation |
| 89 | 3. [Creating Custom Prompts](prompts.md): Author reusable prompt templates with variables |
| 90 | 4. [Authoring Custom Skills](skills.md): Create domain knowledge packages |
| 91 | 5. [Managing Collections](collections.md): Bundle artifacts into distributable packages |
| 92 | 6. [Build System and Validation](build-system.md): Plugin generation, schema validation, npm scripts |
| 93 | 7. [Forking and Extending](forking.md): Full fork-and-extend customization |
| 94 | 8. [Environment Customization](environment.md): DevContainers, VS Code settings, MCP servers |
| 95 | 9. [Team Adoption and Governance](team-adoption.md): Governance, naming, onboarding, change management |
| 96 | |
| 97 | ## Related Resources |
| 98 | |
| 99 | * [Contributing Guides](../contributing/): Detailed syntax references and contribution standards for each artifact type |
| 100 | * [Getting Started](../getting-started/): Installation and first workflow guides |
| 101 | * [Architecture](../architecture/): Technical architecture overview and design decisions |
| 102 | |
| 103 | <!-- markdownlint-disable MD036 --> |
| 104 | *🤖 Crafted with precision by ✨Copilot following brilliant human instruction, |
| 105 | then carefully refined by our team of discerning human reviewers.* |
| 106 | <!-- markdownlint-enable MD036 --> |
| 107 | |