> For the complete documentation index, see [llms.txt](https://portavi.gitbook.io/portavi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portavi.gitbook.io/portavi-docs/tracking-delivery/programme-detail.md).

# Inside a programme

A programme groups projects that deliver one outcome together. Its page answers a different question from a project's: not "is this work on schedule" but "are the projects underneath it adding up to what we promised".

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-38f2a9dbd14636db9daa0f1a1f4bbd4dbcdf4584%2Fprogramme-detail-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-579906a4cf32d5531ac718f18bd72408b40342d5%2Fprogramme-detail.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

## The header

Name, the programme manager, the date range, how many projects it holds, and its health badge, with the latest [status update](/portavi-docs/tracking-delivery/status-updates.md) beneath them. The description sits in an **About** card at the top of the Overview tab. The health isn't set by hand: it's rolled up from the programme's projects, as [Health statuses](/portavi-docs/tracking-delivery/health-statuses.md#roll-up-to-programmes-and-portfolios) explains.

## Tabs

| Tab            | What is in it                                                                                                                                                                                        |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Overview**   | Benefits, the projects underneath, and the four measures below                                                                                                                                       |
| **Reviews**    | Benefit reviews: how the programme's benefits are realised; see below                                                                                                                                |
| **Timeline**   | Every project's dates on one axis, so overlaps and gaps are visible                                                                                                                                  |
| **Team**       | Everyone assigned across the programme's projects. With stakeholder engagement on, this tab is [Stakeholders](/portavi-docs/tracking-delivery/stakeholders.md#programmes) and Team is its first view |
| **Budget**     | The programme's own budget, and the roll-up from its projects                                                                                                                                        |
| **RAID**       | The programme's [RAID log](/portavi-docs/governance/raid-log.md): its risks, assumptions and issues, its dependencies (see below) and its decisions                                                  |
| **Lessons**    | Lessons learned, RAG-rated                                                                                                                                                                           |
| **Discussion** | [Comments](/portavi-docs/tracking-delivery/comments.md) on the programme as a whole                                                                                                                  |
| **Activity**   | Events across the programme in one feed                                                                                                                                                              |

### Reviews

Where the programme records how its benefits are actually realised. All of its benefits are reviewed together, on the programme's **benefit review cycle**: a number of months, set in the creation wizard's Benefits step or the programme's edit modal. The first review is due that many months after the programme's start date, and each one after that the same interval after the latest review, the way a portfolio's strategy cycle works.

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-dfce501df6eaad9079deaa8a5be4a292b2748f11%2Fprogramme-reviews-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-d361a39d86ebc6fb3bbb3ccdefa22d2329a06dda%2Fprogramme-reviews.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

Once 90% of the cycle has passed, the review is due: the **Reviews** tab shows a dot, and the **Next review** card on Overview offers a **Benefit review** button, the same rule a portfolio's strategy review follows. Both stay until a review is recorded.

**New review** opens the review in three steps, shown across the top of the dialog; select a completed step to go back to it:

1. **Values**: the review date, and a value box for every measured benefit. A box left empty skips that benefit this time.
2. **Decisions**: what the review decided, one line each, and an optional note for the source or any caveats. Decisions go to the programme's [decisions log](/portavi-docs/governance/decisions-log.md).
3. **Confirm**: everything above, read back before it is submitted.

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-0feb189a20ce79a744162dbf31ce2f02bf1c295b%2Fmodal-benefit-review-2-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-9fa6c73ced9073576300e4207fec4769210e5036%2Fmodal-benefit-review-2.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

Each review is one row, newest first, with the date in the square and what it concluded: how many benefits were realised, partly realised, not realised or had made no progress at that point. Open a row to see every value, how it moved since the review before, its status, the decisions and the note. Its **⋯** menu edits or deletes it.

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-589da00e64c8df313a0ebcddce11ecbeea941807%2Fmodal-benefit-review-preview-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-7d6dbc64ac8a55694dd3b82181c33e6fc11d6821%2Fmodal-benefit-review-preview.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

The programme's owner and PMO managers record benefit reviews. A benefit appears in them once it has a baseline and a target; see [Benefits](#benefits).

### Timeline

Every project in the programme on one axis. Overlaps and gaps are the point: two projects finishing the same week is a delivery risk the list view hides.

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-899ad573f63a86ade57541975625aad518841e1e%2Fprogramme-timeline-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-5dded2110a723f065125e1d1874cf809dccbda74%2Fprogramme-timeline.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

Dependencies are drawn on it as arrows: grey while they hold, red with a dotted line under the successor when they are slipping. See [Dependencies](/portavi-docs/governance/dependencies.md#on-the-timeline).

### Dependencies

In the **RAID** tab, on **Dependencies**: every dependency with an end inside the programme, including links to work in other programmes, and every dependency created on it. **Add dependency** links a predecessor to a successor. The RAID tab and its Dependencies toggle show a dot while any of them is slipping. A row that was created on another programme or portfolio is read-only here. See [Dependencies](/portavi-docs/governance/dependencies.md).

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-75076bd193e6776b23d289f38a64b1764a5dcb53%2Fprogramme-dependencies-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-74a1ca4afa6e63241301daf4a834b77bd771c7ce%2Fprogramme-dependencies.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

### Team

Everyone assigned across the programme's projects, with what each is carrying.

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-d4b13ef7e4508341e6c69e4521b1930eb2e98f9f%2Fprogramme-team-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-42c8012527332f9c4c953a24439e8b920ba57858%2Fprogramme-team.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

### Budget

The programme's own budget alongside the roll-up from its projects, so an overspend is attributable rather than just visible.

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-d05c1a2aaf78e0488b48f081b0a8801dd3da0a66%2Fprogramme-budget-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-0ce6a1d861c5d0bd71d26cbd65697404923a2602%2Fprogramme-budget.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

### Activity

PM-tool events and chat signals across every project in the programme, in one feed.

<figure><picture><source srcset="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-571388d20ea6da4fc6f0bf29e1b53229b16ac32a%2Fprogramme-activity-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4189291014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx6fERvLd0cQQBYlynE5O%2Fuploads%2Fgit-blob-74197f89bcb3c8cec0e1da237b213e65b756f07d%2Fprogramme-activity.png?alt=media" alt=""></picture><figcaption></figcaption></figure>

## What the Overview tab shows

Four measures across the top:

* **Next review**: days until the next benefit review is due, with its date and how much of the review cycle has passed. It turns red once overdue.
* **Benefits delivered**: how many of the programme's benefits are delivered
* **Projects completed**: of the projects it holds
* **Needs attention**: projects at risk or delayed, as a count and a share

A project linked to no benefit is flagged on its own card in the list below.

Then two bars, projects by health and benefits by status, and the **Benefits** list itself.

## Benefits

Each benefit carries an owner, a target date, a status, and the projects contributing to it.

A benefit has two separate states:

* **Delivered**, in blue: the work behind it is done. A benefit is delivered when every project contributing to it is completed. One with no contributing projects is marked delivered by hand, from **⋯ → Mark as delivered** in its preview.
* **Realised**: whether the outcome it promised has arrived, read from its measurements. **Realised** once the latest measurement reaches the target; **Partly realised** on the way; **No progress** if it has not moved toward the target; and **Not realised** if, by its target date, it is under a quarter of the way there or moving away from it.

To measure a benefit, edit it and fill in its **unit**, **baseline** and **target**, as on an objective's key result. A target below the baseline means lower is better. Its preview then shows the baseline, target, latest value and next review, and a chart of every measurement against the target line.

Add one with **Add benefit**. Benefits belong to a programme; a project cannot own one, it can only contribute. See [Benefits](/portavi-docs/governance/benefits.md).

## Projects

Below the benefits, the projects in this programme. **Add project** attaches an existing project; it does not create one. A project belongs to at most one programme, so attaching it here removes it from any other.

## Editing and reports

The pencil opens the edit modal, for a PMO manager or the programme's own manager. The square-plus posts a [status update](/portavi-docs/tracking-delivery/status-updates.md). The chart icon opens this programme's [reports](/portavi-docs/reports-and-notifications/reports.md).

On a phone the header's actions collapse into a **⋯** menu.