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