---
title: Keep your network warm in Venom People
description: Debrief an event in a card stack, get five people a day to reach out to with a drafted message in your tone, set circles and cadences, see why each score is what it is, and ask who you know. Venom drafts; you press send.
section: cloud
order: 162
audience: [user, operator]
sources: [services/nodejs-cloud/lib/people/warming.ts, services/nodejs-cloud/components/people/NeedsWarming.tsx, "services/nodejs-cloud/app/(people)/people/today", "services/nodejs-cloud/app/(people)/people/debrief", services/nodejs-cloud/components/people/Today.tsx, services/nodejs-cloud/components/people/Debrief.tsx, services/nodejs-cloud/lib/people/warmth.ts, services/nodejs-cloud/lib/people/followups.ts, services/nodejs-cloud/lib/people/drafts.ts, services/nodejs-cloud/lib/people/debrief.ts, services/nodejs-cloud/lib/people/recall.ts, services/nodejs-cloud/migrations/0166_people_keep_warm.sql, services/nodejs-cloud/lib/people/today.ts, services/nodejs-cloud/lib/people/today-model.ts, services/nodejs-cloud/lib/people/tools-today.ts, services/nodejs-cloud/components/people/TodayMine.tsx, services/nodejs-cloud/migrations/0294_people_today.sql, services/nodejs-cloud/lib/people/notes.ts, services/nodejs-cloud/lib/people/notes-model.ts, services/nodejs-cloud/components/people/TodayNote.tsx, services/nodejs-cloud/migrations/0295_people_today_notes.sql, docs/adr/0057-venom-people.md]
features: [cloud.page-people]
---

You meet hundreds of people at a conference and follow up with almost none. Months later one of them matters and the
context is gone. [Venom People](/docs/cloud/people.md) keeps the context; this page is the part that makes sure the follow-up
happens. **Venom never sends a message.** It drafts, you read it, you press send in your own app.

## Debrief an event

Open **Debrief** (`/people/debrief`). Every event where you met people you have not rated yet is listed. When an event
has ended, **Today** also shows a banner for it. **Debrief now** works for an event you are still at.

Pick an event to open its stack (`/people/debrief/{event}`). The debrief is a stack of cards, one per person, strongest signal first: the more you wrote down (notes, what was said),
the more open loops ("I promised to send the deck"), and a way to reach them, the earlier they come. One key rates each:

| Key | Rating | What happens |
|---|---|---|
| `h` | Hot | They go in your **inner circle** and get a drafted follow-up |
| `w` | Warm | They go in your **active circle** (an inner-circle person stays there) and get a drafted follow-up |
| `l` | Later | Pick a nudge date (default two weeks); they come back on Today then |
| `s` | Skip | No follow-up; they stay in your people |

`u` undoes the last rating, `←` and `→` move without rating, `Esc` closes the date picker. The same actions work with the
buttons. At the end you see what you did ("3 hot, 5 warm, 2 for later: 8 follow-ups drafted") and go to Today, or
choose **Follow up with N people** to enroll everyone you met there in an Outreach sequence ([Outreach](/docs/funnel/outreach)).

## Today: five people

**Today** (`/people/today`, also a card on Home and a row in the bell) shows up to five people to reach out to. Each has the
reason and, once written, a draft. When a saved Reach view runs every night, Today opens with its picks first
([the overnight queue](/docs/cloud/people-overnight.md)). The five are:

- **Overdue for their circle.** Past the cadence, most overdue first.
- **An open loop.** Something in your notes like "promised the deck" or "I'll send her the intro", unless you have been in
  touch since.
- **You met a year ago this week.**
- **You are travelling to their city.** From a trip you typed on Today (a city and dates). People whose location matches
  come up in the three weeks before.
- **A note or issue matches what they care about.** Words in your own recent notes or open Tasks issues that match
  their tags, role or company. Nothing outside your own notes and issues is read.
- **A nudge date arrived.** You rated them Later.

The five are picked once a day and stay put while you work through them. A snooze or "not relevant" brings in a
replacement; a **Done** or a sent message counts toward the five without one. The picks are varied: at most one person per
company in the first pass, and not five of the same reason when other reasons exist. Snoozed, just-touched and skipped
people never show up.

When you have [intro asks](/docs/cloud/people-intros.md) to send, nudges due or an intro that looks done, Today shows them under
**Intros**.

Keys on Today: `j`/`k` move, `d` draft, `x` done, `s` snooze a week, `Enter` open the person.

### Needs warming

Below the five, **Needs warming** lists up to ten of your own people with an open follow-up (you wrote last and heard
nothing back) or gone quiet (cooling, or cold and worth re-warming), as [Reach](/docs/cloud/people-reach.md) routes them: most senior
first, then the most relevant. Each has **Reached out**, which logs a touch as in Reach, and **Snooze**, which hides them
for 14 days. **See all in Reach** opens Reach with the same two routes. It does not change the five picked for the day.

