diff --git a/AGENTS.md b/AGENTS.md
index f911033..dc12d36 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -5,6 +5,19 @@
 
 ---
 
+## Critical build callouts
+
+Read these two facts before you start a build phase. They already caused a
+confusing failure once.
+
+1. **Force IPv4 for every Gmail connection.** This applies to IMAP and SMTP.
+   See §9 and the infrastructure notes. The first IMAP attempt failed with a
+   socket EOF over IPv6 from `.13`.
+2. **The source address header is `X-Pm-Original-To`** (added by PurelyMail).
+   See FR-2 and §13.7. **Never use `Delivered-To`** — Gmail overwrites it.
+
+---
+
 ## 1. Purpose and outcome
 
 A web app that triages the family inbox. All mail lands in one Gmail account