@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.
Files changed (37) hide show
  1. package/assets/worker-kits/growthub-zernio-social-v1/QUICKSTART.md +209 -0
  2. package/assets/worker-kits/growthub-zernio-social-v1/brands/NEW-CLIENT.md +74 -0
  3. package/assets/worker-kits/growthub-zernio-social-v1/brands/_template/brand-kit.md +131 -0
  4. package/assets/worker-kits/growthub-zernio-social-v1/brands/growthub/brand-kit.md +141 -0
  5. package/assets/worker-kits/growthub-zernio-social-v1/bundles/growthub-zernio-social-v1.json +55 -0
  6. package/assets/worker-kits/growthub-zernio-social-v1/docs/ai-caption-layer.md +132 -0
  7. package/assets/worker-kits/growthub-zernio-social-v1/docs/local-adapters.md +123 -0
  8. package/assets/worker-kits/growthub-zernio-social-v1/docs/platform-coverage.md +112 -0
  9. package/assets/worker-kits/growthub-zernio-social-v1/docs/postiz-ui-shell-integration.md +166 -0
  10. package/assets/worker-kits/growthub-zernio-social-v1/docs/posts-and-queues-layer.md +208 -0
  11. package/assets/worker-kits/growthub-zernio-social-v1/docs/zernio-api-integration.md +265 -0
  12. package/assets/worker-kits/growthub-zernio-social-v1/examples/analytics-brief-sample.md +97 -0
  13. package/assets/worker-kits/growthub-zernio-social-v1/examples/client-proposal-sample.md +106 -0
  14. package/assets/worker-kits/growthub-zernio-social-v1/examples/content-calendar-sample.md +74 -0
  15. package/assets/worker-kits/growthub-zernio-social-v1/examples/social-campaign-sample.md +105 -0
  16. package/assets/worker-kits/growthub-zernio-social-v1/growthub-meta/README.md +146 -0
  17. package/assets/worker-kits/growthub-zernio-social-v1/growthub-meta/kit-standard.md +120 -0
  18. package/assets/worker-kits/growthub-zernio-social-v1/kit.json +104 -0
  19. package/assets/worker-kits/growthub-zernio-social-v1/output/README.md +63 -0
  20. package/assets/worker-kits/growthub-zernio-social-v1/output-standards.md +132 -0
  21. package/assets/worker-kits/growthub-zernio-social-v1/runtime-assumptions.md +170 -0
  22. package/assets/worker-kits/growthub-zernio-social-v1/setup/check-deps.mjs +117 -0
  23. package/assets/worker-kits/growthub-zernio-social-v1/setup/check-deps.sh +86 -0
  24. package/assets/worker-kits/growthub-zernio-social-v1/setup/install-mcp.mjs +177 -0
  25. package/assets/worker-kits/growthub-zernio-social-v1/setup/setup.mjs +247 -0
  26. package/assets/worker-kits/growthub-zernio-social-v1/setup/verify-env.mjs +138 -0
  27. package/assets/worker-kits/growthub-zernio-social-v1/skills.md +332 -0
  28. package/assets/worker-kits/growthub-zernio-social-v1/templates/analytics-brief.md +101 -0
  29. package/assets/worker-kits/growthub-zernio-social-v1/templates/caption-copy-deck.md +105 -0
  30. package/assets/worker-kits/growthub-zernio-social-v1/templates/client-proposal.md +98 -0
  31. package/assets/worker-kits/growthub-zernio-social-v1/templates/content-calendar.md +70 -0
  32. package/assets/worker-kits/growthub-zernio-social-v1/templates/platform-publishing-plan.md +86 -0
  33. package/assets/worker-kits/growthub-zernio-social-v1/templates/scheduling-manifest.md +92 -0
  34. package/assets/worker-kits/growthub-zernio-social-v1/templates/social-campaign-brief.md +102 -0
  35. package/assets/worker-kits/growthub-zernio-social-v1/validation-checklist.md +85 -0
  36. package/assets/worker-kits/growthub-zernio-social-v1/workers/zernio-social-operator/CLAUDE.md +307 -0
  37. 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.