Work Configuration
Define PR exclusion rules and work category mappings to control how Koalr classifies and filters pull requests.
Overview
The Work Configuration page lets you customize how Koalr processes pull requests for metrics calculation. It has two sections: PR Exclusion Rules for filtering out noise, and Work Category Mapping for automatic classification of PRs.
Navigate to Settings > Work Configuration to manage these rules.
PR exclusion rules
Exclusion rules remove pull requests from all metrics calculations based on pattern matching. Use them to filter out automated PRs, documentation-only changes, or specific authors that should not count toward team metrics.
Rule types
| Type | Matches against | Example pattern |
|---|---|---|
REPOSITORY | Repository name | docs-* |
BRANCH | Branch name | dependabot/* |
LABEL | PR label | skip-metrics |
AUTHOR | PR author username | dependabot[bot] |
PATH | Changed file paths | *.md |
Creating an exclusion rule
- Select the rule type from the dropdown.
- Enter a pattern using glob syntax (e.g.,
dependabot*ordocs-*). - Optionally add a description to explain why the rule exists.
- Click Add.
Managing exclusion rules
- Toggle active/inactive -- use the switch in the Active column to temporarily disable a rule without deleting it. Inactive rules are ignored during metrics calculation.
- Delete -- click the trash icon to permanently remove a rule.
Work category mapping
Category rules automatically classify pull requests into work types based on their labels, branch names, or titles. This classification feeds into Flow Metrics and investment allocation reports.
Available categories
- Feature
- Bug Fix
- Maintenance
- Documentation
- Testing
- Infrastructure
- Refactoring
- Other
Match fields
Each rule matches against one of three PR attributes:
| Field | Description |
|---|---|
label | Matches against PR labels |
branch | Matches against the branch name |
title | Matches against the PR title text |
Creating a category rule
- Select the category from the dropdown.
- Select the match field (label, branch, or title).
- Enter a pattern (e.g.,
fix/*for branches orbugfor labels). - Set a priority (lower numbers are evaluated first; useful when a PR could match multiple rules).
- Click Add.
Rule evaluation
Rules are evaluated in priority order (lowest number first). The first matching rule determines the PR's category. PRs that do not match any rule are classified as "Other."
Deleting a category rule
Click the trash icon next to any rule to permanently remove it. PRs previously classified by that rule will be reclassified on the next sync.
Effect on metrics
Changes to exclusion rules and category mappings apply to future data processing. Historical metrics are recalculated during the next scheduled sync cycle to reflect the updated rules.