@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.
Files changed (90) hide show
  1. package/README.md +26 -2
  2. package/assets/worker-kits/growthub-email-marketing-v1/brands/_template/brand-kit.md +172 -0
  3. package/assets/worker-kits/growthub-email-marketing-v1/brands/growthub/VERSION.md +32 -0
  4. package/assets/worker-kits/growthub-email-marketing-v1/brands/growthub/brand-kit.md +282 -0
  5. package/assets/worker-kits/growthub-email-marketing-v1/broadcasts/_template/broadcast-vault.md +188 -0
  6. package/assets/worker-kits/growthub-email-marketing-v1/broadcasts/growthub/broadcast-vault.md +324 -0
  7. package/assets/worker-kits/growthub-email-marketing-v1/bundles/growthub-email-marketing-v1.json +66 -0
  8. package/assets/worker-kits/growthub-email-marketing-v1/examples/campaign-brief-sample.md +110 -0
  9. package/assets/worker-kits/growthub-email-marketing-v1/examples/nurture-sequence-sample.md +265 -0
  10. package/assets/worker-kits/growthub-email-marketing-v1/examples/subject-line-matrix-sample.md +116 -0
  11. package/assets/worker-kits/growthub-email-marketing-v1/growthub-meta/README.md +108 -0
  12. package/assets/worker-kits/growthub-email-marketing-v1/growthub-meta/kit-standard.md +87 -0
  13. package/assets/worker-kits/growthub-email-marketing-v1/kit.json +101 -0
  14. package/assets/worker-kits/growthub-email-marketing-v1/output/growthub/showcase-proof-ai-ugc-v1-20260410/Growthub_Broadcast_ShowcaseProof_v1_20260410.md +139 -0
  15. package/assets/worker-kits/growthub-email-marketing-v1/output/growthub/showcase-proof-ai-ugc-v1-20260410/Growthub_CampaignBrief_ClientResults_v1_20260410.md +115 -0
  16. package/assets/worker-kits/growthub-email-marketing-v1/output/growthub/showcase-proof-ai-ugc-v1-20260410/Growthub_SubjectLineMatrix_v1_20260410.md +83 -0
  17. package/assets/worker-kits/growthub-email-marketing-v1/output-standards.md +174 -0
  18. package/assets/worker-kits/growthub-email-marketing-v1/runtime-assumptions.md +268 -0
  19. package/assets/worker-kits/growthub-email-marketing-v1/skills.md +490 -0
  20. package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/INDEX.md +75 -0
  21. package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/activation-booking.md +156 -0
  22. package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/engagement-nudge.md +175 -0
  23. package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/lead-magnet-traffic.md +149 -0
  24. package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/showcase-proof.md +153 -0
  25. package/assets/worker-kits/growthub-email-marketing-v1/templates/broadcast-formats/value-delivery.md +141 -0
  26. package/assets/worker-kits/growthub-email-marketing-v1/templates/campaign-brief-template.md +115 -0
  27. package/assets/worker-kits/growthub-email-marketing-v1/templates/cta-matrix.md +90 -0
  28. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-draft.md +145 -0
  29. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/INDEX.md +59 -0
  30. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/follow-up-sequence.md +111 -0
  31. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/nurture-sequence.md +143 -0
  32. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/outbound-cold-sequence.md +134 -0
  33. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/promotional-broadcast.md +117 -0
  34. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-formats/re-engagement.md +108 -0
  35. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/INDEX.md +97 -0
  36. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/body/education-block.md +131 -0
  37. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/body/problem-agitate.md +107 -0
  38. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/body/story-bridge.md +112 -0
  39. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/body/value-reveal.md +107 -0
  40. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/cta/primary-cta.md +116 -0
  41. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/cta/reply-cta.md +131 -0
  42. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/cta/soft-cta.md +117 -0
  43. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/subject-lines/curiosity.md +112 -0
  44. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/subject-lines/personal.md +108 -0
  45. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/subject-lines/social-proof.md +109 -0
  46. package/assets/worker-kits/growthub-email-marketing-v1/templates/email-modules/subject-lines/urgency.md +112 -0
  47. package/assets/worker-kits/growthub-email-marketing-v1/templates/hooks-library/subject-line-patterns.csv +73 -0
  48. package/assets/worker-kits/growthub-email-marketing-v1/templates/qa-checklist.md +106 -0
  49. package/assets/worker-kits/growthub-email-marketing-v1/templates/sequence-planner.md +94 -0
  50. package/assets/worker-kits/growthub-email-marketing-v1/templates/subject-line-matrix.md +136 -0
  51. package/assets/worker-kits/growthub-email-marketing-v1/workers/email-marketing-strategist/CLAUDE.md +294 -0
  52. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/.env.example +9 -0
  53. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/QUICKSTART.md +85 -0
  54. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/NEW-CLIENT.md +46 -0
  55. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/_template/brand-kit.md +89 -0
  56. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/growthub/brand-kit.md +96 -0
  57. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/bundles/growthub-open-higgsfield-studio-v1.json +57 -0
  58. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/docs/open-higgsfield-fork-integration.md +63 -0
  59. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/docs/provider-adapter-layer.md +67 -0
  60. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/platform-ready-handoff-sample.md +24 -0
  61. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/prompt-matrix-sample.md +6 -0
  62. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/shot-plan-sample.md +7 -0
  63. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/visual-campaign-brief-sample.md +22 -0
  64. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/growthub-meta/README.md +67 -0
  65. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/growthub-meta/kit-standard.md +47 -0
  66. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/kit.json +106 -0
  67. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/output/README.md +34 -0
  68. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/output-standards.md +133 -0
  69. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/runtime-assumptions.md +108 -0
  70. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/setup/check-deps.sh +37 -0
  71. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/setup/clone-fork.sh +27 -0
  72. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/setup/verify-env.mjs +72 -0
  73. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/skills.md +257 -0
  74. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/asset-tracking.md +5 -0
  75. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/frame-analysis.md +24 -0
  76. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/generation-batch-plan.md +7 -0
  77. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/model-selection-recommendation.md +23 -0
  78. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/platform-ready-execution-handoff.md +17 -0
  79. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-matrix.md +7 -0
  80. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-templates/cinema-generation.md +16 -0
  81. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-templates/image-generation.md +11 -0
  82. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-templates/lip-sync-generation.md +14 -0
  83. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/prompt-templates/video-generation.md +11 -0
  84. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/review-qa-checklist.md +26 -0
  85. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/shot-plan.md +11 -0
  86. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/studio-selection-brief.md +18 -0
  87. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/templates/visual-campaign-brief.md +24 -0
  88. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/validation-checklist.md +49 -0
  89. package/assets/worker-kits/growthub-open-higgsfield-studio-v1/workers/open-higgsfield-studio-operator/CLAUDE.md +264 -0
  90. package/package.json +1 -1
@@ -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
+ }