@growthub/cli 0.14.5 → 0.14.8

package/assets/worker-kits/growthub-postiz-social-v1/docs/postiz-fork-integration.md

@@ -1,143 +0,0 @@
-# Postiz Fork Integration
-
-**How this kit integrates with the Postiz open-source social media platform.**
-
----
-
-## What Postiz Is
-
-[Postiz](https://github.com/gitroomhq/postiz-app) is an open-source, self-hosted social media scheduling and automation platform built on NestJS + Next.js. It supports 28+ social media platforms and ships with a BullMQ job queue, multi-workspace management, AI caption generation, media upload, and a public REST API.
-
-GitHub: https://github.com/gitroomhq/postiz-app
-License: MIT
-Stars: ~28,000+ (as of kit creation)
-
----
-
-## Integration Architecture
-
-```
-growthub-postiz-social-v1 (this kit)
-  │
-  ├── workers/postiz-social-operator/CLAUDE.md
-  │     Agent operating law — drives campaign planning, caption drafts,
-  │     scheduling manifest generation, and analytics briefing
-  │
-  ├── setup/clone-fork.sh
-  │     Clones gitroomhq/postiz-app → ~/postiz-app
-  │     Runs docker compose up -d (starts Postiz + Redis + PostgreSQL)
-  │     Waits for API healthcheck at http://localhost:3000/api/healthcheck
-  │
-  ├── setup/verify-env.mjs
-  │     Checks fork existence, API reachability, POSTIZ_WORKSPACE_ID, ANTHROPIC_API_KEY
-  │
-  └── templates/scheduling-manifest.md
-        BullMQ-compatible JSON manifest format for bulk post scheduling
-        via POST /api/v1/posts/bulk
-```
-
----
-
-## Service Topology
-
-When running in local-fork mode, Postiz operates as a Docker Compose stack:
-
-```
-postiz-app container (port 3000)
-  ├── NestJS API (apps/backend/)         ← REST API, BullMQ job scheduler
-  └── Next.js Frontend (apps/frontend/)  ← Admin UI, calendar view, analytics
-
-postiz-redis container (port 6379)
-  └── Redis                              ← BullMQ queue backend, session cache
-
-postiz-postgres container (port 5432)
-  └── PostgreSQL                         ← Posts, workspaces, platform credentials, analytics
-```
-
-All services are defined in `docker-compose.yml` at the fork root.
-
----
-
-## Postiz API — Key Endpoints Used By This Kit
-
-| Endpoint | Method | Purpose |
-|---|---|---|
-| `/api/healthcheck` | GET | Verify Postiz is running |
-| `/api/v1/workspace` | GET | Retrieve workspace ID and metadata |
-| `/api/v1/posts/bulk` | POST | Submit scheduling manifest |
-| `/api/v1/posts/{id}` | GET | Verify a scheduled post |
-| `/api/v1/analytics` | GET | Retrieve engagement analytics |
-| `/api/v1/queue/health` | GET | Check BullMQ queue health |
-| `/api/v1/posts/ai/generate` | POST | AI caption generation (Postiz-side) |
-
-Authentication is via JWT bearer token. Obtain from Postiz admin UI → Settings → API Keys.
-
----
-
-## Platform Integration Layer
-
-Platform integrations live under `libraries/nestjs-libraries/src/integrations/` in the Postiz repo. Each integration file:
-- Defines the OAuth flow for connecting the platform account
-- Implements `post()` for publishing content
-- Implements `analytics()` for pulling engagement data
-- Declares the integration ID (used as the `platform` field in scheduling manifests)
-
-When this kit generates a scheduling manifest, platform IDs must match the integration IDs in the running Postiz instance. See `docs/platform-coverage.md` for the full list.
-
----
-
-## AI Caption Generation
-
-Postiz has its own AI caption generation endpoint (`/api/v1/posts/ai/generate`), activated when `OPENAI_API_KEY` or `ANTHROPIC_API_KEY` is set in the Postiz `.env`. This is **separate** from the agent-side caption drafting in this kit.
-
-**This kit's caption workflow:**
-- The `postiz-social-operator` agent drafts A/B/C caption variants using its own reasoning and the AI caption methodology in `docs/ai-caption-layer.md`
-- Postiz's own AI caption feature is available to the user independently in the admin UI
-- The kit does not call the Postiz AI endpoint — it produces its own caption drafts
-
----
-
-## BullMQ Queue Behavior
-
-When a post is submitted to Postiz via `POST /api/v1/posts/bulk`:
-
-1. Postiz validates the payload against the workspace's connected platforms
-2. Each post is enqueued in BullMQ with a delay calculated from `scheduledAt - now()`
-3. When the delay expires, BullMQ triggers the `publish-post` job
-4. The job calls the platform integration's `post()` method
-5. On success: post marked as `published` in PostgreSQL
-6. On failure: retried up to 3 times (configurable), then moved to dead letter queue
-
-Monitor the queue via Postiz admin UI → Queue Management, or via `GET /api/v1/queue/health`.
-
----
-
-## Workspace Isolation
-
-Postiz supports multiple workspaces. Each workspace has:
-- Its own set of connected platform accounts
-- Its own posting queue
-- Its own analytics data
-- A UUID (`workspaceId`) required in all API calls
-
-The `POSTIZ_WORKSPACE_ID` in this kit's `.env` must match the workspace configured in the Postiz admin UI. Get it from Settings → Workspace in the admin UI, or from `GET /api/v1/workspace`.
-
----
-
-## Inspecting the Fork Before Planning
-
-Before generating any campaign or scheduling manifest, inspect the running Postiz instance:
-
-```bash
-# Verify all containers are running
-docker compose ps
-
-# Check API health
-curl http://localhost:3000/api/healthcheck
-
-# List connected platform integrations (requires auth)
-curl http://localhost:3000/api/v1/integrations \
-  -H "Authorization: Bearer <jwt-token>"
-```
-
-Do not generate scheduling manifests for platforms that are not connected and authorized in the Postiz admin UI. Unconnected platform posts will fail at publish time.

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

@@ -1,125 +0,0 @@
-# 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

@@ -1,127 +0,0 @@
-# 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

@@ -1,75 +0,0 @@
-# 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

@@ -1,104 +0,0 @@
-# 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