Home / Ops / More in this area

Affirmology Customer Email System - Single Source of Truth (Cowork <-> Code)

Updated Jul 02, 2026 · Affirmology_EmailSystem_SourceOfTruth_v1.md

Affirmology Customer Email System - Single Source of Truth (Cowork <-> Code)

Purpose: one template family, one sender, zero divergence. This is the authoritative doc for every customer-facing email. Read it before building or changing any email.

Ownership split

• COWORK owns email DESIGN + COPY. The canonical version of every email is its .html file in the project root (below). If the copy or look needs to change, Cowork edits that file.
• CODE owns the SEND. Code copies the exact HTML from the canonical file into an engine constant in api/demo_render.py and sends it via api/emailer.py -> send_email().
• Rule: Code never forks, rewrites, or improvises email copy. It mirrors the .html file verbatim. When Cowork changes a file, it names the file to Code, and Code re-syncs that one constant. Nothing else changes.

Canonical template files (the source of truth)

Shared spec (identical across all customer emails)

• From: Affirmology <hello@affirmology.ai>
• BCC: jeff@affirmology.ai (so Jeff sees a copy of every customer send)
• Sender: api/emailer.py send_email() (Resend). Must send with a browser User-Agent header or Resend 403s with Cloudflare error 1010.
• Placeholders (only these two): {{FIRST_NAME}}, {{RESULT_URL}}
• Canonical result link format: https://demo.affirmology.ai/result?j=<job_id> (the results page reads ?j= first, then #<job>, so both resolve; standardize on ?j=). Force the full experience instead with https://demo.affirmology.ai/primer.html#<job_id>.
• Header logo: https://media.affirmology.ai/brand/email-logo.png (the orb mark, ~70-74px)
• Footer wordmark: ✦ AFFIRMOLOGY ✦ (star both sides), gold #d9b15a, letter-spaced
• Palette: card #0d2c1c, page #061b10, border rgba(217,177,90,0.30), body #cdbfa3, bright #ecd9a8, gold button #c89b3c on #06150c text
• No MP3 or PDF attached to any email. Everything drives to the results page.
• Never use em dashes.

The Mirror email - build note for Code

• Use Affirmology_MirrorEmail_v1.html as-is. Add _MIRROR_HTML + send_mirror_email() in the SAME api/demo_render.py, reusing the identical header/palette/footer, routed through emailer.send_email() with BCC jeff@affirmology.ai. Subject: "We read your chart. Meet The Mirror." (The in-email greeting stays "A new audio gift awaits, {{FIRST_NAME}}." - subject and greeting differ on purpose.)
• DEPENDENCIES before the Mirror can send for real: 1. Code generates each person's Mirror MP3 (Fish "Dr. Young" male voice) and exposes it on the results-page status payload (e.g. a mirror_url field). 2. Cowork adds a "New Audio - The Mirror" player section high on result.html, under the Origin Soul Song, that shows when mirror_url is present.
• The email also teases the inline Jeff & Sol welcome video via its still (https://media.affirmology.ai/brand/jeff-sol-welcome-poster.jpg).

Test protocol before ANY batch

Code sends Jeff a test using the SAME engine constant + a REAL job id, so the test the Jeff sees is byte-identical to what customers will get. Jeff signs off, then the batch runs.

Sync checklist (run this whenever an email changes)

1. Cowork edits the canonical .html file and pings Code with the filename.
2. Code copies that HTML verbatim into the matching constant in api/demo_render.py.
3. Code sends Jeff a test from that constant + a real job.
4. Jeff approves. Batch sends with BCC to jeff@affirmology.ai.