@growthub/cli 0.3.56 → 0.3.58
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,74 @@
|
|
|
1
|
+
# Content Calendar — Growthub · Q2 2026 Agent-Native CLI Launch
|
|
2
|
+
|
|
3
|
+
**Kit:** `growthub-zernio-social-v1`
|
|
4
|
+
**Generated:** 2026-04-15
|
|
5
|
+
**Mode:** api-live
|
|
6
|
+
**Version:** `v1`
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Calendar Header
|
|
11
|
+
|
|
12
|
+
| Field | Value |
|
|
13
|
+
|---|---|
|
|
14
|
+
| Client | Growthub |
|
|
15
|
+
| Zernio profile id | prof_GRO_primary |
|
|
16
|
+
| Campaign window | 2026-05-01 → 2026-05-30 |
|
|
17
|
+
| Platforms | `twitter`, `linkedin`, `bluesky`, `youtube` |
|
|
18
|
+
| Posting timezone | America/New_York |
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Calendar Table (first two weeks shown)
|
|
23
|
+
|
|
24
|
+
| Date | Day | Platform | Account | Theme | Post Type | Caption Preview | CTA | Media Notes | Status |
|
|
25
|
+
|---|---|---|---|---|---|---|---|---|---|
|
|
26
|
+
| 2026-05-01 | Fri | `twitter` | acc_x_growthubai | Product Builds | thread | Q2 is here and the Agent Harness is production-ready. Here's what | Try it now | — | draft |
|
|
27
|
+
| 2026-05-01 | Fri | `linkedin` | acc_li_GrowthubPage | Product Builds | text+image | Q2 is the window where Growthub's Agent Harness moves from preview | Read the docs | 1200x627 launch cover | draft |
|
|
28
|
+
| 2026-05-01 | Fri | `youtube` | acc_yt_GrowthubAI | Developer Tutorials | long-form | Agent Harness end-to-end walkthrough: kits, workflows, pipelines | Subscribe for weekly builds | 1920x1080 thumbnail, 16:9 video | draft |
|
|
29
|
+
| 2026-05-02 | Sat | `twitter` | acc_x_growthubai | Community | text | Weekend builder log: three wins from the week shipping Agent Harness | Drop yours | — | draft |
|
|
30
|
+
| 2026-05-03 | Sun | `bluesky` | acc_bsky_growthub | Open Source | text | Sunday OSS spotlight — the one tool we couldn't have shipped without | Check it out | — | draft |
|
|
31
|
+
| 2026-05-05 | Tue | `twitter` | acc_x_growthubai | Developer Tutorials | image | 30 seconds: `growthub kit download growthub-zernio-social-v1` to | Star on GitHub | Terminal demo screencap | draft |
|
|
32
|
+
| 2026-05-05 | Tue | `linkedin` | acc_li_GrowthubPage | Developer Tutorials | document/carousel | Three ways agent-native CLIs change how teams ship social campaigns | Try it now | 5-slide carousel, 1080x1080 | draft |
|
|
33
|
+
| 2026-05-06 | Wed | `bluesky` | acc_bsky_growthub | Product Builds | text | We chose a kit-first architecture so every workspace ships as a po | Read the docs | — | draft |
|
|
34
|
+
| 2026-05-07 | Thu | `twitter` | acc_x_growthubai | Product Builds | thread | Why we ship kits, not features: the short version and the tradeoffs | Read the docs | — | draft |
|
|
35
|
+
| 2026-05-07 | Thu | `youtube` | acc_yt_GrowthubAI | Developer Tutorials | short | 60s — add a Growthub kit to your workflow | Subscribe | 1080x1920, captions-on | draft |
|
|
36
|
+
| 2026-05-08 | Fri | `linkedin` | acc_li_GrowthubPage | Community | text | Three user projects this week that bent our roadmap in a good way | Share yours | — | draft |
|
|
37
|
+
| 2026-05-09 | Sat | `twitter` | acc_x_growthubai | Community | text | What are you building this weekend? Reply with a link — we rep the | Drop a link | — | draft |
|
|
38
|
+
| 2026-05-10 | Sun | `bluesky` | acc_bsky_growthub | Community | text | Sunday show-and-tell — what's the smallest win you shipped this wee | Share it | — | draft |
|
|
39
|
+
| 2026-05-12 | Tue | `twitter` | acc_x_growthubai | Open Source | image | Open source maturity ladder — where agent tooling is right now and | Keep going | Diagram 1200x675 | draft |
|
|
40
|
+
| 2026-05-12 | Tue | `linkedin` | acc_li_GrowthubPage | Open Source | text+image | Open source maturity isn't about stars. It's about reproducible env | Read the guide | 1200x627 | draft |
|
|
41
|
+
| 2026-05-14 | Thu | `twitter` | acc_x_growthubai | Developer Tutorials | thread | Step by step: how to ship a full social-media campaign with growth | Try it now | — | draft |
|
|
42
|
+
| 2026-05-14 | Thu | `youtube` | acc_yt_GrowthubAI | Developer Tutorials | long-form | Full walkthrough: growthub-zernio-social-v1 from download to publi | Subscribe | 1920x1080, 18 min | draft |
|
|
43
|
+
|
|
44
|
+
Full calendar (weeks 3–4) continues the same cadence — product builds early week, tutorial mid-week, community Fridays and weekends, OSS Sundays.
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## Posting Cadence Summary
|
|
49
|
+
|
|
50
|
+
| Platform | Posts / week | Best time window (America/New_York) | Notes |
|
|
51
|
+
|---|---|---|---|
|
|
52
|
+
| `twitter` | 7 | 08:00, 12:00, 17:00 | Anchor platform; highest-cadence |
|
|
53
|
+
| `linkedin` | 3 | Tue 08:30, Thu 08:30, Fri 09:00 | Never more than 1/day |
|
|
54
|
+
| `bluesky` | 3 | Wed 10:00, Sun 11:00, plus ad-hoc | Text-first, no hashtags |
|
|
55
|
+
| `youtube` | 2 (1 long-form, 1 short) | Thu 12:00, Sat 10:00 | Long-form Thursdays drive weekend discovery |
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Theme Pillar Distribution
|
|
60
|
+
|
|
61
|
+
| Pillar | Count | % of calendar |
|
|
62
|
+
|---|---|---|
|
|
63
|
+
| Product Builds | 11 | 35% |
|
|
64
|
+
| Developer Tutorials | 9 | 30% |
|
|
65
|
+
| Open Source | 6 | 20% |
|
|
66
|
+
| Community | 5 | 15% |
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Notes
|
|
71
|
+
|
|
72
|
+
- Multi-platform posts (e.g., 2026-05-01 X + LinkedIn) are spaced 45 minutes apart — X first, LinkedIn second — to avoid simultaneous-publishing optics
|
|
73
|
+
- The `weekly-build-log` recurring queue handles Saturday community posts so cadence is stable through Q2
|
|
74
|
+
- YouTube long-form premieres are disabled — scheduled publish only, to keep control inside Zernio
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# Social Campaign Brief — Growthub · Q2 2026 Agent-Native CLI Launch
|
|
2
|
+
|
|
3
|
+
**Kit:** `growthub-zernio-social-v1`
|
|
4
|
+
**Generated:** 2026-04-15
|
|
5
|
+
**Mode:** api-live
|
|
6
|
+
**Version:** `v1`
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Project Overview
|
|
11
|
+
|
|
12
|
+
| Field | Value |
|
|
13
|
+
|---|---|
|
|
14
|
+
| Client | Growthub |
|
|
15
|
+
| Project | Q2 2026 Agent-Native CLI Launch |
|
|
16
|
+
| Campaign window | 2026-05-01 → 2026-05-30 |
|
|
17
|
+
| Zernio profile id | prof_GRO_primary |
|
|
18
|
+
| Posting timezone | America/New_York |
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Campaign Objective
|
|
23
|
+
|
|
24
|
+
**Primary:** community growth with a strong secondary for lead generation
|
|
25
|
+
|
|
26
|
+
**Why this objective:** Growthub's flywheel is developer adoption. The CLI ships daily; every release earns a round of organic developer commentary on X, Bluesky, and LinkedIn. Q2 is the first window where the newly-shipped Agent Harness is production-ready, and the campaign goal is to convert that community interest into measurable open-source adoption (CLI downloads, GitHub stars, waitlist signups).
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Target Platforms
|
|
31
|
+
|
|
32
|
+
| Platform | Zernio ID | Account | Rationale |
|
|
33
|
+
|---|---|---|---|
|
|
34
|
+
| X/Twitter | `twitter` | acc_x_growthubai | Highest-signal developer community for agent tooling; lives for technical threads |
|
|
35
|
+
| LinkedIn | `linkedin` | acc_li_GrowthubPage | Hiring signal + thought leadership; partners and enterprise-adjacent audience |
|
|
36
|
+
| Bluesky | `bluesky` | acc_bsky_growthub | Tech-fluent early adopters; text-first format fits our voice |
|
|
37
|
+
| YouTube | `youtube` | acc_yt_GrowthubAI | Long-form CLI walkthroughs and shorts for each release |
|
|
38
|
+
|
|
39
|
+
Max 5 platforms. Fifth (Instagram) deferred — team capacity insufficient for sustained visual production this cycle.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Audience Profile
|
|
44
|
+
|
|
45
|
+
### Primary
|
|
46
|
+
|
|
47
|
+
| Attribute | Value |
|
|
48
|
+
|---|---|
|
|
49
|
+
| Age range | 25–45 |
|
|
50
|
+
| Geography | North America + Europe, English-first |
|
|
51
|
+
| Interests | AI agents, developer tools, automation, local-first infra |
|
|
52
|
+
| Pain points | Agent orchestration sprawl, tool fatigue, SaaS lock-in |
|
|
53
|
+
| Content preferences | Technical threads, CLI walkthroughs, architecture posts, build-in-public behind the scenes |
|
|
54
|
+
|
|
55
|
+
### Secondary
|
|
56
|
+
|
|
57
|
+
| Attribute | Value |
|
|
58
|
+
|---|---|
|
|
59
|
+
| Age range | 18–25 |
|
|
60
|
+
| Platforms | X/Twitter, Bluesky, GitHub |
|
|
61
|
+
| Interests | Open source, indie hacking, learning agent development |
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## KPI Targets
|
|
66
|
+
|
|
67
|
+
| KPI | Metric | Target | Timeline |
|
|
68
|
+
|---|---|---|---|
|
|
69
|
+
| Developer awareness | GitHub stars | +500 | By 2026-05-30 |
|
|
70
|
+
| Community growth | X followers | +400 | Rolling through Q2 |
|
|
71
|
+
| Thought leadership | LinkedIn impressions | 25,000 / month | May 2026 |
|
|
72
|
+
| Open-source adoption | CLI downloads (npm) | +2,000 / month | May 2026 |
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## Content Theme Pillars
|
|
77
|
+
|
|
78
|
+
| Pillar | Description | % of calendar | Primary platforms |
|
|
79
|
+
|---|---|---|---|
|
|
80
|
+
| Product Builds | Behind-the-scenes of shipping kits and CLI features | 35% | X, LinkedIn, YouTube |
|
|
81
|
+
| Developer Tutorials | How to use kits, commands, workflows end-to-end | 30% | X, Bluesky, YouTube |
|
|
82
|
+
| Open Source | OSS culture, contributions, partner projects | 20% | X, Bluesky |
|
|
83
|
+
| Community | User projects, shoutouts, Q&A, polls | 15% | X, LinkedIn |
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## Brand Voice Summary
|
|
88
|
+
|
|
89
|
+
| Attribute | Spec |
|
|
90
|
+
|---|---|
|
|
91
|
+
| Tone | Direct, technically credible, approachable. Explains without condescension. Ships without bragging. |
|
|
92
|
+
| Words to use | "build", "ship", "run", "local", "open", "agent", "workflow", "kit", "workspace" |
|
|
93
|
+
| Words to avoid | "disruptive", "AI-powered", "revolutionary", "hack" |
|
|
94
|
+
| Emoji rule | 0–1 on LinkedIn, 0–2 on X, none on Bluesky |
|
|
95
|
+
| CTA style | Action verbs with immediate value: "Try it now", "Clone and run", "Read the docs", "Star on GitHub" |
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Execution Notes
|
|
100
|
+
|
|
101
|
+
- Caption variants: 3 per post (A direct, B narrative, C question)
|
|
102
|
+
- Every `POST /api/v1/posts` call uses `Idempotency-Key = clientPostId` (shape `growthub-YYYYMMDD-NNN`)
|
|
103
|
+
- `dryRun` is `false` — api-live mode, profile `prof_GRO_primary`
|
|
104
|
+
- Manifest submission order: media uploads → posts → recurring `weekly-build-log` queue creation
|
|
105
|
+
- YouTube long-form videos scheduled via Zernio with premieres disabled; Shorts scheduled via queue
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
# Growthub Meta — growthub-zernio-social-v1
|
|
2
|
+
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
## Kit Identity
|
|
6
|
+
|
|
7
|
+
| Field | Value |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Kit ID | `growthub-zernio-social-v1` |
|
|
10
|
+
| Version | `1.0.0` |
|
|
11
|
+
| Schema Version | `2` |
|
|
12
|
+
| Type | `worker` |
|
|
13
|
+
| Family | `studio` |
|
|
14
|
+
| Factory family (adapter core) | `operator` |
|
|
15
|
+
| Execution Mode | `export` |
|
|
16
|
+
| Activation Modes | `["export"]` |
|
|
17
|
+
| Visibility | `public-open-source` |
|
|
18
|
+
| Source Repo | `growthub-local` |
|
|
19
|
+
| Frozen At | `2026-04-15T00:00:00.000Z` |
|
|
20
|
+
| Kernel packet | [Hosted SaaS Kit Kernel Packet `v1`](../../../../docs/kernel-packets/KERNEL_PACKET_HOSTED_SAAS_KIT.md) — this kit is the canonical reference implementation |
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## What This Kit Does
|
|
25
|
+
|
|
26
|
+
The Growthub Zernio Social Media Studio is a worker kit that wraps the [Zernio](https://zernio.com) REST API — a unified social media API for developers and AI agents — to produce AI-assisted social media campaigns, content calendars, caption copy decks, Zernio-shaped scheduling manifests, and recurring queue definitions across 14 social platforms.
|
|
27
|
+
|
|
28
|
+
The kit provides a self-contained local execution environment. An operator exports the kit, points Claude Code's Working Directory at the kit root, and the `zernio-social-operator` worker handles the complete 10-step social media campaign workflow.
|
|
29
|
+
|
|
30
|
+
Unlike the Postiz kit (self-hosted fork), Zernio is a hosted SaaS: there is no docker / fork to clone. The kit works against the hosted `https://zernio.com/api/v1` endpoint using an API key.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Folder Structure
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
growthub-zernio-social-v1/
|
|
38
|
+
kit.json ← Kit manifest (schemaVersion: 2)
|
|
39
|
+
QUICKSTART.md ← Setup guide
|
|
40
|
+
.env.example ← Environment template
|
|
41
|
+
skills.md ← Master methodology doc (read at every session)
|
|
42
|
+
output-standards.md ← Output naming, structure, quality bar
|
|
43
|
+
runtime-assumptions.md ← Frozen upstream assumptions
|
|
44
|
+
validation-checklist.md ← Pre-session + kit validation checklists
|
|
45
|
+
bundles/
|
|
46
|
+
growthub-zernio-social-v1.json ← Bundle manifest
|
|
47
|
+
workers/
|
|
48
|
+
zernio-social-operator/
|
|
49
|
+
CLAUDE.md ← Agent operating instructions (entrypoint)
|
|
50
|
+
brands/
|
|
51
|
+
_template/
|
|
52
|
+
brand-kit.md ← Blank client brand kit template
|
|
53
|
+
growthub/
|
|
54
|
+
brand-kit.md ← Growthub internal reference example
|
|
55
|
+
NEW-CLIENT.md ← Instructions for adding new clients
|
|
56
|
+
setup/
|
|
57
|
+
setup.mjs ← One-command cross-platform bootstrap (Win/Mac/Linux)
|
|
58
|
+
verify-env.mjs ← Verifies API key, profile, reachability
|
|
59
|
+
check-deps.sh ← Legacy Unix bash dep check
|
|
60
|
+
check-deps.mjs ← Cross-platform Node dep check (Windows parity)
|
|
61
|
+
install-mcp.mjs ← Prints per-IDE MCP server config JSON
|
|
62
|
+
output/
|
|
63
|
+
README.md ← Output directory structure and naming
|
|
64
|
+
templates/ ← 7 production-quality campaign templates
|
|
65
|
+
social-campaign-brief.md
|
|
66
|
+
content-calendar.md
|
|
67
|
+
platform-publishing-plan.md
|
|
68
|
+
caption-copy-deck.md
|
|
69
|
+
scheduling-manifest.md
|
|
70
|
+
analytics-brief.md
|
|
71
|
+
client-proposal.md
|
|
72
|
+
examples/ ← 4 filled samples for reference
|
|
73
|
+
social-campaign-sample.md
|
|
74
|
+
content-calendar-sample.md
|
|
75
|
+
analytics-brief-sample.md
|
|
76
|
+
client-proposal-sample.md
|
|
77
|
+
docs/ ← 6 technical reference documents
|
|
78
|
+
zernio-api-integration.md
|
|
79
|
+
platform-coverage.md
|
|
80
|
+
ai-caption-layer.md
|
|
81
|
+
posts-and-queues-layer.md
|
|
82
|
+
postiz-ui-shell-integration.md ← Optional — pair with the Postiz UI kit
|
|
83
|
+
local-adapters.md ← Per-IDE matrix (Claude/Codex/Cursor/Gemini/OpenCode/…)
|
|
84
|
+
growthub-meta/
|
|
85
|
+
README.md ← This file
|
|
86
|
+
kit-standard.md ← Kit rules and required-files contract
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Activation
|
|
92
|
+
|
|
93
|
+
This kit is activated in `export` mode:
|
|
94
|
+
|
|
95
|
+
1. CLI exports the kit to a local folder
|
|
96
|
+
2. User points Claude Code's Working Directory at the exported folder root
|
|
97
|
+
3. `workers/zernio-social-operator/CLAUDE.md` is the agent entrypoint
|
|
98
|
+
|
|
99
|
+
No server-side activation is required. The kit is fully self-contained.
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Upstream API
|
|
104
|
+
|
|
105
|
+
| Field | Value |
|
|
106
|
+
|---|---|
|
|
107
|
+
| Provider | Zernio |
|
|
108
|
+
| Site | https://zernio.com |
|
|
109
|
+
| Docs | https://docs.zernio.com |
|
|
110
|
+
| API base | `https://zernio.com/api/v1` |
|
|
111
|
+
| Auth | Bearer API key (`sk_` + 64 hex) via `Authorization` header |
|
|
112
|
+
| Env vars used | `ZERNIO_API_KEY`, `ZERNIO_API_URL`, `ZERNIO_PROFILE_ID`, `ZERNIO_TIMEZONE` (optional), `ANTHROPIC_API_KEY` (optional) |
|
|
113
|
+
| Supported platforms | 14 — see `docs/platform-coverage.md` |
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## Supported Output Categories
|
|
118
|
+
|
|
119
|
+
| Category | Templates | Examples |
|
|
120
|
+
|---|---|---|
|
|
121
|
+
| Social Campaign Briefs | `templates/social-campaign-brief.md` | `examples/social-campaign-sample.md` |
|
|
122
|
+
| Content Calendars | `templates/content-calendar.md` | `examples/content-calendar-sample.md` |
|
|
123
|
+
| Platform Publishing Plans | `templates/platform-publishing-plan.md` | — |
|
|
124
|
+
| Caption Copy Decks | `templates/caption-copy-deck.md` | — |
|
|
125
|
+
| Scheduling Manifests | `templates/scheduling-manifest.md` | — |
|
|
126
|
+
| Analytics Briefs | `templates/analytics-brief.md` | `examples/analytics-brief-sample.md` |
|
|
127
|
+
| Client Proposals | `templates/client-proposal.md` | `examples/client-proposal-sample.md` |
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## Related Kits
|
|
132
|
+
|
|
133
|
+
| Kit | Family | Purpose |
|
|
134
|
+
|---|---|---|
|
|
135
|
+
| `creative-strategist-v1` | workflow | Campaign strategy and creative briefs |
|
|
136
|
+
| `growthub-email-marketing-v1` | operator | Email marketing campaigns |
|
|
137
|
+
| `growthub-open-higgsfield-studio-v1` | studio | AI video generation via Open Higgsfield |
|
|
138
|
+
| `growthub-geo-seo-v1` | studio | GEO + SEO auditing |
|
|
139
|
+
| `growthub-postiz-social-v1` | studio | Social media via self-hosted Postiz |
|
|
140
|
+
| `growthub-zernio-social-v1` | studio | Social media via hosted Zernio REST API (this kit) |
|
|
141
|
+
|
|
142
|
+
### Recommended Pairing — Social Media Stack
|
|
143
|
+
|
|
144
|
+
`growthub-postiz-social-v1` (UI shell) + `growthub-zernio-social-v1` (engine) form a first-class paired environment. Postiz provides calendar, compose, analytics shell, and team workspace. Zernio provides the 14-platform transport, queues, media, inbox, and analytics against a single bearer-token REST API — no per-platform OAuth dance, no regional secrets sprayed across the kit.
|
|
145
|
+
|
|
146
|
+
See `docs/postiz-ui-shell-integration.md` in this kit for the 7-module bridge recipe.
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# Kit Standard — growthub-zernio-social-v1
|
|
2
|
+
|
|
3
|
+
**These rules govern the kit's structure, agent behavior, and output contract. All operators and maintainers must follow them.**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Required Files Contract
|
|
8
|
+
|
|
9
|
+
The following files must be present in every valid kit installation. Any missing file constitutes a broken kit.
|
|
10
|
+
|
|
11
|
+
| File | Purpose | Can Be Empty? |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `kit.json` | Kit manifest | No — must be valid JSON with `schemaVersion: 2` |
|
|
14
|
+
| `QUICKSTART.md` | User-facing setup guide | No |
|
|
15
|
+
| `.env.example` | Environment template | No |
|
|
16
|
+
| `skills.md` | Master methodology doc | No — must contain all 10 steps |
|
|
17
|
+
| `output-standards.md` | Output rules | No |
|
|
18
|
+
| `runtime-assumptions.md` | Upstream assumptions | No |
|
|
19
|
+
| `validation-checklist.md` | Pre-session checklist | No |
|
|
20
|
+
| `workers/zernio-social-operator/CLAUDE.md` | Agent entrypoint | No |
|
|
21
|
+
| `brands/_template/brand-kit.md` | Blank brand kit template | No |
|
|
22
|
+
| `brands/growthub/brand-kit.md` | Example brand kit | No |
|
|
23
|
+
| `brands/NEW-CLIENT.md` | New client instructions | No |
|
|
24
|
+
| `setup/verify-env.mjs` | Environment verification | No |
|
|
25
|
+
| `setup/check-deps.sh` | Dependency check | No |
|
|
26
|
+
| `output/README.md` | Output directory guide | No |
|
|
27
|
+
| All 7 template files | Campaign output templates | No — each must have all sections |
|
|
28
|
+
| All 4 example files | Reference samples | No — must contain realistic filled data |
|
|
29
|
+
| All 4 doc files | Technical reference | No |
|
|
30
|
+
| `bundles/growthub-zernio-social-v1.json` | Bundle manifest | No |
|
|
31
|
+
| `growthub-meta/README.md` | Kit metadata | No |
|
|
32
|
+
| `growthub-meta/kit-standard.md` | This file | No |
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Bundle Contract
|
|
37
|
+
|
|
38
|
+
| Requirement | Rule |
|
|
39
|
+
|---|---|
|
|
40
|
+
| Bundle ID | Must match kit ID: `growthub-zernio-social-v1` |
|
|
41
|
+
| Kit ID in bundle | Must be `growthub-zernio-social-v1` |
|
|
42
|
+
| Worker ID in bundle | Must be `zernio-social-operator` |
|
|
43
|
+
| Schema version | Must be `2` |
|
|
44
|
+
| `requiredFrozenAssets` | Must list all files in `kit.json` `frozenAssetPaths` |
|
|
45
|
+
| Export folder name | `growthub-agent-worker-kit-zernio-social-v1` |
|
|
46
|
+
| Export zip name | `growthub-agent-worker-kit-zernio-social-v1.zip` |
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## Agent Rules
|
|
51
|
+
|
|
52
|
+
### Workflow Order
|
|
53
|
+
|
|
54
|
+
The operator must follow the 10-step workflow in `workers/zernio-social-operator/CLAUDE.md` strictly. Steps must not be skipped or reordered. The environment gate (Step 0) must run before anything else.
|
|
55
|
+
|
|
56
|
+
### Platform IDs
|
|
57
|
+
|
|
58
|
+
The operator must only use Zernio platform IDs from `docs/platform-coverage.md`. Invented platform slugs are not acceptable. If the user requests a platform not in the coverage doc, the operator must note it as unsupported in the current Zernio instance and suggest the nearest supported alternative.
|
|
59
|
+
|
|
60
|
+
### Caption Variants
|
|
61
|
+
|
|
62
|
+
Every post in the Caption Copy Deck must have exactly 3 variants (A, B, C). The variants must be meaningfully different in opening hook and structure — not minor word substitutions. Character limits must be checked and documented for every variant.
|
|
63
|
+
|
|
64
|
+
### Scheduling Manifest
|
|
65
|
+
|
|
66
|
+
When a scheduling manifest is produced:
|
|
67
|
+
|
|
68
|
+
- `dryRun` must be `true` in agent-only mode
|
|
69
|
+
- All `scheduledFor` values must be ISO 8601 with explicit timezone offset
|
|
70
|
+
- All `clientPostId` values must follow the naming convention
|
|
71
|
+
- Every `platforms[].platform` must exist in `docs/platform-coverage.md`
|
|
72
|
+
- Every `platforms[].accountId` must be a real Zernio account id (live mode) or a clearly-placeholdered handle (agent-only mode)
|
|
73
|
+
- No manifest may reference a platform not confirmed via `GET /api/v1/accounts` in live mode
|
|
74
|
+
|
|
75
|
+
### Idempotency
|
|
76
|
+
|
|
77
|
+
Every write request to Zernio must carry an `Idempotency-Key` header. The operator uses `clientPostId` from the manifest as that key. Queues use `queue-<name>`. Media uploads use `media-<client-slug>-<YYYYMMDD>-<asset-slug>`.
|
|
78
|
+
|
|
79
|
+
### No Secrets in Outputs
|
|
80
|
+
|
|
81
|
+
The operator must never include `ZERNIO_API_KEY`, `ANTHROPIC_API_KEY`, OAuth tokens, or raw auth headers in any output file. `.env.example` uses placeholder comments only.
|
|
82
|
+
|
|
83
|
+
### Template-Bound Outputs
|
|
84
|
+
|
|
85
|
+
All output artifacts must use the templates in `templates/`. The operator must not invent new template schemas or change the required section structure.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Runtime Rules
|
|
90
|
+
|
|
91
|
+
### Three Execution Modes Are First-Class
|
|
92
|
+
|
|
93
|
+
`api-live`, `agent-only`, and `hybrid` are all valid execution modes. The kit must never require `api-live` mode for a session to produce valid campaign outputs. Agent-only mode is always a valid fallback for campaign planning, caption drafting, and dry-run scheduling manifests.
|
|
94
|
+
|
|
95
|
+
### Zernio Is the Reference Substrate
|
|
96
|
+
|
|
97
|
+
The platform integrations, queue model, and API contract at `https://zernio.com/api/v1` are the source of truth for scheduling behavior. The kit documents and wraps that behavior — it does not redefine it. When the Zernio API changes, `docs/zernio-api-integration.md` and `runtime-assumptions.md` must be updated.
|
|
98
|
+
|
|
99
|
+
### Markdown Is the Primary Output Format
|
|
100
|
+
|
|
101
|
+
All campaign artifacts are Markdown files. The scheduling manifest is a JSON file. Queue definitions are JSON files. No other formats are produced by this kit unless explicitly requested.
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## Versioning Rules
|
|
106
|
+
|
|
107
|
+
| Scenario | Action |
|
|
108
|
+
|---|---|
|
|
109
|
+
| Bug fix in a template or doc file | Patch version bump: `1.0.0` → `1.0.1` |
|
|
110
|
+
| New template or platform added | Minor version bump: `1.0.0` → `1.1.0` |
|
|
111
|
+
| Workflow restructured or output schema changed | Major version bump: `1.0.0` → `2.0.0` |
|
|
112
|
+
| Zernio adds a new platform integration | Minor bump + update `runtime-assumptions.md` and `docs/platform-coverage.md` |
|
|
113
|
+
| Zernio changes the REST contract | Major bump if breaking + update `docs/zernio-api-integration.md` and `runtime-assumptions.md` |
|
|
114
|
+
|
|
115
|
+
Version bumps must update:
|
|
116
|
+
|
|
117
|
+
- `kit.json` → `kit.version`
|
|
118
|
+
- `bundles/growthub-zernio-social-v1.json` → `bundle.version`
|
|
119
|
+
- `growthub-meta/README.md` → Version field
|
|
120
|
+
- `runtime-assumptions.md` → Frozen date and changelog note
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 2,
|
|
3
|
+
"kit": {
|
|
4
|
+
"id": "growthub-zernio-social-v1",
|
|
5
|
+
"version": "1.0.0",
|
|
6
|
+
"name": "Growthub Agent Worker Kit — Zernio Social Media Studio",
|
|
7
|
+
"description": "Self-contained local execution environment for Zernio, the unified social media REST API for developers and AI agents. Produces implementation-ready social media campaigns, content calendars, multi-platform publishing plans, AI-assisted captions, Zernio-shaped scheduling manifests, recurring queue definitions, inbox reply plans, and analytics briefings across 14 platforms including X/Twitter, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Google Business, Telegram, Snapchat, and WhatsApp.",
|
|
8
|
+
"type": "worker",
|
|
9
|
+
"visibility": "public-open-source",
|
|
10
|
+
"sourceRepo": "growthub-local",
|
|
11
|
+
"family": "studio"
|
|
12
|
+
},
|
|
13
|
+
"entrypoint": {
|
|
14
|
+
"workerId": "zernio-social-operator",
|
|
15
|
+
"path": "workers/zernio-social-operator/CLAUDE.md"
|
|
16
|
+
},
|
|
17
|
+
"workerIds": [
|
|
18
|
+
"zernio-social-operator"
|
|
19
|
+
],
|
|
20
|
+
"agentContractPath": "workers/zernio-social-operator/CLAUDE.md",
|
|
21
|
+
"brandTemplatePath": "brands/_template/brand-kit.md",
|
|
22
|
+
"publicExampleBrandPaths": [
|
|
23
|
+
"brands/growthub/brand-kit.md"
|
|
24
|
+
],
|
|
25
|
+
"frozenAssetPaths": [
|
|
26
|
+
"QUICKSTART.md",
|
|
27
|
+
"skills.md",
|
|
28
|
+
"output-standards.md",
|
|
29
|
+
"runtime-assumptions.md",
|
|
30
|
+
"validation-checklist.md",
|
|
31
|
+
"workers/zernio-social-operator/CLAUDE.md",
|
|
32
|
+
"brands/_template/brand-kit.md",
|
|
33
|
+
"brands/growthub/brand-kit.md",
|
|
34
|
+
"brands/NEW-CLIENT.md",
|
|
35
|
+
"setup/setup.mjs",
|
|
36
|
+
"setup/verify-env.mjs",
|
|
37
|
+
"setup/check-deps.sh",
|
|
38
|
+
"setup/check-deps.mjs",
|
|
39
|
+
"setup/install-mcp.mjs",
|
|
40
|
+
"output/README.md",
|
|
41
|
+
"templates/social-campaign-brief.md",
|
|
42
|
+
"templates/content-calendar.md",
|
|
43
|
+
"templates/platform-publishing-plan.md",
|
|
44
|
+
"templates/caption-copy-deck.md",
|
|
45
|
+
"templates/analytics-brief.md",
|
|
46
|
+
"templates/scheduling-manifest.md",
|
|
47
|
+
"templates/client-proposal.md",
|
|
48
|
+
"examples/social-campaign-sample.md",
|
|
49
|
+
"examples/content-calendar-sample.md",
|
|
50
|
+
"examples/analytics-brief-sample.md",
|
|
51
|
+
"examples/client-proposal-sample.md",
|
|
52
|
+
"docs/zernio-api-integration.md",
|
|
53
|
+
"docs/platform-coverage.md",
|
|
54
|
+
"docs/ai-caption-layer.md",
|
|
55
|
+
"docs/posts-and-queues-layer.md",
|
|
56
|
+
"docs/postiz-ui-shell-integration.md",
|
|
57
|
+
"docs/local-adapters.md",
|
|
58
|
+
"growthub-meta/README.md",
|
|
59
|
+
"growthub-meta/kit-standard.md"
|
|
60
|
+
],
|
|
61
|
+
"setupPaths": {
|
|
62
|
+
"quickstart": "QUICKSTART.md",
|
|
63
|
+
"setupDir": "setup/",
|
|
64
|
+
"outputDir": "output/"
|
|
65
|
+
},
|
|
66
|
+
"outputStandard": {
|
|
67
|
+
"type": "working-directory",
|
|
68
|
+
"description": "Exported folder is intended to be pointed at directly by the agent Working Directory. All outputs are Markdown files written to output/<client-slug>/<project-slug>/ alongside a machine-readable scheduling-manifest.json shaped for POST https://zernio.com/api/v1/posts.",
|
|
69
|
+
"requiredPaths": [
|
|
70
|
+
"QUICKSTART.md",
|
|
71
|
+
"kit.json",
|
|
72
|
+
"bundles/growthub-zernio-social-v1.json",
|
|
73
|
+
"skills.md",
|
|
74
|
+
"workers/zernio-social-operator/CLAUDE.md",
|
|
75
|
+
"brands/_template/brand-kit.md",
|
|
76
|
+
"brands/growthub/brand-kit.md",
|
|
77
|
+
"brands/NEW-CLIENT.md",
|
|
78
|
+
"setup/verify-env.mjs",
|
|
79
|
+
"setup/check-deps.sh",
|
|
80
|
+
"output/README.md",
|
|
81
|
+
"templates",
|
|
82
|
+
"docs",
|
|
83
|
+
"growthub-meta"
|
|
84
|
+
]
|
|
85
|
+
},
|
|
86
|
+
"bundles": [
|
|
87
|
+
{
|
|
88
|
+
"id": "growthub-zernio-social-v1",
|
|
89
|
+
"version": "1.0.0",
|
|
90
|
+
"path": "bundles/growthub-zernio-social-v1.json"
|
|
91
|
+
}
|
|
92
|
+
],
|
|
93
|
+
"executionMode": "export",
|
|
94
|
+
"activationModes": [
|
|
95
|
+
"export"
|
|
96
|
+
],
|
|
97
|
+
"compatibility": {
|
|
98
|
+
"cliMinVersion": "0.3.53"
|
|
99
|
+
},
|
|
100
|
+
"provenance": {
|
|
101
|
+
"sourceRepo": "growthub-local",
|
|
102
|
+
"frozenAt": "2026-04-15T00:00:00.000Z"
|
|
103
|
+
}
|
|
104
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Output Directory
|
|
2
|
+
|
|
3
|
+
This directory is where all campaign deliverables are written.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Structure
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
output/
|
|
11
|
+
<client-slug>/
|
|
12
|
+
<project-slug>/
|
|
13
|
+
SocialCampaignBrief_v<N>_<YYYYMMDD>.md
|
|
14
|
+
ContentCalendar_v<N>_<YYYYMMDD>.md
|
|
15
|
+
PlatformPublishingPlan_v<N>_<YYYYMMDD>.md
|
|
16
|
+
CaptionCopyDeck_v<N>_<YYYYMMDD>.md
|
|
17
|
+
SchedulingManifest_v<N>_<YYYYMMDD>.md (if scheduling requested)
|
|
18
|
+
AnalyticsBrief_v<N>_<YYYYMMDD>.md (if analytics data provided)
|
|
19
|
+
ClientProposal_v<N>_<YYYYMMDD>.md (if requested)
|
|
20
|
+
scheduling-manifest.json (machine-readable, for Zernio POST /api/v1/posts)
|
|
21
|
+
queue-<queue-name>.json (machine-readable, for Zernio POST /api/v1/queues)
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Naming Convention
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
<ClientSlug>_<OutputType>_v<N>_<YYYYMMDD>.md
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
- **ClientSlug:** TitleCase, no spaces (`UrbanCycle`, not `Urban Cycle`)
|
|
33
|
+
- **OutputType:** CamelCase (`SocialCampaignBrief`, `ContentCalendar`, etc.)
|
|
34
|
+
- **Version:** `v1`, `v2`, etc.
|
|
35
|
+
- **Date:** `YYYYMMDD` format
|
|
36
|
+
|
|
37
|
+
**Example:** `UrbanCycle_ContentCalendar_v1_20260415.md`
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Adding a New Project
|
|
42
|
+
|
|
43
|
+
When starting a campaign for a new client or a new project for an existing client:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
mkdir -p output/<client-slug>/<project-slug>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
The operator will write all deliverables to this directory and log the project in the brand kit DELIVERABLES LOG.
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Git and Version Control
|
|
54
|
+
|
|
55
|
+
The `output/` directory is excluded from kit exports. Do not commit client deliverables to the kit repository. Keep outputs in your local working directory or a separate client delivery folder.
|
|
56
|
+
|
|
57
|
+
If you are version-controlling client outputs separately, use the project slug as the branch or folder name.
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## Secret Hygiene
|
|
62
|
+
|
|
63
|
+
`scheduling-manifest.json` and `queue-*.json` never contain `ZERNIO_API_KEY` or any OAuth tokens. They reference Zernio resource ids only (`profileId`, `accountId`, `mediaId`). If you see a raw API key in an output file, treat it as a bug and scrub it before sharing.
|