feat(templates): align issue template title prefixes with Conventional Commit format #426
Description
Summary
Update all GitHub issue templates to use Conventional Commit-style title prefixes instead of bracket-based labels. This ensures consistent commit/PR title formatting that aligns with the repository's established commit message conventions.
Background
The repository uses Conventional Commits format as documented in .github/instructions/commit-message.instructions.md. Issue templates currently use bracket-style prefixes that don't align with this convention:
| Template | Current Prefix | Proposed Prefix |
|---|---|---|
| Bug Report | [Bug]: |
fix: |
| Custom Agent Request | [Custom Agent]: |
feat(agents): |
| General Issue | [Issue]: |
feat: |
| Instruction File Request | [Instruction File]: |
feat(instructions): |
| Prompt Request | [Prompt]: |
feat(prompts): |
| Skill Request | [Skill]: |
feat(skills): |
Benefits
- Consistent Formatting: Issue titles match commit message and PR title conventions
- Automated Changelog: Properly formatted titles enable release-please and changelog automation
- Scope Clarity: Scopes like
agents,instructions,prompts,skillsclearly identify affected areas - Type Accuracy: Bug reports use
fix:while feature requests usefeat:matching semantic intent
Files to Modify
Issue Templates
.github/ISSUE_TEMPLATE/bug-report.yml.github/ISSUE_TEMPLATE/custom-agent-request.yml.github/ISSUE_TEMPLATE/general-issue.yml.github/ISSUE_TEMPLATE/instruction-file-request.yml.github/ISSUE_TEMPLATE/prompt-request.yml.github/ISSUE_TEMPLATE/skill-request.yml
Scope Alignment
.github/instructions/commit-message.instructions.md- Add(agents)and(skills)scopes
Documentation Updates
.github/agents/github-issue-manager.agent.md- Update bracket-style examples.github/prompts/github-add-issue.prompt.md- Update bracket-style examplesdocs/contributing/ai-artifacts-common.md- Add GitHub Issue Title Conventions section
Acceptance Criteria
- All issue template
title:fields use Conventional Commit format - Bug reports use
fix:prefix - Feature requests use
feat:with appropriate scope -
(agents)and(skills)scopes added to commit-message.instructions.md - Documentation examples use Conventional Commit format
- Contributing docs include issue title guidance
- Templates validate successfully (YAML lint passes)
- New issues created from templates have correct title format
Considerations
- Breaking Change: No - this only affects the default title in new issues
- User Impact: Users may need to adjust titles if they're accustomed to bracket format
- Related Documentation: Contributing docs updated with issue title conventions
References
- Conventional Commits Specification
.github/instructions/commit-message.instructions.md- Research:
.copilot-tracking/research/2026-02-05-issue-template-title-format-research.md