Contact List

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:

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

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