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, skills clearly identify affected areas
- Type Accuracy: Bug reports use
fix: while feature requests use feat: 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
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
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:[Bug]:fix:[Custom Agent]:feat(agents):[Issue]:feat:[Instruction File]:feat(instructions):[Prompt]:feat(prompts):[Skill]:feat(skills):Benefits
agents,instructions,prompts,skillsclearly identify affected areasfix:while feature requests usefeat:matching semantic intentFiles 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.ymlScope Alignment
.github/instructions/commit-message.instructions.md- Add(agents)and(skills)scopesDocumentation 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 sectionAcceptance Criteria
title:fields use Conventional Commit formatfix:prefixfeat:with appropriate scope(agents)and(skills)scopes added to commit-message.instructions.mdConsiderations
References
.github/instructions/commit-message.instructions.md.copilot-tracking/research/2026-02-05-issue-template-title-format-research.md