microsoft/hve-core
Publicmirrored fromhttps://github.com/microsoft/hve-coreAvailable
docs/contributing/README.md
64lines · modecode
| 1 | --- |
| 2 | title: Contributing AI Artifacts |
| 3 | description: Guides for contributing agents, instructions, and prompts to hve-core |
| 4 | sidebar_position: 1 |
| 5 | author: Microsoft |
| 6 | ms.date: 2026-05-13 |
| 7 | ms.topic: overview |
| 8 | keywords: |
| 9 | - contributing |
| 10 | - agents |
| 11 | - instructions |
| 12 | - prompts |
| 13 | - ai artifacts |
| 14 | estimated_reading_time: 2 |
| 15 | --- |
| 16 | |
| 17 | Guidelines and standards for contributing AI artifacts to hve-core. |
| 18 | |
| 19 | ## Finding the Right Guide |
| 20 | |
| 21 | Use this table to navigate to the appropriate guide based on what you want to contribute: |
| 22 | |
| 23 | | I want to... | Start here | |
| 24 | |-----------------------------------------|-----------------------------------------------------------------------------------------------------------------| |
| 25 | | Report a bug or suggest an enhancement | [CONTRIBUTING.md](https://github.com/microsoft/hve-core/blob/main/CONTRIBUTING.md#reporting-bugs) | |
| 26 | | Submit a code change | [CONTRIBUTING.md](https://github.com/microsoft/hve-core/blob/main/CONTRIBUTING.md#your-first-code-contribution) | |
| 27 | | Improve general documentation | [CONTRIBUTING.md](https://github.com/microsoft/hve-core/blob/main/CONTRIBUTING.md#improving-the-documentation) | |
| 28 | | Create or modify an agent | [Custom Agents](custom-agents.md) | |
| 29 | | Create or modify an instruction file | [Instructions](instructions.md) | |
| 30 | | Create or modify a prompt | [Prompts](prompts.md) | |
| 31 | | Create or modify a skill | [Skills](skills.md) | |
| 32 | | Understand shared AI artifact standards | [Common Standards](ai-artifacts-common.md) | |
| 33 | | Learn about the release process | [Release Process](release-process.md) | |
| 34 | | Check CI and review requirements | [Branch Protection](branch-protection.md) | |
| 35 | | See the project roadmap | [Roadmap](ROADMAP.md) | |
| 36 | |
| 37 | ## Contribution Guides |
| 38 | |
| 39 | | Guide | Description | |
| 40 | |--------------------------------------------|---------------------------------------------------------------------------------| |
| 41 | | [Common Standards](ai-artifacts-common.md) | Shared conventions, quality gates, and rejection criteria for all contributions | |
| 42 | | [Custom Agents](custom-agents.md) | How to create and submit new agent definitions | |
| 43 | | [Instructions](instructions.md) | How to create repository-specific coding guidelines | |
| 44 | | [Prompts](prompts.md) | How to create reusable prompt templates | |
| 45 | | [Skills](skills.md) | How to create skill packages with scripts and documentation | |
| 46 | | [Release Process](release-process.md) | Extension channels, maturity levels, and publishing workflow | |
| 47 | |
| 48 | ## Before You Start |
| 49 | |
| 50 | 1. Read the [Common Standards](ai-artifacts-common.md) first - it defines quality gates that apply to all artifact types |
| 51 | 2. Check existing artifacts in `.github/` to avoid duplicating functionality |
| 52 | 3. Review the [main Contributing Guide](https://github.com/microsoft/hve-core/blob/main/CONTRIBUTING.md) for general contribution process |
| 53 | |
| 54 | ## Quick Links |
| 55 | |
| 56 | * [Agents Directory](https://github.com/microsoft/hve-core/blob/main/.github/agents/) |
| 57 | * [Instructions Directory](https://github.com/microsoft/hve-core/blob/main/.github/instructions/) |
| 58 | * [Prompts Directory](https://github.com/microsoft/hve-core/blob/main/.github/prompts/) |
| 59 | * [Skills Directory](https://github.com/microsoft/hve-core/blob/main/.github/skills/) |
| 60 | |
| 61 | --- |
| 62 | |
| 63 | *🤖 Crafted with precision by ✨Copilot following brilliant human instruction, |
| 64 | then carefully refined by our team of discerning human reviewers.* |
| 65 | |