Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Software capitalization

Use developer activity data from Swarmia to generate capitalization reports and blend with cost data.

Accounting and engineering rarely meet, but in modern software development organizations, that sometimes becomes a must. When software development costs are treated as long-term assets, it's essential to accurately connect effort with specific projects.

How software capitalization works in Swarmia

Swarmia helps organizations track and report on capitalizable software development costs with precision:

  • We connect data from your Git and issue tracker to accurately understand how developers allocate their time. Data accuracy is ensured because your developers regularly view and verify their activity in Swarmia.

  • You can define custom rules to match what work qualifies as capitalizable

  • Your finance team can export monthly or yearly software capitalization reports

Using Swarmia

Swarmia - Software capitalization
Reports on software capitalization based on your Swarmia data.

Swarmia automatically generates monthly reports based on developer activity, issue hierarchy, and capitalization rules. You can manually generate data and override the previous snapshot for the given month.

Software capitalization is available to organization admins.

Setting up your categorization

You can categorize issues manually, set issue filters to categorize them automatically, or combine both approaches. AI suggestions can help you review your categorization.

Remember that only work linked to issues can be capitalized. If much of your organization's effort involves unlinked pull requests, consider creating issues and linking them to enable capitalization.

Manual categorization

Manual categorization works well if you capitalize a small number of large projects annually. These projects are easily identified in the work tab and marked "Capitalizable." When you categorize issues manually, you'll see a small hand icon next to the category.

The work tab shows all issues for the year grouped by the highest level.

Automatic categorization

Automatic categorization works best if you already have clear categories in your issue tracker and want to transfer them to Swarmia. On the setup tab, you'll find a section called "Rules for software capitalization," where you can configure filters to identify capitalizable work.

A typical way of doing automatic categorization is via a Jira custom field connected to capitalizable initiatives or epics.

AI suggestions

AI suggestions help you identify work that may need a closer look, whether you categorize work manually or use rules. Swarmia considers the issue's title, type, labels, and description and suggests whether the work is capitalizable (CapEx) or not capitalizable (OpEx). Suggestions don't change categories until you apply them.

To enable suggestions, select Suggest categories automatically when setting up software capitalization, or enable AI suggestions on the setup tab. By default, suggestions are limited to issues without a parent issue. Under Advanced options, you can change which issues receive suggestions and customize the suggestion prompt to reflect your accounting policy.

When you save changes to enabled AI suggestion settings, choose Save only to keep existing suggestions for matching issues without generating suggestions for existing work immediately. Choose Save and refresh to generate suggestions for matching issues updated this year. Refreshing uses your AI quota. Suggestions for issues outside the filter are removed with either option, but categories you've already applied are kept. Prompt changes apply to suggestions started after you save.

Reviewing your capitalizable work

Review your capitalization data before exporting:

The work tab allows you to examine issues and see how much of each is marked as capitalizable. The issues are grouped at the highest level, which means the capitalization percentage represents how much of the work grouped underneath is capitalizable.

If you've set automatic categorization rules and see a lower-than-expected capitalization percentage, it is likely because child items do not match your rules.

With AI suggestions enabled, the work tab's Suggestion column shows the suggested category. Hover over it to see the reasoning, and use the checkmark to apply a suggestion that differs from the current category. The Worth a second look summary highlights capitalized effort the AI considers non-capitalizable (Risk) and non-capitalized effort it considers capitalizable (Potential). Select either to filter the work table for review.

The inbox tab lists uncategorized top-level issues with effort in the selected year. Suggestions are preselected when available. Review the reasoning, choose CapEx or OpEx, and use the checkmark to apply the category. You can also use Apply all to apply the selected categories on the current page.

The employees tab shows employees and their respective capitalization percentages. This means how much of their total accumulated effort is directed towards capitalizable issues. This view also shows excluded days (time offs and inactive days), which lower an employee's accumulated effort. You can find more on this topic in the effort article.

Building reports

Once you've categorized work (either manually or automatically), reports will automatically be generated and delivered to the reports tab. In this view, you'll find monthly and yearly exports. The exports are split into employees (yearly) and capitalization (yearly/monthly) files.

You can use these files as raw data or alternatively, compile them into a capitalization report using our reporting template. To use the reporting template, copy it by clicking the "Copy reporting template" button on the reports tab and follow the instructions inside.

Frequently asked questions

Q: Can the work be aggregated by a specific Jira issue type in the software capitalization report?

A: It's not possible right now, but we're going to add support for this in the future. Currently, the work is aggregated by the highest-level issue that we can find from your Jira issue hierarchy. However, you can already see the FTE values for any of your issues from Swarmia's UI.

Q: Can I capitalize unlinked pull requests?

A: No. Software capitalization only accounts for work linked to issues. We require each line item in your capitalization report to have proper documentation in the form of an issue. If you have significant effort in unlinked pull requests, consider creating issues and linking them to enable capitalization.

Q: What's the optional "additional info" field in software capitalization settings?

A: It is an extra column in the work export that provides more context about the capitalizable project (e.g., the reason for capitalization, and the capitalization date).

Concretely, it's a field in your Jira issues, e.g. a label or a custom field, that's pulled to the capitalizable work export as a separate column. It can be used for custom reporting purposes if you don't prefer to use software capitalization reporting template.

Q: Can I convert the software capitalization reporting template to a .xlsx file?

A: It's not possible right now as some of the formulas used in the Google Sheet reporting template are not available on Microsoft Excel. We're planning to build a reporting template for Excel in the future.

Last updated

Was this helpful?