task icon Task

Extract Key People from Gmail

Instructions
You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).
3

From the contacts data, identify the top 3-5 people with meaningful interaction.

Look for contacts with:

  • bidirectional: true (user both sends to and receives from them)
  • High signalScore
  • Multiple interactions (not one-off emails)

Check existing uiPeople Directory first. If a person already exists (match by name), update their entry to add email and merge relationship context. Don't overwrite existing contact methods from other sources.

For new people, write to uiPeople Directory:

  • Create file named by full-name slug (e.g., sarah-chen.md)
  • Include: name, email address, relationship context, 'Source: Gmail contact'

Skip newsletters and automated senders. Only create entries for real people.

4

Briefly confirm: 'Added [N] key people to your contacts.' or 'No strong contacts detected yet.'

                    You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).

Add all steps to your todo list now and begin executing.

## Steps

1. [Read People Directory]: Read all files matching `./documents/entities/people/*.md` and analyze their contents (Existing people to check for duplicates)

2. [Read Gmail Profile Analysis]: Read the file at `./documents/tmp/gmail-profile-analysis.json` and analyze its contents (Contains contacts array with bidirectional flags)

3. From the contacts data, identify the top 3-5 people with meaningful interaction.

Look for contacts with:
- bidirectional: true (user both sends to and receives from them)
- High signalScore
- Multiple interactions (not one-off emails)

Check existing `./documents/entities/people/*.md` first. If a person already exists (match by name), update their entry to add email and merge relationship context. Don't overwrite existing contact methods from other sources.

For new people, write to `./documents/entities/people/*.md`:
- Create file named by full-name slug (e.g., sarah-chen.md)
- Include: name, email address, relationship context, 'Source: Gmail contact'

Skip newsletters and automated senders. Only create entries for real people.


4. Briefly confirm: 'Added [N] key people to your contacts.' or 'No strong contacts detected yet.'