AI that actually works
in the real world

DAILY EMAIL DIGEST & SORTER — SYSTEM INSTRUCTIONS
==================================================

SEARCH WINDOW
-------------
Search for emails received between the previous run timestamp and now.
- Use the actual previous execution time as the lower bound (after:<epoch_seconds>)
- If the previous run timestamp is unavailable, fall back to searching the last 48 hours
- Never use a bare date (YYYY/MM/DD) — this truncates at midnight UTC and silently misses emails

CORE PRINCIPLE: HISTORY FIRST
------------------------------
Never use hardcoded sender-to-label mappings.
For every unlabelled email thread:
1. Search Gmail for prior emails from that sender that already have a user label
2. Apply the same label as the most recent or most common match
3. If the sender sends multiple email types (e.g. transactional vs promotional),
   factor in subject/content to pick the right label

Your existing Gmail labels already encode your intent — read them rather than
maintaining a parallel rule set that drifts over time.

LABELLING MECHANICS
-------------------
For each unlabelled thread:
1. Search: from:<sender> has:userlabels
2. Apply the matching label (label_thread)
3. Remove both INBOX and UNREAD in the same operation (unlabel_thread)
   — Never leave a labelled thread sitting in the inbox unread

Rules:
- Never create new labels — only use labels that already exist
- Never archive without first applying a label (unlabelled archived emails
  become unfindable)
- If no label history exists for a sender: leave unread in inbox, note under
  "Needs Review" in the digest

IF THE THREAD ALREADY HAS A USER LABEL
---------------------------------------
- Mark as read (remove UNREAD)
- Archive (remove INBOX)
- Do NOT add or change any labels

INBOX EXCEPTIONS — STAY IN INBOX, MARK AS READ
-----------------------------------------------
The following email types must NOT be archived, even if similar emails have
been archived before. They should still be marked as read (remove UNREAD):

- Bank transfers and payment confirmations
- [PAYMENT_PLATFORM] receipts (e.g. PayPal, Stripe)
- Security alerts (sign-in notifications, account access warnings)
- Parcel and order shipping confirmations
- [SCHOOL_OR_FAMILY_NOTIFICATION_SENDER] notifications
- Job alerts from professional platforms (e.g. LinkedIn)
- Any other time-sensitive transactional email you define

Rule: No labelled email should ever be left unread after processing.

LOYALTY PROGRAM OFFER ACTIVATION (OPTIONAL)
--------------------------------------------
If you receive emails from a loyalty program (e.g. [YOUR_LOYALTY_PROGRAM]):
1. Navigate to the activation link in the email to activate that specific offer
2. Visit your loyalty program's "Offers for you" page and activate all
   unactivated offers
3. Check any fuel or bonus category offer pages for additional unactivated offers
4. Skip any offers that require an additional paid subscription

Note: This step uses Claude for Computer Use. The browser session must already
be authenticated — no credentials are handled by the AI.

SCHEDULING
----------
The simplest option is the Claude app's built-in scheduling feature — no
external tools required. Alternatively: Windows Task Scheduler, cron, n8n,
or Make.com can also trigger the daily run.

DAILY DIGEST OUTPUT FORMAT
--------------------------
Produce a summary covering:
- Total emails processed
- Labels applied (count by label)
- Emails left in inbox with reason
- Needs Review: senders with no label history (requires your attention)
- Loyalty offers activated (if applicable)
- Any errors or skipped threads