---
url: /handbook/opportunities/reports.md
description: >-
  How the Reports tab builds dated reports from the Company Repo, and how an
  advisor saves, approves and delivers them.
---

# Reports

**Reports** turns the Company Repo into dated documents for the sponsor, leadership and the delivery team. Code builds every report. No report needs AI. A page in the app is live. A saved report is frozen, addressed to an audience and printable.

The page has two tabs: **Prepare** and **Saved**.

## Prepare

**Prepare** lists the reports by loop step. Each card names its audience and purpose, and shows a readiness line in words, such as "Ready · 6 of 7 sections have data". Select **Preview** to open the report as the Repo is now. The preview says "Live preview · changes as the Repo changes".

| Loop step | Report | Reader | Today |
| --- | --- | --- | --- |
| Discover | Research brief | Sponsor | Built |
| Discover | Kickoff summary | Sponsor, leadership | Partial |
| Discover | Discovery status | Sponsor, client team | Built |
| Map | As-is readout | Leadership | Built |
| Map | Department pack (choose a department) | Department heads | Built |
| Diagnose | Constraints and gaps register | Advisor, sponsor | Built |
| Route | Change options | Sponsor, advisor | Partial |
| Route | Workflow build brief (choose a workflow) | Forward deployed engineer (FDE), delivery team | Partial |
| Measure | Measures and results | Sponsor | Partial |
| Any | Client Brief | Sponsor | Built |
| Any | Download your company | Client IT, FDE | Built |

**Partial** means some sections print "Not found" by design, for example volumes, time or cost that nobody has recorded. A Partial report is not a broken one.

### What a report looks like

Each report opens as a document:

* a cover with the company, the date and the Repo revision;
* an executive summary, answer first;
* numbered sections and numbered exhibits, each with a source line;
* next steps with an owner;
* an appendix with the evidence register and the meaning of each state word;
* notes that link to the Repo files.

Every item carries its state: Client confirmed, Observed, Inferred, Disputed or Not found. An empty section prints "Not found" and why, never 0. A percentage shows its basis, such as "12 of 31 Task Cards confirmed · 39%". Change options shows no savings estimate.

### Formats

* **Save snapshot** freezes the report as a Draft on the **Saved** tab.
* **Print / Save as PDF** prints it with the cover alone on page 1.
* **Download Markdown** gives a text copy. It needs the right to download exports.

## Saved

**Saved** lists each saved report with its title, type, date, Repo revision and state: **Draft**, **Approved**, **Withdrawn** or **Out of date**. It also shows who received it and when they first opened it. **Download your company** sits in this tab's header. It downloads the whole Company Repo as files, with checksums.

On a saved report:

### Approve

Select **Approve** to approve it for the named audience. Only an approved report can go to the client.

### Deliver

Select **Deliver**. DutyGraph issues one private, expiring link per recipient, tied to the exact approved version. It emails the link through the workspace email, or you can select **Copy link instead**.

### Track the first view

The recipient opens the report on a private page. The first view is recorded, and DutyGraph notifies the advisor. The recipient can select **I have read the report**.

**Download zip** gives the approved packet: a readable HTML report, the structured packet, a record register and a `checksums.json` file. A checksum detects changed bytes. It is not an approval or proof of who sent a file.

**Withdraw** stops a report. A withdrawn report cannot be printed, downloaded or sent. Copies already sent stay with the people who have them. You can also revoke one delivery link.

**Out of date** means the server found that the Repo changed what the report says. A stale report cannot be sent. Save a fresh one.

## Client Brief

The **Client Brief** card opens its builder. It is the narrative memo the advisor writes and approves.

1. Select **Prepare client report**. It carries the current company picture into a draft narrative and a suggested record selection.
2. Edit the summary, decisions, next steps and limitations. Name the audience.
3. Select **Save report draft** to freeze it for review.

**Write a custom report** is there for a different audience or purpose. The brief can be an executive, weekly or audit report.

## Company Snapshot

The Company Snapshot is the company's live front page, on **Overview**. Select **Print / Save as PDF** to print it. Opening or printing it does not call AI or send anything to the client. It is a page, not a saved report: it changes as the Repo changes.

## Where AI is used

Nowhere in this tab. Each report builder is code: the same Repo gives the same report. An optional, labelled AI summary paragraph on four reports is in the design. It is not built.

## Planned reports

The **Planned reports** list on **Prepare** has no action. It holds:

* Execution coverage
* Evaluation against representative cases
* Automation Work Orders
* Agent Build Packets
* Realized financial outcomes
* Scheduled delivery

These are roadmap items. See [Where DutyGraph is going](../roadmap/vision.md).

::: info
**Status.** The Prepare and Saved tabs, the report catalogue, Save snapshot, Print / Save as PDF, Download Markdown, Approve, Deliver, Withdraw, the Out of date check, first-view tracking, the Client Brief, the Company Snapshot print and Download your company are **Built**. Kickoff summary, Change options, Workflow build brief and Measures and results are Built but print "Not found" where data is missing. The optional AI summary, a server-rendered PDF attachment and the six reports in the Planned list are **Planned**.
:::
