contact-list

Single source of truth for all contacts, PAs, and WhatsApp groups. Use when: looking up a phone number, email, address, PA, group JID, adding/updating a contact, or before sending any WhatsApp message

SKILL.md

GitHub

Contact List Skill

Minimum Model

Any model. This is a lookup/edit skill.


Source File

All contact data lives in contact-list.md (workspace root). This is the ONLY source of truth.

❌ Do NOT use data/contacts.md, PA_LIST.md, addresses.md, builders_leadership.md, or groups_index.md — they are deprecated.

File Structure

contact-list.md has these sections:

Section Content
אנשי קשר Main contacts table: שם, טלפון, אימייל, כתובת, עיר, Owner Role, PA, הערות
Active PAs PA↔Owner mapping with phones and status
PA Sync List DM targets for pa-network-daily-sync
Contacts Without PA Interested/pending PA contacts
WhatsApp Groups All group JIDs (English + Hebrew)

Lookup

Find a contact by name

grep -i "SEARCH_TERM" /path/to/workspace/contact-list.md

Replace SEARCH_TERM with the name (partial match OK, case-insensitive).

Find a PA by owner name

grep -i "OWNER_NAME" /path/to/workspace/contact-list.md | head -5

The PA column in the contacts table shows PA_NAME (+phone). The Active PAs section has the full mapping.

Find a group JID

grep -i "GROUP_NAME" /path/to/workspace/contact-list.md

Look in the WhatsApp Groups section (bottom of file).

Pre-send validation

Before sending any WhatsApp message:

  1. grep the recipient's name or phone in contact-list.md
  2. Verify the phone/JID exists
  3. If not found → ask the owner. Never guess.

Add a Contact

Append a new row to the אנשי קשר table in contact-list.md:

| Name | Phone | Email | Address | City | Owner Role | PA | Notes |

Rules:

  • Check for duplicates first: grep -i "NAME_OR_PHONE" contact-list.md
  • If the contact is from Builders Leadership → set Owner Role = leadership
  • If they have a PA → fill the PA column with PA_NAME (+phone)
  • Keep alphabetical order: Hebrew names (א-ת) first, then English (A-Z)
  • After adding → git add contact-list.md && git commit -m "add contact: NAME" && git push

Update a Contact

  1. Read contact-list.md
  2. Find the row to update
  3. Edit the specific field (phone, address, PA, etc.)
  4. After updating → git add contact-list.md && git commit -m "update contact: NAME — FIELD" && git push

Add a New PA

When a new PA is onboarded:

  1. Add to Active PAs table — new row with PA Name, Phone, Owner, Owner Phone, Status
  2. Update the contact row — add PA name + phone to the PA column of the owner's entry
  3. Add to PA Sync List — append DM target line: - +PHONE — PA_NAME (Owner)
  4. Git push — git add contact-list.md && git commit -m "add PA: PA_NAME for OWNER" && git push

Add a New Group

When joining a new WhatsApp group:

  1. Add a row to the appropriate section (English or עברית) in the WhatsApp Groups table
  2. Include: שם הקבוצה, Group JID, הערות
  3. Git push

Remove / Deactivate

  • Contact removed: Delete the row. Git push.
  • PA deactivated: Change status to ❌ לא פעיל in Active PAs. Remove from PA Sync List DM targets. Keep the contact row but clear the PA column. Git push.

Trigger Phrases

If the owner says... Action
"מי זה X" / "who is X" Lookup by name
"מספר של X" / "X's number" / "phone for X" Lookup phone
"כתובת של X" / "address for X" Lookup address
"אימייל של X" / "email for X" Lookup email
"PA של X" / "X's PA" / "find PA for X" Lookup PA
"JID של X" / "group JID" Lookup group
"add contact" / "הוסף איש קשר" Add contact flow
"update contact" / "עדכן פרטים" Update contact flow
"new PA" / "PA חדש" Add PA flow (then also run ai-pa)

Cost Tips

  • Very cheap — grep + file edit, any model works
  • No API calls — everything is local markdown
  • Batch multiple updates into one commit

Error Reference

Error Cause Fix
Contact not found Name spelling, partial match Try shorter search term, check both Hebrew and English
Duplicate detected Contact already exists Update existing row instead of adding
File not found contact-list.md missing Check workspace root, run git pull
Git push failed Network or auth issue Retry, check git credentials