Appearance
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:
Step 1
Approve
Select Approve to approve it for the named audience. Only an approved report can go to the client.
Step 2
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.
Step 3
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.
- Select Prepare client report. It carries the current company picture into a draft narrative and a suggested record selection.
- Edit the summary, decisions, next steps and limitations. Name the audience.
- 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.
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.
Source: gitbook/product/opportunities/reports.md in the DutyGraph repository.