Page tree
Skip to end of metadata
Go to start of metadata

Back To Overview


Getting Started

1. Installation


Introduction

Agile Hive is an app for Jira Software and can be downloaded via the Atlassian Marketplace.

Try it for free for 30 days without limitations.

Atlassian Marketplace


Prerequisites

  • Jira Software 8.3.0 or higher.
  • Confluence is technically optional but highly recommended for implementing SAFe in terms of content, such as Lean Business Cases, Epic Hypothesis Statements or PI Planning Overviews.


Next step

Project Creation

2. Project Creation


Introduction

Agile Hive provides preconfigured projects for all four SAFe levels. Easily create a project for every Team, Agile Release Train, Solution and Portfolio with the corresponding template.

Go to 'Projects → Create Project' and select the desired project template.

Matching boards are also created automatically by Agile Hive. Of course, you can adapt the delivered project configuration to your wishes.

If you want to use existing projects, please follow this link:

Use existing Projects


Example - Creating an Essential SAFe (Agile Release Train + Teams)

» Creating the Agile Release Train project

  1. Go to 'Projects → Create Project' and select the 'SAFe ART Project' template.
  2. Enter a project name (optionally adjust the project key and the project lead).
  3. Repeat those steps for all your Agile Release Trains.

» Creating the Team projects

  1. Go to 'Projects → Create Project' and select either the 'SAFe Scrum-Team Project' or the 'SAFe Kanban-Team Project' template.
  2. Enter a project name (optionally adjust the project key and the project lead).
  3. Repeat those steps for all your teams.


Next step

Project Hierarchy

3. Project Hierarchy


Introduction

With the help of the Agile Hive Project Hierarchies, you can map the four SAFe levels (Portfolio, Large Solution, ART and Team) as well as the business units (Jira projects like an ART or team project) located therein.

The SAFe levels are represented as horizontal layers. The business units are shown as colored nodes within the layers.

Go to 'Administration → Manage Apps → Project Hierarchies' to configure the Agile Hive Project Hierarchies.

More Details


Example - Creating an Essential SAFe Project Hierarchy (Agile Release Train + Teams)

» Create the SAFe Layers

  1. If you have no layers yet, you will be prompted to: “Click here to add your first Layer”
  2. Create the first Layer and name it "Program" or "ART". In the column "SAFe level" please select "Program" from the dropdown.
  3. Create the second Layer and name it "Team". In the column "SAFe level" please select "Team" from the dropdown.
  4. Close the "Confirgure Layer" dialog

» Map the SAFe Projects

  1. Click on the grey Layer "Program" (on the right side an area will slide open, showing the name of the layer and a Drop-Down menu titled Projects)
  2. Clicking on the drop-down, a list of all Jira projects is displayed. By typing a name or a key of a specific project, you filter the results.
  3. Choose a project. It will be displayed in a list under the drop-down, labeled “New”. This indicates, that this project will be assigned to the layer once you press Save.
  4. Repeat this process for the Layer "Team" until all teams are inserted and visible inside the view

» Relate the SAFe Projects

  1. Select a project within the "Program" Layer in the hierarchy view. In the sidebar is a drop-down titled "Child Projects".

  2. Clicking on the drop-down, a list of all Jira projects is displayed. By typing a name or a key of a specific project, you filter the results. Choose a "Team" project.

  3. Repeat step 3 until all "Team" projects are inserted & finally press Save. The selected "Program" should now be connected to the first "Team" project with a grey line.


Automated Agile Hive Main Menu

The hierarchy is automatically displayed in a menu called Agile Hive and is accessible to all users (reload the current page if it is not visible it in the top navigation).

This means that users can conveniently access the various projects and immediately access the numerous Agile Hive views.

Next step

Optional Configuration

4. Optional Steps


Introduction - Custom Issue Types, Workflows, Screens & Links

Agile Hive does not take anything away from you or limit you, on the contrary, you retain full flexibility. You can adapt all Issue Types, Workflows and Screens to your needs. Only a few Agile Hive fields should be used here and there - that's it. Let's take a closer look.

Issue Types

The following applies to all Agile Hive projects and their issue types:

  • Every Issue Type is optional
  • Add as many Issue Types to every Agile Hive Scheme as you want
  • Every Issue Type can be renamed
  • Every Issue Type can be removed from the Agile Hive Schemes
  • Every Issue Type can use other icons
  • Every Issue Type can be deleted
    • If the Issue Type Objective or Risk haven been deleted & you want to use Objective or Risk again, simply create new issue types with the name ‘Objective’ or ‘Risk’ and Agile Hive automatically uses them
  • Only the Issue Types Objective & Risk are used for specific reports

