@growthub/cli 0.3.53 → 0.3.55

package/assets/worker-kits/growthub-postiz-social-v1/examples/analytics-brief-sample.md

@@ -0,0 +1,125 @@
+# Analytics Brief — Sample
+
+<!-- Sample: Urban Cycle | Q2 2026 Urban Mobility Month | May 2026 | v1 | 2026-06-01 -->
+<!-- This is a filled example demonstrating the expected format. All metrics are fictitious but realistic. -->
+
+---
+
+## Period Summary
+
+| Field | Value |
+|---|---|
+| Client | Urban Cycle |
+| Campaign | Q2 2026 — Urban Mobility Month |
+| Period | 2026-05-01 to 2026-05-31 |
+| Platforms Analyzed | instagram, linkedin, twitter |
+| Total Posts Published | 52 |
+| Data Source | Client-provided platform export (Instagram Insights, LinkedIn Analytics, X Analytics) |
+
+---
+
+## Per-Platform Performance
+
+| Platform | Impressions | Reach | Engagement Rate | Follower Growth | Link Clicks | Posts Published |
+|---|---|---|---|---|---|---|
+| instagram | 28,450 | 14,200 | 4.1% | +612 | 487 (bio link) | 22 |
+| linkedin | 9,800 | 6,300 | 2.8% | +94 | 312 (post links) | 12 |
+| twitter | 11,200 | 8,700 | 1.9% | +128 | 156 | 18 |
+| **Totals** | **49,450** | **29,200** | **avg 2.9%** | **+834** | **955** | **52** |
+
+*Engagement Rate = (likes + comments + shares + saves) / impressions × 100*
+
+---
+
+## Top 3 Performing Posts
+
+### #1 Best Performing
+
+| Attribute | Value |
+|---|---|
+| Post Date | 2026-05-07 |
+| Platform | instagram |
+| Theme Pillar | Community Spotlight |
+| Post Type | Reel |
+| Impressions | 4,230 |
+| Engagement Rate | 8.7% |
+| Caption Preview | "Maria cycles 14km each way to her nursing shift. Every. Single. Day. Here's her route." |
+| Why It Worked | Community Spotlight Reels consistently outperform static images by 2–3x for this account. Maria's human story resonated — 127 saves, 43 comments. Reel format received Explore page placement. |
+
+---
+
+### #2 Best Performing
+
+| Attribute | Value |
+|---|---|
+| Post Date | 2026-05-05 |
+| Platform | linkedin |
+| Theme Pillar | Advocacy & Infrastructure |
+| Post Type | Text + image (infographic) |
+| Impressions | 2,800 |
+| Engagement Rate | 5.2% |
+| Caption Preview | "72% of urban commuters cite safety as the #1 barrier to cycling. Yet cities that invest in prot..." |
+| Why It Worked | Bike to Work Day (May 5) created organic interest in cycling safety data. The infographic format drove 47 saves. 12 comments from city planners and transportation professionals — organic reach into LinkedIn's professional niche. |
+
+---
+
+### #3 Best Performing
+
+| Attribute | Value |
+|---|---|
+| Post Date | 2026-05-14 |
+| Platform | instagram |
+| Theme Pillar | Gear & Technique |
+| Post Type | Carousel |
+| Impressions | 3,140 |
+| Engagement Rate | 6.1% |
+| Caption Preview | "5 locks that actually work (and 2 that don't). Swipe for the breakdown →" |
+| Why It Worked | Carousel format drove 89 saves — highest save count of the month. "Save this" CTA explicitly requests save behavior. Educational format with opinionated recommendations outperforms generic product posts. |
+
+---
+
+## Bottom 3 Performing Posts
+
+| Post Date | Platform | Theme | Engagement Rate | Failure Hypothesis |
+|---|---|---|---|---|
+| 2026-05-20 | twitter | Brand & Behind the Scenes | 0.6% | Brand origin story content underperforms on X — audience wants real-time commentary and opinions, not retrospective narrative. Recommend moving brand storytelling to Instagram only. |
+| 2026-05-13 | instagram | Route Stories | 1.2% | Posted on Victoria Day holiday weekend (May 13) — audience not active. Should have used this slot for a lighter community post or pushed the Route Story to the following Tuesday. |
+| 2026-05-18 | linkedin | Gear & Technique | 0.8% | Gear recommendations are not relevant to LinkedIn's Urban Cycle audience (B2B decision-makers, urban planners). Gear content should stay on Instagram and X. Platform-content mismatch. |
+
+---
+
+## KPI vs. Target Comparison
+
+| KPI | Target | Actual | Status |
+|---|---|---|---|
+| Impressions | 25,000 / month | 49,450 | Exceeded (+98%) |
+| Avg Engagement Rate | ≥3.5% Instagram | 4.1% Instagram | Met |
+| Follower Growth | +500 Instagram | +612 Instagram | Exceeded (+22%) |
+| Link Clicks | 300 (bio + LinkedIn) | 955 | Exceeded (+218%) |
+| UGC Posts #UrbanCycleMonth | ≥3 | 7 | Exceeded (+133%) |
+
+---
+
+## Recommendations for Next Period (June)
+
+1. **Increase Reel frequency on Instagram from 1x/week to 3x/week:** Reels account for 38% of total impressions on only 14% of posts. Shifting 2 static image slots to Reels should push Instagram impressions 40–60% higher with the same posting volume.
+
+2. **Shift X/Twitter posting time from 8am to 7:30am ET on weekdays:** Top-performing X posts came at 7:30am on days when the captions were tied to commute timing. Early morning commuter context drove 2.3× more replies than midday posts.
+
+3. **Remove Gear content from LinkedIn:** The two lowest-performing LinkedIn posts were gear recommendations. Replace with Advocacy & Infrastructure content (strongest LinkedIn performer) and bring LinkedIn gear coverage to 0% in June.
+
+4. **Launch a UGC challenge for June:** With 7 UGC posts in May (vs. 3 target), there's clear community enthusiasm. A branded June challenge (#RideWithUrbanCycle) with a weekly rider spotlight will compound community content without increasing production cost.
+
+5. **Test Variant C (question hook) on Instagram Thursday posts:** May analysis shows engagement rate 1.8× higher on posts that opened with a direct question. Currently only 30% of Instagram captions use Variant C. Shift Thursday posts to question-hook format for 4-week A/B test.
+
+---
+
+## Benchmark Comparison
+
+| Metric | Urban Cycle Result | Industry Benchmark | Source |
+|---|---|---|---|
+| Instagram engagement rate | 4.1% | 0.83%–1.22% (general); 3.0% for lifestyle/outdoor | Rival IQ 2026 Social Media Benchmark Report |
+| LinkedIn engagement rate | 2.8% | 0.35%–0.50% (company pages) | LinkedIn internal benchmark 2025 |
+| X/Twitter engagement rate | 1.9% | 0.05%–0.09% (general) | Rival IQ 2026 |
+
+*Urban Cycle is performing significantly above industry benchmarks across all three platforms. Above-average performance is driven by high-quality visual content, strong community focus, and consistent posting cadence.*

