> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vinmake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Oversight Agent

> Monitor every RFQ in flight. Flag what's slow, cold, or at risk.

# Oversight Agent

⚪ **Planned (Phase 4)**

The oversight agent is the always-on watcher. It doesn't drive any individual
workflow — it watches all of them and surfaces what's slipping. Managers get the
visibility they currently have to assemble by hand from email threads.

## What it tracks

For every RFQ that's ever entered the pipeline:

* Which have a style record
* Which have a BOM draft
* Which have a true cost draft
* Which have a quotation
* Which quotations were sent
* Which clients replied
* Which inquiries went cold
* Which staff are delayed

## Why this matters

Today, missed opportunities at VinMake come from:

* Staff replying slowly
* RFQs not being followed up
* Clients stopping mid-thread
* Inquiries going cold with nobody noticing
* Managers lacking clean visibility
* Email threads being too long and fragmented to scan

The oversight agent exists to make those failure modes visible before they cost an
order.

## Pipeline view

The oversight dashboard surface (in the [Inbox / Task / Engine UI](/brain/staging/architecture/ui-structure))
shows every active RFQ as a row:

| RFQ     | Client | Style     | Owner | Current Step         | Last Action      | Days Since | Risk   |
| ------- | ------ | --------- | ----- | -------------------- | ---------------- | ---------: | ------ |
| RFQ-001 | Jaspal | J26WGW153 | Mai   | True cost draft      | BOM created      |          2 | Medium |
| RFQ-002 | Lulus  | LUL-883   | Anna  | Waiting client reply | Quote sent       |          7 | High   |
| RFQ-003 | ASOS   | AS-441    | Zean  | Style draft          | Pending approval |          1 | Low    |

Managers can filter, sort, and drill into any row.

## Risk detection

The agent flags specific risk patterns and routes them to the right person:

| Risk                   | Trigger                                          |
| ---------------------- | ------------------------------------------------ |
| Slow internal response | No action after X hours/days                     |
| Client cold            | No reply after quote sent within N days          |
| Missing true cost      | Style exists but no true cost after N days       |
| Missing quotation      | True cost ready but no quotation after N days    |
| Duplicate style risk   | Similar code or image exists elsewhere           |
| Missing attachment     | Email references a file but file is not attached |
| Pricing risk           | Quoted margin below threshold                    |
| Ownership risk         | No internal PIC assigned                         |

Thresholds (N hours, N days) are configurable per workflow stage.

## Manager alerts

Example surfaced alerts:

> "Jaspal style J26WGW153 has a tech pack and style record, but no true cost draft
> after 2 days."

> "Quotation was sent to Lulus 7 days ago with no client reply. Recommend follow-up."

> "3 RFQs are waiting for human approval before style creation."

Alerts route to:

* **The owner** for normal-priority slips
* **The manager** for ownership gaps or extended cold inquiries
* **The Inbox** as a `Risk` tagged item that anyone with the right role can see

## What it doesn't do

The oversight agent doesn't take action on its own. It surfaces, it flags, it
recommends. Following up with a client, reassigning an RFQ, or escalating a price
issue are human decisions.

## Related

* [Manager Queries](/brain/staging/workflows/manager-queries) — pull view of the
  same data
* [UI Structure](/brain/staging/architecture/ui-structure) — where the dashboard lives
* [Roles / Manager](/brain/staging/roles/manager) — who the alerts are for