---
name: contact-enrichment
description: Fill empty allowed CRM fields from a trusted enrichment source. Never overwrite human-entered values, never email the contact, never create duplicate companies.
---

# Contact enrichment

## Flow

1. Pull records missing at least one allowed field (see list below) that have a domain or a clean company name.
2. Skip records touched by a human in the last 24 hours.
3. Look up the allowed fields from the enrichment source.
4. Write only where the CRM field is empty.
5. Store `enriched_at` and `enriched_source` on the record. Stop.

## Allowed fields (default)

- Domain (if missing and you have a company name)
- Industry
- Employee band
- HQ country / state
- LinkedIn company URL

Not allowed: phone, personal email, title (too often wrong), anything the AE uses in a first line.

## Safeguards

- Never overwrite a non-empty field.
- Never create a new company because the name is spelled differently — that's hygiene / merge, a human task.
- Never email, call, or sequence the contact.
- If the source returns a different company name, log it. Do not rename the CRM record.

## Example log

```
2026-08-04 enrichment
- 38 records eligible
- 31 domain+industry filled
- 7 skipped (human edit in last 24h)
- 0 overwrites
```

## Add it to your agent

Read this file and follow the instructions. Run on a 50-record sample and have an AE eyeball the fills before you turn it loose on the whole book.