package/assets/worker-kits/growthub-postiz-social-v1/examples/client-proposal-sample.md

@@ -0,0 +1,127 @@
+# Social Media Campaign Proposal — Sample
+
+<!-- Sample: Urban Cycle | Q3 2026 Growth Campaign | v1 | 2026-06-01 -->
+<!-- This is a filled example demonstrating the expected format. Data is fictitious but realistic. -->
+
+---
+
+## Executive Summary
+
+Urban Cycle's May 2026 campaign exceeded all KPIs — 4.1% Instagram engagement rate (vs. 1.2% industry average), 49,450 total impressions (vs. 25,000 target), and 955 link clicks. The Q3 2026 proposal expands to 4 platforms (adding TikTok), increases Reel production to 3x/week, and introduces a monthly rider spotlight series that drove Urban Cycle's highest-performing post in May (8.7% engagement rate). Projected outcome: 120,000 monthly impressions and +1,500 followers by end of Q3.
+
+---
+
+## Campaign Overview
+
+| Field | Value |
+|---|---|
+| Proposed Campaign Name | Q3 2026 — Ride Every City |
+| Campaign Objective | Community growth + brand awareness + product launch (new route planner app) |
+| Recommended Platforms | instagram, tiktok, linkedin, twitter |
+| Campaign Duration | 90 days (July 1 – September 30, 2026) |
+| Total Posts | 270 posts across 4 platforms |
+| Start Date | 2026-07-01 (proposed) |
+
+---
+
+## Why These Platforms
+
+| Platform | Audience Fit | Primary Role in Campaign |
+|---|---|---|
+| instagram | 68% of Urban Cycle's target audience (urban cyclists, 25–40) is active on Instagram. Q2 data confirms 4.1% engagement — highest of any platform tested. | Brand awareness hub — Reels, carousels, community spotlights |
+| tiktok | Urban Cycle's 18–28 secondary audience segment is 3× more active on TikTok than Instagram. Short-form cycling route videos align with TikTok's discovery algorithm. New platform for Urban Cycle — expect 60-day ramp before organic growth signals emerge. | Audience growth, route content, app launch reach |
+| linkedin | B2B pipeline for corporate wellness programs and urban planning partnerships. May LinkedIn posts drove 312 link clicks to the route planner landing page — highest per-platform click rate. | Thought leadership, infrastructure advocacy, B2B pipeline |
+| twitter | Real-time community engagement during commute hours. Urban Cycle's X presence drove 7 UGC posts in May tied to live commute commentary. | Community engagement, newsjacking, advocacy moments |
+
+---
+
+## Content Strategy
+
+### Theme Pillars
+
+| Pillar | Description | % of Calendar | Key Formats |
+|---|---|---|---|
+| Route Stories | Real routes, real riders — city-specific commute coverage | 30% | Reels (Instagram + TikTok), route maps on X |
+| App Launch | Route Planner app features, onboarding, user stories | 25% | Carousels (Instagram + LinkedIn), demo videos (TikTok) |
+| Advocacy & Infrastructure | Cycling infrastructure wins and gaps — data-backed | 20% | LinkedIn long-form, Instagram infographics |
+| Rider Spotlight | Weekly spotlight — one real rider per week across all platforms | 15% | Reel (Instagram), short video (TikTok), text post (LinkedIn) |
+| Community & UGC | #RideWithUrbanCycle challenge, poll, community repair night coverage | 10% | Instagram Story, X text, LinkedIn community post |
+
+### Caption Strategy
+
+All captions will use A/B/C variant framework. Selection criteria:
+- Route Stories and App Launch → Variant A (direct, factual, product-specific)
+- Rider Spotlight → Variant B (narrative-first)
+- Community and Advocacy → Variant C (question hook for comments)
+
+---
+
+## Deliverables
+
+| Deliverable | Format | Cadence |
+|---|---|---|
+| Social Campaign Brief | Markdown | Once (at campaign start) |
+| Content Calendar | Markdown | Monthly refresh (3 deliveries) |
+| Platform Publishing Plan | Markdown | Once (at campaign start) |
+| Caption Copy Deck | Markdown | Monthly (A/B/C per post) |
+| Scheduling Manifest | JSON | Monthly (submitted on approval) |
+| Analytics Brief | Markdown | Monthly (3 deliveries) |
+| Q3 Campaign Wrap Report | Markdown | Once (at campaign end) |
+
+---
+
+## Engagement Tiers
+
+### Tier 1 — Campaign Starter
+
+**Scope:** 2 platforms (Instagram + LinkedIn), 3 posts/week each, 30-day calendar per month
+
+**Includes:** Campaign Brief, 30-day Content Calendar, Caption Copy Deck (A/B variants), Monthly Analytics Brief
+
+**Pricing:** $2,500/month
+
+**Best for:** Urban Cycle maintaining current Instagram + LinkedIn presence without TikTok expansion.
+
+---
+
+### Tier 2 — Multi-Platform Growth *(Recommended)*
+
+**Scope:** 4 platforms (Instagram + TikTok + LinkedIn + X), 5 posts/week Instagram and TikTok, 3x/week LinkedIn, daily X
+
+**Includes:** Full Campaign Brief, 90-day Content Calendar, Platform Publishing Plan, Caption Copy Deck (A/B/C), Scheduling Manifest (Postiz API), 3× Monthly Analytics Briefs
+
+**Pricing:** $6,500/month
+
+**Best for:** Urban Cycle's Q3 app launch requiring full platform saturation and Reel-first content strategy.
+
+---
+
+### Tier 3 — Full Social Media Operator
+
+**Scope:** 5 platforms including Pinterest (Q4 add), Reels 5x/week, weekly UGC challenge management, Postiz multi-workspace scheduling
+
+**Includes:** All Tier 2 deliverables + weekly analytics check-in, quarterly strategy review, Pinterest campaign, Postiz Scheduling API management
+
+**Pricing:** $11,000/month
+
+**Best for:** Urban Cycle treating social media as a primary growth channel with a dedicated content team producing assets.
+
+---
+
+## ROI Projection
+
+| Scenario | Baseline Assumptions | Projected Outcome by Sep 30 | Source |
+|---|---|---|---|
+| Conservative (Tier 1) | 2 platforms, 3 posts/week each, avg 2.5% engagement | 60,000 impressions/month; +400 followers/month | Q2 actual data + Rival IQ 2026 benchmark |
+| Mid (Tier 2 — Recommended) | 4 platforms, full cadence, Reel-first Instagram, TikTok launch | 120,000 impressions/month; +1,500 followers/month; 200 app downloads/month attributed to social | Q2 actuals + TikTok Reel discovery coefficient 3.2× |
+| Aggressive (Tier 3) | 5 platforms, daily Reels, UGC challenge, Postiz automation | 200,000 impressions/month; +2,500 followers/month; 500+ app installs attributed | Comparable brand case (Moov cycling app, Q1 2026) |
+
+---
+
+## Next Steps
+
+1. Select engagement tier (Tier 2 recommended based on Q3 app launch goals)
+2. Approve Q3 Campaign Brief (draft to be shared within 3 business days)
+3. Complete TikTok brand kit section (currently empty in brand kit)
+4. Connect Instagram, TikTok, LinkedIn, and X in Postiz admin UI
+5. Set campaign start date — earliest available: 2026-07-01

