Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
186 commits
Select commit Hold shift + click to select a range
f034ecd
fix(skills): ship a variant's own reference folder in its bundle
Silthus Oct 22, 2026
177e741
refactor(skills): share the email sender setup as a partial
Silthus Oct 22, 2026
8169d7e
feat(skills): add the migrate-email skill with a Resend variant
Silthus Oct 22, 2026
5e019aa
fix(skills): keep migrate-email's summary values bare and define a site
Silthus Oct 22, 2026
6e902dc
fix(skills): point migrate-email at the transactional email docs and …
Silthus Oct 31, 2026
0286e23
fix(skills): check migrate-email's API access with the real tools and…
Silthus Nov 1, 2026
0920218
refactor(skills): share the posthog-node client setup as a partial
Silthus Oct 22, 2026
64a2397
feat(skills): move Resend sends to posthog-node in migrate-email
Silthus Oct 22, 2026
ad4b0c7
fix(skills): keep migrate-email from splitting sends or faking the ol…
Silthus Oct 22, 2026
b2965cc
fix(skills): handle suppressed recipients and dynamic subjects in mig…
Silthus Oct 22, 2026
f8f4fea
fix(skills): keep a suppressed copy address from passing as a sent email
Silthus Oct 22, 2026
8dcd459
fix(skills): warn that retrying a send with a suppressed copy address…
Silthus Oct 22, 2026
154e8f5
fix(skills): leave migratedFrom off the posthog-node client in migrat…
Silthus Oct 31, 2026
9cd85f5
fix(skills): check that posthog-node has the code form before migrate…
Silthus Nov 1, 2026
41ca66a
fix(skills): detect resend over smtp, stop without sends, and record …
Silthus Nov 1, 2026
0e526b9
refactor(scripts): ship variant references through the local referenc…
Silthus Nov 1, 2026
e51df39
merge: feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 1, 2026
8c841cd
fix(skills): tie migrate-email's test send to its own events and repo…
Silthus Nov 1, 2026
4ad8c6e
fix(skills): let migrate-email move on when DNS waits and read templa…
Silthus Nov 1, 2026
020b877
merge: feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 1, 2026
8452a82
fix(skills): pin migrate-email's test start to the database clock and…
Silthus Nov 1, 2026
53a190c
fix(skills): keep migrate-email's test clock uncached and report depe…
Silthus Nov 1, 2026
50b5f27
fix(skills): keep migrate-email's chain query uncached on its rerun
Silthus Nov 1, 2026
8f77354
fix(skills): keep cc, bcc, headers, tags and attachments sites on Res…
Silthus Nov 2, 2026
d871b8e
Merge feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 2, 2026
b9d785e
Drop local templates and parked fields from the cutover steps
Silthus Nov 2, 2026
5edeb92
feat(migrate-email): set migratedFrom on the posthog-node client
Silthus Nov 2, 2026
64cf8ef
fix(migrate-email): ask for the PostHog template ID before a template…
Silthus Nov 2, 2026
85f6096
fix(migrate-email): check each PostHog template and its sender before…
Silthus Nov 2, 2026
a759ff4
fix(migrate-email): ask about a repeat import and test a send that na…
Silthus Nov 2, 2026
5c8a34b
fix(migrate-email): ask for the PostHog template ID and sender before…
Silthus Nov 2, 2026
e053dab
Merge feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 2, 2026
efa4933
fix(skills): read Dirent.path when parentPath is missing in the migra…
Silthus Nov 2, 2026
5e40f2a
Merge feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 2, 2026
2c36853
fix(migrate-email): match account.md's template-content rule to Step 3
Silthus Nov 2, 2026
8dcf6e7
fix(migrate-email): keep a site on Resend when its idempotency key do…
Silthus Nov 2, 2026
07dbf3a
fix(migrate-email): name PostHog's idempotency key rule exactly
Silthus Nov 2, 2026
a1376c0
Merge feat/migrate-email-resend into feat/migrate-email-resend-cutover
Silthus Nov 2, 2026
21f683e
fix(migrate-email): end Step 8's email check when the person declines…
Silthus Nov 2, 2026
d157859
docs(migrate-email): say where a send without distinctId lands
Silthus Nov 3, 2026
5dcdd21
docs(migrate-email): test Step 8 on a site that passes distinctId
Silthus Nov 3, 2026
4fc8d41
docs(migrate-email): say why cc, bcc and attachments stay on Resend
Silthus Nov 4, 2026
9664659
docs(migrate-email): name the real reason a field stays on Resend
Silthus Nov 4, 2026
4e5a672
docs(migrate-email): give scheduled sends and topics a reason too
Silthus Nov 4, 2026
8d88206
fix(migrate-email): keep a site on Resend when its key length is unbo…
Silthus Nov 4, 2026
5863a99
fix(migrate-email): quote Resend fallbacks with single quotes only
Silthus Nov 4, 2026
eed16c6
fix(migrate-email): record the PostHog key as set only after a check …
Silthus Nov 4, 2026
2d91936
fix(migrate-email): accept spaces around = in the key check
Silthus Nov 4, 2026
074130e
fix(migrate-email): check the last assignment of the PostHog key
Silthus Nov 4, 2026
5c92245
docs(migrate-email): ask for the transactional_email:write scope
Silthus Nov 5, 2026
f5080a7
Merge remote-tracking branch 'origin/feat/migrate-email-resend' into …
Silthus Nov 5, 2026
254dbb9
fix(migrate-email): name the transactional email scope in the preflight
Silthus Nov 5, 2026
464644f
Merge branch 'feat/migrate-email-resend' into feat/migrate-email-rese…
Silthus Nov 5, 2026
4b0f257
feat(migrate-email): move Resend sends in every PostHog SDK's language
Silthus Nov 5, 2026
c4ed38c
fix(migrate-email): keep the app booting and check the whole project …
Silthus Nov 5, 2026
a658c75
fix(migrate-email): use the one Rust client the app's features build
Silthus Nov 5, 2026
cffc009
feat(migrate-email): carry posthog-sdks.md's rules into the rewrite f…
Silthus Nov 5, 2026
6ab1cc2
Merge the migration lane's per-SDK rules into feat/migrate-email-all-…
Silthus Nov 5, 2026
f6b6af8
fix(migrate-email): check the merged SDK rules against the SDK heads
Silthus Nov 5, 2026
ef2c2e9
fix(migrate-email): give Elixir email its own instance when the app u…
Silthus Nov 5, 2026
fbd1e83
fix(migrate-email): never pass nil for Elixir's host or token
Silthus Nov 5, 2026
78d56ce
fix(migrate-email): fall back past a nil :posthog host in Elixir
Silthus Nov 5, 2026
bb711c5
fix(migrate-email): list the error names once and state reply-to per SDK
Silthus Nov 5, 2026
5398fd9
fix(migrate-email): give email its own client behind a reverse proxy
Silthus Nov 5, 2026
6924d48
test(migrate-email): pin keeping the secret key off the proxied client
Silthus Nov 5, 2026
2ebcce0
feat(migrate-email): bring Resend templates into the code
Silthus Nov 5, 2026
4ce6c2d
docs(migrate-email): record engagement events only when engagement ca…
Silthus Nov 9, 2026
0192a3d
fix(migrate-email): keep an app's PostHog key, and a Resend HTTP call…
Silthus Nov 12, 2026
d2e2848
Merge #451 at 0192a3d (keep an app's PostHog key, and an HTTP call's …
Silthus Nov 12, 2026
5c996de
fix(migrate-email): keep email off a disabled client, and pass numeri…
Silthus Nov 12, 2026
20036d6
Merge #451 at 5c996de (no email on a disabled client, numeric IDs as …
Silthus Nov 12, 2026
dddd616
fix(migrate-email): keep undeadlined HTTP sites on Resend and keep im…
Silthus Nov 12, 2026
8234d71
fix(migrate-email): record the send's own sender, replace markers in …
Silthus Nov 12, 2026
e9953c0
fix(migrate-email): map Go's other Resend error checks and keep Outlo…
Silthus Nov 12, 2026
ecd0366
fix(migrate-email): render variables in Go's Outlook blocks and scope…
Silthus Nov 12, 2026
7e5a468
fix(migrate-email): keep encoded URL values as they are in Go templates
Silthus Nov 12, 2026
e22fa6c
Merge branch 'main' into feat/migrate-email-resend
Silthus Nov 12, 2026
7afab6e
Merge branch 'feat/migrate-email-resend-cutover' into feat/migrate-em…
Silthus Nov 12, 2026
ae88e6e
Merge branch 'feat/migrate-email-resend' into feat/migrate-email-rese…
Silthus Nov 12, 2026
6b41f33
feat(migrate-email): move the shared step changes from the SendGrid l…
Silthus Nov 12, 2026
a366b71
fix(migrate-email): list Resend webhook handlers, keep ignored argume…
Silthus Nov 12, 2026
f279e43
fix(migrate-email): keep provider content inert in code literals, and…
Silthus Nov 12, 2026
487262b
fix(skills): close the migrate-email preparation gaps the QA swarm found
Silthus Nov 12, 2026
00b9aa3
fix(skills): tighten the migrate-email key check and template rules
Silthus Nov 12, 2026
bde5bb6
Merge branch 'feat/migrate-email-resend' into feat/migrate-email-rese…
Silthus Nov 12, 2026
708f7f1
fix(migrate-email): keep each site's own HTTP deadline
Silthus Nov 12, 2026
56158d1
fix(migrate-email): keep marketing sends on the provider
Silthus Nov 12, 2026
04e7c84
fix(migrate-email): read the provider's report notes without the impo…
Silthus Nov 12, 2026
7c388d1
Merge branch 'feat/migrate-email-resend' into feat/migrate-email-rese…
Silthus Nov 12, 2026
0186ee2
fix(migrate-email): answer the round 1 review of the rewrite and veri…
Silthus Nov 12, 2026
30f3873
fix(migrate-email): match baseline typecheck errors without their line
Silthus Nov 12, 2026
dc18f5d
fix(migrate-email): count each baseline typecheck error
Silthus Nov 12, 2026
c33bf45
Merge branch 'feat/migrate-email-resend-cutover' into feat/migrate-em…
Silthus Nov 12, 2026
a2994e9
fix(migrate-email): keep a named recipient on Resend
Silthus Nov 12, 2026
bde40bc
Merge remote-tracking branch 'origin/feat/migrate-email-resend' into …
Silthus Nov 12, 2026
e4221d8
Merge remote-tracking branch 'origin/feat/migrate-email-resend-cutove…
Silthus Nov 12, 2026
82d6ebf
fix(migrate-email): settle deadlines, attribute quoting, and suppress…
Silthus Nov 12, 2026
497d017
fix(migrate-email): keep a site on Resend when it needs a suppressed …
Silthus Nov 12, 2026
69edcdd
fix(migrate-email): keep a Resend SDK send with an abortable signal o…
Silthus Nov 12, 2026
22df812
Merge remote-tracking branch 'origin/feat/migrate-email-resend-cutove…
Silthus Nov 12, 2026
e36fd64
fix(migrate-email): own email clients, long deadlines, clicks and tem…
Silthus Nov 12, 2026
08c9d15
test(migrate-email): drop the tests that match the skill's own wording
Silthus Nov 12, 2026
bb14da9
fix(migrate-email): blank .NET host, long .NET deadlines, shared temp…
Silthus Nov 12, 2026
eeeb620
fix(migrate-email): keep a Go site whose template fills CSS from a value
Silthus Nov 12, 2026
64bb2a2
fix(migrate-email): count brought-in templates as code content, stop …
Silthus Nov 12, 2026
8ead8e1
fix(migrate-email): keep enable_local_evaluation off the Python async…
Silthus Nov 12, 2026
0158aef
fix(migrate-email): keep sites that branch on one kind of network fai…
Silthus Nov 12, 2026
f6978e7
fix(migrate-email): keep separate connect limits, require ext-curl fo…
Silthus Nov 12, 2026
ad23a92
fix(migrate-email): keep a Go request's transport limits
Silthus Nov 12, 2026
7ccc0ee
fix(migrate-email): keep a Python whole-request limit on the provider
Silthus Nov 12, 2026
eef1481
fix(migrate-email): settle untracked clicks, timeout kinds, and the m…
Silthus Nov 12, 2026
efb8451
fix(migrate-email): read Faraday's timeout by its adapter
Silthus Nov 12, 2026
f658354
fix(migrate-email): keep a site whose handler needs an event PostHog …
Silthus Nov 12, 2026
a66e15b
fix(migrate-email): upgrade mocked send tests to the HTTP boundary
Silthus Nov 12, 2026
18ab351
fix(migrate-email): fake fetch instead of keeping a send mock
Silthus Nov 12, 2026
ced460c
Merge commit '18ab3510a0b5cb457fab6a6b3d6079d8078bbc2d' into HEAD
Silthus Nov 12, 2026
e14c1fc
fix(migrate-email): keep a Ruby site with a partial Net::HTTP timeout
Silthus Nov 12, 2026
a943460
fix(migrate-email): note a must-be-sensitive template in its plan row
Silthus Nov 12, 2026
45c5716
fix(migrate-email): keep network failures off Resend's 503 branch
Silthus Nov 12, 2026
d51979c
fix(migrate-email): allow a loopback app host in Go and .NET tests
Silthus Nov 12, 2026
17c6ca1
feat(migrate-email): ask before adding an open pixel to untracked email
Silthus Nov 12, 2026
cff58f5
fix(migrate-email): route a network failure the way Resend's code did
Silthus Nov 12, 2026
96e10a2
Merge commit 'cff58f516b33b2fe5eb3c0a5d2704f874f7c3d85' into HEAD
Silthus Nov 12, 2026
6f7abcb
fix(migrate-email): test with a standard-library server, never a mock…
Silthus Nov 12, 2026
8776c81
fix(migrate-email): ask about a test dependency only where one is needed
Silthus Nov 12, 2026
63c3dfe
fix(migrate-email): ask before adding any test tool, in every language
Silthus Nov 12, 2026
21e1d27
feat(migrate-email): re-import the suppression list weekly while site…
Silthus Nov 12, 2026
a65bb90
fix(migrate-email): check the project before a suppression re-import
Silthus Nov 12, 2026
b28e13b
fix(migrate-email): write the re-import's project check out in Step 5
Silthus Nov 12, 2026
b2dfe53
fix(migrate-email): confirm the production project before a re-import
Silthus Nov 12, 2026
731b092
fix(migrate-email): read the project token with project-get
Silthus Nov 12, 2026
8929f93
fix(migrate-email): switch the MCP back after a re-import
Silthus Nov 12, 2026
e5735c8
fix(migrate-email): name the production project in a by-hand re-import
Silthus Nov 12, 2026
8b9757e
fix(migrate-email): let a re-import without the tool say so
Silthus Nov 12, 2026
349a407
fix(migrate-email): let a re-import say why it got no list
Silthus Nov 12, 2026
2df1f26
fix(migrate-email): read the project token with project-get
Silthus Nov 12, 2026
090ac92
Merge #451 (feat/migrate-email-resend-cutover) into feat/migrate-emai…
Silthus Nov 12, 2026
d8dd2d4
fix(migrate-email): ask for re-imports only when the provider keeps a…
Silthus Nov 12, 2026
94d44d3
fix(migrate-email): record a provider with no list before the tool check
Silthus Nov 13, 2026
2b8d0d6
fix(migrate-email): end a re-import early when the provider keeps no …
Silthus Nov 13, 2026
5e0607f
fix(migrate-email): keep sites a Resend webhook handler acts on, and …
Silthus Nov 13, 2026
eeed7cb
fix(migrate-email): check every error in a rewritten line against its…
Silthus Nov 13, 2026
5f5debd
fix(migrate-email): check for a provider without a suppression list b…
Silthus Nov 13, 2026
cb26a5f
Merge #451 (feat/migrate-email-resend-cutover) into feat/migrate-emai…
Silthus Nov 13, 2026
77b680b
fix(migrate-email): give Step 8 one rule for which typecheck errors a…
Silthus Nov 13, 2026
e7a7f3f
Merge #451 (feat/migrate-email-resend-cutover) into feat/migrate-emai…
Silthus Nov 13, 2026
1d85155
fix(migrate-email): tie the kept Resend error names to posthog-node, …
Silthus Nov 13, 2026
013a98e
Merge #450 (feat/migrate-email-resend) into feat/migrate-email-resend…
Silthus Nov 13, 2026
19b1b90
fix(migrate-email): mark secret emails sensitive, check template keys…
Silthus Nov 13, 2026
fdea2d3
fix(migrate-email): send sensitive only with rendered content, and on…
Silthus Nov 13, 2026
2fe8430
fix(migrate-email): check the app's Node version and count removed er…
Silthus Nov 13, 2026
6c45e23
Merge remote-tracking branch 'origin/feat/migrate-email-resend-cutove…
Silthus Nov 13, 2026
4087e6c
fix(migrate-email): carry the key, sensitive and Node checks; count r…
Silthus Nov 13, 2026
808f61d
fix(migrate-email): name each SDK's sensitive flag; list the moved keys
Silthus Nov 13, 2026
fd58f93
fix(migrate-email): move the template keys to after cutover; edge reason
Silthus Nov 13, 2026
f1ba031
fix(migrate-email): scope the runtime check to where each site runs
Silthus Nov 13, 2026
a0b01bc
fix(migrate-email): check every server that shares the SDK's manifest
Silthus Nov 13, 2026
8f51a57
fix(migrate-email): keep every site on a manifest an unsupported serv…
Silthus Nov 13, 2026
6b0083e
fix(migrate-email): count workspace and root lockfile installs in the…
Silthus Nov 13, 2026
ef71e1f
fix(migrate-email): keep a site whose HTTP client retries a request w…
Silthus Nov 13, 2026
6fdfdf7
fix(migrate-email): count only a retry setup that covers the POST
Silthus Nov 13, 2026
6d4801f
fix(migrate-email): name the retry setups as examples, not a full list
Silthus Nov 13, 2026
caff403
fix(migrate-email): read the retry setup's options before counting it
Silthus Nov 13, 2026
7aad014
fix(migrate-email): count a requests adapter whose max_retries is a n…
Silthus Nov 13, 2026
a090b5b
chore: merge main after #450 landed
Silthus Nov 13, 2026
66dc2b2
Merge branch 'feat/migrate-email-resend-cutover' into feat/migrate-em…
Silthus Nov 13, 2026
6d3d8b0
fix(migrate-email): keep a site that reads Resend's response headers
Silthus Nov 13, 2026
610e703
fix(migrate-email): name each SDK's retry delay in its rewrite file
Silthus Nov 13, 2026
d186900
fix(migrate-email): keep a send that turns Resend's plain-text part off
Silthus Nov 13, 2026
088f35b
fix(migrate-email): cover react and run-time empty text, word the tem…
Silthus Nov 13, 2026
3b204b7
fix(migrate-email): check the text-part rule in Step 3, count Go's em…
Silthus Nov 13, 2026
f3bb668
fix(migrate-email): ask whether a copied Resend template turns its pl…
Silthus Nov 13, 2026
355df95
fix(migrate-email): offer the full-access key for the plain-text ques…
Silthus Nov 13, 2026
74040e5
fix(migrate-email): note every template's plain text, offer the key o…
Silthus Nov 13, 2026
b99cea5
fix(migrate-email): sync suppression calls on the reasons PostHog stores
Silthus Nov 13, 2026
9eb4180
fix(migrate-email): report suppression-list calls instead of syncing …
Silthus Nov 13, 2026
1bcc53c
fix(migrate-email): say only hard bounces block a moved send
Silthus Nov 13, 2026
daf563e
fix(migrate-email): give the add item a check the app can make
Silthus Nov 13, 2026
d00e808
fix(migrate-email): ask in Step 3 which sites rely on a suppression add
Silthus Nov 13, 2026
2fe5090
fix(migrate-email): ask about hand-added suppressions too
Silthus Nov 13, 2026
b006c9b
fix(migrate-email): keep the sites when nobody can say who relies on …
Silthus Nov 13, 2026
cd9e38a
fix(migrate-email): ask about the suppression list before the templat…
Silthus Nov 13, 2026
4db6763
fix(migrate-email): list the suppression note in the plan file rules
Silthus Nov 13, 2026
0a6ae00
fix(migrate-email): keep Rust sites on runtimes other than Tokio
Silthus Nov 13, 2026
f98eb3b
fix(migrate-email): require Tokio's timers for the Rust async client
Silthus Nov 13, 2026
418cc5a
chore: merge main after #451 landed
Silthus Nov 13, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion context/skills/migrate-email/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
type: skill
template: description.md
category: migrate
description: Migrate transactional email from {display_name} to PostHog. Use when asked to migrate from {display_name}, replace {display_name} with PostHog, or switch email providers. It finds every {display_name} send in the code, sets up the sender and DNS next to {display_name}'s records, imports {display_name}'s suppression list, moves each send PostHog can take to posthog-node, and writes a migration report that lists the sends that stay.
description: Migrate transactional email from {display_name} to PostHog. Use when asked to migrate from {display_name}, replace {display_name} with PostHog, switch email providers, or re-import the {display_name} suppression list into PostHog after a migration. It finds every {display_name} send in the code, sets up the sender and DNS next to the records the app sends with now, imports the suppression list, moves each send PostHog can take to PostHog's SDK for its language (Node.js, Python, Go, Ruby, PHP, .NET, Rust, or Elixir), and writes a migration report that lists the sends that stay.
tags: [migration, workflows]
cli:
role: command
Expand Down
14 changes: 9 additions & 5 deletions context/skills/migrate-email/description.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Use this skill to move an app's transactional email, such as welcome emails, password resets, and receipts, from {display_name} to PostHog.

