@sellable/mcp 0.1.414 → 0.1.415
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index-dev.js +0 -0
- package/dist/index.js +0 -0
- package/package.json +1 -1
- package/skills/create-campaign-v2/references/ai-tells.md +6 -0
- package/skills/create-campaign-v2/references/gold-standard-message-examples.md +34 -7
- package/skills/create-campaign-v2/references/gold-standard-message-patterns.md +11 -1
- package/skills/create-campaign-v2/references/sellable-cleanup-rules.md +1 -1
- package/skills/create-evergreen-campaigns/SKILL.md +455 -34
- package/skills/generate-messages/SKILL.md +94 -33
package/dist/index-dev.js
CHANGED
|
File without changes
|
package/dist/index.js
CHANGED
|
File without changes
|
package/package.json
CHANGED
|
@@ -55,6 +55,12 @@ raise your hand for X (creepy to reach out based on that, i know) - but
|
|
|
55
55
|
this felt too on the nose to ignore"` shapes only when the source was an
|
|
56
56
|
explicit lead-magnet comment, reply, or opt-in.
|
|
57
57
|
|
|
58
|
+
Shared evergreen exception: for Shared Signal Discovery and other shared
|
|
59
|
+
evergreen lanes, the weak-signal permissioned bridge above is still a tell.
|
|
60
|
+
Reject `hope this is relevant`, `might be interested`, and `saw you in a few
|
|
61
|
+
conversations` as openers; require a concrete signal/problem bridge or omit the
|
|
62
|
+
source line.
|
|
63
|
+
|
|
58
64
|
**Severity:** REJECT
|
|
59
65
|
|
|
60
66
|
## Tell #3 — Explicit date or duration references about the recipient
|
|
@@ -203,6 +203,32 @@ Why it works:
|
|
|
203
203
|
**Proof ranks used:** rank 1 (mechanism - 1,000+ conditions from one blood
|
|
204
204
|
draw), rank 3 (risk before claims).
|
|
205
205
|
|
|
206
|
+
Do not use the Superpower weak-signal hedge pattern for Shared Evergreen Signal Discovery. Shared evergreen lanes are reused across multiple senders and must not open with `hope this is relevant`, `might be interested`, or `saw you in a few conversations`. Use the safe pattern below instead.
|
|
207
|
+
|
|
208
|
+
### Shared Evergreen Signal Discovery Safe Pattern
|
|
209
|
+
|
|
210
|
+
Use when the campaign is a shared evergreen signal lane and the source signal is
|
|
211
|
+
real but not sender-owned.
|
|
212
|
+
|
|
213
|
+
```text
|
|
214
|
+
Hey {{first_name}},
|
|
215
|
+
|
|
216
|
+
The AI-assisted GTM conversations keep coming back to one problem: turning good LinkedIn signal into review-ready pipeline without another outbound dashboard.
|
|
217
|
+
|
|
218
|
+
Sellable helps teams find signal-matched prospects, filter for fit, and generate reviewed LinkedIn copy from one workflow.
|
|
219
|
+
|
|
220
|
+
Curious if LinkedIn outbound is a channel you're trying to make more reliable this quarter?
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
Why it works:
|
|
224
|
+
|
|
225
|
+
- no low-confidence relevance hedge
|
|
226
|
+
- no `I'm building` or founder-only first person
|
|
227
|
+
- no internal workflow vocabulary such as Codex, MCP, agent workflows, workflow
|
|
228
|
+
table, lead source, or signal discovery
|
|
229
|
+
- the signal becomes a buyer problem instead of an activity-log opener
|
|
230
|
+
- safe for multiple senders attached to the same shared lane
|
|
231
|
+
|
|
206
232
|
## Conditional Examples
|
|
207
233
|
|
|
208
234
|
Use these only when the campaign motion matches.
|
|
@@ -419,24 +445,25 @@ Tokenized shape:
|
|
|
419
445
|
Hey there
|
|
420
446
|
|
|
421
447
|
Thanks for the support on my post about {{post_topic_line}}
|
|
422
|
-
|
|
423
|
-
Curious, is this something you're dealing with right now?
|
|
424
448
|
```
|
|
425
449
|
|
|
426
450
|
Transfer rules:
|
|
427
451
|
|
|
428
452
|
- Do not hardcode a post topic. Fill `{{post_topic_line}}` from the actual
|
|
429
453
|
selected sender-authored post or use a safer source-specific phrase.
|
|
454
|
+
- Do not add a relevance question, CTA, product line, or extra paragraph after
|
|
455
|
+
the thank-you line. The reply-rate lesson is the casual warm acknowledgment,
|
|
456
|
+
not a cold pitch appended to it.
|
|
430
457
|
- Do not use "showing some love"; it reads too casual for executive/VP/director
|
|
431
458
|
contacts.
|
|
432
459
|
- Keep the thank-you line. The point of this motion is acknowledging real
|
|
433
|
-
sender-owned support
|
|
434
|
-
it back to "saw you pop up" unless the sender specifically asks for
|
|
435
|
-
wording.
|
|
460
|
+
sender-owned support without appending a cold relevance question. Do not
|
|
461
|
+
flatten it back to "saw you pop up" unless the sender specifically asks for
|
|
462
|
+
that wording.
|
|
436
463
|
- Do not copy this shape into shared lanes, third-party thread sources, or cold
|
|
437
464
|
fallback campaigns.
|
|
438
|
-
-
|
|
439
|
-
|
|
465
|
+
- Do not pitch, ask for a meeting, or mention internal product vocabulary in
|
|
466
|
+
message one.
|
|
440
467
|
|
|
441
468
|
## Useful CTA Shapes
|
|
442
469
|
|
|
@@ -199,11 +199,21 @@ Shape:
|
|
|
199
199
|
Prefer:
|
|
200
200
|
|
|
201
201
|
- lowercase or casual casing when the motion supports it
|
|
202
|
-
- an honest line like "hope this is relevant" or "so may be off, but this seemed relevant"
|
|
202
|
+
- an honest line like "hope this is relevant" or "so may be off, but this seemed relevant" only for non-evergreen weak-signal campaigns
|
|
203
203
|
- a concrete CTA that names the useful conversation or asset
|
|
204
204
|
- binary options only when the brief explicitly supports two real next steps
|
|
205
205
|
- direct wording over polished marketing language
|
|
206
206
|
|
|
207
|
+
Shared Evergreen Signal Discovery override:
|
|
208
|
+
|
|
209
|
+
- Do not use `hope this is relevant`, `might be interested`, or `saw you in a
|
|
210
|
+
few conversations` as the opener.
|
|
211
|
+
- Do not use `I'm building`, `I've mapped`, `my company`, or `my team`.
|
|
212
|
+
- Turn the source topic into a buyer problem bridge, then write the product line
|
|
213
|
+
in team/company voice.
|
|
214
|
+
- If the source topic cannot support a concrete bridge, omit the source line and
|
|
215
|
+
start from a role/company/problem observation.
|
|
216
|
+
|
|
207
217
|
Avoid:
|
|
208
218
|
|
|
209
219
|
- copying a gimmick like "from a claude code terminal" unless the brief
|
|
@@ -74,7 +74,7 @@ Revise or reject the sample when any of these happen.
|
|
|
74
74
|
- **actions are implied, not stated** — e.g. "runs that chain as AI agents" when a clearer version would name the specific actions (verb + object, one per line)
|
|
75
75
|
- **category-level opener used when a per-lead signal exists** — if `lead-sample.json` carries any per-lead signal (post, hire, visible tool, topic engagement), the opener must reference it. Category-level openers of shape `"Most [category] teams still do X by hand"` are only acceptable when zero per-lead signal is in the sample. When a category-level opener is used as fallback, Findings must flag it explicitly
|
|
76
76
|
- **mind-reading from engagement signals** — a topic engagement, post, public activity, role, company, or hiring trigger does not prove buyer intent. Reject phrases like `"AI-GTM stack is clearly on your mind"`, `"you're clearly focused on..."`, `"obviously relevant"`, or `"already thinking about..."` unless that exact priority is explicitly present in `lead-sample.json`. Translate to low-certainty buyer context or omit the signal from copy.
|
|
77
|
-
- **source-y signal narration** — reject `"saw you on..."`, `"saw you engaging with..."`, `"you commented on..."`, `"your LinkedIn activity..."`, `"you might not remember the thread..."`, `"found you through [source] and your role looked close..."`, or any line that makes the recipient feel watched unless the chosen archived motion is intentionally self-aware about the signal. For sender-owned LinkedIn post sources, a light first-person acknowledgment is allowed when row data proves a reaction/comment: `"appreciate you showing some love on my post about [topic]"` or `"thanks for showing support on my [topic] post"`. Do not name a comment unless comment text is present. Follow the acknowledgment with a soft relevance bridge before broad pain/product copy, e.g. `"figured this might be relevant if LinkedIn is becoming more of a GTM channel for [company]"`. For third-party LinkedIn-post-sourced campaigns, a topic-level bridge is allowed when it explains why the note exists and stays apologetically uncertain: `"saw you in a few conversations about [topic], so may be off, but this seemed relevant."`, `"saw you in a few conversations around [topic], so hope this is relevant."`, or `"found you in a thread about [topic], so may be off, but this seemed relevant."` Reserve `"raise your hand"` language for explicit lead-magnet comments, replies, or opt-ins. Translate the signal into natural buyer context or omit it.
|
|
77
|
+
- **source-y signal narration** — reject `"saw you on..."`, `"saw you engaging with..."`, `"you commented on..."`, `"your LinkedIn activity..."`, `"you might not remember the thread..."`, `"found you through [source] and your role looked close..."`, or any line that makes the recipient feel watched unless the chosen archived motion is intentionally self-aware about the signal. For sender-owned LinkedIn post sources, a light first-person acknowledgment is allowed when row data proves a reaction/comment: `"appreciate you showing some love on my post about [topic]"` or `"thanks for showing support on my [topic] post"`. Do not name a comment unless comment text is present. Follow the acknowledgment with a soft relevance bridge before broad pain/product copy, e.g. `"figured this might be relevant if LinkedIn is becoming more of a GTM channel for [company]"`. For third-party LinkedIn-post-sourced campaigns, a topic-level bridge is allowed when it explains why the note exists and stays apologetically uncertain: `"saw you in a few conversations about [topic], so may be off, but this seemed relevant."`, `"saw you in a few conversations around [topic], so hope this is relevant."`, or `"found you in a thread about [topic], so may be off, but this seemed relevant."` Shared evergreen signal exception: these hedges are blocked for Shared Signal Discovery and other shared evergreen lanes; use a concrete signal/problem bridge or omit the source line. Reserve `"raise your hand"` language for explicit lead-magnet comments, replies, or opt-ins. Translate the signal into natural buyer context or omit it.
|
|
78
78
|
- **sender-owned source rendered as third-party** — hard fail when the source post is sender-owned and the draft says `"found you in a thread"`, `"saw you in a thread"`, `"saw you in conversations"`, or `"saw you in a few conversations"` as if the post were third-party. For sender-owned sources, the copy must either use a light first-person acknowledgment plus a soft relevance bridge, or omit the source line. If multiple senders may send the campaign, or the final sender/source-owner match is ambiguous, do not assume a specific `my post` voice or name a specific sender; omit the sender-owned source line until row-level sender ownership is proven. Neutral low-certainty thread/source language is only for truly third-party sources.
|
|
79
79
|
- **fake line-to-line continuity** — reject line stacks where the source acknowledgment, relevance bridge, product line, and CTA do not actually build on each other. Each line must make the next line feel earned. If two adjacent lines could be swapped, deleted, or joined with `"anyway"` without changing the meaning, the transition is fake. In sender-owned post campaigns, the chain should be: support on my post -> why this topic may matter for the company -> what the product/problem does about that same topic -> low-friction next step.
|
|
80
80
|
- **assumptive title-fit opener** — reject `"Your [role] role at [company] looked close to this problem"` or `"looked close to this outbound campaign problem"`. This asserts fit from title/company. Keep the apologetic uncertainty instead: `"may be off, but if [workflow] is relevant to what you're working on..."`.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: create-evergreen-campaigns
|
|
3
3
|
description: Reconcile a sender team's evergreen campaigns — create-or-reuse the standing campaigns (per-sender post engagers + shared signal/cold lanes) idempotently, and when asked for customer-ready/full setup, complete each customer-visible campaign to paused send review with brief, rows, generated review messages, one approval gate row, and sequence. Never duplicates, never launches.
|
|
4
|
-
visibility:
|
|
4
|
+
visibility: public
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Create Evergreen Campaigns
|
|
@@ -14,6 +14,40 @@ producing duplicates. This skill never launches campaigns; customer-visible
|
|
|
14
14
|
completion stops at paused send review.
|
|
15
15
|
</role>
|
|
16
16
|
|
|
17
|
+
## Operational Fast Path
|
|
18
|
+
|
|
19
|
+
In automation or `--yolo` customer-visible setup, use this path before the
|
|
20
|
+
long-form contract below:
|
|
21
|
+
|
|
22
|
+
1. Resolve the active workspace and explicit sender scopes, then call
|
|
23
|
+
`setup_evergreen_campaigns({ mode:"plan", yolo:true, postEngagerSenderIds,
|
|
24
|
+
sharedSenderIds })`. If the user did not name senders but
|
|
25
|
+
`get_campaign_waterfall` returns an active managed evergreen/prod waterfall
|
|
26
|
+
for the workspace, derive exact sender scopes from the waterfall `senderRefs`
|
|
27
|
+
and canonical Post Engagers/shared slots before the first setup plan. Match
|
|
28
|
+
`senderRefs` to `list_senders` by LinkedIn public identifier, display name,
|
|
29
|
+
or obvious handle/name alias; record the mapping in the plan notes. Do not
|
|
30
|
+
call setup with empty sender arrays when product-visible waterfall evidence
|
|
31
|
+
identifies the evergreen sender scope.
|
|
32
|
+
2. If the plan is not current, lacks lane packets, or has
|
|
33
|
+
`autoExecutable:false`, return the exact blocker before mutation.
|
|
34
|
+
3. Choose the worker runtime immediately. When running under Codex CLI or on VPS,
|
|
35
|
+
the local Codex CLI fallback is the default accepted runtime. Use visible
|
|
36
|
+
Codex app threads only when the callable thread tools are actually available.
|
|
37
|
+
If shell execution is unavailable and no visible/durable thread surface is
|
|
38
|
+
callable, return `blocked: missing_visible_or_durable_lane_worker_runtime`
|
|
39
|
+
before mutation.
|
|
40
|
+
4. Write one compact prompt file per selected lane packet, create the receipt
|
|
41
|
+
directory, and launch all lane workers in parallel with the literal Codex CLI
|
|
42
|
+
worker command shape below. The parent does not create campaign shells.
|
|
43
|
+
5. Collect fresh durable receipts, verify with the original planRevision and
|
|
44
|
+
selectedActionIds, then run the idempotency plan and show sample messages.
|
|
45
|
+
|
|
46
|
+
Do not keep reasoning, re-reading prompts, or restating this workflow instead of
|
|
47
|
+
dispatching workers. If the first worker cannot be launched after at most one
|
|
48
|
+
short planning pass, return `blocked: worker_dispatch_deadline_exceeded` before
|
|
49
|
+
directory setup or product mutation.
|
|
50
|
+
|
|
17
51
|
<inputs>
|
|
18
52
|
The invoking prompt names the senders ("create evergreen campaigns for csreyes92 and thomas"). Resolve each via `list_senders`.
|
|
19
53
|
|
|
@@ -58,6 +92,32 @@ Default evergreen plan per workspace (override only if the prompt specifies diff
|
|
|
58
92
|
1. **`<Sender Name> - Post Engagers`** — one per sender (warm lane, highest priority)
|
|
59
93
|
2. **`<Workspace/Team> - Shared Signal Discovery`** — one shared warm-signal campaign lane across senders
|
|
60
94
|
3. **`<Workspace/Team> - Shared Cold Fallback`** — one shared cold/fallback campaign lane across senders
|
|
95
|
+
|
|
96
|
+
Sender scope resolution is safety-critical. Do not pass
|
|
97
|
+
`allConnectedSenders:true` unless the invoking prompt explicitly says "all
|
|
98
|
+
connected senders", "every connected sender", "all seats", or names an
|
|
99
|
+
equivalent all-sender scope. If the user says "all 4 campaigns", "the four
|
|
100
|
+
evergreen campaigns", or names specific senders, resolve those exact senders
|
|
101
|
+
and pass explicit `postEngagerSenderIds` plus `sharedSenderIds`; do not broaden
|
|
102
|
+
the plan to every connected sender. If the prompt does not name senders but the
|
|
103
|
+
active workspace has a product-visible managed evergreen/prod waterfall, derive
|
|
104
|
+
the exact scope from that waterfall instead of using all connected senders:
|
|
105
|
+
Post Engagers sender scope is the senderRefs that own person-specific
|
|
106
|
+
Post Engagers slots; shared sender scope is the union of senderRefs on the
|
|
107
|
+
shared Signal Discovery and Shared Cold Fallback waterfall slots. If the
|
|
108
|
+
waterfall has one clear production evergreen program for the workspace, this is
|
|
109
|
+
not ambiguous even when `list_senders` returns additional connected senders.
|
|
110
|
+
In non-interactive or `--yolo` mode, when more than two connected senders exist
|
|
111
|
+
and neither the prompt nor product-visible waterfall evidence identifies exact
|
|
112
|
+
evergreen sender scope, stop before mutation with
|
|
113
|
+
`blocked: ambiguous_post_engager_sender_scope` and report the sender ids/names
|
|
114
|
+
needed for approval. Never let "workspace default" silently create Post
|
|
115
|
+
Engagers lanes for extra senders.
|
|
116
|
+
Short form: Do not pass `allConnectedSenders:true` unless the prompt explicitly says all/every connected sender.
|
|
117
|
+
Short form: "all 4 campaigns" means explicit sender scope plus two shared lanes, not all connected senders.
|
|
118
|
+
Short form: Product-visible managed evergreen/prod waterfall senderRefs are exact sender scope.
|
|
119
|
+
Short form: Do not report `no_senders` while waterfall senderRefs can be mapped to list_senders.
|
|
120
|
+
Short form: In `--yolo`, ambiguous multi-sender scope blocks before mutation.
|
|
61
121
|
</inputs>
|
|
62
122
|
|
|
63
123
|
<command_backed_workflow>
|
|
@@ -71,6 +131,13 @@ error, or does not return a current `planRevision` with lane packets, stop
|
|
|
71
131
|
immediately with `blocked: setup_evergreen_campaigns_unavailable`. Do not fall
|
|
72
132
|
back to ad hoc create-campaign calls, inventory-only guesses, or direct shell
|
|
73
133
|
creation when the command-backed plan is missing.
|
|
134
|
+
Exception: if an initial unscoped plan returns only `blocked:no_senders`, and
|
|
135
|
+
the parent has already read `list_senders` plus a product-visible managed
|
|
136
|
+
evergreen/prod waterfall with mappable `senderRefs`, immediately re-run the
|
|
137
|
+
plan once with explicit derived `postEngagerSenderIds` and `sharedSenderIds`.
|
|
138
|
+
Do not report `no_senders` to the user until that scoped plan has also failed.
|
|
139
|
+
If senderRef mapping is partial, stop with
|
|
140
|
+
`blocked: ambiguous_post_engager_sender_scope` and include the unmapped refs.
|
|
74
141
|
|
|
75
142
|
MCP/product-visible proof only: every success claim must be observable through
|
|
76
143
|
the installed Sellable MCP tools and product-visible readbacks a normal user or
|
|
@@ -215,7 +282,8 @@ After bounded delegated approval or safe `--yolo`, fan out lane worker tasks
|
|
|
215
282
|
only from the current plan. Each worker receives the complete lane packet:
|
|
216
283
|
workspace id, sender ids, lane key/type, existing campaign/table binding or
|
|
217
284
|
create intent, source hints, caps, planRevision, actionId, allowed side effects,
|
|
218
|
-
postconditions,
|
|
285
|
+
postconditions, the parent `postEngagerSenderIds`, the parent
|
|
286
|
+
`sharedSenderIds`, and the packet's `workerDispatch` policy. Treat
|
|
219
287
|
`workerDispatch.requiresVisibleThreadOrDurableReceipt:true` as a hard
|
|
220
288
|
execution boundary, not guidance. Read and preserve `workerDispatch.acceptedRuntimes`,
|
|
221
289
|
`workerDispatch.rejectedRuntimes`, and `workerDispatch.receiptArtifactHint`
|
|
@@ -234,6 +302,15 @@ parent packet, do not mutate and do not use it as `setupPlanCall` proof; stop
|
|
|
234
302
|
with `blocked: worker_plan_scope_drift` and ask the parent to re-plan.
|
|
235
303
|
Short form: If a worker-local plan omits `postEngagerSenderIds:[]`, do not use it as `setupPlanCall` proof.
|
|
236
304
|
Short form: stop with `blocked: worker_plan_scope_drift`.
|
|
305
|
+
Every worker prompt must include both parent scope arrays as explicit fields:
|
|
306
|
+
`Parent postEngagerSenderIds:` and `Parent sharedSenderIds:`. Workers must
|
|
307
|
+
preserve parent postEngagerSenderIds even for shared lanes. Never run a
|
|
308
|
+
shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent
|
|
309
|
+
`postEngagerSenderIds` is exactly `[]`. Every durable receipt must copy these
|
|
310
|
+
arrays to top-level `parentPostEngagerSenderIds` and `parentSharedSenderIds`
|
|
311
|
+
before completion.
|
|
312
|
+
Short form: Workers must preserve parent postEngagerSenderIds even for shared lanes.
|
|
313
|
+
Short form: Never run a shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent `postEngagerSenderIds` is exactly `[]`.
|
|
237
314
|
|
|
238
315
|
Worker fan-out must use visible or durable execution. Preferred in local Codex
|
|
239
316
|
is a visible Codex thread created with the actual Codex app thread tools:
|
|
@@ -257,35 +334,128 @@ acceptable only when it writes a fresh durable per-lane receipt artifact as it
|
|
|
257
334
|
works.
|
|
258
335
|
When visible Codex app thread tools are unavailable but local Codex CLI is
|
|
259
336
|
available, the accepted durable streaming-worker command shape is:
|
|
260
|
-
`codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> -`.
|
|
337
|
+
`codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> -`.
|
|
261
338
|
The approval and sandbox flags must come before the `exec` subcommand for Codex
|
|
262
|
-
CLI builds that expose `-a`/`-s` only at top level.
|
|
339
|
+
CLI builds that expose `-a`/`-s` only at top level. `--skip-git-repo-check` belongs after `exec` because current customer and VPS Codex CLI builds expose it
|
|
340
|
+
as an `exec` subcommand flag, not a top-level flag. Do not use
|
|
263
341
|
`codex exec --ask-for-approval never ...` or `codex exec -a never ...`; those
|
|
264
342
|
forms fail on current customer CLI installs. Pipe the lane packet prompt on
|
|
265
343
|
stdin, require the worker to write `workerDispatch.receiptArtifactHint`, and
|
|
266
344
|
pass exactly one lane packet per worker.
|
|
345
|
+
When launching durable Codex CLI workers from an automation parent, pass an
|
|
346
|
+
explicit supported worker model instead of relying on the Codex CLI default
|
|
347
|
+
model. Use the parent runtime model when known, for example:
|
|
348
|
+
`codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> -`.
|
|
349
|
+
Do not rely on the Codex CLI default model; some customer and VPS installs
|
|
350
|
+
default to unavailable model aliases. If the parent cannot identify a supported
|
|
351
|
+
worker model and a test `codex exec -m <worker-model>` launch is rejected, stop
|
|
352
|
+
with `blocked: worker_model_unavailable` before mutation.
|
|
353
|
+
When wrapping multiple local Codex CLI workers in a shell launcher, run the
|
|
354
|
+
wrapper with `/bin/bash -lc` or another explicitly chosen portable shell. Do not
|
|
355
|
+
rely on zsh-specific behavior. Do not use `status` as a shell variable because
|
|
356
|
+
zsh treats it as read-only; use `exit_code` or `rc` instead. Receipt polling
|
|
357
|
+
must use `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print` or an
|
|
358
|
+
explicit nullglob-safe equivalent. Do not use naked `*.json` globs under zsh,
|
|
359
|
+
and keep zero-receipt polls quiet with no `no matches found` diagnostics.
|
|
360
|
+
Do not embed `<<'WORKER_PROMPT'` heredocs inside a single quoted or double
|
|
361
|
+
quoted `/bin/bash -lc '...'` command string; nested quoting is brittle and can
|
|
362
|
+
truncate the first worker before mutation. For multi-worker launchers, write one
|
|
363
|
+
plain prompt file per lane under the current run directory, then start each
|
|
364
|
+
worker with `codex -a never -s danger-full-access exec --skip-git-repo-check -m "$WORKER_MODEL" -C "$REPO" -o
|
|
365
|
+
"$worker_final_file" - < "$worker_prompt_file"`. Keep launcher shell variables
|
|
366
|
+
double-quoted and keep the prompt heredoc only in a standalone script/prompt-file
|
|
367
|
+
write step, not inside an already quoted shell argument. If the first launcher
|
|
368
|
+
attempt exits with a shell parse error or before starting the first worker,
|
|
369
|
+
stop with `blocked: worker_launcher_quoting_failed` and do not retry by
|
|
370
|
+
loosening sender scope or mutating in the parent.
|
|
371
|
+
Do not use `nohup`, detached background workers, or any launcher that returns
|
|
372
|
+
before the workers finish and before receipts/final files exist. A durable
|
|
373
|
+
worker must run in a foreground command session, visible Codex thread, or a shell
|
|
374
|
+
that stays alive until every worker has finished. If using background jobs inside
|
|
375
|
+
one shell, the same shell must stay alive, wait for every worker PID, poll only
|
|
376
|
+
the expected receipt paths, and record a per-worker exit code plus final-file
|
|
377
|
+
paths and stderr/log paths before returning. If workers exit with empty logs and
|
|
378
|
+
no final files because the subprocess detached or was reaped, stop with
|
|
379
|
+
`blocked: worker_subprocess_detached_without_output` before parent verify.
|
|
380
|
+
When launching multiple local Codex CLI workers from one shell, start each
|
|
381
|
+
background job in the same shell that will call `wait`. Do not capture worker
|
|
382
|
+
PIDs through command substitution, a subshell, a pipeline, or a helper function
|
|
383
|
+
invoked as `worker_pid=$(launch_worker ...)`; those patterns make the captured
|
|
384
|
+
PID non-waitable by the parent shell. Use the same-shell PID array pattern:
|
|
385
|
+
`pids=(); codex ... > "$log_file" 2>&1 & pids+=("$!")`, then
|
|
386
|
+
`for pid in "${pids[@]}"; do wait "$pid" || rc=1; done`. If `wait` reports
|
|
387
|
+
`pid is not a child of this shell`, stop with
|
|
388
|
+
`blocked: worker_subprocess_detached_without_output`.
|
|
389
|
+
Short form: run the wrapper with `/bin/bash -lc`.
|
|
390
|
+
Short form: Do not rely on zsh-specific behavior.
|
|
391
|
+
Short form: Do not use `status` as a shell variable; use `exit_code` or `rc`.
|
|
392
|
+
Short form: Do not capture worker PIDs through command substitution or a subshell.
|
|
393
|
+
Short form: Use same-shell `pids+=("$!")` before waiting on every PID.
|
|
394
|
+
Short form: Receipt polling uses `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print`.
|
|
395
|
+
Short form: Do not use naked `*.json` globs under zsh; no `no matches found` diagnostics.
|
|
396
|
+
Short form: Do not embed `<<'WORKER_PROMPT'` heredocs inside a quoted `/bin/bash -lc` command string.
|
|
397
|
+
Short form: Multi-worker launchers write prompt files and run `codex ... - < "$worker_prompt_file"`.
|
|
398
|
+
Short form: Do not use `nohup`; keep the worker process attached until receipt or blocker.
|
|
399
|
+
After the auto-executable plan returns, take at most one short planning pass to
|
|
400
|
+
choose the visible/durable worker runtime and build the worker launch packet.
|
|
401
|
+
Do not keep reasoning, re-reading prompts, or restating the workflow instead of
|
|
402
|
+
dispatching. If the parent cannot name the callable worker runtime and prepare
|
|
403
|
+
the first worker launch command/tool call immediately after that pass, stop with
|
|
404
|
+
`blocked: worker_dispatch_deadline_exceeded` before directory setup or mutation.
|
|
267
405
|
After creating receipt directories, dispatch workers immediately; do not perform extended parent reasoning, extra inventory, or prompt rewriting loops.
|
|
406
|
+
Before any campaign shell creation, the parent must dispatch every selected lane
|
|
407
|
+
worker from the current plan and record the visible thread id or
|
|
408
|
+
`receiptArtifactPath` for each selected actionId. The parent must not call
|
|
409
|
+
`create_campaign`, `import_leads`, `confirm_lead_list`, sequence tools, message
|
|
410
|
+
preparation tools, or `setup_evergreen_campaigns` with `mode:"apply"` or any
|
|
411
|
+
other mutating setup mode. In this wrapper, `setup_evergreen_campaigns` is
|
|
412
|
+
plan/verify authority only; customer-visible creation belongs inside lane
|
|
413
|
+
workers through `$sellable:create-campaign`. If a campaign/table id appears for
|
|
414
|
+
a create lane before that lane has a recorded worker runtime and fresh receipt
|
|
415
|
+
path/thread id, stop with `blocked: parent_mutated_before_worker_receipt` and
|
|
416
|
+
do not continue setup in the parent.
|
|
417
|
+
Short form: dispatch every selected lane worker before shell creation.
|
|
418
|
+
Short form: do not call `setup_evergreen_campaigns` with `mode:"apply"` from the parent.
|
|
268
419
|
Use a compact worker prompt: include lane packet JSON, original selectedActionIds,
|
|
269
|
-
original planRevision,
|
|
270
|
-
side-effect caps, and the
|
|
420
|
+
original planRevision, parent postEngagerSenderIds, parent sharedSenderIds,
|
|
421
|
+
receiptArtifactPath, workspace id, sender ids, side-effect caps, and the
|
|
422
|
+
instruction to load packaged prompts through MCP.
|
|
423
|
+
The worker prompt must include the exact filter status rule:
|
|
424
|
+
`filterDecisionReceipt.status:"applied"` only; never `completed`, `confirmed`,
|
|
425
|
+
`done`, or any other alias.
|
|
426
|
+
The worker prompt must include the generated-message write rule: `update_cell`
|
|
427
|
+
is allowed only for the semantic Approved checkbox, never for generated message
|
|
428
|
+
text/body/sample copy. Bad copy requires `revise_message_template_and_rerun` or
|
|
429
|
+
brief/template revision plus Generate Message rerun; any generated-message cell
|
|
430
|
+
override is `blocked: generated_message_cell_override`.
|
|
271
431
|
Do not paste the entire wrapper skill into worker prompts. If the parent cannot
|
|
272
432
|
launch at least one visible/durable worker immediately after directory setup,
|
|
273
433
|
stop with `blocked: worker_dispatch_stalled` before any mutation.
|
|
434
|
+
After launching workers, poll only the expected current-run receipt paths from
|
|
435
|
+
`workerDispatch.receiptArtifactHint`. If no worker receipt file appears within a
|
|
436
|
+
bounded wait, for example 10 minutes in automation, stop with
|
|
437
|
+
`blocked: worker_receipt_timeout`, include the worker ids/final-file paths/stderr
|
|
438
|
+
if available, and do not create or repair campaign shells in the parent.
|
|
274
439
|
Use only the repo-local `workerDispatch.receiptArtifactHint` returned by the
|
|
275
440
|
current lane packet for receipt paths.
|
|
276
441
|
Do not hardcode machine-specific paths, workspace ids, campaign ids, sender ids, or UAT/phase artifact paths in this MCP prompt or any worker prompt.
|
|
277
442
|
After the receipt-directory `mkdir`, the next shell/tool call must launch the first lane worker.
|
|
278
443
|
Do not run `find`, `ls`, extra inventory, or another preflight between directory setup and the first worker launch.
|
|
279
|
-
For the local Codex CLI fallback, use this literal durable CLI worker launch
|
|
280
|
-
and fill only the lane-specific placeholders
|
|
444
|
+
For the local Codex CLI fallback, use this literal durable CLI worker launch
|
|
445
|
+
template and fill only the lane-specific placeholders. For one-off direct worker
|
|
446
|
+
launches you may pipe a heredoc directly to `codex`; for multi-worker shell
|
|
447
|
+
launchers, write the same prompt body to `<worker-prompt-file>` and launch the
|
|
448
|
+
worker with stdin redirected from that file:
|
|
281
449
|
|
|
282
450
|
```
|
|
283
|
-
codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
|
|
451
|
+
codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
|
|
284
452
|
Use $sellable:create-evergreen-campaigns as the governing skill for this one lane worker.
|
|
285
453
|
|
|
286
454
|
Workspace id: <workspaceId>
|
|
287
455
|
Parent planRevision: <planRevision>
|
|
288
456
|
Parent selectedActionIds: <selectedActionIds JSON>
|
|
457
|
+
Parent postEngagerSenderIds: <postEngagerSenderIds JSON>
|
|
458
|
+
Parent sharedSenderIds: <sharedSenderIds JSON>
|
|
289
459
|
Action id: <actionId>
|
|
290
460
|
Lane key: <laneKey>
|
|
291
461
|
Allowed side effects: <allowedSideEffects JSON>
|
|
@@ -297,8 +467,13 @@ Worker lane packet JSON:
|
|
|
297
467
|
Load `$sellable:create-campaign` and nested prompts/assets through Sellable MCP loaders.
|
|
298
468
|
Use mcp__sellable only. Do not use admin tools, direct DB, Prisma, SQL, web search, or browser search.
|
|
299
469
|
Do not launch, start, schedule, send, or use paid InMail.
|
|
470
|
+
For filter proof, durable receipt status must be `filterDecisionReceipt.status:"applied"` only; never `completed`, `confirmed`, `done`, or aliases.
|
|
471
|
+
For generated messages, `update_cell` is allowed only for the semantic Approved checkbox. Never use `update_cell` for generated message text/body/sample copy. Bad copy requires `revise_message_template_and_rerun` or brief/template revision plus Generate Message rerun. Any generated-message cell override is `blocked: generated_message_cell_override`.
|
|
300
472
|
Complete only this lane, write the required durable receipt JSON, and stop.
|
|
301
473
|
WORKER_PROMPT
|
|
474
|
+
|
|
475
|
+
# Multi-worker launcher equivalent:
|
|
476
|
+
codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> - < <worker-prompt-file>
|
|
302
477
|
```
|
|
303
478
|
|
|
304
479
|
If any placeholder cannot be filled from the current lane packet, do not inspect
|
|
@@ -368,7 +543,14 @@ not a parent-thread summary. The receipt must include:
|
|
|
368
543
|
`senderIds`, `campaignId`, `tableId`, and `createIntent`. Do not use
|
|
369
544
|
`laneActionId`, `lanePacketActionId`, `delegatedPlanRevision`,
|
|
370
545
|
`delegatedActionId`, or freeform `requestedCall` text as a substitute for
|
|
371
|
-
these fields.
|
|
546
|
+
these fields. For create lanes, `setupPlanCall.campaignId` and
|
|
547
|
+
`setupPlanCall.tableId` must be the actual created campaign/table ids after
|
|
548
|
+
creation and readback. If the parent lane packet carried null ids before
|
|
549
|
+
creation, preserve that original packet only in a separate `parentLanePacket`
|
|
550
|
+
object; do not leave `setupPlanCall.campaignId:null` or
|
|
551
|
+
`setupPlanCall.tableId:null`.
|
|
552
|
+
Short form: For create lanes, `setupPlanCall.campaignId` and `setupPlanCall.tableId` must be the actual created campaign/table ids.
|
|
553
|
+
Short form: Do not leave `setupPlanCall.campaignId:null` or `setupPlanCall.tableId:null`.
|
|
372
554
|
- `createCampaignWorkflowReceipt`: proof the worker loaded the actual installed
|
|
373
555
|
`$sellable:create-campaign` wrapper instead of doing ad hoc MCP calls. It must
|
|
374
556
|
include `skillCommand:"$sellable:create-campaign"`,
|
|
@@ -423,8 +605,26 @@ not a parent-thread summary. The receipt must include:
|
|
|
423
605
|
evidence field such as `rowCount`, `rowIdsHash`, or `rowEvidence`; do not
|
|
424
606
|
leave those only in `searchSignalsProof`, `importProof`, `coldFallbackProof`,
|
|
425
607
|
or narrative text for the parent/verifier to infer.
|
|
426
|
-
- `filterDecisionReceipt`: saved/applied filter
|
|
427
|
-
|
|
608
|
+
- `filterDecisionReceipt`: saved/applied ICP filter proof for the current
|
|
609
|
+
campaign/table basis. Customer-visible evergreen lanes must enable ICP
|
|
610
|
+
filtering with `enableICPFilters:true`, call `save_rubrics`, and save at
|
|
611
|
+
least three rubric/filter criteria before Message Drafting. Do not skip
|
|
612
|
+
filtering for evergreen setup. Missing or skipped filter proof is
|
|
613
|
+
`blocked: missing_filter_setup`.
|
|
614
|
+
Before the worker exits, the durable JSON must contain
|
|
615
|
+
`filterDecisionReceipt.status:"applied"`,
|
|
616
|
+
`filterDecisionReceipt.enableICPFilters:true`, the current
|
|
617
|
+
`workflowTableId`, and concrete saved-filter proof such as
|
|
618
|
+
`filterDecisionReceipt.filterIds`, `filterDecisionReceipt.rubricIds`,
|
|
619
|
+
`filterDecisionReceipt.savedRubricCount`, or
|
|
620
|
+
`filterDecisionReceipt.headlineICPCriteria`.
|
|
621
|
+
The exact status string is contractual: use `status:"applied"` only.
|
|
622
|
+
Do not write `status:"completed"`, `status:"confirmed"`, `status:"saved"`,
|
|
623
|
+
`status:"done"`, or any other alias after saving filters; the parent verifier
|
|
624
|
+
rejects those aliases even when saved rubric proof exists.
|
|
625
|
+
Short form: Filter receipt status must be exactly `applied`.
|
|
626
|
+
Short form: Do not write `filterDecisionReceipt.status:"completed"`.
|
|
627
|
+
Short form: Do not write `filterDecisionReceipt.status:"confirmed"`.
|
|
428
628
|
- `messageDraftingReceipt`: the Message Drafting proof described below,
|
|
429
629
|
including packaged `generate-messages` prompt/assets and validation. Raw
|
|
430
630
|
fields like `generateMessagesPromptLoadedToHasMoreFalse`,
|
|
@@ -460,7 +660,10 @@ not a parent-thread summary. The receipt must include:
|
|
|
460
660
|
Before writing the durable receipt, run a receipt self-check. The top-level
|
|
461
661
|
receipt must include top-level `planRevision`, `actionId`, `laneKey`,
|
|
462
662
|
`laneType`, `workspaceId`, and `senderIds`, plus campaign/table/source ids and
|
|
463
|
-
row/message/approval counts.
|
|
663
|
+
row/message/approval counts. It must also include top-level `receiptArtifactPath`,
|
|
664
|
+
top-level `durableReceiptWritten:true`, top-level `receiptRunId`, and top-level
|
|
665
|
+
`receiptWrittenAt`; do not leave `receiptArtifactPath` only under
|
|
666
|
+
`createCampaignWorkflowReceipt` for the parent to patch during verify. Inside
|
|
464
667
|
`createCampaignStepReceipt.messageDraftingReceipt`, `sampleMessages[]` must
|
|
465
668
|
include `rowId`, `generatedMessageText`, `verdict`, and `issues`. Do not
|
|
466
669
|
substitute `message` for `generatedMessageText`. Do not substitute
|
|
@@ -472,6 +675,8 @@ before writing JSON; do not leave only raw objects like
|
|
|
472
675
|
`get_campaign_message_preparation_status`, `attachRecommendedSequenceResult`,
|
|
473
676
|
`finalCampaignRead`, or `finalTableRead`.
|
|
474
677
|
Self-check shorthand: top-level `planRevision`, `actionId`, `laneKey`, `laneType`, `workspaceId`, and `senderIds` must exist before worker completion.
|
|
678
|
+
Self-check shorthand: top-level `receiptArtifactPath`, `durableReceiptWritten:true`, `receiptRunId`, and `receiptWrittenAt` must exist before worker completion.
|
|
679
|
+
Self-check shorthand: top-level `receiptWrittenAt` must exist before worker completion.
|
|
475
680
|
Self-check shorthand: `campaignBriefReceipt.briefHash`,
|
|
476
681
|
`campaignBriefReceipt.deliveryFormat`, `campaignBriefReceipt.tokenRules`,
|
|
477
682
|
`campaignBriefReceipt.hardAvoids`, and `campaignBriefReceipt.sourceUseRules`
|
|
@@ -560,7 +765,12 @@ verification unless the same object also appears inside
|
|
|
560
765
|
"sourceLadderReason": "<why the current source is valid before colder sources>"
|
|
561
766
|
},
|
|
562
767
|
"filterDecisionReceipt": {
|
|
563
|
-
"status": "
|
|
768
|
+
"status": "applied",
|
|
769
|
+
"enableICPFilters": true,
|
|
770
|
+
"filterIds": ["<saved filter/rubric id>"],
|
|
771
|
+
"rubricIds": ["<saved rubric id>"],
|
|
772
|
+
"headlineICPCriteria": ["<saved ICP criterion>", "<saved ICP criterion>", "<saved ICP criterion>"],
|
|
773
|
+
"savedRubricCount": 3,
|
|
564
774
|
"workflowTableId": "<workflow table id>"
|
|
565
775
|
},
|
|
566
776
|
"messageDraftingReceipt": {
|
|
@@ -641,6 +851,25 @@ path itself in the worker thread:
|
|
|
641
851
|
exactly one semantic Approved cell through `select_campaign_cells` and
|
|
642
852
|
`update_cell`.
|
|
643
853
|
Approval shorthand: approve exactly one semantic Approved cell.
|
|
854
|
+
In this message-drafting path, `update_cell` is allowed only for the semantic
|
|
855
|
+
Approved checkbox. Do not use `update_cell` or any row/cell write to edit
|
|
856
|
+
generated message text, sample copy, or final message bodies in automation.
|
|
857
|
+
If generated copy fails review, update the campaign brief/message template
|
|
858
|
+
with `update_campaign_brief` or `revise_message_template_and_rerun`, then
|
|
859
|
+
rerun Generate Message and review current-revision generated output. Receipt
|
|
860
|
+
`sampleMessages` must come from generated current-revision cells after the
|
|
861
|
+
brief/template rerun, not from hand-edited message cell overrides. If a lane
|
|
862
|
+
used a generated-message body override, report
|
|
863
|
+
`blocked: generated_message_cell_override` instead of success.
|
|
864
|
+
Do not repair by overwriting bad generated message cells and then calling the
|
|
865
|
+
overwritten cells `sampleMessages`.
|
|
866
|
+
`messageDraftingReceipt.qualityReview.repairNote`,
|
|
867
|
+
`messageDraftingReceipt.toolsUsed`, or any proof mentioning generated
|
|
868
|
+
message cell repair through `update_cell` is self-incriminating and must be
|
|
869
|
+
`blocked: generated_message_cell_override`.
|
|
870
|
+
Short form: `update_cell` is allowed only for the semantic Approved checkbox.
|
|
871
|
+
Short form: Do not use `update_cell` to edit generated message text.
|
|
872
|
+
Short form: Bad copy requires brief/template revision plus Generate Message rerun.
|
|
644
873
|
4. Poll `get_campaign_message_preparation_status` until no queued/active cells
|
|
645
874
|
remain or a bounded stop reason is returned.
|
|
646
875
|
5. Use `get_campaign_messages_preview` or `select_campaign_cells` to inspect
|
|
@@ -667,6 +896,26 @@ The only accepted statusSource values are exactly `branch` and
|
|
|
667
896
|
`packaged-generate-messages-worker`; descriptive aliases such as
|
|
668
897
|
`package-readback-local-thread` are rejected.
|
|
669
898
|
|
|
899
|
+
Before any provider-specific source mutation for a newly created campaign,
|
|
900
|
+
reread `get_campaign_navigation_state({ campaignId })` and use that product
|
|
901
|
+
navigation state as the source-step authority. Do not jump from a shell directly
|
|
902
|
+
into `contact-search`, and do not jump from a shell directly into
|
|
903
|
+
`signal-discovery`. Advance through the product-visible source-selection step
|
|
904
|
+
first, then load the provider prompt and write only the provider/source fields
|
|
905
|
+
accepted for that current step. Never include sender reassignment fields in
|
|
906
|
+
source-step updates, never include custom narration fields in source-step
|
|
907
|
+
updates, and do not use guessed `currentStep` or watched narration payloads to
|
|
908
|
+
force the flow forward. If `update_campaign` rejects the source transition
|
|
909
|
+
twice, reread navigation/campaign state once; if the campaign is not already on
|
|
910
|
+
the intended source step, stop the lane with
|
|
911
|
+
`blocked: watched_source_transition_blocked` and include the rejected tool
|
|
912
|
+
result plus the readback. Do not loop on rejected `update_campaign` transitions.
|
|
913
|
+
Short form: do not jump from a shell directly into `contact-search`.
|
|
914
|
+
Short form: do not jump from a shell directly into `signal-discovery`.
|
|
915
|
+
Short form: never include sender reassignment fields in source-step updates.
|
|
916
|
+
Short form: never include custom narration fields in source-step updates.
|
|
917
|
+
Short form: do not loop on rejected `update_campaign` transitions.
|
|
918
|
+
|
|
670
919
|
One lane may produce exactly one CampaignOffer/campaign id and one current
|
|
671
920
|
workflow table id. For `intent:"create"`, the first successful
|
|
672
921
|
`create_campaign` result establishes the lane's only allowed campaign/table
|
|
@@ -705,9 +954,14 @@ the prospect's engagement unless the selected source evidence proves that exact
|
|
|
705
954
|
sender authored the post.
|
|
706
955
|
Shared lanes must reject generic product-summary samples that explain the
|
|
707
956
|
product in the same broad words for every row. Shared lanes must reject three
|
|
708
|
-
nearly identical samples after stripping the leading name.
|
|
709
|
-
|
|
710
|
-
|
|
957
|
+
nearly identical samples after stripping the leading name. Shared lanes must
|
|
958
|
+
fail quality review when any reviewed sample has non-empty `issues`; do not
|
|
959
|
+
approve or final-report samples with `verdict:"passed"` and non-empty `issues`.
|
|
960
|
+
If any of these failures appears, revise or rerun the packaged
|
|
961
|
+
create-campaign/generate-messages path from the lane worker before writing a
|
|
962
|
+
success receipt.
|
|
963
|
+
Short form: Shared lanes must fail quality review when any reviewed sample has non-empty `issues`.
|
|
964
|
+
Short form: Do not approve or final-report samples with `verdict:"passed"` and non-empty `issues`.
|
|
711
965
|
The generated-message cells are not prompt proof: `currentRevisionGeneratedMessages`,
|
|
712
966
|
Generate Message column counts, `messagesCount`, or rendered row previews prove
|
|
713
967
|
only that table cells exist from the current brief/template, not that the
|
|
@@ -727,10 +981,85 @@ duplicate-lane blockers before you call the command finished. If verify blocks,
|
|
|
727
981
|
report the blocker and repair only the missing postconditions from the same
|
|
728
982
|
current plan.
|
|
729
983
|
|
|
984
|
+
Before calling verify, the parent should build compact receipt objects from the
|
|
985
|
+
durable receipt files and pass those compact objects to MCP. The compact receipt
|
|
986
|
+
must preserve every verifier-owned field named above, including top-level ids,
|
|
987
|
+
`createCampaignStepReceipt`, `researchSenderReceipt`, canonical
|
|
988
|
+
filter/message/review/sequence/final proof, and at least three concrete sample
|
|
989
|
+
messages. It should omit large raw
|
|
990
|
+
search outputs, long post lists, full row arrays, raw provider responses, and
|
|
991
|
+
debug-only narration fields. Do not pass multi-hundred-kilobyte raw receipt
|
|
992
|
+
objects when a compact canonical receipt has the same proof; large raw verify
|
|
993
|
+
payloads can stall local MCP bridges and make UAT ambiguous.
|
|
994
|
+
Use a small Node JSON compactor for non-trivial compaction. Do not build complex
|
|
995
|
+
inline `jq` filters inside nested quoted shell strings; quote failures are a
|
|
996
|
+
UAT blocker and waste the verification run. The Node compactor must preserve
|
|
997
|
+
every canonical verifier object under `createCampaignStepReceipt`, including
|
|
998
|
+
`setupPlanCall`, `createCampaignWorkflowReceipt`, `researchSenderReceipt`,
|
|
999
|
+
`campaignBriefReceipt`, `sourceDecisionReceipt`, `filterDecisionReceipt`,
|
|
1000
|
+
`messageDraftingReceipt`, `reviewBatchReceipt`, `sequenceReceipt`,
|
|
1001
|
+
`finalPausedSendProof`, and `verifyCall`.
|
|
1002
|
+
When compacting, normalize `finalPausedSendProof.currentStep` and
|
|
1003
|
+
`finalPausedSendProof.campaignStatus` from nested pause/navigation readbacks if
|
|
1004
|
+
the worker receipt stored those values under `pauseCampaignResult`,
|
|
1005
|
+
`navigationReadback`, or `navigationProof`; do not pass an empty
|
|
1006
|
+
`finalPausedSendProof` object to verify.
|
|
1007
|
+
Do not print or `jq .` full receipt JSON into the terminal. For local checks,
|
|
1008
|
+
print only compact summaries such as file, actionId, laneKey, campaignId,
|
|
1009
|
+
filter status, sample count, approved count, and final status.
|
|
1010
|
+
Short form: Parent verify uses compact canonical receipt objects, not raw giant receipts.
|
|
1011
|
+
Short form: Do not dump full receipt JSON with `jq .`.
|
|
1012
|
+
Short form: Do not use complex inline `jq` for receipt compaction; use Node.
|
|
1013
|
+
Short form: Compact receipts must preserve `researchSenderReceipt`.
|
|
1014
|
+
Short form: Compact receipts must preserve direct `finalPausedSendProof.currentStep` and `campaignStatus`.
|
|
1015
|
+
Short form: Never change planRevision/actionId/laneKey while compacting receipts.
|
|
1016
|
+
|
|
1017
|
+
Parent repair dispatch uses the same compact discipline. If the parent sample
|
|
1018
|
+
quality gate fails after a worker receipt, do not launch a repair worker by
|
|
1019
|
+
embedding the full existing receipt JSON, raw row arrays, raw provider output,
|
|
1020
|
+
or the full wrapper skill in the repair prompt. Build a compact repair packet
|
|
1021
|
+
with only: workspace id, original planRevision, selectedActionIds, lane
|
|
1022
|
+
actionId, laneKey, campaignId, tableId, parent sender scope arrays, receipt
|
|
1023
|
+
artifact path, allowed repair side effects, failed sample snippets, failed
|
|
1024
|
+
quality codes, and the banned phrase list. The repair prompt must say
|
|
1025
|
+
`Do not include existing receipt JSON; load current product state through
|
|
1026
|
+
Sellable MCP readbacks and rewrite the durable receipt from fresh readbacks`.
|
|
1027
|
+
After the repair worker completes the final product readbacks
|
|
1028
|
+
(`get_campaign_messages_preview`, `get_campaign`, navigation/table readback),
|
|
1029
|
+
it must rewrite the durable receipt immediately before any extended narration,
|
|
1030
|
+
analysis, or final answer. If the repair worker cannot rewrite the durable
|
|
1031
|
+
receipt in one bounded pass, it must exit with
|
|
1032
|
+
`blocked: repair_receipt_write_timeout`. The parent must treat an unchanged
|
|
1033
|
+
receipt mtime, missing repair final file, or missing updated
|
|
1034
|
+
`messageDraftingReceipt.sampleMessages` after repair as blocked, never success.
|
|
1035
|
+
Short form: repair prompts use compact repair packets, not full receipt JSON.
|
|
1036
|
+
Short form: Do not include existing receipt JSON in repair prompts.
|
|
1037
|
+
Short form: repair workers write the durable receipt immediately after final readbacks.
|
|
1038
|
+
Short form: missing repair receipt rewrite is `blocked: repair_receipt_write_timeout`.
|
|
1039
|
+
|
|
730
1040
|
Message proof for every customer-visible lane must come from the current
|
|
731
1041
|
campaign/table basis and include at least 3 generated review rows from the
|
|
732
1042
|
packaged `generate-messages` path before completion is reported.
|
|
733
1043
|
Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
1044
|
+
|
|
1045
|
+
The parent must run its own sample-quality gate before final reporting, even
|
|
1046
|
+
when worker receipts say `verdict:"passed"`. For Post Engagers lanes, reject
|
|
1047
|
+
any sample that adds a relevance question, CTA, product line, or extra paragraph
|
|
1048
|
+
after `Thank you for the support on my post about ...`; blocked phrases include
|
|
1049
|
+
`curious`, `open to`, `trying to`, `worth seeing`, `want to see`, and any
|
|
1050
|
+
Sellable/product explanation. For each shared lane, normalize the reviewed
|
|
1051
|
+
sample messages by removing leading greeting/name lines, first names, and
|
|
1052
|
+
whitespace-only differences; reject shared-lane samples when the message body is
|
|
1053
|
+
identical after removing first names or when all samples share the same paragraph
|
|
1054
|
+
skeleton. Also reject final shared-lane samples with `Hey <name>,` letter
|
|
1055
|
+
punctuation, weak relevance hedges, internal workflow vocabulary, self-intros,
|
|
1056
|
+
or any non-empty `issues`. Shared lanes must also reject mechanical
|
|
1057
|
+
product-process wording such as `sequence-prospects`, `dashboard overhead`,
|
|
1058
|
+
`campaign map`, `campaign idea into prospects`, `prospects, filters, messages`,
|
|
1059
|
+
`send-ready copy`, or `reviewed prospect lists`. If the parent finds repeated
|
|
1060
|
+
shared-lane sample copy, report `blocked: repeated_shared_lane_sample_copy`,
|
|
1061
|
+
revise the campaign brief/template through the packaged workflow, rerun Generate
|
|
1062
|
+
Message, and verify current-revision sample messages before final completion.
|
|
734
1063
|
</command_backed_workflow>
|
|
735
1064
|
|
|
736
1065
|
<objective>
|
|
@@ -765,19 +1094,26 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
765
1094
|
Short form: Do not pass the warm template into Shared Signal Discovery or Shared Cold Fallback.
|
|
766
1095
|
Short form: Shared lanes must reject generic product-summary samples.
|
|
767
1096
|
Short form: Shared lanes must reject three nearly identical samples.
|
|
1097
|
+
Short form: Shared lanes must reject low-confidence relevance hedges.
|
|
1098
|
+
Short form: Shared lanes must reject internal workflow vocabulary.
|
|
768
1099
|
Short form: revise or rerun the packaged create-campaign/generate-messages path.
|
|
769
1100
|
- **Post Engagers** first-message style: short, casual, references the
|
|
770
|
-
sender-authored post they engaged with,
|
|
771
|
-
vocabulary, no pitch, no meeting ask
|
|
1101
|
+
sender-authored post they engaged with, and stops after the thank-you
|
|
1102
|
+
line. Use **no internal vocabulary, no pitch, no meeting ask, no product
|
|
1103
|
+
line, and no relevance question** in message one:
|
|
772
1104
|
|
|
773
1105
|
```
|
|
774
1106
|
{{first_name}}
|
|
775
1107
|
|
|
776
1108
|
Hey there
|
|
777
1109
|
|
|
778
|
-
|
|
1110
|
+
Thank you for the support on my post about {{post_topic_line}}
|
|
779
1111
|
```
|
|
780
1112
|
|
|
1113
|
+
Do not add any paragraph after the thank-you line. In particular, do not
|
|
1114
|
+
append `curious, are you trying...`, `open to...`, `worth seeing...`, or
|
|
1115
|
+
Sellable/product copy to a Post Engagers first message.
|
|
1116
|
+
|
|
781
1117
|
- **Shared Signal Discovery** first-message style: short, casual, references
|
|
782
1118
|
the real observed signal/theme or public conversation. It may mention the
|
|
783
1119
|
engagement source only when the source evidence supports it. Do not say
|
|
@@ -791,6 +1127,28 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
791
1127
|
say it. Prefer sender-agnostic company/team language such as "we're
|
|
792
1128
|
helping CX teams..." or "at cxconnect.ai, we help..." and one clear
|
|
793
1129
|
problem question.
|
|
1130
|
+
Before Message Drafting runs, the campaign brief must already include
|
|
1131
|
+
these shared-lane hard avoids and source-use rules. Do not rely on a
|
|
1132
|
+
failed first generation batch to discover that self-intros, generic
|
|
1133
|
+
product summaries, or repeated structure are bad. If the first generated
|
|
1134
|
+
batch violates these rules, rerun, but record that as a repaired UAT path
|
|
1135
|
+
rather than the desired zero-shot path.
|
|
1136
|
+
Do not use low-confidence relevance hedges such as "hope this is
|
|
1137
|
+
relevant" in Shared Signal Discovery samples. Translate source/tool terms
|
|
1138
|
+
into prospect-facing business language; do not put internal workflow
|
|
1139
|
+
vocabulary such as "Codex-style workflow", "MCP", "agent workflows",
|
|
1140
|
+
"Claude Code", or "Claude-style agent workflows" in customer-facing
|
|
1141
|
+
message one. Also avoid generic product-process nouns such as "dashboard",
|
|
1142
|
+
"workflow", "source", "send-ready copy", "reviewed prospect lists",
|
|
1143
|
+
"reviewed pipeline", "leads, filters, messages", "review-ready LinkedIn
|
|
1144
|
+
sequence", "plain-language campaign idea into leads/filters/messages",
|
|
1145
|
+
and "sequence" unless the recipient's own product/category makes that
|
|
1146
|
+
exact word buyer-native.
|
|
1147
|
+
Short form: Shared Signal Discovery uses no self-intro such as "I'm building Sellable".
|
|
1148
|
+
Short form: Shared Signal Discovery uses no self-intro such as "We're building Sellable".
|
|
1149
|
+
Short form: Shared Signal Discovery uses no "I've put together".
|
|
1150
|
+
Short form: no low-confidence relevance hedge such as "hope this is relevant".
|
|
1151
|
+
Short form: no internal workflow vocabulary such as "Codex-style workflow", "MCP", "agent workflows", "Claude Code", or "Claude-style agent workflows".
|
|
794
1152
|
- **Shared Cold Fallback** first-message style: cold, direct, and cohesive.
|
|
795
1153
|
It must not pretend there was engagement, must not say "saw you pop up",
|
|
796
1154
|
and must not use a standalone name line followed by "Hey there" or other
|
|
@@ -805,14 +1163,57 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
805
1163
|
Sellable/Codex/Claude-Code feature summary
|
|
806
1164
|
across prospects. This is a single-message cold path unless the approved
|
|
807
1165
|
create-campaign message workflow proves a better delivery format.
|
|
1166
|
+
Do not open with "hope this is relevant" or a similar low-confidence
|
|
1167
|
+
relevance hedge. Do not use a repeated product-definition paragraph such
|
|
1168
|
+
as "Sellable is a GTM system" across samples; every reviewed cold sample
|
|
1169
|
+
should be specific enough to the role, company, or problem that the three
|
|
1170
|
+
sample messages do not share the same body skeleton.
|
|
1171
|
+
Do not use mechanical Sellable process language such as "campaign idea into
|
|
1172
|
+
prospects, filters, messages, and sequence setup", "sequence-prospects",
|
|
1173
|
+
"dashboard overhead", "campaign map", "send-ready copy", or "reviewed
|
|
1174
|
+
prospect lists" in final cold samples. Say the buyer problem and one plain
|
|
1175
|
+
outcome instead.
|
|
1176
|
+
Before Message Drafting runs, the campaign brief must already forbid
|
|
1177
|
+
self-intros, generic product summaries, opt-out shrugs, product-stack
|
|
1178
|
+
dumps, and repeated template structure. Do not let the first generation
|
|
1179
|
+
batch use "I'm building", "We're building", "I've put together", or
|
|
1180
|
+
similar language and then rely on a cleanup rerun as the normal path.
|
|
808
1181
|
Short form: Shared Cold Fallback must not pass just because the receipt says `generate-messages` loaded.
|
|
809
1182
|
Short form: Shared Cold Fallback uses no self-intro such as "We're building".
|
|
1183
|
+
Short form: Shared Cold Fallback uses no self-intro such as "I'm building Sellable".
|
|
1184
|
+
Short form: Shared Cold Fallback uses no "I've put together".
|
|
810
1185
|
Short form: Shared Cold Fallback uses no opt-out shrug such as "If this isn't relevant, ignore me".
|
|
811
1186
|
Short form: Shared Cold Fallback uses no product-stack dump.
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
1187
|
+
Short form: no low-confidence relevance hedge such as "hope this is relevant".
|
|
1188
|
+
Short form: no repeated product-definition paragraph such as "Sellable is a GTM system".
|
|
1189
|
+
- Customer-visible evergreen lanes must enable ICP filtering before Message
|
|
1190
|
+
Drafting. This applies to Post Engagers, Shared Signal Discovery, and
|
|
1191
|
+
Shared Cold Fallback. Do not skip filtering for evergreen setup, even when
|
|
1192
|
+
the source is warm. Use the normal `$sellable:create-campaign` filter
|
|
1193
|
+
workflow: set or save 3-5 headline ICP criteria, call `save_rubrics`, and
|
|
1194
|
+
persist `enableICPFilters:true` on the campaign before generating
|
|
1195
|
+
messages. Good evergreen filters should be light but real: role/budget
|
|
1196
|
+
relevance, company/market fit, and obvious non-buyer exclusion. For
|
|
1197
|
+
Post Engagers, keep filters permissive enough that warm source rows are not
|
|
1198
|
+
over-pruned, but still save the filter rules. For shared lanes, filter for
|
|
1199
|
+
buyers/operators relevant to the workspace offer and exclude students,
|
|
1200
|
+
job seekers, vendors, and off-topic commenters. The receipt must show
|
|
1201
|
+
`filterDecisionReceipt.status:"applied"`,
|
|
1202
|
+
`filterDecisionReceipt.enableICPFilters:true`, current `workflowTableId`,
|
|
1203
|
+
and saved filter/rubric proof with at least three saved rubric/filter
|
|
1204
|
+
criteria (`filterIds`, `rubricIds`, `headlineICPCriteria`, or
|
|
1205
|
+
`savedRubricCount`). Missing or skipped filter proof is
|
|
1206
|
+
`blocked: missing_filter_setup`.
|
|
1207
|
+
Short form: Customer-visible evergreen lanes must enable ICP filtering.
|
|
1208
|
+
Short form: `enableICPFilters:true`.
|
|
1209
|
+
Short form: Do not skip filtering for evergreen setup.
|
|
1210
|
+
Short form: at least three saved rubric/filter criteria.
|
|
1211
|
+
Short form: missing or skipped filter proof is `blocked: missing_filter_setup`.
|
|
1212
|
+
Short form: run Message Drafting only after saved filters are applied.
|
|
1213
|
+
- Every customer-visible lane must run Message Drafting from the current
|
|
1214
|
+
campaign/table basis after source rows exist. The worker must load the full
|
|
1215
|
+
packaged `generate-messages` prompt, every required asset, and
|
|
1216
|
+
`create-campaign-v2-validation`; if the internal branch handoff is not
|
|
816
1217
|
callable in the packaged runtime, the worker must call
|
|
817
1218
|
`start_campaign_message_preparation` and poll
|
|
818
1219
|
`get_campaign_message_preparation_status` from the lane worker. The
|
|
@@ -842,10 +1243,13 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
842
1243
|
- A source/list decision has been resolved and campaign rows are loaded. If
|
|
843
1244
|
there is no approved source or no rows can be copied, report `blocked` with
|
|
844
1245
|
the missing source detail; do not call the campaign complete.
|
|
845
|
-
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
1246
|
+
- The filter step is resolved with saved/applied filters. Customer-visible
|
|
1247
|
+
evergreen lanes must have `enableICPFilters:true`, at least three saved
|
|
1248
|
+
ICP filter/rubric criteria, and a receipt with
|
|
1249
|
+
`filterDecisionReceipt.status:"applied"`. Do not skip filters for
|
|
1250
|
+
evergreen setup. Do not leave customer-visible campaigns at
|
|
1251
|
+
`filter-choice`, `filter-rules`, or `apply-icp-rubric` and report success.
|
|
1252
|
+
Do not proceed to Message Drafting until saved filters are applied.
|
|
849
1253
|
- Message Drafting has run from the current campaign/table basis, using the
|
|
850
1254
|
create-campaign message prompt/assets and validation gate. Updating
|
|
851
1255
|
`currentStep:"messages"` is not proof. Parent-thread handwritten copy is
|
|
@@ -864,13 +1268,17 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
864
1268
|
reviewed sample messages. For Shared Cold Fallback, reject samples that
|
|
865
1269
|
open with a standalone name followed by "Hey there" or a similarly generic
|
|
866
1270
|
greeting. For Shared Cold Fallback, also reject samples with a self-intro
|
|
867
|
-
such as "We're building",
|
|
868
|
-
|
|
1271
|
+
such as "We're building", "I'm building Sellable", or "I've put
|
|
1272
|
+
together", an opt-out shrug such as "If this isn't relevant, ignore me",
|
|
1273
|
+
or a product-stack dump that repeats the same
|
|
869
1274
|
Sellable/Codex/Claude-Code feature summary across prospects. For all
|
|
870
1275
|
shared lanes, reject generic product-summary samples, repeated
|
|
871
|
-
near-identical samples,
|
|
872
|
-
|
|
873
|
-
|
|
1276
|
+
near-identical samples, low-confidence relevance hedges such as "hope this
|
|
1277
|
+
is relevant", internal workflow vocabulary, any sample with non-empty
|
|
1278
|
+
`issues`, and any preserved Post Engagers opener; revise or rerun the packaged
|
|
1279
|
+
create-campaign/generate-messages path before reporting completion. Do not
|
|
1280
|
+
approve or final-report samples with `verdict:"passed"` and non-empty
|
|
1281
|
+
`issues`.
|
|
874
1282
|
- The first review batch exists and at least 3 review rows have generated
|
|
875
1283
|
messages from the approved brief. If fewer than 3 usable rows exist, report
|
|
876
1284
|
the actual count and why.
|
|
@@ -944,7 +1352,9 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
944
1352
|
**Also confirm the delivery format and keep config in sync.** Ask the user whether DM lanes should send multiline (paragraph-per-message) or as a single message. Record the answer as the brief's `Delivery format:` line, and when multiline is chosen, set `actionConfig.sendEachParagraphAsMessage: true` on that campaign's `send_dm` column via `update_column` (config edits run no cells and nothing sends from unlaunched campaigns). Never set the paragraph-split flag on InMail columns — the option does not apply to InMail.
|
|
945
1353
|
6. **Interactive polish mode only: prove the template on one real row.** For ONE campaign that has at least one lead row (add one via `add_on_demand_leads` if every lane is empty and the user provides/approves a test lead), generate a message for exactly one row (`queue_campaign_cells` with `columnRole: "generateMessage"`, `rowSelector: { type: "reviewBatch", limit: 1 }` or the single row's ID), wait for it, then show the user the generated message next to the template — AND show how it would split if paragraph-per-message sending is enabled (list each paragraph as `msg 1:`, `msg 2:`, …) so the user confirms each one reads like a real typed message. Check alignment: tone, structure, no internal vocabulary, correct token substitution, no letter punctuation. Do NOT approve the row or generate for more rows — one sample only.
|
|
946
1354
|
7. **Automation mode template/config audit**: inspect existing send-lane briefs for a `Delivery format:` line and chat-native warm template. If a send lane is missing the line and the prompt allows cleanup, update only the campaign brief metadata with the safest default for that lane (`Delivery format: single message (LinkedIn DM; line breaks remain inside one generated message; no follow-up until reply)`). If cleanup is not allowed, flag it. Do not generate a sample row in automation mode unless the invocation explicitly asks for sample proof. In structure-only automation, do not generate a sample row unless the invocation explicitly asks for sample proof. In customer-visible completion, follow the Customer-Visible Completion Contract instead.
|
|
947
|
-
8. **
|
|
1355
|
+
8. **Final customer-facing completion must include sample messaging**: after customer-visible verify and the idempotency rerun pass, add a `Sample Messaging Review` section to the final answer. For every completed lane, show at least one full generated first message for every completed lane with campaign name, campaign id, row id, and verdict. Extract samples from nested `createCampaignStepReceipt.messageDraftingReceipt.sampleMessages`, not from top-level summaries; extract samples from nested `createCampaignStepReceipt.messageDraftingReceipt.sampleMessages` when building the final answer. Prefer the approved route-proof row when it is quality-valid; otherwise use the best reviewed generated row from the verified receipt. A final `passed` sample must have `issues:[]`; if every reviewed sample has issues, report the lane as needing message revision instead of presenting a passed sample. Never approve or final-report sample text produced by manual `update_cell` body edits. Do not summarize the sample into a copy theme. Show the actual message text so the user can inspect tone and specificity. If any sample is not quite right, tell the user they can ask the AI to update the campaign brief/message template and rerun Generate Message before launch. Never suggest launching, scheduling, or sending as the next step from this command.
|
|
1356
|
+
If the `Sample Messaging Review` section is omitted, the command is incomplete even when the structural campaign setup succeeded.
|
|
1357
|
+
9. **Report the reconcile plan and result** — every slot tagged `reused`, `created`, `repaired`, `flagged`, or `blocked`, plus template/sample details only when that mode ran:
|
|
948
1358
|
|
|
949
1359
|
```
|
|
950
1360
|
Evergreen Reconcile — {date}
|
|
@@ -953,6 +1363,17 @@ Evergreen Reconcile — {date}
|
|
|
953
1363
|
• Sellable.dev - Shared Signal Discovery: repaired (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
|
|
954
1364
|
• Sellable.dev - Shared Cold Fallback: created (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
|
|
955
1365
|
All campaigns remain unlaunched. Next: enrich/approve more rows when you want more items ready to schedule.
|
|
1366
|
+
|
|
1367
|
+
Sample Messaging Review
|
|
1368
|
+
• Christian Reyes - Post Engagers (`cmp_...`, row `row_...`, verdict: passed)
|
|
1369
|
+
```
|
|
1370
|
+
{{full generated first message}}
|
|
1371
|
+
```
|
|
1372
|
+
• Sellable.dev - Shared Cold Fallback (`cmp_...`, row `row_...`, verdict: passed)
|
|
1373
|
+
```
|
|
1374
|
+
{{full generated first message}}
|
|
1375
|
+
```
|
|
1376
|
+
If any sample is not quite right, ask the AI to update the campaign brief/message template and rerun Generate Message before launch.
|
|
956
1377
|
```
|
|
957
1378
|
</objective>
|
|
958
1379
|
|
|
@@ -228,12 +228,16 @@ must choose a signal-led, event-led, job-post-led, or proof-led motion from the
|
|
|
228
228
|
current brief and row evidence instead of inheriting a preset first-message
|
|
229
229
|
template.
|
|
230
230
|
Post-engager first messages should thank the prospect for the support on the
|
|
231
|
-
sender-owned post
|
|
232
|
-
|
|
231
|
+
sender-owned post and then stop. Do not add a relevance question, CTA, product
|
|
232
|
+
line, meeting ask, or extra paragraph after the thank-you opener unless the
|
|
233
|
+
operator explicitly asks for a longer first message. Prefer the gold shape
|
|
234
|
+
`Thanks for the support on my post about {{post_topic_line}}` over
|
|
233
235
|
surveillance-flavored wording like `saw you pop up`, unless the sender explicitly
|
|
234
236
|
asks for that older wording.
|
|
235
237
|
Short form: use the CXConnect Post-Engager Warm Reply-Rate Pattern only when the source is sender-owned Post Engagers.
|
|
236
238
|
Short form: Never use that warm post-engager pattern for Shared Signal Discovery or Shared Cold Fallback.
|
|
239
|
+
Short form: Post-engager warm first messages stop after the thank-you line.
|
|
240
|
+
Short form: Do not add `curious`, `open to`, `trying to`, product copy, or a CTA after the post-engager thank-you line.
|
|
237
241
|
|
|
238
242
|
### Shared Cold Fallback quality bar
|
|
239
243
|
|
|
@@ -245,6 +249,12 @@ must read like final create-campaign/generate-messages output.
|
|
|
245
249
|
- Ask one clear buyer problem question.
|
|
246
250
|
- Keep the product line minimal and buyer-readable; do not turn the note into a
|
|
247
251
|
product-stack dump.
|
|
252
|
+
- Do not describe Sellable as a process checklist such as "campaign idea into
|
|
253
|
+
prospects, filters, messages, and sequence setup"; that reads like internal
|
|
254
|
+
product plumbing, not a buyer reason to reply.
|
|
255
|
+
- Do not use awkward product-process nouns in reviewed cold samples:
|
|
256
|
+
`sequence-prospects`, `dashboard overhead`, `campaign map`, `send-ready copy`,
|
|
257
|
+
`reviewed prospect lists`, or "one campaign would look like" as a default CTA.
|
|
248
258
|
- Use no self-intro such as "We're building" or "We're working on a way" in the
|
|
249
259
|
reviewed samples.
|
|
250
260
|
- Use no opt-out shrug such as "If this isn't relevant, ignore me."
|
|
@@ -252,6 +262,39 @@ must read like final create-campaign/generate-messages output.
|
|
|
252
262
|
samples. If two samples would still read the same after replacing names and
|
|
253
263
|
companies, revise or rerun.
|
|
254
264
|
|
|
265
|
+
### Shared Evergreen Signal Discovery hard gate
|
|
266
|
+
|
|
267
|
+
For Shared Signal Discovery and other shared evergreen lanes, signal-led copy
|
|
268
|
+
must be safer than the legacy weak-signal examples. These lanes are reused by
|
|
269
|
+
multiple senders, so the first line cannot sound like a scraped-activity excuse
|
|
270
|
+
or a founder self-intro.
|
|
271
|
+
|
|
272
|
+
- `hope this is relevant`, `might be interested`, and `saw you in a few conversations` are blocked openers for shared evergreen lanes.
|
|
273
|
+
- do not write first-person singular founder language such as `I'm building`,
|
|
274
|
+
`I've mapped`, `my company`, or `my team` unless exactly one sender can
|
|
275
|
+
credibly say it and the lane is not shared.
|
|
276
|
+
- Do not put internal workflow vocabulary in buyer-facing copy: `Codex`, `MCP`,
|
|
277
|
+
`Claude-style agent workflows`, `agent workflows`, `workflow table`, `lead
|
|
278
|
+
source`, or `signal discovery`.
|
|
279
|
+
- Do not use `Claude`, `Codex`, `MCP`, `agent`, `dashboard`, `workflow`,
|
|
280
|
+
`source`, `sequence`, `send-ready copy`, or `reviewed prospect list` as
|
|
281
|
+
buyer-facing explanation in shared evergreen samples unless the buyer's own
|
|
282
|
+
company/product category uses that exact word and the line still sounds human.
|
|
283
|
+
- Write a concrete signal/problem bridge instead of a relevance hedge. Good
|
|
284
|
+
shapes are `the AI-assisted GTM conversations keep coming back to [buyer
|
|
285
|
+
problem]`, `teams trying to turn LinkedIn signal into pipeline usually hit
|
|
286
|
+
[problem]`, or `when [observable business moment] is live, [buyer workflow]
|
|
287
|
+
gets harder to run consistently`.
|
|
288
|
+
- If the row evidence is too weak to write a concrete bridge, omit the source
|
|
289
|
+
line and start from a buyer problem, event, role, or company observation.
|
|
290
|
+
- Shared evergreen lanes must pass this gate before `confirmed`, before saving a
|
|
291
|
+
reusable template, and before any route-proof approval.
|
|
292
|
+
|
|
293
|
+
Short form: shared evergreen copy cannot use `hope this is relevant`.
|
|
294
|
+
Short form: shared evergreen copy cannot use `might be interested`.
|
|
295
|
+
Short form: shared evergreen copy cannot use `I'm building`.
|
|
296
|
+
Short form: write a concrete signal/problem bridge instead of a relevance hedge.
|
|
297
|
+
|
|
255
298
|
### Rich Personalization Contract
|
|
256
299
|
|
|
257
300
|
The `create-campaign` asset `references/ai-native-tokens.md` is the canonical
|
|
@@ -269,12 +312,15 @@ conditional good/bad fill reference.
|
|
|
269
312
|
- Use this shape for any hook, bridge, or row-specific relevance line:
|
|
270
313
|
`[PERSONALIZATION_LINE — Intent: write one short sentence that anchors the
|
|
271
314
|
note to why this might matter now. DO: connect one observable role/company/
|
|
272
|
-
activity signal to the buyer problem or offer with
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
315
|
+
activity signal to the buyer problem or offer with a permissioned bridge. For
|
|
316
|
+
shared evergreen lanes, do not use `hope this is relevant`, `might be
|
|
317
|
+
interested`, or `saw you in a few conversations`; use a concrete
|
|
318
|
+
signal/problem bridge instead. For non-evergreen weak-signal campaigns only,
|
|
319
|
+
legacy low-certainty language like "hope this is relevant if..." or "so may be
|
|
320
|
+
off, but this seemed relevant" can be considered when the source is otherwise
|
|
321
|
+
awkward. DON'T: recap their resume, list companies, compliment their
|
|
322
|
+
background, name a product their company sells, use source-citation phrasing, or
|
|
323
|
+
use generic nouns like "your work".
|
|
278
324
|
FALLBACK: if unsupported, omit the entire line.]`
|
|
279
325
|
- The rendered personalization line should usually be 6-14 words. If it needs
|
|
280
326
|
two clauses, multiple companies, or abstract tags like `GTM`, `international
|
|
@@ -433,9 +479,9 @@ artifact.**
|
|
|
433
479
|
|
|
434
480
|
Safer shapes:
|
|
435
481
|
|
|
436
|
-
- `hope this is relevant if {{signal_topic}} is part of the plan`
|
|
437
|
-
- `saw you might be interested in {{signal_topic}}, so hope this is relevant`
|
|
438
|
-
- `saw you in a few conversations around {{signal_topic}}, so hope this is relevant`
|
|
482
|
+
- `hope this is relevant if {{signal_topic}} is part of the plan` for non-evergreen weak-signal campaigns only
|
|
483
|
+
- `saw you might be interested in {{signal_topic}}, so hope this is relevant` for non-evergreen weak-signal campaigns only
|
|
484
|
+
- `saw you in a few conversations around {{signal_topic}}, so hope this is relevant` for non-evergreen weak-signal campaigns only
|
|
439
485
|
- `saw you in a few conversations about {{signal_topic}}, so may be off, but this seemed relevant`
|
|
440
486
|
- `appreciate you showing some love on my post about {{signal_topic}}` only when the sender/client authored the source post and the row proves a reaction or comment
|
|
441
487
|
- `thanks for showing support on my {{signal_topic}} post` only when the sender/client authored the source post and the row proves a reaction or comment
|
|
@@ -499,20 +545,22 @@ artifact.**
|
|
|
499
545
|
magnet replies, or scraped conversations), it is acceptable to reference the
|
|
500
546
|
conversation when it explains why the note exists. Keep it topic-level, not
|
|
501
547
|
activity-log-level: `saw you in a few conversations around
|
|
502
|
-
{{signal_topic}}, so hope this is relevant` is acceptable
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
548
|
+
{{signal_topic}}, so hope this is relevant` is acceptable only for
|
|
549
|
+
non-evergreen weak-signal campaigns; it is blocked for Shared Evergreen
|
|
550
|
+
Signal Discovery. `saw you commented on {{post_context}}` and `your LinkedIn
|
|
551
|
+
activity around...` are not acceptable. Reserve `raise your hand` phrasing
|
|
552
|
+
for explicit lead-magnet comments, replies, or opt-ins. For ordinary shared
|
|
553
|
+
evergreen thread discovery, either translate the topic into a concrete
|
|
554
|
+
buyer/problem bridge or omit the source line.
|
|
508
555
|
|
|
509
556
|
Keep the apologetic nature, but aim it at uncertainty, not surveillance.
|
|
510
|
-
Good: `saw you in a few
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
because it asserts fit from a
|
|
557
|
+
Good for non-evergreen weak-signal campaigns: `saw you in a few
|
|
558
|
+
conversations about outbound, so may be off, but this seemed relevant`, `may
|
|
559
|
+
be off, but if outbound is relevant to what you're working on...`, or `hope
|
|
560
|
+
this is relevant if...`. For shared evergreen lanes, these hedges are not
|
|
561
|
+
enough; use a concrete signal/problem bridge or omit the source line. Bad:
|
|
562
|
+
`your role at {{company}} looked close...`, because it asserts fit from a
|
|
563
|
+
title and tells the buyer about themselves.
|
|
516
564
|
|
|
517
565
|
Block wordier source narration such as `you might not remember the thread,
|
|
518
566
|
but I found you through a {{signal_topic}} discussion and your
|
|
@@ -1509,7 +1557,10 @@ Before `confirmed`, run the selected winner against these gates:
|
|
|
1509
1557
|
the lead sample. If desire is inferred, use tentative framing like
|
|
1510
1558
|
`hope this is relevant if...`, `saw you might be interested in...`,
|
|
1511
1559
|
`saw you in a few conversations around...`, `figured this might matter if...`,
|
|
1512
|
-
or `if you've ever wanted...`.
|
|
1560
|
+
or `if you've ever wanted...`. Exception: for Shared Signal Discovery and
|
|
1561
|
+
other shared evergreen lanes, `hope this is relevant`, `might be interested`,
|
|
1562
|
+
and `saw you in a few conversations` are blocked; use a concrete
|
|
1563
|
+
signal/problem bridge or omit the source line.
|
|
1513
1564
|
- **Buyer-first opener:** after the greeting, the first substantive line
|
|
1514
1565
|
should usually enter the buyer's world: a real signal, current-state
|
|
1515
1566
|
pain, buyer-owned priority, or useful artifact. Sender-origin can come
|
|
@@ -1810,8 +1861,11 @@ about`, or `clearly relevant` are BLOCKED. Source-y phrases such as
|
|
|
1810
1861
|
`saw you might be interested in [topic], so hope this is relevant`, `saw you
|
|
1811
1862
|
in a few conversations around [topic], so hope this is relevant`, `found you
|
|
1812
1863
|
in a few conversations about [topic], so may be off, but this seemed
|
|
1813
|
-
relevant`, `figured this might matter if [workflow] is live at [company]`, or
|
|
1814
|
-
line.
|
|
1864
|
+
relevant`, `figured this might matter if [workflow] is live at [company]`, or
|
|
1865
|
+
a similarly natural line. For shared evergreen lanes, skip the `hope this is
|
|
1866
|
+
relevant` / `might be interested` / `saw you in a few conversations` versions
|
|
1867
|
+
and use the concrete bridge version. Longer source-recap forms such as `you
|
|
1868
|
+
might not remember the thread,
|
|
1815
1869
|
but I found you through a [topic] discussion...` are BLOCKED; they narrate
|
|
1816
1870
|
the scrape path instead of creating buyer relevance.
|
|
1817
1871
|
- **Engagement reference is opt-in, not the default opener:** do not
|
|
@@ -1956,9 +2010,9 @@ matters to the buyer, why this might be relevant, or the operator-reality that
|
|
|
1956
2010
|
led to it. Acceptable openers:
|
|
1957
2011
|
|
|
1958
2012
|
- `Hey {{first_name}}, [one plain sentence about what we built].`
|
|
1959
|
-
- `Hey {{first_name}}, hope this is relevant if [buyer context] is still on your plate.`
|
|
1960
|
-
- `Hey {{first_name}}, saw you might be interested in [topic], so hope this is relevant.`
|
|
1961
|
-
- `Hey {{first_name}}, saw you in a few conversations around [topic], so hope this is relevant.`
|
|
2013
|
+
- `Hey {{first_name}}, hope this is relevant if [buyer context] is still on your plate.` Not for shared evergreen lanes.
|
|
2014
|
+
- `Hey {{first_name}}, saw you might be interested in [topic], so hope this is relevant.` Not for shared evergreen lanes.
|
|
2015
|
+
- `Hey {{first_name}}, saw you in a few conversations around [topic], so hope this is relevant.` Not for shared evergreen lanes.
|
|
1962
2016
|
- `Hey {{first_name}}, found you in a thread about [topic], so may be off, but this seemed relevant.`
|
|
1963
2017
|
- `Hey {{first_name}}, saw you raise your hand for [topic], so figured this was (hopefully) worth sending.` Only use this for explicit lead-magnet comments, replies, or opt-ins.
|
|
1964
2018
|
- `Hey {{first_name}}, saw you raise your hand for [topic] (creepy to reach out based on that, i know) - but this felt too on the nose to ignore.` Only use this for explicit lead-magnet comments, replies, or opt-ins.
|
|
@@ -2219,9 +2273,9 @@ Rules:
|
|
|
2219
2273
|
- if `lead-sample.json` carries **any** per-lead signal for this lead — a recent post, a recent hire, a visible tool in the headline, a topic engagement, a public initiative — the **message must reference it specifically**. Category-level copy is rejected.
|
|
2220
2274
|
- default placement is **Block 3**, not Block 1. Keep Block 1 substance-first unless the archived motion clearly earns a signal-led opener without falling into source-citation / talk-at phrasing.
|
|
2221
2275
|
- acceptable signal use by default:
|
|
2222
|
-
- `"Hope this is relevant if [topic] is part of the plan."`
|
|
2223
|
-
- `"Saw you might be interested in [topic], so hope this is relevant."`
|
|
2224
|
-
- `"Saw you in a few conversations around [topic], so hope this is relevant."`
|
|
2276
|
+
- `"Hope this is relevant if [topic] is part of the plan."` Non-evergreen weak-signal only; blocked for shared evergreen lanes.
|
|
2277
|
+
- `"Saw you might be interested in [topic], so hope this is relevant."` Non-evergreen weak-signal only; blocked for shared evergreen lanes.
|
|
2278
|
+
- `"Saw you in a few conversations around [topic], so hope this is relevant."` Non-evergreen weak-signal only; blocked for shared evergreen lanes.
|
|
2225
2279
|
- `"Saw you in a few conversations about [topic], so may be off, but this seemed relevant."`
|
|
2226
2280
|
- `"Found you in a thread about [topic], so may be off, but this seemed relevant."`
|
|
2227
2281
|
- `"Thought of {{company}} because [observable signal] points at [problem]."`
|
|
@@ -2239,6 +2293,11 @@ Rules:
|
|
|
2239
2293
|
- `"Saw you raise your hand for [topic], so figured this was worth sending."`
|
|
2240
2294
|
- `"Figured this was worth sending."`
|
|
2241
2295
|
- signal-led opener shape is a **special case**, not the default. Use it only when the archived motion truly depends on it and the line can stay natural. For LinkedIn-post-sourced campaigns, prefer `"saw you in a few conversations around [topic], so hope this is relevant"` or `"found you in a thread about [topic], so may be off, but this seemed relevant"` when referencing the source makes the outreach feel less random. Avoid activity-log phrasing such as `"you commented on..."`, `"you reacted to..."`, or `"your LinkedIn activity..."` unless the approved motion is the deliberately self-aware raise-hand line for an explicit lead-magnet comment, reply, or opt-in.
|
|
2296
|
+
- For Shared Evergreen Signal Discovery, do not use the weak signal-led opener
|
|
2297
|
+
shapes above. Translate the source into a concrete problem bridge, e.g.
|
|
2298
|
+
`"The AI-assisted GTM conversations keep coming back to one problem: turning
|
|
2299
|
+
good LinkedIn signal into review-ready pipeline without another dashboard."`
|
|
2300
|
+
Then connect the product in buyer language.
|
|
2242
2301
|
- tokenized engagement-source opener shape is BLOCKED by default:
|
|
2243
2302
|
`{{first_name}}, saw you {{engagement_context}} on {{post_context}}` reads
|
|
2244
2303
|
like surveillance unless the filled line is explicitly self-aware and
|
|
@@ -2247,7 +2306,9 @@ Rules:
|
|
|
2247
2306
|
this is relevant`, `saw you in a few conversations around [topic], so hope this
|
|
2248
2307
|
is relevant`, `saw you in a few conversations about [topic], so may be off,
|
|
2249
2308
|
but this seemed relevant`, or `found you in a thread about [topic], so may be
|
|
2250
|
-
off, but this seemed relevant`.
|
|
2309
|
+
off, but this seemed relevant`. For shared evergreen lanes, those weak signal
|
|
2310
|
+
bridges are blocked; use a concrete signal/problem bridge instead. Use the
|
|
2311
|
+
self-aware raise-hand shapes only when
|
|
2251
2312
|
the source was an explicit lead-magnet comment, reply, or opt-in: `saw you raise
|
|
2252
2313
|
your hand for [topic], so figured this was (hopefully) worth sending` or `saw you
|
|
2253
2314
|
raise your hand for [topic] (creepy to reach out based on that, i know) - but
|