PR titles and commit messages must include a conventional commit type keyword. This keyword drives automatic t: label assignment via CI (.github/scripts/label-pr.py reads .github/label-pr.json).
Return the chosen type keyword and the t: label it maps to.
Format
The type keyword appears after the Jira ticket prefix:
[PM-XXXXX] <type>: <imperative summary>
The CI labeling script matches <type>: or <type>( in the lowercased PR title, so the keyword must be followed by a colon or parenthesis.
Type Keywords
| Type | Label | Use for |
|---|---|---|
feat |
t:feature |
New features or functionality |
fix |
t:bug |
Bug fixes |
refactor |
t:tech-debt |
Code restructuring without behavior change |
chore |
t:tech-debt |
Maintenance, cleanup, minor tweaks |
test |
t:tech-debt |
Adding or updating tests |
perf |
t:tech-debt |
Performance improvements |
docs |
t:docs |
Documentation changes |
ci / build |
t:ci |
CI/CD and build system changes |
deps |
t:deps |
Dependency updates |
llm |
t:llm |
LLM/Claude configuration changes |
breaking |
t:breaking-change |
Breaking changes requiring migration |
misc |
t:misc |
Changes that do not fit other categories |
CI also accepts additional aliases (e.g., revert, bugfix, cleanup). See .github/label-pr.json for the full mapping.
Selecting a Type
Infer the type from the task description and changes made. If the type cannot be confidently determined, ask the user.
Ambiguous Cases
- Refactor that incidentally fixes a bug → use the primary intent:
fix:if the bug was the goal,refactor:if the restructuring was the goal - Adding tests for existing untested code →
test:(notchore:) - Updating a dependency to fix a vulnerability →
deps:(notfix:) - Changing Claude/LLM configuration files →
llm:(notchore:) - Removing dead code →
refactor:(notchore:— it changes the codebase structure)