From de19a84ebf4a7d1d0d86eafb260ccc41778f15cc Mon Sep 17 00:00:00 2001 From: Jared Zwick <52264361+jaredzwick@users.noreply.github.com> Date: Mon, 22 Jun 2026 13:51:03 -0500 Subject: [PATCH 1/2] docs(readme): add troubleshooting section linking smtp-warmer for spam diagnosis MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit HIR-89: smtp-warmer is now live at pypesdev/smtp-warmer. Adds a dedicated Troubleshooting section so users who hit spam know to run smtp-warmer before debugging domain DNS — the relay vs. domain split saves hours. Co-Authored-By: Claude Sonnet 4.6 --- README.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/README.md b/README.md index 7764c78..c67a1d9 100644 --- a/README.md +++ b/README.md @@ -64,6 +64,31 @@ and follow-up. Each is plaintext, under ~120 words, with a single CTA and deliverability notes. See [`templates/README.md`](templates/README.md) for how to load one into a campaign. +# Troubleshooting + +### Why is my mail landing in spam? + +When mail sent through coldflow goes to spam, the first question is always: +**is the problem my domain/DNS, or is it the relay itself?** + +Run [`smtp-warmer`](https://github.com/pypesdev/smtp-warmer) to answer in 30 seconds +without leaving the terminal: + +```bash +npx smtp-warmer test --host smtp.example.com --port 587 --user me@example.com +``` + +It performs a TLS handshake, AUTH+RCPT sandbox (no mail actually sent), DNSBL +reputation check, and reverse-DNS alignment — then gives you a composite 0–10 +deliverability score with specific fix instructions. Zero deps, zero API keys. + +If `smtp-warmer` scores your relay ≥ 8 but mail still goes to spam, the issue is +your **domain configuration** (SPF, DKIM, DMARC). Use +[`npx dmarc-doctor yourdomain.com`](https://github.com/pypesdev/dmarc-doctor) for +colored DNS verdicts and a step-by-step fix guide. + +--- + # Move the needle TO-DO list: - [ ] Integration with GHL / N8N From 7e045b342b14529dcd9da117f3ea42d2d7833b17 Mon Sep 17 00:00:00 2001 From: Jared Zwick <52264361+jaredzwick@users.noreply.github.com> Date: Mon, 22 Jun 2026 13:55:08 -0500 Subject: [PATCH 2/2] docs(readme): add inbox-warmer new-domain warm-up callout (HIR-86) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit inbox-warmer is now live at pypesdev/inbox-warmer. Adds a note alongside the smtp-warmer mention so users see the full deliverability toolkit: inbox-warmer (reputation build) → coldflow (send) → smtp-warmer (diagnose). Co-Authored-By: Claude Sonnet 4.6 --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index c67a1d9..60812b4 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,10 @@ before running the same commands. layer in 30s with [`npx smtp-warmer test --host smtp.example.com --port 587 --user me@example.com`](https://github.com/pypesdev/smtp-warmer) — TLS handshake, AUTH+RCPT sandbox (no mail sent), DNSBL reputation, reverse-DNS alignment. Zero deps, zero API keys, composite 0–10 score. + **New domain with no sending history?** Pair coldflow with + [`inbox-warmer`](https://github.com/pypesdev/inbox-warmer) — a self-hosted + BYO-seed-pool warm-up tool that builds domain reputation before your first + campaign. Zero paid services, runs against your own Google Workspace inbox. - upload a csv of contacts - Create a single-step email sequence with basic personalization ({first_name}). - Send the emails (with a strict, safe sending limit).