It finds every {display_name} send, sets up the PostHog sender and its DNS records next to {display_name}'s, imports {display_name}'s suppression list, and hands over the PostHog secret key. Then it moves every send PostHog can take to `posthog-node`, checks one email on one person, and writes a report. Sends PostHog can't take stay on {display_name} with a reason, so both providers send during the cutover.
It finds every {display_name} send, sets up the PostHog sender and its DNS records next to the records the app sends with now, imports the suppression list, and hands over the PostHog secret key. Then it moves every send PostHog can take to PostHog's SDK for its language (Node.js, Python, Go, Ruby, PHP, .NET, Rust, or Elixir), checks one email on one person, and writes a report. Sends PostHog can't take stay on {display_name} with a reason, so both providers send during the cutover.

The transactional email API is in beta. PostHog enables it per project.

Expand All @@ -12,23 +12,27 @@ The transactional email API is in beta. PostHog enables it per project.

Read the step files in order, one at a time. Each step names the next one. Do not read a step before the one before it tells you to.

When the person asks only to re-import the {display_name} suppression list into PostHog, after a migration, skip the workflow: read `5-suppressions.md` under "Re-import only" and do only that.

## Provider files

The folder `references/<provider>/` holds everything specific to {display_name}. The steps tell you when to read each file:

- `sdk-reference.md`: how {display_name} looks in code, so you can find every send.
- `mapping.md`: how each send field maps to PostHog, what keeps a call site on {display_name}, and how to rewrite a site that moves.
- `account.md`: {display_name}'s DNS records, and how to get its templates and its suppression list.
- `account.md`: the DNS records the app sends with now, and how to get the templates and the suppression list.

The rewrite files next to the step files, `rewrite-<language>.md`, have PostHog's email send in each language the sites can move in. Step 7 says which one to read. `template-to-code.md` says how a send of a template stored at {display_name} moves with its email in the app's code. Steps 3 and 7 say when to read it.

Everything you need is on disk. Do not fetch {display_name}'s docs.
Everything you need is on disk. Do not fetch the {display_name} docs. Never tell the person how PostHog behaves where these files don't say: say that you can't tell.

## Plan file

The plan file `.posthog-email-migration-plan.md` lives at the project root. Step 3 writes it, the later steps update it, and the last step writes the report from it and deletes it.

## Rules

- Change send code only in Step 7, and fix it only in Step 8: the sites that move, the helpers, callers, and tests they need, and other `posthog-node` code that the upgrade breaks. Leave every site that stays as it is.
- Change send code only in Step 7, and fix it only in Step 8: the sites that move, the helpers, callers, and tests they need, and other PostHog SDK code that the SDK's upgrade breaks. Leave every site that stays as it is.
- Never touch DNS or the {display_name} account. Give the person the records and the links, and let them make the change.
- Never remove the {display_name} package or its API key. The report tells the person when to remove them.
- Never create, upload, or edit a template in PostHog. The person makes each template that moves to PostHog.
Expand All @@ -54,4 +58,4 @@ Outside the Wizard, skip the `[STATUS]` lines, and tell the person why you stopp

`transactional-emails.md` is the transactional email overview. It covers how to create a transactional email and its API key, idempotency, and the error codes. `api.md` covers the send route, including content from your code, and the checks of a send.

When the `sending-transactional-emails` skill is available, read it for the PostHog side of a send. Its `moving-from-other-providers.md` moves sends to a template stored in PostHog. This skill moves {display_name}'s sends to `posthog-node`, with the content in the app's code, or to a template the person makes in PostHog. Where the two disagree, this skill's steps win.
When the `sending-transactional-emails` skill is available, read it for the PostHog side of a send. Its `moving-from-other-providers.md` moves sends to a template stored in PostHog. This skill moves the {display_name} sends to PostHog's SDKs with the content in the app's code, and brings a template stored at {display_name} into the code too. It moves a send to a template the person makes in PostHog only when they ask for one. Where the two disagree, this skill's steps win.
4 changes: 2 additions & 2 deletions context/skills/migrate-email/references/1-detect.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ Read the provider's `sdk-reference.md`. It lists the provider's packages, import

The provider is in this project when at least one of these is true:

- Its package is in a dependency manifest, such as `package.json`, `requirements.txt`, `pyproject.toml`, `Gemfile`, `composer.json`, or `go.mod`.
- Source code imports it or creates its client.
- Its package is in a dependency manifest, such as `package.json`, `requirements.txt`, `pyproject.toml`, `Gemfile`, `composer.json`, `go.mod`, a `.csproj` file, `mix.exs`, or `Cargo.toml`.
- Source code imports it or creates its client, including a module of the language's standard library that `sdk-reference.md` names.
- Source code calls its HTTP host.
- Source code, mail config, or an example env file names its SMTP host or its framework mailer.

Expand Down
Loading
Loading