package/assets/worker-kits/growthub-postiz-social-v1/examples/content-calendar-sample.md

@@ -0,0 +1,75 @@
+# Content Calendar — Sample
+
+<!-- Sample: Urban Cycle | Q2 2026 Urban Mobility Month | v1 | 2026-04-15 -->
+<!-- This is a filled example demonstrating the expected format. Data is fictitious but realistic. -->
+
+---
+
+## Calendar Header
+
+| Field | Value |
+|---|---|
+| Client | Urban Cycle |
+| Campaign | Q2 2026 — Urban Mobility Month (Week 1 excerpt) |
+| Period | 2026-05-01 to 2026-05-07 |
+| Platforms | instagram, linkedin, twitter |
+| Total Posts (Week 1) | 11 |
+| Generated By | postiz-social-operator |
+
+---
+
+## Posting Cadence Summary
+
+| Platform | Posts/Week | Best Times (ET) | Content Mix |
+|---|---|---|---|
+| instagram | 5 | Mon/Wed/Fri: 9am; Tue/Thu: 7pm | 40% Route Stories, 30% Advocacy, 20% Gear, 10% Community |
+| linkedin | 3 | Tue: 8am, Thu: 8am, Sat: 10am | 50% Advocacy, 30% Community Spotlight, 20% Brand |
+| twitter | daily | 8am and 12pm | 40% Advocacy, 30% Route, 20% Community, 10% Gear |
+
+---
+
+## Content Calendar (Week 1 Sample)
+
+| Date | Day | Platform | Theme Pillar | Post Type | Caption Preview (first 100 chars) | CTA | Media Notes | Status |
+|---|---|---|---|---|---|---|---|---|
+| 2026-05-01 | Friday | instagram | Route Stories | image | "Friday route drop: The Lakeshore Loop — 8km of waterfront commuting bliss. No car lanes. No s..." | Link in bio | 1080×1350 portrait; sunrise on lake path; brand blue overlay in corner | draft |
+| 2026-05-01 | Friday | twitter | Advocacy | text | "May is Urban Mobility Month. 68% of people who live within 5km of work still drive. What would..." | What would change your commute? Reply below | Text only | draft |
+| 2026-05-03 | Sunday | instagram | Story | story | "Quick poll: Do you cycle to work? 🚲 YES / 🚗 Not yet" | Vote in story | Instagram Story format; brand template with poll sticker | draft |
+| 2026-05-04 | Monday | instagram | Advocacy & Infrastructure | image | "Amsterdam added 7km of protected bike lanes last month. That's more than most North American ci..." | Link in bio | 1080×1080 square; split-screen city comparison graphic | draft |
+| 2026-05-04 | Monday | twitter | Route Stories | text + image | "Your Monday commute route matters. Here's the Westside Cut — 12 minutes faster than the subway..." | Try the route — link in bio | 1200×675 landscape map image with route overlay | draft |
+| 2026-05-05 | Tuesday | linkedin | Advocacy | text + image | "72% of urban commuters cite safety as the #1 barrier to cycling. Yet cities that invest in prot..." | What infrastructure change would make you ride? Comment below | 1200×627 landscape; infographic on cycling safety stats | draft |
+| 2026-05-06 | Wednesday | instagram | Gear & Technique | carousel | "5 locks that actually work (and 2 that don't). Swipe for the breakdown →" | Save this | 5-slide carousel; 1080×1080; product photos + ratings | draft |
+| 2026-05-06 | Wednesday | twitter | Community | text | "Community repair night recap: 23 bikes tuned, 4 new riders taught their first brake adjust, 1 p..." | Find your local repair night — link in bio | Text only | draft |
+| 2026-05-07 | Thursday | linkedin | Community Spotlight | text + image | "Rider of the week: Maria C. — full-time nurse, 14km commute, 3 years running. No excuses, no c..." | Share your commute story in the comments | 1200×627; portrait photo of Maria with bike outside hospital | draft |
+| 2026-05-07 | Thursday | instagram | Community Spotlight | reel | "Maria cycles 14km each way to her nursing shift. Every. Single. Day. Here's her route." | Follow for weekly rider stories | 1080×1920 Reel; 30s; talking head + B-roll of commute route | draft |
+| 2026-05-07 | Thursday | twitter | Gear | text + image | "The one thing every urban cyclist needs but nobody talks about: a chain tensioner. Here's why →" | Reply with your go-to gear | 1200×675; product close-up with annotation | draft |
+
+---
+
+## Theme Distribution (Week 1)
+
+| Pillar | Posts | % of Week |
+|---|---|---|
+| Route Stories | 2 | 18% |
+| Advocacy & Infrastructure | 3 | 27% |
+| Gear & Technique | 2 | 18% |
+| Community Spotlight | 3 | 27% |
+| Story / Poll | 1 | 9% |
+
+---
+
+## Platform Distribution (Week 1)
+
+| Platform | Total Posts | % of Week |
+|---|---|---|
+| instagram | 6 | 55% |
+| linkedin | 2 | 18% |
+| twitter | 3 | 27% |
+
+---
+
+## Notes
+
+- May 5 (Tuesday) is Bike to Work Day — plan a campaign-specific post for all platforms
+- May 7 (Thursday) Maria Spotlight requires photo approval before scheduling
+- Blackout period: May 12–13 (Victoria Day weekend in Canada) — reduce LinkedIn frequency

