Skip to content

chore(templates): align issue templates with conventional commit format#427

Merged
WilliamBerryiii merged 2 commits intomainfrom
chore/issue-426-conventional-commit-templates
Feb 5, 2026
Merged

chore(templates): align issue templates with conventional commit format#427
WilliamBerryiii merged 2 commits intomainfrom
chore/issue-426-conventional-commit-templates

Conversation

@WilliamBerryiii
Copy link
Member

Description

Converted all 6 issue template title prefixes from bracket-style (e.g., [Bug]:) to Conventional Commit format (e.g., fix:). Cleaned up scope definitions in commit-message.instructions.md from 26 inherited scopes to 12 project-relevant ones. Updated documentation examples in agent and prompt files to match the new format and added contributing guidance for issue title conventions.

  • chore(templates): convert 6 issue template title prefixes to conventional commit style

    • bug-report.yml: [Bug]:fix:
    • custom-agent-request.yml: [Custom Agent]:feat(agents):
    • general-issue.yml: [Issue]:feat:
    • instruction-file-request.yml: [Instruction File]:feat(instructions):
    • prompt-request.yml: [Prompt]:feat(prompts):
    • skill-request.yml: [Skill]:feat(skills):
  • refactor(instructions): reduce commit-message.instructions.md scopes from 26 to 12 project-relevant definitions

    • Added descriptions for each scope
    • Removed irrelevant scopes inherited from microsoft/edge-ai (cloud, iot-ops, terraform, bicep, etc.)
    • Updated attribution from microsoft/edge-ai to microsoft/hve-core
  • docs(agents): update github-issue-manager.agent.md examples to use conventional commit format

  • docs(prompts): update github-add-issue.prompt.md examples to use conventional commit format

  • docs: add "GitHub Issue Title Conventions" section to ai-artifacts-common.md with issue type mapping table

Related Issue(s)

Closes #426

Type of Change

Select all that apply:

Code & Documentation:

  • Bug fix (non-breaking change fixing an issue)
  • New feature (non-breaking change adding functionality)
  • Breaking change (fix or feature causing existing functionality to change)
  • Documentation update

Infrastructure & Configuration:

  • GitHub Actions workflow
  • Linting configuration (markdown, PowerShell, etc.)
  • Security configuration
  • DevContainer configuration
  • Dependency update

AI Artifacts:

  • Reviewed contribution with prompt-builder agent and addressed all feedback
  • Copilot instructions (.github/instructions/*.instructions.md)
  • Copilot prompt (.github/prompts/*.prompt.md)
  • Copilot agent (.github/agents/*.agent.md)
  • Copilot skill (.github/skills/*/SKILL.md)

Other:

  • Script/automation (.ps1, .sh, .py)
  • Other (please describe):

Sample Prompts (for AI Artifact Contributions)

Not applicable - this PR updates existing artifacts to align with new conventions rather than adding new functionality.

Testing

  • Verified all 6 issue templates have correct Conventional Commit title prefixes
  • Validated YAML syntax with npm run lint:yaml
  • Validated markdown files with npm run lint:md
  • Validated frontmatter with npm run lint:frontmatter

Checklist

Required Checks

  • Documentation is updated (if applicable)
  • Files follow existing naming conventions
  • Changes are backwards compatible (if applicable)
  • Tests added for new functionality (if applicable)

AI Artifact Contributions

  • Used /prompt-analyze to review contribution
  • Addressed all feedback from prompt-builder review
  • Verified contribution follows common standards and type-specific requirements

Required Automated Checks

The following validation commands must pass before merging:

  • Markdown linting: npm run lint:md
  • Spell checking: npm run spell-check
  • Frontmatter validation: npm run lint:frontmatter
  • Link validation: npm run lint:md-links
  • PowerShell analysis: npm run lint:ps

Security Considerations

  • This PR does not contain any sensitive or NDA information
  • Any new dependencies have been reviewed for security issues
  • Security-related scripts follow the principle of least privilege

Additional Notes

The scope cleanup removed 17 irrelevant scopes inherited from microsoft/edge-ai that do not apply to hve-core (cloud, data, edge, application, tools, resource-group, security-identity, observability, fabric, messaging, vm-host, cncf-cluster, iot-ops, blueprints, terraform, bicep, azureml). Five new scopes were added to cover hve-core artifact categories (agents, skills, templates, workflows, extension).

📝 - Generated by Copilot

- convert 6 issue template title prefixes to conventional commit style
- clean up commit-message.instructions.md scopes from 26 to 12
- update documentation examples in agent and prompt files
- add GitHub issue title conventions to contributing guide

Closes #426

