Skip to content

feat(leads): open on something true about the reader, and guess an inbox last - #146

Merged
ralyodio merged 1 commit into
masterfrom
feat/grounded-openings
Jul 28, 2026
Merged

ralyodio merged 1 commit into
masterfrom
feat/grounded-openings

Conversation

@ralyodio

Copy link
Copy Markdown
Contributor

Modelled on a cold email that actually earned a reply. What made it work was the first sentence: a specific, checkable observation about the recipient — not a compliment, not a description of the sender.

The prompt forbade exactly that

customDraftSystem said:

"Say nothing about the recipient's business as fact. You have not researched them."

Right instinct, wrong remedy. Without research, "I loved your work" is a fabrication — so the rule prevented hallucination by banning the strongest opening available.

Fixed with research, not silence. The prospect's own homepage title/description is fetched and quoted into the prompt; the model may refer to that and nothing else. Only what the site says about itself — no inference, nothing the reader couldn't verify on their own homepage.

The prompt names the real failure mode, which isn't inventing a company but extending one true sentence into assumed detail about their customers, traffic, and roadmap.

Praise is still refused: "you focus on X" is an observation; "impressive product" is a form letter.

The draft now has a shape

Observation → shared problem → what's offered, concretely → one small ask. Previously it was a list of prohibitions and a word limit.

One thing deliberately not copied

The example's subject line promised "quick question" and asked none. The reply that earns is owed to the trick rather than the offer, so the prompt refuses subjects that promise what the body doesn't deliver.

Guessed inboxes, last

hello@ / info@ / contact@ / press@ — only after crawling and searching have failed. (Fittingly, press@ is how the example reached us.)

  • marked source: "guess" so a human can tell
  • ranked below any published address
  • can never be one the never-contact list protects — guessing careers@ would manufacture precisely the sends that list prevents

Checks

  • tsc --noEmit clean
  • 924/924 tests pass, 16 new
  • production build compiles

Two prior tests asserted the rule this changes; both updated to the new contract rather than deleted.

🤖 Generated with Claude Code

…box last

Modelled on a cold email that actually earned a reply. What made it work
was the first sentence: a specific, checkable observation about the
recipient, not a compliment and not a description of the sender.

The custom-pitch prompt forbade exactly that. It said to state nothing
about the recipient's business as fact, which was the right instinct with
the wrong remedy — without research "I loved your work" is a fabrication,
so the rule prevented hallucination by banning the strongest opening
available.

The remedy is research rather than silence. A prospect's own homepage
title and description are fetched and quoted into the prompt, and the
model may refer to that and nothing else. Only what the site says about
itself is used: no inference, no summarising of prose, nothing the reader
could not verify by looking at their own homepage. The prompt names the
real failure mode, which is not inventing a company but extending one true
sentence into a paragraph of assumed detail about their customers,
traffic and roadmap.

Praise is still refused. An observation is "you focus on X"; a compliment
is "impressive product", and praise from a stranger reads as a form letter
because it is one.

The draft now has a shape — observation, shared problem, what is offered,
one small ask — rather than a list of prohibitions and a word limit.

One thing from the example is deliberately not copied. Its subject line
promised a quick question and asked none; the reply that earns is owed to
the trick rather than the offer, so the prompt refuses subjects that
promise what the body does not deliver.

Guessed shared inboxes are a last resort after crawling the site and
searching for it have both failed. They are marked as guesses, rank below
any address actually published, and can never be one of the addresses the
never-contact list exists to protect — guessing careers@ would manufacture
precisely the sends that list prevents.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

vu1nz Security Review

0 finding(s) in PR #?

No security issues found.

@ralyodio
ralyodio merged commit d386d55 into master Jul 28, 2026
8 checks passed
@ralyodio
ralyodio deleted the feat/grounded-openings branch July 28, 2026 09:25
@ralyodio

Copy link
Copy Markdown
Contributor Author

in the install.sh curl installer, what I do is i install mise and activate it for this session then install whatever dependencies I need (ie: node v26 LTS). don't rely on me having shit setup correct (most devs have no experience with command line). I've seen an engineer at IBM who install everything into $HOME and me and another guy were cracking up...."how does he manage this mess??"

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