Meeting Brief

Meeting Brief

Automated daily meeting preparation system that researches meeting attendees and sends you personalized briefs.

What It Does

Every morning (configurable time):

1. Checks your calendar for today's meetings (via gcalcli)
2. Extracts attendees from each meeting
3. Filters out your team members (configurable)
4. Deep researches each external person:
   • LinkedIn profile (web search)
   • Company information
   • GitHub profile (if engineer)
   • Past interactions/notes (memory search)
   • Recent news/activity
5. Generates AI-powered brief per person
6. Sends 1 email per person to your inbox

Setup

1. Configure Team Members

Edit config.json to list your team members (these will be skipped):

{
  "team_members": [
    "alice@yourcompany.com",
    "bob@yourcompany.com",
    "team@yourcompany.com"
  ],
  "team_domains": [
    "@yourcompany.com"
  ],
  "schedule": "0 7 * * *",
  "timezone": "America/Los_Angeles",
  "your_email": "you@yourcompany.com",
  "brief_from": "Meeting Brief <briefbot@yourcompany.com>",
  "slack_webhook": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL",
  "send_email": true,
  "send_slack": true,
  "include_calendar_details": true,
  "research_depth": "standard"
}

Config options:

• team_members: Emails to skip (exact match)
• team_domains: Domain patterns to skip (e.g., skip all @yourcompany.com)
• schedule: Cron expression for daily run (default: 7am)
• timezone: Timezone for schedule
• your_email: Where to send briefs
• brief_from: From address for briefs
• slack_webhook: Slack incoming webhook URL (optional)
• send_email: Whether to send email briefs (default: true)
• send_slack: Whether to send Slack notifications (default: false)
• include_calendar_details: Include meeting time/location in brief
• research_depth: quick (web only), standard (web + GitHub), deep (web + GitHub + past notes)

2. Run Daily (Manual or Scheduled)

Run manually each morning:

cd skills/meeting-brief
./scripts/run_daily.sh

How It Works

Main Workflow (scripts/run_daily.sh)

1. Fetch today's meetings (scripts/check_calendar.sh)

   • Uses gcalcli to get today's agenda
   • Parses meeting times, titles, attendees
   • Outputs JSON with meeting details

2. Filter external attendees (built into run_daily.sh)

   • Loads config.json
   • Filters out team members and team domains
   • Creates list of people to research

3. Research each person (scripts/research_person.js)

   • Web search: LinkedIn profile, company info
   • GitHub search: Profile and repos (if applicable)
   • Memory search: Past interactions/notes
   • News search: Recent activity
   • Outputs structured research JSON

4. Generate brief (scripts/generate_brief.js)

   • Uses AI agent to generate the brief
   • Inputs: research data + meeting context
   • Outputs: Two formats:
     • Email: Concise bullet-point brief
     • Slack: Rich paragraph-style story with deeper context and narrative

5. Send brief

   • Email: Uses Gmail skill (send_email: true)
   • Slack: Uses webhook (send_slack: true, scripts/send_slack.sh)
   • Subject: "Meeting Brief: [Person Name] - [Meeting Title]"
   • Body: AI-generated brief with research

6. Save to personal CRM (supernotes/people/)

   • Each researched person saved as markdown file
   • Includes: research data, meeting context, date
   • Builds personal relationship database over time

7. Track sent briefs (logs to data/sent/YYYY-MM-DD.json)

   • Prevents duplicates
   • Enables analytics

Research Process

For each external attendee, the system researches:

Web Search (Always)

• LinkedIn profile (name + company)
• Company information
• Recent news mentions
• Professional background

GitHub (If research_depth is standard or deep)

• GitHub profile lookup (by name/email)
• Recent repos and contributions
• Technical focus areas

Memory/Past Notes (If research_depth is deep)

• Search MEMORY.md and daily notes
• Past meeting notes
• Previous interactions
• Context from past conversations

Output Format

Research is structured as JSON:

{
  "person": {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "company": "Example Corp",
    "title": "VP Engineering"
  },
  "linkedin": {
    "url": "...",
    "bio": "...",
    "experience": [...]
  },
  "github": {
    "username": "janedoe",
    "profile_url": "...",
    "recent_repos": [...]
  },
  "company": {
    "name": "Example Corp",
    "industry": "...",
    "recent_news": [...]
  },
  "past_interactions": [
    "Met at conference in 2024",
    "Discussed partnership opportunity"
  ]
}

Brief Generation

The AI-generated brief comes in two formats: