Skip to content

Add email-deliverability (MX lookup) rule to review prompts - #55

Merged
bockets merged 1 commit into
mainfrom
email-deliverability-review-rule
Sep 10, 2026
Merged

Add email-deliverability (MX lookup) rule to review prompts#55
bockets merged 1 commit into
mainfrom
email-deliverability-review-rule

Conversation

@bockets

@bockets bockets commented Sep 10, 2026

Copy link
Copy Markdown
Member

Summary

Adds a new shared rule block, prompts/_shared/email-deliverability-rules.md, and wires it into all three review prompts (Codex first pass, Claude synthesize control, and Claude synthesize thesis-first) as the step immediately after the member-privacy rules.

The rule requires reviewers to flag, as a blocking finding, any code that lets an email address be added — form field, API endpoint, admin/console path, import, mailing list signup — without first doing an MX record lookup on the address's domain to confirm the address is deliverable.

The sole exception

The MX lookup is not required when the code is only logging that the email exists — e.g. stashing an address observed in a third-party payload for the record — and nothing in the change (or in code consuming what it stores) intends to send an actual message to that address.

Notes on scope

  • The rule explicitly does not require the mailbox to exist or send a test message — only the domain's MX records are queried.
  • It flags "lookups that never run": format-only regex checks, happy-path-only checks, flag-gated-off checks, and nil-safe rescues that accept the address anyway.
  • Prompt versions are derived from content by scripts/resolve-prompts.sh, so this change rolls all prompt versions automatically.

Reviewers must now flag any code that accepts an email address without
checking the domain's MX records first, so the address is deliverable.
Sole exception: logging-only collection where no message will be sent.
@bockets
bockets merged commit 59099d5 into main Sep 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant