---
url: /handbook/advisors.md
description: >-
  How an advisor's workspace is laid out, and how an engagement runs from first
  note to Living DutyGraph.
---

# Run engagements

An advisor runs every client company from one workspace. This section covers the advisor's side of the work: finding and signing clients, getting paid, staying engaged after the audit, and working from a phone.

## The workspace

Every advisor page sits inside the same frame.

| Zone | What it holds |
| --- | --- |
| **Left rail** | The portfolio: **Home**, **Inbox** (with a count badge) and **Companies**. At the bottom: **Settings**, **Help** and your avatar menu (theme and Sign out). |
| **Company sidebar** | The selected company's pages. The company switcher at the top shows the company name and its stage, such as "Discovery active". |
| **Page header** | The page name, the company, one status line, search (⌘K) and one **Next** button with the company's next action. |
| **Status bar** | "Simulated data" for a sample company, and the record's revision. |

### Company sidebar, in order

For an engaged company the sidebar shows these items, in this order:

1. **Overview**: the Company Snapshot.
2. **Discovery**: Plan, Asks and Sessions.
3. **Repo**: the [Company Repo](../discovery/company-repo.md) and the [DutyGraph Agent](repo-copilot.md).
4. **Work Map**: Value chain, Work flows, Task Cards, People and RACI.
5. **Opportunities**: Your team, Proposed agents, Possible constraints and Changes.
6. **Agents**: the builder, saved agents and agent governance.
7. **Outcomes**: Results and Measures.
8. **Strategy**: Summary and Frameworks.
9. **Reports**: Prepare and Saved.

A **prospect** (an account whose engagement is not active yet) shows only **Overview**, **Repo** and **Reports**. The sidebar says "Discovery and Work Map open once the engagement is active." with **Record the commitment**. The closed pages stay closed by address too.

A person who was given shared access to one company sees the pages their role allows. Shared members do not see **Inbox** or **Companies**. See [Engagements and payment](engagements-and-payment.md#share-a-company).

### Settings

**Settings** has seven sections. Three apply to the whole workspace: **Workspace**, **Research & AI keys** and **MCP access**. Four apply to the selected company only: **Connections**, **Members & roles**, **Company account** and **Billing**. The page header says which.

## How an engagement runs

### Find or receive the client

Add the company in **Companies**, or accept a website request in the **Inbox**. DutyGraph creates an account, a contact and research for it. See [Accounts and Inbox](accounts-and-inbox.md).

### Make first contact

Send a first note or a company picture review by email or by a private link. Outreach rules run on every send.

### Activate the engagement

Send the client their options. A card payment, a paid invoice or a recorded commitment activates the engagement. See [Engagements and payment](engagements-and-payment.md).

### Map the company

Run discovery: the [sponsor packet](../discovery/sponsor-packet.md), the [executive kickoff](../discovery/executive-kickoff.md) and [team asks](../discovery/team-asks.md). Answers come back to the Inbox.

### Deliver results

Approve and send the report. The client can follow progress on a status page.

### Keep it current

A Living DutyGraph plan schedules digests, research refreshes and renewals. Each one waits for the advisor's approval. See [Living DutyGraph](living-dutygraph.md).

## Pages in this section

| Page | What it covers |
| --- | --- |
| [Accounts and Inbox](accounts-and-inbox.md) | The accounts list, adding an account, research, outreach rules, website requests and the Inbox |
| [Engagements and payment](engagements-and-payment.md) | Options, Stripe Checkout, invoices and statements of work, activation, and sharing a company |
| [Living DutyGraph](living-dutygraph.md) | Digests, research refreshes, renewals and client results after the audit |
| [DutyGraph Agent](repo-copilot.md) | Ask, Review, Edit and Draft an ask, through the company's approved AI connection |
| [Phones and notifications](phones-and-notifications.md) | Phone layouts, web push, **Share…** and the Companion phone API |

For the step-by-step path from website to governed agent, see [Run a company in 9 steps](../start-here/run-a-company.md).

::: info
**Status.** **Built**: the rail, the company sidebar in the order above, the prospect rule, the page header with one **Next** action, Settings sections and shared-member filters. **Simulated**: sample companies, labelled in the status bar. **Planned**: tabs on the Companies page and a resizable inspector.
:::
