@growthub/cli 0.3.56 → 0.3.57
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/assets/worker-kits/growthub-zernio-social-v1/QUICKSTART.md +209 -0
- package/assets/worker-kits/growthub-zernio-social-v1/brands/NEW-CLIENT.md +74 -0
- package/assets/worker-kits/growthub-zernio-social-v1/brands/_template/brand-kit.md +131 -0
- package/assets/worker-kits/growthub-zernio-social-v1/brands/growthub/brand-kit.md +141 -0
- package/assets/worker-kits/growthub-zernio-social-v1/bundles/growthub-zernio-social-v1.json +55 -0
- package/assets/worker-kits/growthub-zernio-social-v1/docs/ai-caption-layer.md +132 -0
- package/assets/worker-kits/growthub-zernio-social-v1/docs/local-adapters.md +123 -0
- package/assets/worker-kits/growthub-zernio-social-v1/docs/platform-coverage.md +112 -0
- package/assets/worker-kits/growthub-zernio-social-v1/docs/postiz-ui-shell-integration.md +166 -0
- package/assets/worker-kits/growthub-zernio-social-v1/docs/posts-and-queues-layer.md +208 -0
- package/assets/worker-kits/growthub-zernio-social-v1/docs/zernio-api-integration.md +265 -0
- package/assets/worker-kits/growthub-zernio-social-v1/examples/analytics-brief-sample.md +97 -0
- package/assets/worker-kits/growthub-zernio-social-v1/examples/client-proposal-sample.md +106 -0
- package/assets/worker-kits/growthub-zernio-social-v1/examples/content-calendar-sample.md +74 -0
- package/assets/worker-kits/growthub-zernio-social-v1/examples/social-campaign-sample.md +105 -0
- package/assets/worker-kits/growthub-zernio-social-v1/growthub-meta/README.md +146 -0
- package/assets/worker-kits/growthub-zernio-social-v1/growthub-meta/kit-standard.md +120 -0
- package/assets/worker-kits/growthub-zernio-social-v1/kit.json +104 -0
- package/assets/worker-kits/growthub-zernio-social-v1/output/README.md +63 -0
- package/assets/worker-kits/growthub-zernio-social-v1/output-standards.md +132 -0
- package/assets/worker-kits/growthub-zernio-social-v1/runtime-assumptions.md +170 -0
- package/assets/worker-kits/growthub-zernio-social-v1/setup/check-deps.mjs +117 -0
- package/assets/worker-kits/growthub-zernio-social-v1/setup/check-deps.sh +86 -0
- package/assets/worker-kits/growthub-zernio-social-v1/setup/install-mcp.mjs +177 -0
- package/assets/worker-kits/growthub-zernio-social-v1/setup/setup.mjs +247 -0
- package/assets/worker-kits/growthub-zernio-social-v1/setup/verify-env.mjs +138 -0
- package/assets/worker-kits/growthub-zernio-social-v1/skills.md +332 -0
- package/assets/worker-kits/growthub-zernio-social-v1/templates/analytics-brief.md +101 -0
- package/assets/worker-kits/growthub-zernio-social-v1/templates/caption-copy-deck.md +105 -0
- package/assets/worker-kits/growthub-zernio-social-v1/templates/client-proposal.md +98 -0
- package/assets/worker-kits/growthub-zernio-social-v1/templates/content-calendar.md +70 -0
- package/assets/worker-kits/growthub-zernio-social-v1/templates/platform-publishing-plan.md +86 -0
- package/assets/worker-kits/growthub-zernio-social-v1/templates/scheduling-manifest.md +92 -0
- package/assets/worker-kits/growthub-zernio-social-v1/templates/social-campaign-brief.md +102 -0
- package/assets/worker-kits/growthub-zernio-social-v1/validation-checklist.md +85 -0
- package/assets/worker-kits/growthub-zernio-social-v1/workers/zernio-social-operator/CLAUDE.md +307 -0
- package/package.json +1 -1
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
# Growthub Zernio Social Media Studio — Quickstart
|
|
2
|
+
|
|
3
|
+
**Kit:** `growthub-zernio-social-v1`
|
|
4
|
+
**Worker:** `zernio-social-operator`
|
|
5
|
+
**Platform:** [Zernio](https://zernio.com) — unified social media REST API for developers and AI agents
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## What This Kit Does
|
|
10
|
+
|
|
11
|
+
The Growthub Zernio Social Media Studio is a self-contained AI agent environment for planning, drafting, scheduling, and analyzing social media campaigns against the Zernio REST API. It produces:
|
|
12
|
+
|
|
13
|
+
- Social campaign briefs (objective, platforms, audience, KPIs)
|
|
14
|
+
- 30/60/90-day content calendars with theme pillars
|
|
15
|
+
- Platform publishing plans for 14 social networks
|
|
16
|
+
- Caption copy decks with A/B/C variants per post
|
|
17
|
+
- Zernio-shaped scheduling manifests (`POST /api/v1/posts`) + recurring queue definitions
|
|
18
|
+
- Analytics briefings (engagement, reach, growth signals)
|
|
19
|
+
- Client-ready proposals with platform mix and ROI projections
|
|
20
|
+
|
|
21
|
+
Supported platforms: X/Twitter, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Google Business, Telegram, Snapchat, WhatsApp. See `docs/platform-coverage.md` for the full list.
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Setup — One Command (Mac / Windows / Linux)
|
|
26
|
+
|
|
27
|
+
From the exported kit folder:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
node setup/setup.mjs
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
That single command:
|
|
34
|
+
|
|
35
|
+
1. Detects your host OS (macOS / Windows / Linux)
|
|
36
|
+
2. Checks dependencies (Node 18+ required; `curl` and `git` optional)
|
|
37
|
+
3. Ensures `.env` exists — if `.env.example` is present it copies it; otherwise prints the exact vars you need to add manually
|
|
38
|
+
4. Runs `setup/verify-env.mjs` to validate your `ZERNIO_API_KEY` format and live-reachability against `GET /api/v1/profiles`
|
|
39
|
+
5. Prints the exact next step for your OS
|
|
40
|
+
|
|
41
|
+
**No bash required on Windows.** Everything runs under Node. PowerShell, cmd, WSL, git-bash all work identically.
|
|
42
|
+
|
|
43
|
+
### After the first run
|
|
44
|
+
|
|
45
|
+
Open `.env` and fill in:
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
| Variable | Required? | What to put |
|
|
49
|
+
| ------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
|
50
|
+
| `ZERNIO_API_KEY` | Yes (for live mode) | `sk_` + 64 hex characters — create one at [zernio.com/signup](https://zernio.com/signup) or via `POST /api/v1/api-keys` |
|
|
51
|
+
| `ZERNIO_API_URL` | Yes | Default `https://zernio.com/api/v1` — override only for regional / proxy deployments |
|
|
52
|
+
| `ZERNIO_PROFILE_ID` | Yes (for scheduling) | The profile you'll post from — find it in the Zernio dashboard |
|
|
53
|
+
| `ZERNIO_TIMEZONE` | Optional | IANA tz name (e.g. `America/New_York`); defaults to the profile's timezone |
|
|
54
|
+
| `ANTHROPIC_API_KEY` | Optional | Only for enhanced caption drafting in hybrid mode |
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
Re-run `node setup/setup.mjs` after editing `.env` to confirm everything is valid.
|
|
58
|
+
|
|
59
|
+
### Agent-only mode (no Zernio key needed)
|
|
60
|
+
|
|
61
|
+
If you just want to plan, write captions, and produce dry-run manifests without touching the Zernio API, skip the key entirely:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
node setup/setup.mjs --skip-verify
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
The operator falls back cleanly to `agent-only` mode and produces manifests with `"dryRun": true` that you can submit manually later.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Open Your IDE
|
|
72
|
+
|
|
73
|
+
Point your IDE's Working Directory at this exported folder. The agent entrypoint is `workers/zernio-social-operator/CLAUDE.md`.
|
|
74
|
+
|
|
75
|
+
### macOS
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
open .
|
|
79
|
+
# or specifically:
|
|
80
|
+
open -a "Claude" . # Claude Desktop with this folder
|
|
81
|
+
code . # VS Code / Cursor
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Windows (PowerShell)
|
|
85
|
+
|
|
86
|
+
```powershell
|
|
87
|
+
start .
|
|
88
|
+
# or specifically:
|
|
89
|
+
code . # VS Code / Cursor
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Linux
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
xdg-open .
|
|
96
|
+
code .
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Any of these IDEs can drive the operator from this folder:
|
|
100
|
+
|
|
101
|
+
- Claude Code (CLI)
|
|
102
|
+
- Claude Desktop
|
|
103
|
+
- Codex
|
|
104
|
+
- Cursor
|
|
105
|
+
- Gemini CLI
|
|
106
|
+
- OpenCode
|
|
107
|
+
- Qwen Code CLI
|
|
108
|
+
- Open Agents
|
|
109
|
+
|
|
110
|
+
See `docs/local-adapters.md` for per-IDE setup notes + optional MCP server install.
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## What the per-OS paths look like
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
| OS | Exported kit path after `growthub kit download` |
|
|
118
|
+
| ------- | ---------------------------------------------------------------------------------- |
|
|
119
|
+
| macOS | `~/paperclip/kits/exports/growthub-agent-worker-kit-zernio-social-v1/` |
|
|
120
|
+
| Linux | `~/paperclip/kits/exports/growthub-agent-worker-kit-zernio-social-v1/` |
|
|
121
|
+
| Windows | `%USERPROFILE%\paperclip\kits\exports\growthub-agent-worker-kit-zernio-social-v1\` |
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
Override the export path with `--out <path>` on `growthub kit download`.
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Execution Modes
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
| Mode | Requirements | Use When |
|
|
132
|
+
| ----------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
133
|
+
| `api-live` | Valid `ZERNIO_API_KEY` + at least one connected account on a profile | You want to schedule posts and queues via the live Zernio API |
|
|
134
|
+
| `agent-only` | Nothing — Claude Code handles everything | You need campaign planning, calendars, and captions without touching the Zernio API |
|
|
135
|
+
| `hybrid` | `ANTHROPIC_API_KEY` + valid `ZERNIO_API_KEY` | Enhanced caption drafting via Anthropic plus live Zernio scheduling |
|
|
136
|
+
| `postiz-ui-shell` | `api-live` / `hybrid` + the Postiz kit (`growthub-postiz-social-v1`) running | You want Postiz's UI (calendar, compose, analytics shell) with Zernio as the transport engine. See `docs/postiz-ui-shell-integration.md` for the 7-module bridge. |
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
**Agent-only mode is always valid.** Zernio reachability never blocks campaign planning.
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## First Run
|
|
144
|
+
|
|
145
|
+
1. Tell the operator: **"Plan a 30-day Instagram + LinkedIn campaign for [your brand]"**
|
|
146
|
+
2. The operator asks the 4-question gate (client, platforms, objective, cadence)
|
|
147
|
+
3. The operator runs the 10-step workflow and produces all campaign artifacts
|
|
148
|
+
4. Output is saved to `output/<client-slug>/<project-slug>/`
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## New Client Setup
|
|
153
|
+
|
|
154
|
+
See `brands/NEW-CLIENT.md` for instructions on adding a new client brand kit.
|
|
155
|
+
|
|
156
|
+
Quick version:
|
|
157
|
+
|
|
158
|
+
```bash
|
|
159
|
+
cp brands/_template/brand-kit.md brands/<client-slug>/brand-kit.md
|
|
160
|
+
# Then fill in the fields in the new file
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## Available Commands
|
|
166
|
+
|
|
167
|
+
Tell the operator which you need:
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
| Command | What It Does |
|
|
171
|
+
| ------------------- | -------------------------------------------------------------------- |
|
|
172
|
+
| `/zernio campaign` | Full campaign brief + content calendar + publishing plan |
|
|
173
|
+
| `/zernio calendar` | Content calendar only — existing brief provided |
|
|
174
|
+
| `/zernio captions` | Caption copy deck for a specific platform or batch |
|
|
175
|
+
| `/zernio schedule` | Generate Zernio-shaped scheduling manifest (`POST /api/v1/posts`) |
|
|
176
|
+
| `/zernio queue` | Define or update a recurring Zernio queue (time slots) |
|
|
177
|
+
| `/zernio analytics` | Analytics briefing from Zernio API metrics or provided data |
|
|
178
|
+
| `/zernio inbox` | Draft replies for DMs, comments, reviews in the Zernio unified inbox |
|
|
179
|
+
| `/zernio proposal` | Client-ready proposal with platform mix and ROI projection |
|
|
180
|
+
| `/zernio platforms` | Platform coverage report for a specific client context |
|
|
181
|
+
| `/zernio quick` | 30-second campaign snapshot for a domain or brand |
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## Key Files
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
| File | Purpose |
|
|
190
|
+
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
|
|
191
|
+
| `setup/setup.mjs` | **One-command cross-platform bootstrap — start here** |
|
|
192
|
+
| `setup/verify-env.mjs` | Validates `ZERNIO_API_KEY` + live reachability |
|
|
193
|
+
| `setup/check-deps.mjs` | Cross-platform Node dependency check (Windows parity) |
|
|
194
|
+
| `setup/check-deps.sh` | Legacy Unix bash dependency check (Mac / Linux) |
|
|
195
|
+
| `setup/install-mcp.mjs` | Prints per-IDE MCP config JSON for plugging in Zernio's official MCP server |
|
|
196
|
+
| `workers/zernio-social-operator/CLAUDE.md` | Agent operating instructions |
|
|
197
|
+
| `skills.md` | Full methodology — read at every session |
|
|
198
|
+
| `brands/_template/brand-kit.md` | Blank brand kit template |
|
|
199
|
+
| `brands/growthub/brand-kit.md` | Growthub reference example |
|
|
200
|
+
| `output/README.md` | Output directory structure and naming |
|
|
201
|
+
| `docs/zernio-api-integration.md` | How this kit integrates with Zernio (REST contract + plans + capability surface) |
|
|
202
|
+
| `docs/platform-coverage.md` | All 14 supported platforms with format specs |
|
|
203
|
+
| `docs/ai-caption-layer.md` | AI caption generation methodology |
|
|
204
|
+
| `docs/posts-and-queues-layer.md` | Scheduling manifest + queue format for Zernio API |
|
|
205
|
+
| `docs/local-adapters.md` | Per-IDE setup matrix (Claude Code / Desktop / Codex / Cursor / Gemini / OpenCode / Qwen / Open Agents) |
|
|
206
|
+
| `docs/postiz-ui-shell-integration.md` | Optional — run this kit as the engine under the Postiz UI shell |
|
|
207
|
+
| `validation-checklist.md` | Pre-session checklist |
|
|
208
|
+
|
|
209
|
+
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Adding a New Client
|
|
2
|
+
|
|
3
|
+
This guide explains how to create a brand kit for a new client in the Zernio Social Media Studio.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Steps
|
|
8
|
+
|
|
9
|
+
### 1. Copy the Template
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
cp brands/_template/brand-kit.md brands/<client-slug>/brand-kit.md
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Replace `<client-slug>` with a lowercase, hyphenated version of the client name. Examples:
|
|
16
|
+
- "Urban Cycle" → `urban-cycle`
|
|
17
|
+
- "Acme SaaS Corp" → `acme-saas`
|
|
18
|
+
- "The Bloom Studio" → `bloom-studio`
|
|
19
|
+
|
|
20
|
+
### 2. Fill in the Brand Kit
|
|
21
|
+
|
|
22
|
+
Open the new file and fill in every section:
|
|
23
|
+
|
|
24
|
+
- **Client Identity** — name, slug, industry, website
|
|
25
|
+
- **Zernio Account Context** — profile id, timezone, API key scope
|
|
26
|
+
- **Social Media Presence** — existing accounts with Zernio platform ids and account ids
|
|
27
|
+
- **Target Audience** — primary and secondary audience profiles
|
|
28
|
+
- **Campaign Objectives** — metrics, targets, and timelines
|
|
29
|
+
- **Brand Voice** — tone, personality, approved/blocked words, emoji usage
|
|
30
|
+
- **Content Theme Pillars** — 3–5 recurring themes with platform assignments
|
|
31
|
+
- **Competitor Reference Accounts** — 2–3 accounts to reference for format benchmarking
|
|
32
|
+
- **Benchmark Reference** (optional) — baseline engagement rates per platform
|
|
33
|
+
- **Agency Context** — engagement stage, retainer, reporting cadence
|
|
34
|
+
|
|
35
|
+
### 3. Verify the Brand Kit
|
|
36
|
+
|
|
37
|
+
Before using the brand kit in a session, confirm:
|
|
38
|
+
|
|
39
|
+
- [ ] `client-slug` in the filename matches the `Client Slug` field in the kit
|
|
40
|
+
- [ ] At least one platform is listed in `Social Media Presence` with a Zernio platform id from `docs/platform-coverage.md`
|
|
41
|
+
- [ ] At least one campaign objective has a measurable target
|
|
42
|
+
- [ ] Brand voice section is complete — no empty `[fill in]` placeholders
|
|
43
|
+
- [ ] At least 3 content theme pillars are defined
|
|
44
|
+
- [ ] `Zernio profile id` either references a real `prof_...` or is tagged `placeholder` (agent-only mode)
|
|
45
|
+
|
|
46
|
+
### 4. Tell the Operator
|
|
47
|
+
|
|
48
|
+
Start your Claude Code session and say:
|
|
49
|
+
|
|
50
|
+
> "Load the brand kit for [client-name] and begin a [campaign objective] campaign."
|
|
51
|
+
|
|
52
|
+
The operator will read the brand kit and ask the 4-question gate before producing any output.
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## Brand Kit Naming Rules
|
|
57
|
+
|
|
58
|
+
| Rule | Correct | Incorrect |
|
|
59
|
+
|---|---|---|
|
|
60
|
+
| Directory name is lowercase kebab-case | `brands/urban-cycle/` | `brands/UrbanCycle/` |
|
|
61
|
+
| Filename is always `brand-kit.md` | `brands/urban-cycle/brand-kit.md` | `brands/urban-cycle/UrbanCycle.md` |
|
|
62
|
+
| Slug contains no spaces | `acme-saas` | `acme saas` |
|
|
63
|
+
| Slug contains no special chars | `bloom-studio` | `bloom/studio` |
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Note on Public Brand Kits
|
|
68
|
+
|
|
69
|
+
Brand kits are **not included in kit exports by default**. The only brand kits included in exports are:
|
|
70
|
+
|
|
71
|
+
- `brands/_template/brand-kit.md` — the blank template
|
|
72
|
+
- `brands/growthub/brand-kit.md` — the public reference example
|
|
73
|
+
|
|
74
|
+
Client brand kits you create live in your local kit installation only. They are not bundled into the export zip or submitted to any external service.
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
# Brand Kit — [Client Name]
|
|
2
|
+
|
|
3
|
+
<!-- Replace [Client Name] with the actual client name and rename this file to brands/<client-slug>/brand-kit.md -->
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Client Identity
|
|
8
|
+
|
|
9
|
+
| Field | Value |
|
|
10
|
+
|---|---|
|
|
11
|
+
| Client Name | [Client Name] |
|
|
12
|
+
| Client Slug | [client-slug] |
|
|
13
|
+
| Industry | [e.g., SaaS / E-commerce / Hospitality / Fintech] |
|
|
14
|
+
| Website | [https://...] |
|
|
15
|
+
| Primary Contact | [Name, email] |
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Zernio Account Context
|
|
20
|
+
|
|
21
|
+
| Field | Value |
|
|
22
|
+
|---|---|
|
|
23
|
+
| Zernio profile id | [prof_...] or `placeholder` in agent-only mode |
|
|
24
|
+
| Default posting timezone | [IANA tz, e.g., America/New_York] |
|
|
25
|
+
| API key scope | [read | read-write] |
|
|
26
|
+
| Profile-specific key? | [yes | no] |
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Social Media Presence
|
|
31
|
+
|
|
32
|
+
| Platform | Zernio platform id | Account id / handle | Followers | Current Status |
|
|
33
|
+
|---|---|---|---|---|
|
|
34
|
+
| Instagram | `instagram` | [acc_ig_... or @handle] | [N] | [Active / Inactive / New] |
|
|
35
|
+
| LinkedIn | `linkedin` | [page id] | [N] | [Active / Inactive] |
|
|
36
|
+
| TikTok | `tiktok` | [acc_tt_...] | [N] | [Active / Inactive] |
|
|
37
|
+
| X/Twitter | `twitter` | [acc_x_...] | [N] | [Active / Inactive] |
|
|
38
|
+
| [Other] | [id] | [handle] | [N] | [Active / Inactive] |
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## Target Audience
|
|
43
|
+
|
|
44
|
+
### Primary Audience
|
|
45
|
+
|
|
46
|
+
| Attribute | Description |
|
|
47
|
+
|---|---|
|
|
48
|
+
| Age Range | [e.g., 25–40] |
|
|
49
|
+
| Gender | [e.g., 55% female, 45% male] |
|
|
50
|
+
| Location | [e.g., North America, English-speaking markets] |
|
|
51
|
+
| Interests | [e.g., entrepreneurship, productivity, design] |
|
|
52
|
+
| Pain Points | [e.g., too many disconnected tools, manual social media posting] |
|
|
53
|
+
| Content Preferences | [e.g., educational how-tos, success stories, data-driven insights] |
|
|
54
|
+
|
|
55
|
+
### Secondary Audience
|
|
56
|
+
|
|
57
|
+
| Attribute | Description |
|
|
58
|
+
|---|---|
|
|
59
|
+
| Age Range | [e.g., 18–25] |
|
|
60
|
+
| Interests | [e.g., tech, side projects] |
|
|
61
|
+
| Platform | [e.g., TikTok, Reddit] |
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## Campaign Objectives
|
|
66
|
+
|
|
67
|
+
| Objective | Metric | Target | Timeline |
|
|
68
|
+
|---|---|---|---|
|
|
69
|
+
| [Brand awareness] | [Impressions] | [50,000/month] | [Q2 2026] |
|
|
70
|
+
| [Lead generation] | [Link clicks] | [200/month] | [Q2 2026] |
|
|
71
|
+
| [Community growth] | [Follower growth] | [+500] | [Q2 2026] |
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## Brand Voice
|
|
76
|
+
|
|
77
|
+
| Attribute | Spec |
|
|
78
|
+
|---|---|
|
|
79
|
+
| Tone | [e.g., Professional but approachable. Data-driven without being dry. Never salesy.] |
|
|
80
|
+
| Personality | [e.g., Smart, helpful, occasionally witty] |
|
|
81
|
+
| Words to Use | [e.g., "build", "grow", "automate", "team", "results"] |
|
|
82
|
+
| Words to Avoid | [e.g., "hack", "guru", "crush it", "cheap", "amazing"] |
|
|
83
|
+
| Emoji Usage | [e.g., Minimal on LinkedIn; moderate on Instagram; more on TikTok] |
|
|
84
|
+
| CTA Style | [e.g., Direct action verbs: "Start today", "Learn more", "Join the team"] |
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## Content Theme Pillars
|
|
89
|
+
|
|
90
|
+
| Pillar | Description | Platforms | % of Calendar |
|
|
91
|
+
|---|---|---|---|
|
|
92
|
+
| [Industry Insights] | [What we know that others don't — data, trends, analysis] | [All] | [40%] |
|
|
93
|
+
| [Product Value] | [Feature spotlights, use cases, ROI stories] | [LinkedIn, Instagram] | [30%] |
|
|
94
|
+
| [Social Proof] | [Customer testimonials, case studies, results] | [All] | [20%] |
|
|
95
|
+
| [Community] | [Q&A, behind the scenes, team moments] | [Instagram, TikTok] | [10%] |
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Competitor Reference Accounts
|
|
100
|
+
|
|
101
|
+
| Platform | Account | Why Reference |
|
|
102
|
+
|---|---|---|
|
|
103
|
+
| [Instagram] | [@competitor] | [Strong visual brand, good engagement format] |
|
|
104
|
+
| [LinkedIn] | [competitor company page] | [Industry leader, consistent posting cadence] |
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## Agency Context
|
|
109
|
+
|
|
110
|
+
| Field | Value |
|
|
111
|
+
|---|---|
|
|
112
|
+
| Engagement Stage | [Prospect / Onboarding / Retained] |
|
|
113
|
+
| Monthly Retainer | [e.g., $X,XXX/month or "not established"] |
|
|
114
|
+
| Campaign Budget | [e.g., $X,XXX / campaign or "TBD"] |
|
|
115
|
+
| Reporting Cadence | [e.g., Monthly analytics brief] |
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## CRM Notes
|
|
120
|
+
|
|
121
|
+
<!-- Internal notes for agency context. Not included in client-facing outputs. -->
|
|
122
|
+
|
|
123
|
+
[Add internal notes here: key contacts, relationship history, upsell opportunities, account health signals]
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## DELIVERABLES LOG
|
|
128
|
+
|
|
129
|
+
<!-- Append a line for each completed deliverable. -->
|
|
130
|
+
|
|
131
|
+
<!-- - YYYY-MM-DD | Social Media Campaign Package v1 — [Project Name] | output/<client-slug>/<project-slug>/ -->
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
# Brand Kit — Growthub
|
|
2
|
+
|
|
3
|
+
<!-- Reference example for the Zernio Social Media Studio. Use this to understand the expected format and detail level. -->
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Client Identity
|
|
8
|
+
|
|
9
|
+
| Field | Value |
|
|
10
|
+
|---|---|
|
|
11
|
+
| Client Name | Growthub |
|
|
12
|
+
| Client Slug | `growthub` |
|
|
13
|
+
| Industry | Developer tools / AI agent infrastructure / SaaS |
|
|
14
|
+
| Website | https://growthub.ai |
|
|
15
|
+
| Primary Contact | Internal — Growthub marketing team |
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Zernio Account Context
|
|
20
|
+
|
|
21
|
+
| Field | Value |
|
|
22
|
+
|---|---|
|
|
23
|
+
| Zernio profile id | prof_GRO_primary |
|
|
24
|
+
| Default posting timezone | America/New_York |
|
|
25
|
+
| API key scope | read-write |
|
|
26
|
+
| Profile-specific key? | yes — scoped to `prof_GRO_primary` only |
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Social Media Presence
|
|
31
|
+
|
|
32
|
+
| Platform | Zernio platform id | Account id / handle | Followers | Current Status |
|
|
33
|
+
|---|---|---|---|---|
|
|
34
|
+
| X/Twitter | `twitter` | acc_x_growthubai (@growthubai) | 3,200 | Active |
|
|
35
|
+
| LinkedIn | `linkedin` | acc_li_GrowthubPage | 1,800 | Active |
|
|
36
|
+
| Bluesky | `bluesky` | acc_bsky_growthub (@growthub.ai) | 400 | Growing |
|
|
37
|
+
| YouTube | `youtube` | acc_yt_GrowthubAI | 1,100 | Active |
|
|
38
|
+
|
|
39
|
+
GitHub (github.com/Growthub-ai — 2,100 stars) is tracked separately; not published through Zernio.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Target Audience
|
|
44
|
+
|
|
45
|
+
### Primary Audience
|
|
46
|
+
|
|
47
|
+
| Attribute | Description |
|
|
48
|
+
|---|---|
|
|
49
|
+
| Age Range | 25–45 |
|
|
50
|
+
| Gender | 60% male, 40% female |
|
|
51
|
+
| Location | North America, Europe, English-speaking global |
|
|
52
|
+
| Interests | AI agents, developer tools, automation, indie hacking, SaaS growth |
|
|
53
|
+
| Pain Points | Complex agent orchestration, lack of open-source local-first alternatives, AI tool fatigue |
|
|
54
|
+
| Content Preferences | Technical tutorials, tool comparisons, workflow examples, behind-the-scenes product builds |
|
|
55
|
+
|
|
56
|
+
### Secondary Audience
|
|
57
|
+
|
|
58
|
+
| Attribute | Description |
|
|
59
|
+
|---|---|
|
|
60
|
+
| Age Range | 18–25 |
|
|
61
|
+
| Interests | Open source, hackathons, learning AI development |
|
|
62
|
+
| Platform | GitHub, X/Twitter, Bluesky |
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Campaign Objectives
|
|
67
|
+
|
|
68
|
+
| Objective | Metric | Target | Timeline |
|
|
69
|
+
|---|---|---|---|
|
|
70
|
+
| Developer awareness | GitHub stars | +500/quarter | Q2 2026 |
|
|
71
|
+
| Community growth | X followers | +200/month | Ongoing |
|
|
72
|
+
| Thought leadership | LinkedIn impressions | 20,000/month | Q2 2026 |
|
|
73
|
+
| Open-source adoption | CLI downloads | +1,000/month | Q2 2026 |
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## Brand Voice
|
|
78
|
+
|
|
79
|
+
| Attribute | Spec |
|
|
80
|
+
|---|---|
|
|
81
|
+
| Tone | Direct, technically credible, approachable. We explain without condescending. We ship without bragging. |
|
|
82
|
+
| Personality | Builder-first. We're in the trenches using the tools we build. |
|
|
83
|
+
| Words to Use | "build", "ship", "run", "local", "open", "agent", "workflow", "kit", "workspace" |
|
|
84
|
+
| Words to Avoid | "disruptive", "AI-powered" (use "agent-native" instead), "revolutionary", "hack" |
|
|
85
|
+
| Emoji Usage | Minimal — 0–1 on LinkedIn; 0–2 on X; 0 on Bluesky |
|
|
86
|
+
| CTA Style | Action verbs with immediate value: "Try it now", "Clone and run", "Read the docs", "Star on GitHub" |
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## Content Theme Pillars
|
|
91
|
+
|
|
92
|
+
| Pillar | Description | Platforms | % of Calendar |
|
|
93
|
+
|---|---|---|---|
|
|
94
|
+
| Product Builds | Behind-the-scenes of building Growthub features — architecture, decisions, tradeoffs | X, LinkedIn, YouTube | 35% |
|
|
95
|
+
| Developer Tutorials | How to use Growthub kits, commands, and workflows in real workflows | X, Bluesky, YouTube | 30% |
|
|
96
|
+
| Open Source | Open-source culture, contributions, partner project spotlights | X, Bluesky | 20% |
|
|
97
|
+
| Community | User projects, shoutouts, Q&A, polls | X, LinkedIn | 15% |
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Competitor Reference Accounts
|
|
102
|
+
|
|
103
|
+
| Platform | Account | Why Reference |
|
|
104
|
+
|---|---|---|
|
|
105
|
+
| X/Twitter | @langchain | Strong developer community engagement, technical thread format |
|
|
106
|
+
| LinkedIn | Anthropic company page | Consistent educational posting, thought leadership |
|
|
107
|
+
| X/Twitter | @cursor_ai | Product-led content strategy, community responsiveness |
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Benchmark Reference
|
|
112
|
+
|
|
113
|
+
| Platform | Median developer-tool engagement rate | Notes |
|
|
114
|
+
|---|---|---|
|
|
115
|
+
| `twitter` | 3.2% | Across peer dev-tool accounts, rolling 90-day |
|
|
116
|
+
| `linkedin` | 4.0% | Peer enterprise tool pages |
|
|
117
|
+
| `bluesky` | 5.5% | Narrower tech-fluent audience skews rate up |
|
|
118
|
+
| `youtube` | 6.0% (likes+comments/views) | Short-form skew |
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## Agency Context
|
|
123
|
+
|
|
124
|
+
| Field | Value |
|
|
125
|
+
|---|---|
|
|
126
|
+
| Engagement Stage | Internal — first-party reference kit |
|
|
127
|
+
| Monthly Retainer | N/A (internal) |
|
|
128
|
+
| Campaign Budget | N/A |
|
|
129
|
+
| Reporting Cadence | Monthly analytics brief to marketing team |
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## CRM Notes
|
|
134
|
+
|
|
135
|
+
Internal reference account. Used to demonstrate the kit's brand kit format and example output quality. Not a live client account.
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## DELIVERABLES LOG
|
|
140
|
+
|
|
141
|
+
<!-- - YYYY-MM-DD | Social Media Campaign Package v1 — Growthub Q2 2026 Launch | output/growthub/q2-2026-launch/ -->
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 2,
|
|
3
|
+
"bundle": {
|
|
4
|
+
"id": "growthub-zernio-social-v1",
|
|
5
|
+
"version": "1.0.0",
|
|
6
|
+
"kitId": "growthub-zernio-social-v1",
|
|
7
|
+
"workerId": "zernio-social-operator"
|
|
8
|
+
},
|
|
9
|
+
"briefType": "zernio-social-media-campaign",
|
|
10
|
+
"publicExampleBrandPaths": [
|
|
11
|
+
"brands/growthub/brand-kit.md"
|
|
12
|
+
],
|
|
13
|
+
"requiredFrozenAssets": [
|
|
14
|
+
"QUICKSTART.md",
|
|
15
|
+
"skills.md",
|
|
16
|
+
"output-standards.md",
|
|
17
|
+
"runtime-assumptions.md",
|
|
18
|
+
"validation-checklist.md",
|
|
19
|
+
"workers/zernio-social-operator/CLAUDE.md",
|
|
20
|
+
"brands/_template/brand-kit.md",
|
|
21
|
+
"brands/growthub/brand-kit.md",
|
|
22
|
+
"brands/NEW-CLIENT.md",
|
|
23
|
+
"setup/setup.mjs",
|
|
24
|
+
"setup/verify-env.mjs",
|
|
25
|
+
"setup/check-deps.sh",
|
|
26
|
+
"setup/check-deps.mjs",
|
|
27
|
+
"setup/install-mcp.mjs",
|
|
28
|
+
"output/README.md",
|
|
29
|
+
"templates/social-campaign-brief.md",
|
|
30
|
+
"templates/content-calendar.md",
|
|
31
|
+
"templates/platform-publishing-plan.md",
|
|
32
|
+
"templates/caption-copy-deck.md",
|
|
33
|
+
"templates/analytics-brief.md",
|
|
34
|
+
"templates/scheduling-manifest.md",
|
|
35
|
+
"templates/client-proposal.md",
|
|
36
|
+
"examples/social-campaign-sample.md",
|
|
37
|
+
"examples/content-calendar-sample.md",
|
|
38
|
+
"examples/analytics-brief-sample.md",
|
|
39
|
+
"examples/client-proposal-sample.md",
|
|
40
|
+
"docs/zernio-api-integration.md",
|
|
41
|
+
"docs/platform-coverage.md",
|
|
42
|
+
"docs/ai-caption-layer.md",
|
|
43
|
+
"docs/posts-and-queues-layer.md",
|
|
44
|
+
"docs/postiz-ui-shell-integration.md",
|
|
45
|
+
"docs/local-adapters.md",
|
|
46
|
+
"growthub-meta/README.md",
|
|
47
|
+
"growthub-meta/kit-standard.md"
|
|
48
|
+
],
|
|
49
|
+
"optionalPresets": [],
|
|
50
|
+
"export": {
|
|
51
|
+
"folderName": "growthub-agent-worker-kit-zernio-social-v1",
|
|
52
|
+
"zipFileName": "growthub-agent-worker-kit-zernio-social-v1.zip"
|
|
53
|
+
},
|
|
54
|
+
"activationModes": ["export"]
|
|
55
|
+
}
|