# Quickstart guide

{% embed url="<https://www.youtube.com/watch?v=l6YHBF8hJI4>" %}

### Step 1 – Installation

As a Jira admin, you can install the Ativo Programs app directly in Jira. Click on **Settings > Apps > Find new apps**.

Search for **Ativo**, click on the box, and then click on **Try it free**.

<figure><img src="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2FSFIhliPrOPAzNT6rgtGZ%2Finstallation2.png?alt=media&#x26;token=fdb5a6f6-f718-4cf0-8012-d5b0d7d399ce" alt=""><figcaption></figcaption></figure>

### Step 2 – Permissions

We wil now set the permissions. As a Jira admin click on **Jira admin > Apps > Ativo Programs > Administrators**.

Add the persons or groups you want to give Ativo Programs configuration permissions and click on **Save**.

<figure><img src="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2Fm3ION16SwSPDMMpIOemC%2FPermissions.png?alt=media&#x26;token=2f3a47eb-8382-428e-a7b6-72f9181307ff" alt=""><figcaption></figcaption></figure>

### Step 3 – Teams

Now that we have permissions, we can configure the teams.

Locate Ativo Programs via **Apps > Programs** in the top navigation bar. Click on the **Create Teams** button.

We’ll add a first team. Fill in the **name**, choose a **key** (capital letters). Define if the team is working scrum (sprints) or Kanban. Choose the estimation model they are using.

Define the **filter**, which defines the scope of the issues of the team. Choose one or more **Jira projects**. If needed, we can narrow down the scope with one or more **field filters**.

We’ll now add a second team.

Then click on **Submit**.

<figure><img src="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2FtxEFlptE7zypk9xMNBpQ%2FTeams%20submit.png?alt=media&#x26;token=9e02c8a9-31c8-42ff-b4ab-9da5ed53f591" alt=""><figcaption></figcaption></figure>

### Step 4 – ART (program) configuration

Now that we have teams, we can configure the ART (program).

Click on the **Create ART** button in the top navigation selection. Choose an ART **name** and **key** and click on **Create**.

Select the teams you want to add in the ART.

Select the filter for the epics (feature) backlog. This defines the scope of the ART.

For the optional issues filter, you can probably just leave it empty at this moment.

Click **Submit**.

<figure><img src="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2FJNtTlKEuQUCTfLu1b4pM%2FProgram%20creation.png?alt=media&#x26;token=a7857080-bb8b-4627-8399-b60d6e6501e3" alt=""><figcaption></figcaption></figure>

### Step 5 – PI

Now that we have defined the ART (program), we can configure the PI.

Click on **Create PI**, fill in the **name** and **key**, and define how many sprints you want to add to the period. Click on **Create**.

Set the **start dates** and **end dates** of the sprints.

For the teams working scrum, we’ll define the sprints. If the sprint names have a logical order with number in it, then Ativo will do a suggestion for the next sprints automatically.

If you need to create sprints in teams, you can do so in Ativo directly.

You can leave the optional additional epic and issue filters to the default setting (empty).

Click on **Submit**.

<figure><img src="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2FSmYjBD9xkmgxlY1rSOqO%2FSprints%20mapping.png?alt=media&#x26;token=4ddb8448-d5fe-4ce8-bd61-dee6b226d799" alt=""><figcaption></figcaption></figure>

### Conclusion

We’ve configured and installed Ativo Programs in 5 steps:

* Installation
* Permissions
* Teams configuration
* ART (program) configuration
* PI (period) configuration


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ativo.io/getting-started/quickstart-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.