name: Contacts
description: Build a personal contact system with details, interactions, birthdays, and smart reminders.
metadata: {"clawdbot":{"emoji":"π₯","os":["linux","darwin","win32"]}}
Core Behavior
User mentions a person β check if contact exists, offer to create/update
Calendar event detected with contact β surface relevant notes before meeting
Birthday approaching β remind with context about the person
Create ~/contacts/ as workspace
When User Mentions Someone
"Had coffee with Maria" β log interaction, create contact if new
"John's daughter is Sofia" β add to personal details
"Sarah loves hiking" β add to interests/notes
"Meeting with Tom tomorrow" β check calendar, surface Tom's context
Contact Structure
One Markdown file per person: maria-garcia.md
Sections: basics, personal details, interaction history, notes
Tags for grouping: #family #work #friend #neighbor
Keep it human-readable β this is about relationships, not data entry
Key Fields To Capture
Name, how you met, where they work/live
Birthday, anniversary, important dates
Family members, pets, kids names
Interests, hobbies, what they care about
Last interaction and context
How they prefer to communicate
Interaction Logging
Date + brief note: "2024-03-15: Lunch, discussed her new job"
Don't force structure β freeform is fine
Recent interactions at top β most relevant for context
Link to related contacts if group interaction
Birthday System
Store birthday in frontmatter or consistent format
Daily/weekly scan for upcoming birthdays
Remind 3-7 days ahead β time to prepare
Include context: interests, gift ideas from notes
Calendar Integration
Before meeting: "You're meeting Alex tomorrow. Last saw him in January, discussed his startup pivot"
After meeting: prompt to log interaction
Detect recurring meetings β suggest adding contact details if sparse
Conference/event: remind of attendees you know
Progressive Enhancement
Week 1: create contacts as they come up naturally
Week 2: add birthdays for close contacts
Month 2: review and enrich sparse contacts
Ongoing: capture details during conversations
What To Surface Proactively
"Tomorrow is David's birthday" + last interaction + interests
"Meeting with Lisa in 2 hours" + her context + last topics
"Haven't talked to Mom in 3 weeks" β if user wants relationship nudges
"Alex mentioned job hunting last time" β relevant context resurfacing
Details Worth Remembering
Kids/spouse names and ages
Recent life events: new job, moved, health issues
Preferences: vegetarian, doesn't drink, early riser
Sensitive topics to avoid
How you can help them / how they can help you
What NOT To Suggest
Syncing with phone contacts β different purpose, keep separate
CRM-style pipeline tracking β this is personal, not sales
Automated birthday messages β defeats the purpose
Social media integration β privacy and complexity
