Investment balance
Everything you need to know about setting up your Investment Balance and configuring your organization's categories.
Last updated
Was this helpful?
Everything you need to know about setting up your Investment Balance and configuring your organization's categories.
Last updated
Was this helpful?
The Investment Balance shows activity on pull requests and issues grouped by the configured investment categories and includes both completed issues and merged pull requests. Over a longer period of time, we've seen that these activities are a reliable proxy for understanding development time.
You can configure more than one way to break down your work into distinct sets of categories.
The primary breakdown is meant for the most important categorization you want to track company-wide, is visible everywhere in Swarmia, and has a bunch of tools to help you increase data quality.
You can create additional breakdowns that are available exclusively on the Investment Balance view.
If your team members have contributed towards issues belonging to other teams, those issues will also show up. Think of this as not a bug, but a feature: the team is investing its time somewhere, and the report shows you where that investment goes, even if it's not for the things you might've expected.
We start by looking at all contributions by all team members of the selected team, then determine the investment category based on the rules you've set up.
Then work is grouped by investment category. (These categories are mutually exclusive and collectively exhaustive within any single breakdown.)
If multiple tasks belong to a bigger project, it's possible to have different investment categories assigned to each task and the project as a whole. In this case, we'll show each task in its respective category of work.
Each issue or pull request can link only to one category. All work not linked to a category will show up as uncategorized for the primary breakdown, or the similar last catch-all category for additional breakdowns.
In other words, categories are mutually exclusive and collectively exhaustive.
The logic for determining an issue’s category works in the following order:
Setting the category for the issue manually takes precedence over everything else. (Manual override)
If the issue matches one or more category filters, it will be linked to the top most matching category. You can re-order the categories in settings.
If the issue is a child of another issue (parent) that either matches with category filters or is manually categorized, it will inherit from the parent issue. The inheritance works several steps down the issue hierarchy.
If there are no category matches, the issue will show up as uncategorized.
For instance, if we have the following issue hierarchy with issues uncategorized, with the exception of one bug that matches the filters for KTLO:
If the top epic would then be categorized as New Things, all the uncategorized children of the epic would also get categorized as New Things. Bug 1 (and any children it might have) would not be automatically categorized as New Things (as it matches step 2 in the logic).
If there are no investment category matches of any kind, the issue is considered uncategorized.
The logic for determining a pull request's category is similar:
Linking PRs to categories takes precedence over everything else.
If the PR is linked to an issue that's categorized, the PR is assigned the same category.
If the PR matches one or more investment category filters, it will be linked to the first matching category.
If there are no category matches, it will show up as uncategorized.
Company initiatives
Product focus areas
R&D Capitalization / R&D expenditure
Releases, or a company level roadmap (e.g. "Q3")
Using our automated filters, you can assign work to categories based on certain criteria.
We support a variety of filter options for both Pull Request data and Issue data.
Your filter might be as simple as this:
But reality is often a bit messier. In a large organization, each team might have their own little quirks in how they track their work. For instance, let's say most teams use Epics and Stories for Roadmap work... but some also use specific labels for that purpose, and one team stubbornly wants to use their custom Jira issue type.
No problem:
In addition to being able to categorize work items with automated filters, it is possible to directly choose the category of an issue or pull request for the primary investment breakdown. To do that, select an individual work item in one of the many views in Swarmia, then click on Categorize in the popup if the issue is uncategorized or the issue type dropdown if it is currently categorized, then select the desired category.
When organizations mature and grow, more things start to compete for teams' attention. This can result in teams spreading their focus too thin, and not being able to spend enough time on their top priorities.
It's easy to imagine the difference between a team spending 20% of their time towards a goal versus one that spends 40%: the time to deliver a solution at least doubles. This isn't good news for the team or the organization – but there's a massive opportunity on the flip side: teams who can improve roadmap focus can drastically improve their impact.
Here are some questions Investment Balance can help you answer:
Are you spending less than 50% of your time on high priorities? Little time spent on the most important category might mean your team has too many things to focus on, or that it's not clear how to progress further with the important projects.
Is a majority of your time going to bug fixing and maintenance work? An increasing trend in the amount of bug fixing and maintenance work can indicate a problem with the team health. This might require an action such as investing into infrastructure, or addressing some of the technical debt the team has accrued.
Are you spending an increasing amount of time with ad hoc tasks? When organizations and systems grow, complexity grows with them. It's sometimes easy to get overwhelmed by the amount of goals, opportunities and the difficulty of getting complex problems solved. This can cause teams and individuals to fall back to simple, reactive tasks which are easy to complete, but time spent on them might not maximize the impact of the team.
Do you have a lot of uncategorized work? Drawing good conclusions without transparency to a major share of the work can be difficult. Creating routines to link issues and pull requests, and categorizing ad hoc work, pays off and enables the team to make well-informed decisions to improve their performance.
Look out for decreasing trends in the most important work. This increases your odds of catching a problem early and correcting course before it becomes a real problem.
Automated filters can be configured in a way that makes an issue match multiple categories. In this case, we'll assign it the first category that matches. You can to influence that.
You will configure a set of Investment Categories for you organization in the There are different ways to think of investment categories. Many of our customers use primarily the for balancing engineering investments. Additional approaches to grouping work include:
