Getting started
Residual adds a Risks page to your Jira Cloud projects. This page walks you through installation, setup by the project admin and your first risk.
1. Install from the Atlassian Marketplace
Section titled “1. Install from the Atlassian Marketplace”Residual is installed on your Atlassian site from the Atlassian Marketplace, in the same way as any other app. Atlassian’s standard install process applies: the app is installed by a person who is allowed to install apps on your site, or requested from them.
Installing Residual does not change your Jira configuration. It creates no work item types, no custom fields and no permission schemes.
2. Set up the register in your project
Section titled “2. Set up the register in your project”After installation, each Jira project shows a Risks page in its project navigation.
The project admin opens Risks. The register for the project is created on first open with the default risk model. Everything that follows is done by the project admin inside the project; no Jira administrator is needed.
Who can view, edit and configure the register follows your existing Jira project permissions. See Permissions.
3. Create your first risk
Section titled “3. Create your first risk”- On the Risks page, select Create risk.
- Enter a title, for example Main component delivered late by supplier, a category and optionally a description, a review date and an asset reference.
- Save. The risk appears in the table with the level Unrated.
4. Assess the risk
Section titled “4. Assess the risk”Open the risk to see the detail panel with the tabs Assessment, Treatments and History.
- In Assessment, rate the inherent risk: probability and impact before any treatment. Write the rationale, for example Single source for the main component, supplier reported two late deliveries in the last twelve months, no buffer in the schedule. The rationale is required.
- Rate the residual risk: probability and impact after treatment, with its own rationale.
Each assessment stores the rating, the rationale, the model version, the person and the time. The heatmap and the table update immediately.
5. Add treatments
Section titled “5. Add treatments”In Treatments, add the measures that reduce the risk, with owner, due date and status. A treatment can only be marked Effective when evidence is attached. See Treatments and evidence.
Next steps
Section titled “Next steps”- Switch the heatmap between inherent and residual.
- Look at the History tab to see every change with person, old and new value. See Audit trail.
- Export the register as PDF or CSV. See Export.