Workflows

The following applies to all Agile Hive projects and their workflows:

  • Use your own workflows or adapt those from Agile Hive. There are no restrictions.

Screens

The following applies to all Agile Hive projects and their screens:

  • Adjust the screens according to your wishes. Add any fields & sort them as you like.
  • We recommend keeping the Agile Hive fields in the various schemes in order to be able to view and edit important information directly in the issue.

Agile Hive Links

All Agile Hive Linktypes can be renamed.

The outward / inward link of the following links can be renamed:

  • Agile Hive Objective Link
  • Agile Hive Risk Link
  • Agile Hive Dependency Link


Agile Hive Link

  • Important: Do not rename the outward/inward link!


Custom Epic Panel

The 'Custom Epic Panel' allows you to display issues from a higher SAFe level in the Epic Panel of a Jira board. This empowers users to use drag and drop to hierarchically link for example stories on team level to Features on ART level. 

The same procedure can also be used for other scenarios. For example, another board can be used exclusively for objectives. Instead of Features, the team's objectives could be displayed in the panel and thus enable a easy linking between team issues and team objectives.
Since these settings can be stored for each board individually, numerous use cases are possible and all unaffected boards continue to work with the standard Jira Epic Panel functionality.

Go to 'Administration → Manage Apps → Custom Epic Panel → Configuration' to configure the behaviour of Epic Panels in the desired Jira boards.

Example for all Teams of one ART

  1. Click on "Create new configuration"
  2. Enter as Panel Name "Program" or "ART" or "Features"
  3. Enter as JQL: project = "Your Project" AND statusCategory != Done
  4. Enter all Team Boards of the specified ART
  5. Set the Link Type to "Agile Hive Link"
  6. Set the Link Direction to "Inward"
  7. Enter as Backlog Name "Backlog"
  8. Press Save


More Details


AutoPage

AutoPage creates, links & updates Confluence pages, page trees & the page content automatically through Jira. This functionality is mostly used to automize the creation of the 'Epic Hypothesis Statement', the WSJF documentation and the 'Lean Business Case'.

Numerous use cases are possible. Think of automated Sprint review & retrospective pages or Release documentation.

Go to 'Administration → Manage Apps → AutoPage → AutoPage Settings' to configure when Confluence pages should be created, linked & updated automatically through Jira.

Example for automated documentation of Epics

  1. Click on "Create new rule"
  2. Rule: As rule name enter "Epic Overview"
  3. Issue Event Types: Select as Issue Event Types "all events"
  4. JQL: Provide the following JQL: project = "Your Project" and issuetype = "Your Issue Type for Epics"
  5. Confluence Space: Provide the Confluence Space where the page should be created
  6. Confluence Template Page: Provide a Confluence Page, that will be used as a template
  7. Confluence Page: Choose a Confluence page as parent page
  8. Issue Link Name: Enter "Epic Overview"
  9. Press Save


More Details

Next step

Using Agile Hive

5. Getting Started


Introduction

After the installation and configuration is complete (step 1 - 4), it is time to set up Program Increments (PIs), create issues & plan some work so that the reports and the other Agile Hive views can present the information.

Please ensure the following before you proceed:

  • Layers were created in the project hierarchies and each provided with the correct SAFe levels
  • Projects were created using the Agile Hive project templates
  • These projects were inserted into the correct layers of the project hierarchies according to their SAFe level
  • The projects were linked hierarchically

Note: Of course, further projects can be created at any time and inserted into the layers



Managing Program Increments (PIs)

With Agile Hive, PIs can be created per ART. The respective sprints / iterations are then automatically created in the teams.
The user who creates the PIs must have the "Manage Sprints" permission in all child projects of the respective ART.

Creating new PIs

  1. Open the desired ART project in which the PIs are to be created via the Agile Hive menu
  2. In the reports view click on the PI dropdown at the top right
  3. Click on "Create new PI"
  4. Fill in the fields of the PI dialog & click the Confirm button

Repeat the process for other PIs.

After creation, PIs can be selected in the dropdown at the top right. This means that every user can switch to past, future and current PIs in order to view the reports, breakout boards or program boards of a specific PI.

