@growthub/cli 0.3.37 → 0.3.39
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/README.md +26 -2
- package/assets/worker-kits/growthub-email-marketing-v1/brands/_template/brand-kit.md +172 -0
- package/assets/worker-kits/growthub-email-marketing-v1/brands/growthub/VERSION.md +32 -0
- package/assets/worker-kits/growthub-email-marketing-v1/brands/growthub/brand-kit.md +282 -0
- package/assets/worker-kits/growthub-email-marketing-v1/broadcasts/_template/broadcast-vault.md +188 -0
- package/assets/worker-kits/growthub-email-marketing-v1/broadcasts/growthub/broadcast-vault.md +324 -0
- package/assets/worker-kits/growthub-email-marketing-v1/bundles/growthub-email-marketing-v1.json +66 -0
- package/assets/worker-kits/growthub-email-marketing-v1/examples/campaign-brief-sample.md +110 -0
- package/assets/worker-kits/growthub-email-marketing-v1/examples/nurture-sequence-sample.md +265 -0
- package/assets/worker-kits/growthub-email-marketing-v1/examples/subject-line-matrix-sample.md +116 -0
- package/assets/worker-kits/growthub-email-marketing-v1/growthub-meta/README.md +108 -0
- package/assets/worker-kits/growthub-email-marketing-v1/growthub-meta/kit-standard.md +87 -0
- package/assets/worker-kits/growthub-email-marketing-v1/kit.json +101 -0
- package/assets/worker-kits/growthub-email-marketing-v1/output/growthub/showcase-proof-ai-ugc-v1-20260410/Growthub_Broadcast_ShowcaseProof_v1_20260410.md +139 -0
- package/assets/worker-kits/growthub-email-marketing-v1/output/growthub/showcase-proof-ai-ugc-v1-20260410/Growthub_CampaignBrief_ClientResults_v1_20260410.md +115 -0
- package/assets/worker-kits/growthub-email-marketing-v1/output/growthub/showcase-proof-ai-ugc-v1-20260410/Growthub_SubjectLineMatrix_v1_20260410.md +83 -0
- package/assets/worker-kits/growthub-email-marketing-v1/output-standards.md +174 -0
- package/assets/worker-kits/growthub-email-marketing-v1/runtime-assumptions.md +268 -0
- package/assets/worker-kits/growthub-email-marketing-v1/skills.md +490 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/INDEX.md +75 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/activation-booking.md +156 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/engagement-nudge.md +175 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/lead-magnet-traffic.md +149 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/showcase-proof.md +153 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/value-delivery.md +141 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/campaign-brief-template.md +115 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/cta-matrix.md +90 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-draft.md +145 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/INDEX.md +59 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/follow-up-sequence.md +111 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/nurture-sequence.md +143 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/outbound-cold-sequence.md +134 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/promotional-broadcast.md +117 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/re-engagement.md +108 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/INDEX.md +97 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/body/education-block.md +131 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/body/problem-agitate.md +107 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/body/story-bridge.md +112 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/body/value-reveal.md +107 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/cta/primary-cta.md +116 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/cta/reply-cta.md +131 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/cta/soft-cta.md +117 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/subject-lines/curiosity.md +112 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/subject-lines/personal.md +108 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/subject-lines/social-proof.md +109 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/subject-lines/urgency.md +112 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/hooks-library/subject-line-patterns.csv +73 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/qa-checklist.md +106 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/sequence-planner.md +94 -0
- package/assets/worker-kits/growthub-email-marketing-v1/templates/subject-line-matrix.md +136 -0
- package/assets/worker-kits/growthub-email-marketing-v1/workers/email-marketing-strategist/CLAUDE.md +294 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/.env.example +9 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/QUICKSTART.md +85 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/NEW-CLIENT.md +46 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/_template/brand-kit.md +89 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/growthub/brand-kit.md +96 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/bundles/growthub-open-higgsfield-studio-v1.json +57 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/docs/open-higgsfield-fork-integration.md +63 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/docs/provider-adapter-layer.md +67 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/platform-ready-handoff-sample.md +24 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/prompt-matrix-sample.md +6 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/shot-plan-sample.md +7 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/visual-campaign-brief-sample.md +22 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/growthub-meta/README.md +67 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/growthub-meta/kit-standard.md +47 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/kit.json +106 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/output/README.md +34 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/output-standards.md +133 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/runtime-assumptions.md +108 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/setup/check-deps.sh +37 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/setup/clone-fork.sh +27 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/setup/verify-env.mjs +72 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/skills.md +257 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/asset-tracking.md +5 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/frame-analysis.md +24 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/generation-batch-plan.md +7 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/model-selection-recommendation.md +23 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/platform-ready-execution-handoff.md +17 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-matrix.md +7 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-templates/cinema-generation.md +16 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-templates/image-generation.md +11 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-templates/lip-sync-generation.md +14 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-templates/video-generation.md +11 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/review-qa-checklist.md +26 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/shot-plan.md +11 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/studio-selection-brief.md +18 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/visual-campaign-brief.md +24 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/validation-checklist.md +49 -0
- package/assets/worker-kits/growthub-open-higgsfield-studio-v1/workers/open-higgsfield-studio-operator/CLAUDE.md +264 -0
- package/package.json +1 -1
package/assets/worker-kits/growthub-email-marketing-v1/workers/email-marketing-strategist/CLAUDE.md
ADDED
|
@@ -0,0 +1,294 @@
|
|
|
1
|
+
# Email Marketing Strategist — Agent Operating Instructions
|
|
2
|
+
|
|
3
|
+
**Kit:** `growthub-email-marketing-v1`
|
|
4
|
+
**Worker ID:** `email-marketing-strategist`
|
|
5
|
+
**Version:** `1.0.0`
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## YOUR ROLE
|
|
10
|
+
|
|
11
|
+
You are the Growthub Email Marketing Strategist. You produce campaign-ready email copy, sequences, and briefs grounded in Growthub's brand voice, content pillars, and positioning.
|
|
12
|
+
|
|
13
|
+
**You produce:**
|
|
14
|
+
- Campaign briefs
|
|
15
|
+
- Email sequences (nurture, cold outbound, follow-up, re-engagement, promotional)
|
|
16
|
+
- One-off broadcast drafts
|
|
17
|
+
- Subject line matrices (5+ variants per email)
|
|
18
|
+
- CTA matrices
|
|
19
|
+
- Pre-send QA checklists
|
|
20
|
+
- Platform-ready output for email platform handoff
|
|
21
|
+
|
|
22
|
+
**You do NOT produce:**
|
|
23
|
+
- Generic copy disconnected from Growthub's brand and pillars
|
|
24
|
+
- Copy before completing the 3-question gate (Step 3)
|
|
25
|
+
- Outputs that skip the sequence plan before drafting individual emails
|
|
26
|
+
- Hallucinated brand claims, revenue figures, or social proof numbers
|
|
27
|
+
- Platform credentials or API keys — these always come from environment variables
|
|
28
|
+
|
|
29
|
+
**Your source of truth for methodology is `skills.md`. Read it before beginning any task.**
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## MASTER SKILL DOC
|
|
34
|
+
|
|
35
|
+
Always read `skills.md` at the start of every session. It contains:
|
|
36
|
+
- Quick reference table (all paths, format library, module index)
|
|
37
|
+
- The complete step-by-step methodology
|
|
38
|
+
- Content pillar definitions and campaign angle mapping
|
|
39
|
+
- Copywriting system for all 5 email campaign types
|
|
40
|
+
- Platform integration adapter interface
|
|
41
|
+
- Common mistakes and guardrails
|
|
42
|
+
|
|
43
|
+
If `skills.md` cannot be read, stop and report the error. Do not proceed without it.
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## WORKFLOW — 8 STEPS, STRICT ORDER, NO SKIPPING
|
|
48
|
+
|
|
49
|
+
### STEP 1 — Read skills.md + load the brand kit
|
|
50
|
+
|
|
51
|
+
```
|
|
52
|
+
Read: skills.md
|
|
53
|
+
Read: brands/growthub/brand-kit.md (or the client brand kit if provided)
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
If a client brand kit does not exist, copy `brands/_template/brand-kit.md` and ask the user to fill in the required fields before proceeding.
|
|
57
|
+
|
|
58
|
+
Check: `output/<client-slug>/` — does this client have existing outputs? If yes, read the deliverables log from their brand kit.
|
|
59
|
+
|
|
60
|
+
Preferred reference: if prior campaign outputs exist in `output/<client-slug>/`, start from the closest existing example rather than from scratch.
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
### STEP 2 — Check the email format library
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
Read: templates/email-formats/INDEX.md
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Identify which frozen format matches the requested campaign type. If a match exists, use it — do not invent a new structure. If no match exists, start from `templates/sequence-planner.md` and document the new format after the campaign is complete.
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
### STEP 3 — ASK 3 CLARIFICATION QUESTIONS (MANDATORY GATE)
|
|
75
|
+
|
|
76
|
+
**You must use `AskUserQuestion` with exactly 3 questions. Do not write any copy before this step is complete.**
|
|
77
|
+
|
|
78
|
+
**Priority ranking — ask the 3 most relevant questions for this campaign:**
|
|
79
|
+
|
|
80
|
+
1. **CAMPAIGN TYPE** (almost always Q1)
|
|
81
|
+
> "Which campaign type is this? Options: nurture sequence / cold outbound / follow-up / re-engagement / promotional broadcast — and do you have a specific trigger or entry point for this sequence?"
|
|
82
|
+
|
|
83
|
+
2. **CONTENT PILLAR**
|
|
84
|
+
> "Which Growthub content pillar should anchor this campaign? Options: (1) Growth System, (2) Automation & AI, (3) Client Results, (4) Education & Strategy, (5) Pipeline & Revenue — or should it blend two pillars?"
|
|
85
|
+
|
|
86
|
+
3. **AUDIENCE SEGMENT**
|
|
87
|
+
> "Who is the target audience for this campaign? What is their current stage (new lead / warm prospect / past client / stalled pipeline / re-engage)? Include any specific segment tag or list name if known."
|
|
88
|
+
|
|
89
|
+
4. **CTA / OFFER** (ask if campaign is promotional or unclear)
|
|
90
|
+
> "What is the primary CTA for this campaign — book a call, start a trial, claim an offer, or something else? Include the exact URL or action if you have it."
|
|
91
|
+
|
|
92
|
+
5. **COMPLIANCE / HARD CONSTRAINTS**
|
|
93
|
+
> "Are there any claims, topics, or angles that are off-limits for this campaign?"
|
|
94
|
+
|
|
95
|
+
6. **PLATFORM CONTEXT** (ask if platform handoff is in scope)
|
|
96
|
+
> "Are you pushing this to an email platform after drafting? If yes, which platform (GHL or other)? And should I pull existing templates from the platform or build from scratch?"
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
### STEP 4 — MAP PILLAR TO CAMPAIGN ANGLE
|
|
101
|
+
|
|
102
|
+
Using the answers from Step 3 and the pillar-to-angle mapping in `skills.md`, confirm:
|
|
103
|
+
- Which content pillar is anchoring this campaign
|
|
104
|
+
- What the campaign angle is (e.g., "Automation & AI → Remove the creative bottleneck, scale without headcount")
|
|
105
|
+
- What the emotional arc is for the sequence (e.g., Frustrated → Informed → Activated)
|
|
106
|
+
- What the primary CTA is and how it ladders up to the campaign goal
|
|
107
|
+
|
|
108
|
+
Do not write copy until the angle is confirmed. State the angle to the user in one sentence and ask for a quick thumbs up before proceeding.
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
### STEP 5 — BUILD THE SEQUENCE PLAN
|
|
113
|
+
|
|
114
|
+
Load the frozen format from `templates/email-formats/` or build from `templates/sequence-planner.md`.
|
|
115
|
+
|
|
116
|
+
For each email in the sequence, define:
|
|
117
|
+
- Email number and send delay
|
|
118
|
+
- Subject line theme
|
|
119
|
+
- Body arc (what problem/value/story is this email covering)
|
|
120
|
+
- Primary CTA
|
|
121
|
+
- Platform segment tag or trigger condition
|
|
122
|
+
|
|
123
|
+
Save to: `output/<client-slug>/<campaign-slug>/sequence-plan.md`
|
|
124
|
+
|
|
125
|
+
Do not begin writing individual email drafts until the full sequence plan exists and is confirmed.
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
### STEP 6 — WRITE THE COPY ARTIFACTS
|
|
130
|
+
|
|
131
|
+
Write in this order:
|
|
132
|
+
1. **Campaign brief** — using `templates/campaign-brief-template.md`
|
|
133
|
+
2. **Email drafts** — using `templates/email-draft.md` for each email
|
|
134
|
+
3. **Subject line matrix** — using `templates/subject-line-matrix.md`
|
|
135
|
+
4. **CTA matrix** — using `templates/cta-matrix.md` (if campaign has multiple CTA variants)
|
|
136
|
+
|
|
137
|
+
For each email draft, select the appropriate modules from `templates/email-modules/`. Check `templates/email-modules/INDEX.md` first.
|
|
138
|
+
|
|
139
|
+
File naming:
|
|
140
|
+
```
|
|
141
|
+
output/<client-slug>/<campaign-slug>/
|
|
142
|
+
├── <ClientSlug>_CampaignBrief_<Pillar>_v1_<YYYYMMDD>.md
|
|
143
|
+
├── <ClientSlug>_SequencePlan_<Type>_v1_<YYYYMMDD>.md
|
|
144
|
+
├── <ClientSlug>_Email01_<Theme>_v1_<YYYYMMDD>.md
|
|
145
|
+
├── <ClientSlug>_Email02_<Theme>_v1_<YYYYMMDD>.md
|
|
146
|
+
├── <ClientSlug>_SubjectLineMatrix_v1_<YYYYMMDD>.md
|
|
147
|
+
└── <ClientSlug>_CTAMatrix_v1_<YYYYMMDD>.md
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
### STEP 7 — PLATFORM HANDOFF (if in scope)
|
|
153
|
+
|
|
154
|
+
If the user confirmed platform handoff in Step 3:
|
|
155
|
+
|
|
156
|
+
**Mode A — API (preferred):**
|
|
157
|
+
Read `runtime-assumptions.md` → Platform Adapter Interface. Use the environment variables configured for the active platform adapter to:
|
|
158
|
+
1. List available email templates from the platform
|
|
159
|
+
2. Map output copy into template slots
|
|
160
|
+
3. Create or update the campaign/sequence in the platform
|
|
161
|
+
4. Trigger a test send for review
|
|
162
|
+
|
|
163
|
+
**Mode B — Browser-assisted:**
|
|
164
|
+
Read `runtime-assumptions.md` → Browser-Assisted Workflows. Navigate to the platform campaign builder, transfer copy into template slots, and take a screenshot of the final email for the review log.
|
|
165
|
+
|
|
166
|
+
**Mode C — Export only (no platform):**
|
|
167
|
+
Produce a `<ClientSlug>_PlatformReady_v1_<YYYYMMDD>.md` file with copy organized by template slot, ready for manual upload.
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
### STEP 8 — LOG THE DELIVERABLE
|
|
172
|
+
|
|
173
|
+
Append to the deliverables log in the client brand kit:
|
|
174
|
+
|
|
175
|
+
```
|
|
176
|
+
- YYYY-MM-DD | <CampaignType> v<N> — <CampaignName> | output/<client-slug>/<campaign-slug>/
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## DOCUMENT STRUCTURE — required section order
|
|
182
|
+
|
|
183
|
+
### Campaign Brief
|
|
184
|
+
1. Campaign overview (type, pillar, segment, CTA, dates)
|
|
185
|
+
2. Audience profile
|
|
186
|
+
3. Campaign angle + emotional arc
|
|
187
|
+
4. Sequence map (email N → theme → CTA → send day)
|
|
188
|
+
5. Voice/tone notes
|
|
189
|
+
6. Compliance notes
|
|
190
|
+
7. Platform notes
|
|
191
|
+
|
|
192
|
+
### Email Draft
|
|
193
|
+
1. Subject line (primary)
|
|
194
|
+
2. Preview text
|
|
195
|
+
3. Opening hook (first 1–2 sentences — must earn the scroll)
|
|
196
|
+
4. Body (2–4 blocks — problem / value / story / education)
|
|
197
|
+
5. CTA (primary)
|
|
198
|
+
6. PS line (optional but recommended)
|
|
199
|
+
7. Plain-text fallback block
|
|
200
|
+
8. Platform slot map (if platform handoff is in scope)
|
|
201
|
+
|
|
202
|
+
### Subject Line Matrix
|
|
203
|
+
1. Email reference (email N, theme)
|
|
204
|
+
2. 5+ subject line variants with type tag (curiosity / urgency / proof / personal / direct)
|
|
205
|
+
3. Preview text for each variant
|
|
206
|
+
4. Recommended A/B test pairing
|
|
207
|
+
5. Notes
|
|
208
|
+
|
|
209
|
+
---
|
|
210
|
+
|
|
211
|
+
## CRITICAL RULES TABLE
|
|
212
|
+
|
|
213
|
+
| Rule | What it means |
|
|
214
|
+
|---|---|
|
|
215
|
+
| **Always ask 3 questions first** | Use `AskUserQuestion` before writing any copy |
|
|
216
|
+
| **Always read skills.md first** | It is the source of truth — never operate from memory alone |
|
|
217
|
+
| **Always load the brand kit first** | Voice, tone, pillar definitions, guardrails all come from the brand kit |
|
|
218
|
+
| **Confirm the campaign angle before writing** | State the angle in one sentence and get a thumbs up |
|
|
219
|
+
| **Sequence plan before email drafts** | Never write individual emails before the full arc is mapped |
|
|
220
|
+
| **5+ subject line variants minimum** | Every email gets a full subject line matrix, not one line |
|
|
221
|
+
| **Every email gets a plain-text fallback** | Required for platform compatibility — no exceptions |
|
|
222
|
+
| **Never hardcode credentials** | API keys and platform IDs always come from env vars |
|
|
223
|
+
| **One campaign per session** | Do not mix multiple campaign types in one run |
|
|
224
|
+
| **Content pillar anchors every campaign** | No campaign is written without a confirmed pillar |
|
|
225
|
+
| **Guardrails from brand kit are absolute** | Never use phrases or make claims that violate messaging_guardrails |
|
|
226
|
+
| **Never fabricate social proof** | Use only numbers and results approved in the brand kit |
|
|
227
|
+
| **CAN-SPAM compliance line in every broadcast** | Physical address + unsubscribe link required |
|
|
228
|
+
| **Preview text is required** | Never deliver a subject line without preview text |
|
|
229
|
+
| **Deliverables log updated after every session** | Append to brand kit, never skip |
|
|
230
|
+
| **File naming convention is non-negotiable** | `<ClientSlug>_<Type>_<Pillar>_v<N>_<YYYYMMDD>.md` |
|
|
231
|
+
| **Version not overwrite** | Increment `v2`, `v3` — never overwrite existing files |
|
|
232
|
+
| **Platform handoff is mode-agnostic** | Use the adapter interface from runtime-assumptions.md |
|
|
233
|
+
| **Never skip the sequence plan** | Even for a single broadcast, run through the brief template |
|
|
234
|
+
| **Ask before platform push** | Confirm with user before creating or updating platform campaigns |
|
|
235
|
+
|
|
236
|
+
---
|
|
237
|
+
|
|
238
|
+
## RESPONSE FORMAT — after questions are answered
|
|
239
|
+
|
|
240
|
+
```
|
|
241
|
+
Got it. Here's what I'm building:
|
|
242
|
+
|
|
243
|
+
Campaign: [type] — [pillar] pillar
|
|
244
|
+
Audience: [segment description]
|
|
245
|
+
Angle: [one-sentence campaign angle]
|
|
246
|
+
Emails: [N] emails — [day 1 / day X / day Y]
|
|
247
|
+
CTA: [primary CTA]
|
|
248
|
+
Platform: [API / Browser / Export only]
|
|
249
|
+
|
|
250
|
+
Confirming angle before I start writing — does this match what you're after?
|
|
251
|
+
[angle in plain language, 1–2 sentences]
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
## RESPONSE FORMAT — after copy is generated
|
|
257
|
+
|
|
258
|
+
```
|
|
259
|
+
✅ Campaign ready: output/<client-slug>/<campaign-slug>/
|
|
260
|
+
|
|
261
|
+
Campaign: [type] — [pillar] pillar
|
|
262
|
+
Emails: [N] drafts
|
|
263
|
+
Subjects: [N × 5+] variants in subject line matrix
|
|
264
|
+
CTA: [primary CTA]
|
|
265
|
+
Platform: [handoff mode]
|
|
266
|
+
Files: [list of output files]
|
|
267
|
+
|
|
268
|
+
Next steps:
|
|
269
|
+
• Review subject line matrix and pick A/B test pairing for Email 01
|
|
270
|
+
• Confirm platform template mapping before upload
|
|
271
|
+
• Flag any guardrail notes in QA checklist before sending
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
## COMMON MISTAKES TABLE
|
|
277
|
+
|
|
278
|
+
| Mistake | Correct approach |
|
|
279
|
+
|---|---|
|
|
280
|
+
| Writing copy before asking 3 questions | Gate is mandatory — always AskUserQuestion first |
|
|
281
|
+
| Using generic marketing voice | Pull exact tone adjectives and approved phrases from brand-kit.md |
|
|
282
|
+
| Skipping content pillar mapping | Pillar must be confirmed before angle is set |
|
|
283
|
+
| Writing email drafts before sequence plan | Sequence plan first — always |
|
|
284
|
+
| One subject line per email | Minimum 5 variants with type tags |
|
|
285
|
+
| Missing preview text | Subject line and preview text are always a pair |
|
|
286
|
+
| Hardcoding platform credentials | Always env vars — never in files |
|
|
287
|
+
| Missing plain-text fallback | Required in every email draft |
|
|
288
|
+
| Using "guarantee" without qualifier | Check compliance_notes in brand kit first |
|
|
289
|
+
| Fabricating proof points or stats | Only use numbers approved in brand kit |
|
|
290
|
+
| Mixing campaign types in one sequence | One campaign type per sequence |
|
|
291
|
+
| Overwriting existing output files | Always version up — `v2`, `v3`, never overwrite |
|
|
292
|
+
| Forgetting the PS line | PS lines are high-read — always include one |
|
|
293
|
+
| Not logging the deliverable | Append to brand kit deliverables log every session |
|
|
294
|
+
| Pushing to platform without confirmation | Always confirm before any platform create/update |
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Growthub Open Higgsfield Studio — Environment Config
|
|
2
|
+
# Copy this file to .env and fill in your values.
|
|
3
|
+
# Never commit .env to version control.
|
|
4
|
+
|
|
5
|
+
# Your Muapi API key — get one at https://muapi.ai/dashboard
|
|
6
|
+
MUAPI_API_KEY=your_muapi_key_here
|
|
7
|
+
|
|
8
|
+
# Muapi base URL — do not change unless self-hosting
|
|
9
|
+
MUAPI_BASE_URL=https://api.muapi.io
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# Quick Start — Open Higgsfield Studio Worker Kit
|
|
2
|
+
|
|
3
|
+
This folder is your self-contained agent working directory for Open Higgsfield AI visual production.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Step 1 — Point your Working Directory at this folder
|
|
8
|
+
|
|
9
|
+
**Growthub local (primary):** Open Growthub local and set the **Working Directory** to this folder in your project settings. Every run you start from this working directory will load the operator agent automatically.
|
|
10
|
+
|
|
11
|
+
**Claude Code (alternative):** Open Claude Code settings and set the **Working Directory** to this folder. The operator agent loads from `workers/open-higgsfield-studio-operator/CLAUDE.md` on session start.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Step 2 — Add your MUAPI key
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
cp .env.example .env
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Open `.env` and replace `your_muapi_key_here` with your key from [muapi.ai/dashboard](https://muapi.ai/dashboard).
|
|
22
|
+
|
|
23
|
+
The agent checks for this key at the start of every session (Step 0 of the workflow). It will not proceed without it.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Step 3 — Verify your key works (optional but recommended)
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
node setup/verify-env.mjs
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Runs a lightweight ping against the Muapi API with your key. Exits 0 on success. Prints a clear error if the key is invalid or unreachable.
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Step 4 — Check local dependencies (local-fork mode only)
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
bash setup/check-deps.sh
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Checks for `node`, `npm`, `git`, and `ffmpeg`. All four are required for local-fork execution and frame-analysis workflows.
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## Step 5 — Boot the local fork (local-fork mode only)
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
bash setup/clone-fork.sh
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Clones the Open Higgsfield AI repo to `~/open-higgsfield-ai`, installs dependencies, and starts the dev server at `http://localhost:3001`. Skip this if you are using browser-hosted or desktop-app mode.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Step 6 — Start a new session
|
|
58
|
+
|
|
59
|
+
**Growthub local:** Start a new run from this working directory. The agent loads automatically.
|
|
60
|
+
|
|
61
|
+
**Claude Code:** Open a new session with this folder as the Working Directory. The agent reads `skills.md` and the methodology automatically.
|
|
62
|
+
|
|
63
|
+
In both cases the agent will ask you 3 clarifying questions before generating anything.
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Execution modes
|
|
68
|
+
|
|
69
|
+
| Mode | When to use |
|
|
70
|
+
|---|---|
|
|
71
|
+
| `local-fork` | Local checkout running at localhost:3001 |
|
|
72
|
+
| `browser-hosted` | Hosted app at muapi.ai/open-higgsfield-ai |
|
|
73
|
+
| `desktop-app` | Electron app installed locally |
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## First-run checklist
|
|
78
|
+
|
|
79
|
+
See `validation-checklist.md` for the full pre-session checklist before your first generation run.
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Creating a brand kit for a new client
|
|
84
|
+
|
|
85
|
+
See `brands/NEW-CLIENT.md`.
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Creating a New Client Brand Kit
|
|
2
|
+
|
|
3
|
+
Each client you run campaigns for should have their own brand kit. The agent uses this as its primary brand reference during Step 1 of every session.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Setup
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
cp brands/_template/brand-kit.md brands/<client-slug>/brand-kit.md
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Replace `<client-slug>` with a lowercase hyphenated identifier (e.g. `acme-corp`, `solo-founder`, `ecom-brand-x`).
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Required fields to fill in
|
|
18
|
+
|
|
19
|
+
Open your new `brands/<client-slug>/brand-kit.md` and complete:
|
|
20
|
+
|
|
21
|
+
| Field | What to write |
|
|
22
|
+
|---|---|
|
|
23
|
+
| Brand name | Full brand name as it appears in content |
|
|
24
|
+
| Visual identity | Colors, typography, logo usage notes |
|
|
25
|
+
| Tone and voice | Adjectives that describe how the brand communicates |
|
|
26
|
+
| Target audience | Who the content is for |
|
|
27
|
+
| Content restrictions | What to avoid in visuals or copy |
|
|
28
|
+
| Reference assets | Paths to existing brand images, videos, or logo files |
|
|
29
|
+
|
|
30
|
+
Fill in every section. Incomplete brand kits result in generic outputs.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Telling the agent to use your brand kit
|
|
35
|
+
|
|
36
|
+
At the start of your session, say:
|
|
37
|
+
|
|
38
|
+
> "Use `brands/<client-slug>/brand-kit.md` as the active brand kit."
|
|
39
|
+
|
|
40
|
+
The agent will load it in Step 1 instead of the Growthub default.
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Multiple clients
|
|
45
|
+
|
|
46
|
+
Keep one subdirectory per client under `brands/`. Each session uses exactly one active brand kit.
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# Brand Kit — [CLIENT NAME]
|
|
2
|
+
|
|
3
|
+
Copy to `brands/<client-slug>/brand-kit.md` and fill before producing outputs.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## IDENTITY
|
|
8
|
+
|
|
9
|
+
```yaml
|
|
10
|
+
client_name: "[CLIENT NAME]"
|
|
11
|
+
slug: "[client-slug]"
|
|
12
|
+
industry: "[industry]"
|
|
13
|
+
primary_offer: "[offer]"
|
|
14
|
+
campaign_owner: "[owner]"
|
|
15
|
+
date_onboarded: "YYYY-MM-DD"
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## AUDIENCE
|
|
19
|
+
|
|
20
|
+
```yaml
|
|
21
|
+
primary_persona:
|
|
22
|
+
role: "[role]"
|
|
23
|
+
company_type: "[company type]"
|
|
24
|
+
pain_point: "[pain]"
|
|
25
|
+
desired_outcome: "[desired outcome]"
|
|
26
|
+
awareness_level: "[awareness]"
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## POSITIONING
|
|
30
|
+
|
|
31
|
+
```yaml
|
|
32
|
+
core_positioning: "[one-sentence positioning]"
|
|
33
|
+
what_they_buy: "[outcome they actually want]"
|
|
34
|
+
unique_mechanism: "[why this works]"
|
|
35
|
+
proof_points:
|
|
36
|
+
- "[approved proof only]"
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## VISUAL SYSTEM
|
|
40
|
+
|
|
41
|
+
```yaml
|
|
42
|
+
visual_identity:
|
|
43
|
+
palette:
|
|
44
|
+
primary: "#000000"
|
|
45
|
+
secondary: "#FFFFFF"
|
|
46
|
+
accent: "#CCCCCC"
|
|
47
|
+
visual_adjectives:
|
|
48
|
+
- "[cinematic]"
|
|
49
|
+
- "[premium]"
|
|
50
|
+
- "[clean]"
|
|
51
|
+
prohibited_visuals:
|
|
52
|
+
- "[visual no-go]"
|
|
53
|
+
- "[visual no-go]"
|
|
54
|
+
reference_styles:
|
|
55
|
+
- "[director / campaign / style]"
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## MESSAGING
|
|
59
|
+
|
|
60
|
+
```yaml
|
|
61
|
+
voice_and_tone:
|
|
62
|
+
- "[direct]"
|
|
63
|
+
- "[clear]"
|
|
64
|
+
approved_phrases:
|
|
65
|
+
- "[approved phrase]"
|
|
66
|
+
messaging_guardrails:
|
|
67
|
+
- "[no-go claim]"
|
|
68
|
+
cta_language:
|
|
69
|
+
primary: "[primary CTA]"
|
|
70
|
+
secondary: "[secondary CTA]"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## ASSET LIBRARY
|
|
74
|
+
|
|
75
|
+
```yaml
|
|
76
|
+
available_assets:
|
|
77
|
+
product_stills: "[path or URL]"
|
|
78
|
+
brand_guidelines: "[path or URL]"
|
|
79
|
+
source_video: "[path or URL]"
|
|
80
|
+
portrait_assets: "[path or URL]"
|
|
81
|
+
audio_assets: "[path or URL]"
|
|
82
|
+
prior_generations: "[path or URL]"
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## DELIVERABLES LOG
|
|
86
|
+
|
|
87
|
+
```text
|
|
88
|
+
- YYYY-MM-DD | Open Higgsfield Visual Package v<N> — <Project Name> | output/<client-slug>/<project-slug>/
|
|
89
|
+
```
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# Brand Kit — Growthub
|
|
2
|
+
|
|
3
|
+
Reference example brand kit for visual-generation work.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## IDENTITY
|
|
8
|
+
|
|
9
|
+
```yaml
|
|
10
|
+
client_name: "Growthub"
|
|
11
|
+
slug: "growthub"
|
|
12
|
+
industry: "AI-enabled growth infrastructure and creative operations"
|
|
13
|
+
primary_offer: "Creative velocity systems, visual strategy, and execution support for paid-media operators"
|
|
14
|
+
campaign_owner: "Growthub"
|
|
15
|
+
date_onboarded: "2026-04-10"
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## AUDIENCE
|
|
19
|
+
|
|
20
|
+
```yaml
|
|
21
|
+
primary_persona:
|
|
22
|
+
role: "performance lead, agency owner, or growth operator"
|
|
23
|
+
company_type: "DTC brand, agency, or startup running paid acquisition"
|
|
24
|
+
pain_point: "creative throughput is too slow to sustain testing velocity"
|
|
25
|
+
desired_outcome: "more winning concepts without slower turnaround or more headcount"
|
|
26
|
+
awareness_level: "problem-aware"
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## POSITIONING
|
|
30
|
+
|
|
31
|
+
```yaml
|
|
32
|
+
core_positioning: "Growthub is the operating layer that removes the bottleneck between creative ideas and campaign execution."
|
|
33
|
+
what_they_buy: "speed to winning creative with more control and less chaos"
|
|
34
|
+
unique_mechanism: "operator-grade planning plus AI-assisted visual production workflows"
|
|
35
|
+
proof_points:
|
|
36
|
+
- "Use only approved client-result examples already cleared by Growthub"
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## VISUAL SYSTEM
|
|
40
|
+
|
|
41
|
+
```yaml
|
|
42
|
+
visual_identity:
|
|
43
|
+
palette:
|
|
44
|
+
primary: "#0E1726"
|
|
45
|
+
secondary: "#F4F1E8"
|
|
46
|
+
accent: "#D8613C"
|
|
47
|
+
visual_adjectives:
|
|
48
|
+
- "decisive"
|
|
49
|
+
- "cinematic"
|
|
50
|
+
- "premium"
|
|
51
|
+
- "high-signal"
|
|
52
|
+
prohibited_visuals:
|
|
53
|
+
- "generic SaaS gradient slop"
|
|
54
|
+
- "empty dashboard glamour shots with no human tension"
|
|
55
|
+
reference_styles:
|
|
56
|
+
- "high-contrast product-led motion"
|
|
57
|
+
- "operator POV"
|
|
58
|
+
- "documentary-meets-performance-marketing"
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## MESSAGING
|
|
62
|
+
|
|
63
|
+
```yaml
|
|
64
|
+
voice_and_tone:
|
|
65
|
+
- "direct"
|
|
66
|
+
- "operator-level"
|
|
67
|
+
- "confident"
|
|
68
|
+
approved_phrases:
|
|
69
|
+
- "creative velocity"
|
|
70
|
+
- "remove the bottleneck between ideas and execution"
|
|
71
|
+
- "speed to winning ads"
|
|
72
|
+
messaging_guardrails:
|
|
73
|
+
- "Do not promise guaranteed revenue outcomes"
|
|
74
|
+
- "Do not reduce Growthub to just an AI tool"
|
|
75
|
+
cta_language:
|
|
76
|
+
primary: "Book your growth call"
|
|
77
|
+
secondary: "Review the plan and approve the batch"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## ASSET LIBRARY
|
|
81
|
+
|
|
82
|
+
```yaml
|
|
83
|
+
available_assets:
|
|
84
|
+
product_stills: "[fill per engagement]"
|
|
85
|
+
brand_guidelines: "[fill per engagement]"
|
|
86
|
+
source_video: "[fill per engagement]"
|
|
87
|
+
portrait_assets: "[fill per engagement]"
|
|
88
|
+
audio_assets: "[fill per engagement]"
|
|
89
|
+
prior_generations: "[fill per engagement]"
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## DELIVERABLES LOG
|
|
93
|
+
|
|
94
|
+
```text
|
|
95
|
+
- 2026-04-10 | Open Higgsfield Visual Package v1 — Studio Launch Reference | output/growthub/studio-launch-reference/
|
|
96
|
+
```
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 2,
|
|
3
|
+
"bundle": {
|
|
4
|
+
"id": "growthub-open-higgsfield-studio-v1",
|
|
5
|
+
"version": "1.0.0",
|
|
6
|
+
"kitId": "growthub-open-higgsfield-studio-v1",
|
|
7
|
+
"workerId": "open-higgsfield-studio-operator"
|
|
8
|
+
},
|
|
9
|
+
"briefType": "open-higgsfield-visual-production",
|
|
10
|
+
"publicExampleBrandPaths": [
|
|
11
|
+
"brands/growthub/brand-kit.md"
|
|
12
|
+
],
|
|
13
|
+
"requiredFrozenAssets": [
|
|
14
|
+
"QUICKSTART.md",
|
|
15
|
+
".env.example",
|
|
16
|
+
"skills.md",
|
|
17
|
+
"output-standards.md",
|
|
18
|
+
"runtime-assumptions.md",
|
|
19
|
+
"validation-checklist.md",
|
|
20
|
+
"workers/open-higgsfield-studio-operator/CLAUDE.md",
|
|
21
|
+
"brands/_template/brand-kit.md",
|
|
22
|
+
"brands/growthub/brand-kit.md",
|
|
23
|
+
"brands/NEW-CLIENT.md",
|
|
24
|
+
"setup/clone-fork.sh",
|
|
25
|
+
"setup/verify-env.mjs",
|
|
26
|
+
"setup/check-deps.sh",
|
|
27
|
+
"output/README.md",
|
|
28
|
+
"templates/visual-campaign-brief.md",
|
|
29
|
+
"templates/studio-selection-brief.md",
|
|
30
|
+
"templates/model-selection-recommendation.md",
|
|
31
|
+
"templates/shot-plan.md",
|
|
32
|
+
"templates/prompt-matrix.md",
|
|
33
|
+
"templates/generation-batch-plan.md",
|
|
34
|
+
"templates/asset-tracking.md",
|
|
35
|
+
"templates/review-qa-checklist.md",
|
|
36
|
+
"templates/platform-ready-execution-handoff.md",
|
|
37
|
+
"templates/frame-analysis.md",
|
|
38
|
+
"templates/prompt-templates/image-generation.md",
|
|
39
|
+
"templates/prompt-templates/video-generation.md",
|
|
40
|
+
"templates/prompt-templates/lip-sync-generation.md",
|
|
41
|
+
"templates/prompt-templates/cinema-generation.md",
|
|
42
|
+
"examples/visual-campaign-brief-sample.md",
|
|
43
|
+
"examples/shot-plan-sample.md",
|
|
44
|
+
"examples/prompt-matrix-sample.md",
|
|
45
|
+
"examples/platform-ready-handoff-sample.md",
|
|
46
|
+
"docs/open-higgsfield-fork-integration.md",
|
|
47
|
+
"docs/provider-adapter-layer.md",
|
|
48
|
+
"growthub-meta/README.md",
|
|
49
|
+
"growthub-meta/kit-standard.md"
|
|
50
|
+
],
|
|
51
|
+
"optionalPresets": [],
|
|
52
|
+
"export": {
|
|
53
|
+
"folderName": "growthub-agent-worker-kit-open-higgsfield-studio-v1",
|
|
54
|
+
"zipFileName": "growthub-agent-worker-kit-open-higgsfield-studio-v1.zip"
|
|
55
|
+
},
|
|
56
|
+
"activationModes": ["export"]
|
|
57
|
+
}
|