package/assets/worker-kits/growthub-postiz-social-v1/examples/social-campaign-sample.md

@@ -0,0 +1,104 @@
+# Social Campaign Brief — Sample
+
+<!-- Sample: Urban Cycle | Q2 2026 Brand Awareness Campaign | v1 | 2026-04-15 -->
+<!-- This is a filled example demonstrating the expected detail level. Data is fictitious but realistic. -->
+
+---
+
+## Project Overview
+
+| Field | Value |
+|---|---|
+| Client | Urban Cycle |
+| Campaign Name | Q2 2026 — Urban Mobility Month |
+| Campaign Objective | Brand awareness + community growth |
+| Campaign Window | 2026-05-01 to 2026-06-30 |
+| Total Duration | 60 days |
+| Posting Cadence | 5x per week on Instagram; 3x per week on LinkedIn; daily on X |
+| Target Platforms | instagram, linkedin, twitter |
+| Execution Mode | agent-only |
+
+---
+
+## Campaign Objective
+
+Urban Cycle aims to establish itself as the leading brand voice in urban cycling advocacy during May and June 2026 — peak cycling season in North American cities. The campaign targets awareness and community building rather than direct conversion. Success is a 15% increase in Instagram followers, 25,000 monthly impressions across platforms, and at least 3 user-generated content posts tagged with #UrbanCycleMonth by campaign end.
+
+---
+
+## Target Platforms
+
+| Platform | Audience Fit | Content Format | Primary Goal |
+|---|---|---|---|
+| instagram | 68% of Urban Cycle's target demo (25–40, urban) are active Instagram users; visual platform aligns with cycling lifestyle | Static image, Reel, Story | Brand awareness, follower growth |
+| linkedin | B2B reach for cycling infrastructure decision-makers, urban planners, and corporate wellness buyers | Text + image, Document carousel | Thought leadership, B2B pipeline |
+| twitter | Real-time conversation during cycling events and advocacy moments; 42% of Urban Cycle's audience follows cycling news on X | Text, image | Community, newsjacking, advocacy |
+
+---
+
+## Audience Profile
+
+### Primary Audience
+
+| Attribute | Description |
+|---|---|
+| Age Range | 25–40 |
+| Interests | Urban cycling, sustainability, active commuting, city planning |
+| Platforms Most Active | Instagram, X |
+| Pain Points | Lack of safe cycling infrastructure, inaccessible bike-share programs, no unified community platform |
+| Content Preferences | Inspiring imagery, practical route tips, advocacy wins, behind-the-scenes city cycling stories |
+
+### Secondary Audience
+
+| Attribute | Description |
+|---|---|
+| Age Range | 18–25 |
+| Interests | Environmental activism, side hustles, fixie culture |
+| Platforms Most Active | Instagram, TikTok |
+
+---
+
+## KPI Targets
+
+| Metric | Target | Measurement Method |
+|---|---|---|
+| Impressions | 25,000 / month | Platform native analytics |
+| Engagement Rate | ≥3.5% on Instagram | (likes + comments + shares + saves) / impressions × 100 |
+| Follower Growth | +500 net new Instagram followers | Platform native |
+| Link Clicks | 300 clicks to urbancycle.com (bio link + LinkedIn posts) | UTM tracking |
+| UGC Posts | ≥3 posts tagged #UrbanCycleMonth | Manual search |
+
+---
+
+## Content Theme Pillars
+
+| Pillar | Theme | Content Mix | Example Topics |
+|---|---|---|---|
+| 1 | Route Stories | 35% | "Best commute routes in [city]", "Hidden cycling paths", "Weekend ride reports" |
+| 2 | Advocacy & Infrastructure | 25% | "Cities doing cycling right", "New bike lane wins", "Open letter to city planners" |
+| 3 | Gear & Technique | 20% | "Essential cycling gear for commuters", "Maintenance tips", "Lock your bike right" |
+| 4 | Community Spotlight | 15% | "Rider of the week", "Local group rides", "Community repair nights" |
+| 5 | Brand & Behind the Scenes | 5% | "How Urban Cycle started", "Meet the team", "What we're building next" |
+
+---
+
+## Brand Voice
+
+| Attribute | Spec |
+|---|---|
+| Tone | Passionate, community-first, data-informed. We advocate — we don't preach. |
+| Words to Use | "ride", "route", "commute", "community", "advocate", "city", "local" |
+| Words to Avoid | "disruptive", "hustle", "hack", "crush" |
+| Emoji Usage | 2–3 on Instagram, 0–1 on LinkedIn, 0–1 on X |
+| CTA Style | Community invitation: "Join us", "Share your route", "What's your city?", "Tag a rider" |
+
+---
+
+## Deliverables Scope
+
+- [x] Content Calendar (60 days, 3 platforms)
+- [x] Platform Publishing Plan
+- [x] Caption Copy Deck (A/B/C variants)
+- [ ] Scheduling Manifest (agent-only dry-run)
+- [ ] Analytics Brief (end of campaign)
+- [ ] Client Proposal

package/assets/worker-kits/growthub-postiz-social-v1/growthub-meta/README.md

@@ -0,0 +1,128 @@
+# Growthub Meta — growthub-postiz-social-v1
+
+---
+
+## Kit Identity
+
+| Field | Value |
+|---|---|
+| Kit ID | `growthub-postiz-social-v1` |
+| Version | `1.0.0` |
+| Schema Version | `2` |
+| Type | `worker` |
+| Family | `operator` |
+| Execution Mode | `export` |
+| Activation Modes | `["export"]` |
+| Visibility | `public-open-source` |
+| Source Repo | `growthub-local` |
+| Frozen At | `2026-04-15T00:00:00.000Z` |
+
+---
+
+## What This Kit Does
+
+The Growthub Postiz Social Media Studio is a worker kit that wraps the [Postiz](https://github.com/gitroomhq/postiz-app) open-source social media scheduling platform (~28,000 GitHub stars, MIT license) to produce AI-assisted social media campaigns, content calendars, caption copy decks, and scheduling manifests across 28+ platforms.
+
+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 `postiz-social-operator` worker handles the complete 10-step social media campaign workflow.
+
+---
+
+## Folder Structure
+
+```
+growthub-postiz-social-v1/
+  kit.json                              ← Kit manifest (schemaVersion: 2)
+  QUICKSTART.md                         ← Setup guide
+  .env.example                          ← Environment template
+  skills.md                             ← Master methodology doc (read at every session)
+  output-standards.md                   ← Output naming, structure, quality bar
+  runtime-assumptions.md                ← Frozen upstream assumptions
+  validation-checklist.md              ← Pre-session + kit validation checklists
+  bundles/
+    growthub-postiz-social-v1.json     ← Bundle manifest
+  workers/
+    postiz-social-operator/
+      CLAUDE.md                         ← Agent operating instructions (entrypoint)
+  brands/
+    _template/
+      brand-kit.md                      ← Blank client brand kit template
+    growthub/
+      brand-kit.md                      ← Growthub internal reference example
+    NEW-CLIENT.md                       ← Instructions for adding new clients
+  setup/
+    clone-fork.sh                       ← Clones Postiz, runs docker compose up
+    verify-env.mjs                      ← Verifies fork, API, workspace ID, API key
+    check-deps.sh                       ← Verifies Node, Docker, docker compose, git
+  output/
+    README.md                           ← Output directory structure and naming
+  templates/                            ← 7 production-quality campaign templates
+    social-campaign-brief.md
+    content-calendar.md
+    platform-publishing-plan.md
+    caption-copy-deck.md
+    scheduling-manifest.md
+    analytics-brief.md
+    client-proposal.md
+  examples/                             ← 4 filled samples for reference
+    social-campaign-sample.md
+    content-calendar-sample.md
+    analytics-brief-sample.md
+    client-proposal-sample.md
+  docs/                                 ← 4 technical reference documents
+    postiz-fork-integration.md
+    platform-coverage.md
+    ai-caption-layer.md
+    bullmq-queue-layer.md
+  growthub-meta/
+    README.md                           ← This file
+    kit-standard.md                     ← Kit rules and required-files contract
+```
+
+---
+
+## Activation
+
+This kit is activated in `export` mode:
+
+1. CLI exports the kit to a local folder
+2. User points Claude Code's Working Directory at the exported folder root
+3. `workers/postiz-social-operator/CLAUDE.md` is the agent entrypoint
+
+No server-side activation is required. The kit is fully self-contained.
+
+---
+
+## Upstream Fork
+
+| Field | Value |
+|---|---|
+| Fork Repo | https://github.com/gitroomhq/postiz-app |
+| License | MIT |
+| Default Clone Path | `~/postiz-app` |
+| Env Var Override | `POSTIZ_FORK_PATH` |
+| Services | Docker Compose: Postiz app (port 3000), Redis (6379), PostgreSQL (5432) |
+
+---
+
+## Supported Output Categories
+
+| Category | Templates | Examples |
+|---|---|---|
+| Social Campaign Briefs | `templates/social-campaign-brief.md` | `examples/social-campaign-sample.md` |
+| Content Calendars | `templates/content-calendar.md` | `examples/content-calendar-sample.md` |
+| Platform Publishing Plans | `templates/platform-publishing-plan.md` | — |
+| Caption Copy Decks | `templates/caption-copy-deck.md` | — |
+| Scheduling Manifests | `templates/scheduling-manifest.md` | — |
+| Analytics Briefs | `templates/analytics-brief.md` | `examples/analytics-brief-sample.md` |
+| Client Proposals | `templates/client-proposal.md` | `examples/client-proposal-sample.md` |
+
+---
+
+## Related Kits
+
+| Kit | Family | Purpose |
+|---|---|---|
+| `creative-strategist-v1` | workflow | Campaign strategy and creative briefs |
+| `growthub-email-marketing-v1` | operator | Email marketing campaigns |
+| `growthub-open-higgsfield-studio-v1` | studio | AI video generation via Open Higgsfield |
+| `growthub-geo-seo-v1` | studio | GEO + SEO auditing |

package/assets/worker-kits/growthub-postiz-social-v1/growthub-meta/kit-standard.md

@@ -0,0 +1,113 @@
+# Kit Standard — growthub-postiz-social-v1
+
+**These rules govern the kit's structure, agent behavior, and output contract. All operators and maintainers must follow them.**
+
+---
+
+## Required Files Contract
+
+The following files must be present in every valid kit installation. Any missing file constitutes a broken kit.
+
+| File | Purpose | Can Be Empty? |
+|---|---|---|
+| `kit.json` | Kit manifest | No — must be valid JSON with schemaVersion: 2 |
+| `QUICKSTART.md` | User-facing setup guide | No |
+| `.env.example` | Environment template | No |
+| `skills.md` | Master methodology doc | No — must contain all 10 steps |
+| `output-standards.md` | Output rules | No |
+| `runtime-assumptions.md` | Upstream assumptions | No |
+| `validation-checklist.md` | Pre-session checklist | No |
+| `workers/postiz-social-operator/CLAUDE.md` | Agent entrypoint | No |
+| `brands/_template/brand-kit.md` | Blank brand kit template | No |
+| `brands/growthub/brand-kit.md` | Example brand kit | No |
+| `brands/NEW-CLIENT.md` | New client instructions | No |
+| `setup/clone-fork.sh` | Fork installation script | No |
+| `setup/verify-env.mjs` | Environment verification | No |
+| `setup/check-deps.sh` | Dependency check | No |
+| `output/README.md` | Output directory guide | No |
+| All 7 template files | Campaign output templates | No — each must have all sections |
+| All 4 example files | Reference samples | No — must contain realistic filled data |
+| All 4 doc files | Technical reference | No |
+| `bundles/growthub-postiz-social-v1.json` | Bundle manifest | No |
+| `growthub-meta/README.md` | Kit metadata | No |
+| `growthub-meta/kit-standard.md` | This file | No |
+
+---
+
+## Bundle Contract
+
+| Requirement | Rule |
+|---|---|
+| Bundle ID | Must match kit ID: `growthub-postiz-social-v1` |
+| Kit ID in bundle | Must be `growthub-postiz-social-v1` |
+| Worker ID in bundle | Must be `postiz-social-operator` |
+| Schema version | Must be `2` |
+| `requiredFrozenAssets` | Must list all files in `kit.json` `frozenAssetPaths` |
+| Export folder name | `growthub-agent-worker-kit-postiz-social-v1` |
+| Export zip name | `growthub-agent-worker-kit-postiz-social-v1.zip` |
+
+---
+
+## Agent Rules
+
+### Workflow Order
+
+The operator must follow the 10-step workflow in `workers/postiz-social-operator/CLAUDE.md` strictly. Steps must not be skipped or reordered. The environment gate (Step 0) must run before anything else.
+
+### Platform IDs
+
+The operator must only use 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 Postiz instance and suggest the nearest supported alternative.
+
+### Caption Variants
+
+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.
+
+### Scheduling Manifest
+
+When a scheduling manifest is produced:
+- `dryRun` must be `true` in agent-only mode
+- All `scheduledAt` values must be ISO 8601 with explicit timezone
+- All `postId` values must follow the naming convention
+- No manifest may reference a platform not confirmed to be connected in the Postiz instance
+
+### No Secrets in Outputs
+
+The operator must never include `DATABASE_URL`, `REDIS_URL`, `JWT_SECRET`, OAuth tokens, or any other secret value in any output file. `.env.example` uses placeholder comments only.
+
+### Template-Bound Outputs
+
+All output artifacts must use the templates in `templates/`. The operator must not invent new template schemas or change the required section structure.
+
+---
+
+## Runtime Rules
+
+### Three Execution Modes Are First-Class
+
+`local-fork`, `agent-only`, and `hybrid` are all valid execution modes. The kit must never require local-fork 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.
+
+### Postiz Is the Reference Substrate
+
+The platform integrations, BullMQ queue configuration, and API contract in the Postiz fork are the source of truth for scheduling behavior. The kit documents and wraps that behavior — it does not redefine it. When the upstream Postiz API changes, `runtime-assumptions.md` must be updated.
+
+### Markdown Is the Primary Output Format
+
+All campaign artifacts are Markdown files. The scheduling manifest is a JSON file. These are the canonical records — no other formats are produced by this kit unless explicitly requested.
+
+---
+
+## Versioning Rules
+
+| Scenario | Action |
+|---|---|
+| Bug fix in a template or doc file | Patch version bump: `1.0.0` → `1.0.1` |
+| New template or platform added | Minor version bump: `1.0.0` → `1.1.0` |
+| Workflow restructured or output schema changed | Major version bump: `1.0.0` → `2.0.0` |
+| Upstream Postiz adds new platform integration | Minor bump + update `runtime-assumptions.md` and `docs/platform-coverage.md` |
+| Postiz changes API contract | Major bump if breaking + update `runtime-assumptions.md` and `docs/bullmq-queue-layer.md` |
+
+Version bumps must update:
+- `kit.json` → `kit.version`
+- `bundles/growthub-postiz-social-v1.json` → `bundle.version`
+- `growthub-meta/README.md` → Version field
+- `runtime-assumptions.md` → Frozen date and changelog note