Editing PIs

  1. Open the desired ART project in which the PIs should be edited via the Agile Hive menu
  2. In the reports view click on the PI dropdown at the top right & select the PI which should be edited
  3. Again click on the PI dropdown and click on "Edit PI"
  4. Make the desired changes & click the Confirm button

Note: Only future PIs can be edited

Deleting PIs

PIs cannot be deleted at the moment. We are already working on this feature.



Issue Creation

Since no issues have been created yet, the reports can hardly show anything. If you just want to test Agile Hive or your configuration, it makes sense to create at least one issue in each project.

The following issues should be created in the respective projects for a Full SAFe configuration:

  • Portfolio Epic
  • Capability
  • Feature
  • Story

Furthermore we would like to create a Risk and an Objective in all projects of the teams, ARTs and solutions.




Issue Linking

Before we link the created issues with each other, let's take a look at the four Agile Hive links:

(1) Agile Hive Link

  • This link type links issues hierarchically, that are located on adjacent layers (layers / SAFe levels cannot currently be skipped).
  • It consists of the two link directions "Parent of" and "Child of".
  • Purpose: aggregation of progress and statistics for all reports

(2) Agile Hive Objective Link

  • This link type links Team Objectives to other planned issues of the same team
  • You have to link an objective with at least one planned story so that the objective can be seen in the respective PI in the reports (this will be improved soon).
  • It consists of the two link directions "Belongs to Objective" and "Is Objective of".
  • Purpose: summation of the story points that contribute to the respective objective in the team report as well as progress display based on the completed story points.

(3) Agile Hive Risk Link

  • This link type links Risks to other issues, that will mitigate the risk.
  • It consists of the two link directions "Treats" and "Is treated by".
  • Purpose: Issues that mitigate a risk are automatically displayed in the Team / Program / Solution Reports.

(4) Agile Hive Dependency Link

  • This link type links issues to dependent issues.
  • It consists of the two link directions "requires" and "is required by".
  • Purpose: Visual dependencies in program & breakout boards




Let us link the created issues:

  1. Link the Portfolio Epic, Capability, Feature & Story hierarchically by starting with the Story and linking it to the Feature with the 'Child of' link. Then link the Feature with the Capability and the Capability with the Portfolio Epic, so that there is a strand across all levels. If the custom epic panel from the optional step 4 has been configured for the projects, the child issues can be linked to the parent issues in the respective Jira board using drag and drop.
  2. Link a Team Objective with a Story from the same team with the "Is Objective of" link.
  3. Link a Risk on Team Level to any other issue with the "is treated by" link.
  4. Link an issue that is dependent from any other issue with the "is required by" link.

Of course, you can also create the links from the second issue. Make sure to use the correct link direction.




PI Planning

Now that we have made all the preparations, we can do the PI planning and bring the Agile Hive reports as well as the team breakout views and the program boards to life.

Select a team from the Agile Hive menu. You are now in the Agile Hive Report for the selected team. Now you can easily switch to the Team Breakout Board and the Program Board using the buttons at the top left.

Note:

  • If the Breakout Board is opened from within a team, it is team-specific and represents the respective team in the first row. The capacity for this team can then be entered here.
  • If the breakout board is opened via the ART project, the teams are displayed alphabetically and consequently no capacity can be entered.
  • The Program Board is always displayed identically, regardless of which project it was opened from.

Breakout Board

Step 1 - Capacity

  • Enter the capacity for each sprint of your team

Step 2 - Assign Features

  • Open up the Program Backlog Sidebar and drag and drop the Program issues into your team. They will be displayed as swimlanes (Feature Lanes).

Step 3 - Feature Breakdown

  • Break down those Program issues into Stories (or any other team issue type) by hovering into a swimlane, clicking the '+Add' button & creating a new Story.
  • These issues are automatically linked hierarchically with the program issue and are also scheduled in a sprint.

Step 4 - Dependencies

  • Dependencies are shown automatically for all issues that are linked with the Agile Hive Dependency Link (requires / is required by).

Learn More

Program Board

The Program Board is an automatically generated view and therefore no steps are required here.

  • The completion of features and other ART issues is calculated automatically with Agile Hive. The respective feature is thus represented in an iteration in which it is completed.
  • Dependencies that were set via the Agile Hive Dependency Link are displayed visually. In addition, all other planned issues are shown on which the ART issues depend.

Agile Hive Reports

Team Level

Program Level

Solution Level

This page was last edited on 09/28/2021.