### The draft and the channels

A draft is two or three sentences that refer to what you talked about, in the tone of your own earlier messages. It is
written by your organisation's own gear, counted against People's daily AI limit ($1 by default; an owner or admin
changes it in People → Settings, [AI and limits](/docs/cloud/people.md#ai-and-limits)). Drafts that contain placeholders, sales phrases, lists, markdown or a link that is not in your notes are
rejected; Venom asks the model once more and, if that fails too, tells you instead of showing it. Edit the text freely.

The buttons open your own app with the text ready:

- **WhatsApp**: `https://wa.me/<number>?text=…` (their WhatsApp handle, else their phone).
- **Telegram**: `https://t.me/<handle>`. Telegram cannot prefill text, so Venom copies it first.
- **Email**: a `mailto:` with a subject and the text.
- **Copy**.

**Pressing a channel is how you mark it sent.** It logs an outbound message on their timeline (kind message or email,
direction out), marks the follow-up done and restarts the circle's clock. If you changed your mind after pressing, delete
the interaction on their page. Without a gear, or at the daily limit, you can write the message yourself and the buttons
work the same.

**Snooze** (tomorrow, 3 days, a week, a month) leaves the person out until then. **Not yet** (the X) drops the follow-up and
leaves them out for your default (30 days unless you changed it; see [Not yet](#not-yet)). **Done** is for follow-ups you
handled elsewhere.

## Ask for who you want

The box at the top of Today takes a request in your own words: "founders hiring their first GTM person", "GPU and inference
people I haven't spoken to", "people tagged nextplay I have an email for". Venom finds matching people among **your own**
people and lists up to 20, each with its role, company, last touch and a one-line why ("Founder at Lambdaish · tagged
nextplay · last touch 3 months ago"). The why is built from the person's record, never written by the model, so it cannot
say something the record doesn't.

How it works: your gear turns the request into searches over People's own read tools (`people_person_search` and
`people_reach_search`, the same ones an agent gets), run as you. It can make at most three model calls per request, each
with up to three searches and a short answer, and the whole request stops after 40 seconds. Each model call counts against
People's daily AI limit. The model cannot call any other tool, and nothing it reads (names, notes) changes what it may call.
Searches use words, rules and tags, not meaning, so a request costs no embeddings. With no gear, or once the day's limit is
spent, a plain word search runs instead and the page says so.

Each row has **Add to today** (it joins today's list with that why line, no model call), **Draft**, which opens it on
Today, and **Not yet**. **Save as brief** keeps the request as a standing brief.

### Standing briefs

A brief is a saved request. People who match one of your briefs come up in the daily picks with the reason "Matches your
brief …", next to the other reasons. A brief keeps the tags, functions, sectors and seniority the model searched for, plus
its words; without those, a person has to match two of its words. You can have up to ten, and pause, edit or delete them in
**Customize**.

## Not yet

**Not yet** on a pick or a found person takes an optional reason (not now, not relevant, already in touch, other) and how
long (your default, 30 days unless changed). They are left out of picks and finds until then; **Undo** in the toast or the
**Not yet** list brings them back, and the list hides the ones that lapsed. Two reasons change ranking, in ways you can see:

- **Not relevant** halves the score of other people at the same company.
- **Not relevant** on someone a brief brought in lowers that brief's weight by a fifth per mark (to 40% at most), shown next
  to the brief in **Customize**.

## How did it go?

Every person on Today (the daily picks, brief matches, drafts waiting and people you found) has **How did it go?**. Pick an
outcome if one fits (sent, replied, no reply, meeting booked, not interested, wrong person, ask later), write a line ("sent
the deck, follow up after their launch on the 20th") and **Save**. The note is saved straight away as an interaction on the
person's page, with the draft's channel when there was one, so it shows in their timeline and counts toward last touch,
strength and the context card. The Today row is marked done.

Then Venom works out the next step, without holding up the save. It makes one model call. The call goes to Venom's decision
model `venom-decide` (TypeSafe's Jev, on `/v1/systemone`) where your organisation has it, and otherwise to your gear with
an answer held to a fixed JSON schema. It counts against People's daily AI limit. The answer can only be one of these:

| Next step | What happens with the default setting |
|---|---|
| Follow up on a date | applied: they are left out of Today until then, then come back with "You said to follow up: …" |
| Wait for their reply | applied: back on the date with "No reply since 12 Nov" |
| Reply now | applied: the row opens again so you can answer |
| Not for a while (N days) | applied as a [Not yet](#not-yet) with the reason |
| Meeting | suggested: **Create task** files a Venom Tasks issue assigned to you |
| Stop suggesting | suggested: **Apply** marks them not yet for a year |
| Nothing | nothing changes |

What was applied shows on the row with **Undo**, and **Change** lets you pick another step or date before or after it is
applied. The row also says who chose the step: AI, the rules, or you. When the AI limit is spent, no model is set up, or the
answer doesn't fit the schema, the note is still saved and the rules choose from the outcome and plain dates in your note
("tomorrow", "next week", "in two weeks", "in March", "after the 20th", "3 Dec", "on Friday"). Two **No reply** notes in a row halve
the person's score on Today, and the rules then wait a month before suggesting them again; the row says "No reply 2 times in a row:
ranked lower". Your note is only data for the step. It can't make Venom do anything outside the list, and Venom never sends a
message.

## Customize

**Customize** in Today's header holds your own settings; the defaults are the page as it was before settings existed:

| Setting | Default |
|---|---|
| People a day | 5 (1 to 20) |
| A weight per reason (off, low, normal, high) | normal for every reason |
| How long Not yet lasts | 30 days (1 to 365) |
| Never suggest these tags, circles or companies | none |
| Only people with an email or a phone | anyone |
| Standing briefs | none |
| After a note: apply the next step, only suggest it, or none (no model call) | apply |

Venom never sends anything for you: drafts and the channel buttons are as above.

## Circles and cadences

Every person can be in a circle. The defaults:

| Circle | Default cadence |
|---|---|
| Inner circle | every 3 weeks (21 days) |
| Active | every quarter (90 days) |
| Long tail | every year (365 days) |

Change a circle's cadence on Today (**Circles**, in days; **Reset** goes back to the default) and it applies to your people
in it. A single person can have their own cadence on their page (**Keep warm**), which beats the circle's. People with no
circle are never reminded about by cadence (the other reasons still apply).

To set many at once, pick them in the People list or in [Reach](/docs/cloud/people-reach.md) and choose **Keep warm**: a circle and,
optionally, their own cadence in days.

Instead of a reminder, a person's cadence can run an Outreach catch-up sequence that drafts the message for you
(**When the cadence comes due** on their page). See [Catch-ups and event follow-ups](/docs/funnel/outreach.md#catch-ups-and-event-follow-ups).

## Strength: how warm, and why

Each person has a score from 0 to 100 on their page, with the reasons behind it:

| Factor | Points | How it is worked out |
|---|---|---|
| Recency | 45 | halves every N days since the last real contact (inner 30, active 75, long tail 200, no circle 90); a note to yourself counts half |
| Frequency | 20 | contacts in the last year, with diminishing returns (12 or more is full marks) |
| Reciprocity | 15 | whether they reach out too: logged inbound against outbound, and meetings and calls count both ways |
| Depth | 20 | the best touch of the year (a meeting beats a call beats a message beats a note) and the last five on average |

The score is recomputed every night and when you send a message, rate a person or change their circle. Log who reached out
(`direction` in, out or both) for reciprocity to mean something; a message you send from Today is logged as out.

## Who do I know who…

Ask on Today: "who do I know in cold storage in Jakarta?", "who did I promise a deck to?". Venom searches your own people
(words and meaning), gives the matches' context cards and recent interactions to your gear and writes a short answer with
numbered citations that link to the people. The matches show as soon as the search finds them, with "Writing an
answer…" until the answer replaces them. A citation the model made up is dropped. With no gear, or at the daily limit,
you still get the matches. It only ever reads your own people, never a colleague's shared ones.

## Privacy

Everything on this page is about **your own** people. A colleague's shared person never appears in your Today, debrief,
drafts or answers, and yours never appear in theirs. An org owner or admin has no back door.

## Agents

An agent with your personal key can run the same flow: `people_followup_list`, `people_followup_draft`,
`people_followup_done`, `people_debrief_run`, `people_circle_list`, `people_circle_update` and `people_recall_ask`
([People for agents](/docs/cloud/people-mcp.md)). It can leave drafts for you to approve on Today; it cannot send them.

The rest of Today has tools too: `people_today_find` (ask for who you want), `people_brief_list`, `people_brief_create`,
`people_brief_update`, `people_brief_delete`, `people_downvote_list`, `people_downvote_set`, `people_downvote_delete`,
`people_todaysetting_get` and `people_todaysetting_set`. `people_followup_snooze` and `people_followup_dismiss` take a
`reason`, and `people_followup_dismiss` takes `days`; `people_followup_draft` with `add_only` adds a person to today without
drafting. `people_todaynote_create` saves how it went and makes the next step; `people_nextstep_get`,
`people_nextstep_apply` and `people_nextstep_undo` read, apply or change, and undo it; `people_todaysetting_set` takes
`note_steps` (auto, suggest, off).

## Daily email

An email digest is not available yet: it needs an email provider for the organisation, which Venom Cloud does not have. The
bell and Home carry the daily five instead.