📝 - Generated by Copilot
@WilliamBerryiii WilliamBerryiii requested a review from a team as a code owner February 5, 2026 19:14
Copilot AI review requested due to automatic review settings February 5, 2026 19:14
@github-actions
Copy link

github-actions bot commented Feb 5, 2026

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@codecov-commenter
Copy link

codecov-commenter commented Feb 5, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 76.19%. Comparing base (adf6a5f) to head (43c06c5).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main     #427      +/-   ##
==========================================
- Coverage   76.22%   76.19%   -0.03%     
==========================================
  Files          20       20              
  Lines        3503     3503              
==========================================
- Hits         2670     2669       -1     
- Misses        833      834       +1     
Flag Coverage Δ
pester 76.19% <ø> (-0.03%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR standardizes issue template title prefixes to use Conventional Commit format, replacing bracket-style prefixes (e.g., [Bug]:) with semantic commit types and scopes (e.g., fix:). The scope definitions in commit-message.instructions.md have been streamlined from 26 inherited scopes to 12 project-relevant ones with descriptions. Documentation examples across agents, prompts, and contributing guides have been updated to reflect the new conventions.

Changes:

  • Converted 6 issue template title prefixes to Conventional Commit format (bug reports use fix:, feature requests use feat: with appropriate scopes)
  • Reduced commit message scopes from 26 to 12, removing inherited microsoft/edge-ai scopes and adding hve-core-specific ones (agents, skills, templates, workflows, extension)
  • Updated documentation examples in github-issue-manager.agent.md and github-add-issue.prompt.md to use new format
  • Added "GitHub Issue Title Conventions" section to ai-artifacts-common.md with mapping table and benefits

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated no comments.

Show a summary per file
File Description
.github/ISSUE_TEMPLATE/bug-report.yml Changed title prefix from [Bug]: to fix:
.github/ISSUE_TEMPLATE/custom-agent-request.yml Changed title prefix from [Custom Agent]: to feat(agents):
.github/ISSUE_TEMPLATE/general-issue.yml Changed title prefix from [Issue]: to feat:
.github/ISSUE_TEMPLATE/instruction-file-request.yml Changed title prefix from [Instruction File]: to feat(instructions):
.github/ISSUE_TEMPLATE/prompt-request.yml Changed title prefix from [Prompt]: to feat(prompts):
.github/ISSUE_TEMPLATE/skill-request.yml Changed title prefix from [Skill]: to feat(skills):
.github/instructions/commit-message.instructions.md Replaced 26 scopes with 12 project-relevant scopes with descriptions; updated attribution to microsoft/hve-core
.github/agents/github-issue-manager.agent.md Updated example issue titles from bracket style to conventional commit format
.github/prompts/github-add-issue.prompt.md Updated all examples from [Bug]: prefix to fix: prefix
docs/contributing/ai-artifacts-common.md Added new section documenting GitHub issue title conventions with format table, benefits, and reference link

@WilliamBerryiii WilliamBerryiii added this to the v2.2.0 milestone Feb 5, 2026
@WilliamBerryiii WilliamBerryiii merged commit 2d28702 into main Feb 5, 2026
16 checks passed
@WilliamBerryiii WilliamBerryiii deleted the chore/issue-426-conventional-commit-templates branch February 5, 2026 19:42
WilliamBerryiii pushed a commit that referenced this pull request Feb 6, 2026
🤖 I have created a release *beep* *boop*
---


##
[2.2.0](hve-core-v2.1.0...hve-core-v2.2.0)
(2026-02-06)


### ✨ Features

* add incident response prompt template
([#386](#386))
([0adb35c](0adb35c))
* add Skills and VS Code Extension categories to issue/PR templates
([#410](#410))
([108e160](108e160))
* **hve-core-guidance-instructions:** update guidance artifacts and MCP
config ([#402](#402))
([25b34de](25b34de))
* **security:** add action version consistency validation
([#423](#423))
([f3bb787](f3bb787))
* **workflows:** add copyright header validation CI workflow
([#429](#429))
([c53de22](c53de22))


### 🐛 Bug Fixes

* **docs:** add missing Copilot footers, consolidate validation
exclusions ([#419](#419))
([e40f960](e40f960))
* **scripts:** include CIHelpers module + packaging script testability
([#420](#420))
([da26edf](da26edf))


### ♻️ Refactoring

* migrate inline CI code to CIHelpers module
([#393](#393))
([adf6a5f](adf6a5f))


### 🔧 Maintenance

* **templates:** align issue templates with conventional commit format
([#427](#427))
([2d28702](2d28702))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: hve-core-release-please[bot] <254602402+hve-core-release-please[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(templates): align issue template title prefixes with Conventional Commit format

3 participants