Initial commit

.claude-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "social-media-marketing",
+  "description": "Cross-channel social strategy, experimentation, and community governance",
+  "version": "1.0.0",
+  "author": {
+    "name": "GTM Agents",
+    "email": "opensource@intentgpt.ai"
+  },
+  "skills": [
+    "./skills/channel-roadmap-kit/SKILL.md",
+    "./skills/social-calendar-system/SKILL.md",
+    "./skills/community-sentiment-dashboard/SKILL.md",
+    "./skills/creative-iteration-playbook/SKILL.md"
+  ],
+  "agents": [
+    "./agents/social-strategy-director.md",
+    "./agents/community-insights-lead.md",
+    "./agents/campaign-optimization-manager.md"
+  ],
+  "commands": [
+    "./commands/plan-channel-roadmap.md",
+    "./commands/build-social-calendar.md",
+    "./commands/monitor-community-sentiment.md"
+  ]
+}

README.md

@@ -0,0 +1,3 @@
+# social-media-marketing
+
+Cross-channel social strategy, experimentation, and community governance

agents/campaign-optimization-manager.md

@@ -0,0 +1,27 @@
+---
+name: campaign-optimization-manager
+description: Runs creative and targeting experiments across social channels and scales winners.
+model: haiku
+---
+
+# Campaign Optimization Manager Agent
+
+## Responsibilities
+- Manage paid + organic experiments across priority platforms.
+- Analyze creative, audience, and bidding performance to identify lift opportunities.
+- Coordinate rapid creative refreshes, targeting updates, and budget shifts.
+- Maintain experiment backlog, guardrails, and documentation.
+
+## Workflow
+1. **Performance Sync** – pull latest channel dashboards, pixel data, and experiment logs.
+2. **Opportunity Scan** – flag fatigue, CPA spikes, or creative saturation.
+3. **Test Design** – propose hypotheses, success metrics, and resourcing requirements.
+4. **Activation** – brief creative and trafficking teams, QA builds, and schedule launches.
+5. **Review & Scale** – evaluate results, roll out winners, and archive learnings.
+
+## Outputs
+- Experiment brief with hypothesis, design, and success metrics.
+- Optimization plan (budget reallocations, creative refresh list, targeting tweaks).
+- Weekly performance recap with insights and next actions.
+
+---

agents/community-insights-lead.md

@@ -0,0 +1,27 @@
+---
+name: community-insights-lead
+description: Monitors community sentiment, engagement signals, and advocates across social platforms.
+model: sonnet
+---
+
+# Community Insights Lead Agent
+
+## Responsibilities
+- Track sentiment across owned/earned channels and escalate risks early.
+- Identify advocates, creators, and critics to inform engagement plays.
+- Package community insights for brand, product, and support stakeholders.
+- Maintain listening taxonomies, alerts, and response playbooks.
+
+## Workflow
+1. **Listening Sweep** – pull social listening dashboards, community moderation logs, and analyst notes.
+2. **Signal Classification** – bucket mentions by theme, sentiment, severity, and audience.
+3. **Insight Packaging** – compile highlights, lowlights, and opportunities per stakeholder.
+4. **Action Coordination** – route follow-ups to comms, support, or product teams.
+5. **Retrospective** – record resolved issues, advocate wins, and learning summaries.
+
+## Outputs
+- Sentiment dashboard snapshot with context + drivers.
+- Insight memo with recommended actions and owners.
+- Advocate/opportunity tracker for follow-up campaigns.
+
+---

agents/social-strategy-director.md

@@ -0,0 +1,28 @@
+---
+name: social-strategy-director
+description: Owns cross-channel social strategy, governance, and executive reporting.
+model: sonnet
+---
+
+
+# Social Strategy Director Agent
+
+## Responsibilities
+- Define channel roles, audience priorities, and content pillars.
+- Manage budget allocation, experimentation roadmaps, and platform mix.
+- Align brand, performance, and comms teams on unified narratives.
+- Report on reach, engagement, and business impact with exec-ready insights.
+
+## Workflow
+1. **Signal Review** – analyze performance dashboards, social listening, and campaign retros.
+2. **Strategy Update** – refresh channel mandates, KPIs, and experimentation focus.
+3. **Planning Sprint** – coordinate briefs with creative, paid, and community teams.
+4. **Governance & QA** – enforce brand safety, compliance, and approval workflows.
+5. **Executive Reporting** – synthesize impact, risks, and asks for leadership.
+
+## Outputs
+- Social strategy brief with goals, channel mix, and KPIs.
+- Experiment and content roadmap with owners + timelines.
+- Executive snapshot summarizing performance and recommendations.
+
+---

commands/build-social-calendar.md

@@ -0,0 +1,34 @@
+---
+name: build-social-calendar
+description: Generates detailed social content calendar with briefs, approvals, and publishing workflow.
+usage: /social-media-marketing:build-social-calendar --month "Jan 2026" --channels linkedin,instagram,tiktok --cadence daily --theme "AI Launch"
+---
+
+# Command: build-social-calendar
+
+## Inputs
+- **month** – month or date range for planning.
+- **channels** – comma-separated list of target platforms.
+- **cadence** – daily | 3x/week | weekly | custom.
+- **theme** – optional campaign or narrative focus.
+- **approvers** – optional comma-separated stakeholders for routing.
+
+## Workflow
+1. **Brief Intake** – gather campaign context, themes, assets, and guardrails.
+2. **Content Grid** – map publish rhythm per channel with hooks, CTAs, and creative notes.
+3. **Production Checklist** – assign owners, due dates, and asset requirements.
+4. **Approval Routing** – integrate compliance/brand reviewers and track status.
+5. **Publishing Package** – finalize copy, creative references, and tagging instructions.
+
+## Outputs
+- Calendar spreadsheet/table with channel, date, concept, CTA, owner, status.
+- Asset + production checklist for creative + video teams.
+- Approval + publishing tracker with deadlines and links.
+
+## Agent/Skill Invocations
+- `social-strategy-director` – sets priorities + reviews final plan.
+- `campaign-optimization-manager` – identifies content refresh needs + experiments.
+- `social-calendar-system` skill – enforces template + workflow steps.
+- `creative-iteration-playbook` skill – guides creative briefs and testing cadence.
+
+---

commands/monitor-community-sentiment.md

@@ -0,0 +1,34 @@
+---
+name: monitor-community-sentiment
+description: Produces sentiment dashboard, risk alerts, and advocacy opportunities across social + community channels.
+usage: /social-media-marketing:monitor-community-sentiment --window 14d --channels twitter,linkedin,community --alert-threshold high
+---
+
+# Command: monitor-community-sentiment
+
+## Inputs
+- **window** – lookback window (7d | 14d | 30d | custom).
+- **channels** – comma-separated list (twitter, linkedin, instagram, tiktok, reddit, community, discord, slack).
+- **alert-threshold** – low | medium | high (controls sensitivity and escalation path).
+- **topics** – optional keywords or product lines to prioritize.
+- **export** – dashboard | memo | csv (default dashboard).
+
+## Workflow
+1. **Data Aggregation** – pull social listening feeds, community platform exports, and support tags.
+2. **Sentiment & Theme Analysis** – classify mentions by sentiment, topic, influencer tier, and severity.
+3. **Risk & Opportunity Detection** – flag negative surges, competitor narratives, or advocate spikes.
+4. **Action Routing** – generate follow-up tasks for comms, support, product, or community teams.
+5. **Reporting Package** – compile dashboard/memo with highlights, risks, and recommended actions.
+
+## Outputs
+- Sentiment dashboard snapshot with charts and insight callouts.
+- Escalation list with owners, due dates, and response guidance.
+- Advocate/opportunity tracker for campaign activation.
+
+## Agent/Skill Invocations
+- `community-insights-lead` – leads listening + analysis.
+- `social-strategy-director` – reviews risks + executive updates.
+- `community-sentiment-dashboard` skill – structures reporting outputs.
+- `community-advocacy-toolkit` skill – (optional) seeds advocate activation follow-ups.
+
+---

commands/plan-channel-roadmap.md

@@ -0,0 +1,34 @@
+---
+name: plan-channel-roadmap
+description: Builds quarterly social channel roadmap with goals, content themes, and experiment focus.
+usage: /social-media-marketing:plan-channel-roadmap --quarter Q3 --channels linkedin,tiktok,youtube --objective demand --budget 250k
+---
+
+# Command: plan-channel-roadmap
+
+## Inputs
+- **quarter** – e.g., Q1, Q2, Q3, Q4.
+- **channels** – comma-separated list (linkedin, twitter, instagram, tiktok, youtube, facebook, community).
+- **objective** – demand | awareness | launch | advocacy | retention.
+- **budget** – optional numeric budget for paid activations.
+- **themes** – optional keywords or campaigns to highlight.
+
+## Workflow
+1. **Performance Review** – pull prior-quarter KPIs, benchmark vs targets, and insight highlights.
+2. **Objective Alignment** – map business priorities to channel roles and KPI stack.
+3. **Content & Experiment Plan** – outline tentpole moments, evergreen programs, and test roadmap.
+4. **Resourcing & Budget** – allocate dollars, creators, and tooling needs per channel.
+5. **Communication Pack** – prep brief + dashboard for leadership and execution teams.
+
+## Outputs
+- Channel roadmap doc (goals, KPIs, themes, experiments, owners).
+- Budget/resource allocation table with justifications.
+- Executive summary slide with key bets and risks.
+
+## Agent/Skill Invocations
+- `social-strategy-director` – leads strategy + narrative.
+- `campaign-optimization-manager` – contributes experiment roadmap + budget shifts.
+- `channel-roadmap-kit` skill – ensures roadmap template + governance requirements.
+- `social-calendar-system` skill – aligns content cadences + workflows.
+
+---

plugin.lock.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "internal://schemas/plugin.lock.v1.json",
+  "pluginId": "gh:gtmagents/gtm-agents:plugins/social-media-marketing",
+  "normalized": {
+    "repo": null,
+    "ref": "refs/tags/v20251128.0",
+    "commit": "9a51c1a15eee18c5213a8c79cec98fae32100982",
+    "treeHash": "1a87b2215e96e2da0273dc23354aaf1eb97126e7f089cdd88ddd5f41bbc82035",
+    "generatedAt": "2025-11-28T10:17:17.338445Z",
+    "toolVersion": "publish_plugins.py@0.2.0"
+  },
+  "origin": {
+    "remote": "git@github.com:zhongweili/42plugin-data.git",
+    "branch": "master",
+    "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
+    "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
+  },
+  "manifest": {
+    "name": "social-media-marketing",
+    "description": "Cross-channel social strategy, experimentation, and community governance",
+    "version": "1.0.0"
+  },
+  "content": {
+    "files": [
+      {
+        "path": "README.md",
+        "sha256": "55f75e34ff6386013d280391a22f6e37575cddcab779bb16e1355b9449659209"
+      },
+      {
+        "path": "agents/campaign-optimization-manager.md",
+        "sha256": "b8b45dc0d035eec6d1889224584be6ea54d694f9c1158c861086372579d45273"
+      },
+      {
+        "path": "agents/social-strategy-director.md",
+        "sha256": "f5519c5b661087e6a8979940f2917ec9ef6594a6ad06d06d8ebbd89e37226560"
+      },
+      {
+        "path": "agents/community-insights-lead.md",
+        "sha256": "1cbf596cbb2fcf307d1c0edf8f74d47397467665ff0317bdca17eb8f4425e094"
+      },
+      {
+        "path": ".claude-plugin/plugin.json",
+        "sha256": "de566be18091afeeb82eeb6439dfa58fca742b818ed58ef7403efc8c9b56e50f"
+      },
+      {
+        "path": "commands/monitor-community-sentiment.md",
+        "sha256": "3cc672d1c0c0b50c578492f6cf0f81202e31bfe5fbc9668ecea9862d9273189f"
+      },
+      {
+        "path": "commands/plan-channel-roadmap.md",
+        "sha256": "e3220fcb6faff12d8407d034aee9e585ec99e9c13ea4b1949bb643835f39994d"
+      },
+      {
+        "path": "commands/build-social-calendar.md",
+        "sha256": "af0d4c9ab95e5555f6e62d231dd81b79b34ac41810b688c74c957daf3f34345a"
+      },
+      {
+        "path": "skills/creative-iteration-playbook/SKILL.md",
+        "sha256": "86d50bfc255e0af6dd3c089b8942e3c3c5070daaff5a342c067fb91a3510e642"
+      },
+      {
+        "path": "skills/channel-roadmap-kit/SKILL.md",
+        "sha256": "9683c1647d651f23fa59293183ba45ddb6068d4701e71b00141647981f94c327"
+      },
+      {
+        "path": "skills/community-sentiment-dashboard/SKILL.md",
+        "sha256": "7e6c72b0f1bcaf71b6123ae914a0fcb00a59da64faa3328427fc9b48473a601c"
+      },
+      {
+        "path": "skills/social-calendar-system/SKILL.md",
+        "sha256": "3fadcc1c2cce46e92ac8029129c6978d2f9036b951606a3f7dfef0142f3ddb16"
+      }
+    ],
+    "dirSha256": "1a87b2215e96e2da0273dc23354aaf1eb97126e7f089cdd88ddd5f41bbc82035"
+  },
+  "security": {
+    "scannedAt": null,
+    "scannerVersion": null,
+    "flags": []
+  }
+}

skills/channel-roadmap-kit/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: channel-roadmap-kit
+description: Template system for building quarterly social channel roadmaps with KPIs
+  and experiments.
+---
+
+# Channel Roadmap Kit Skill
+
+## When to Use
+- Updating quarterly or monthly channel strategies.
+- Aligning stakeholders on goals, KPIs, and experimentation focus.
+- Communicating trade-offs on budget, bandwidth, and channel mix.
+
+## Framework
+1. **Channel Mandates** – define role, audience, KPIs, and health metrics per platform.
+2. **Goal & KPI Stack** – connect business objectives to reach, engagement, demand metrics.
+3. **Content & Experiment Pillars** – document themes, tentpoles, evergreen programs, and tests.
+4. **Budget & Resourcing** – allocate spend, creators, tooling, and operational support.
+5. **Governance** – approval flow, compliance requirements, and risk watchlist.
+
+## Templates
+- Channel one-pager (overview, KPIs, status, experiments).
+- Quarterly roadmap deck with heatmap view of initiatives.
+- Budget + resource tracker with justification notes.
+
+## Tips
+- Keep a running backlog of experiments to plug into future quarters.
+- Pair qualitative insight slides with KPI clips for executive storytelling.
+- Use with `plan-channel-roadmap` command for automation.
+
+---

skills/community-sentiment-dashboard/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: community-sentiment-dashboard
+description: Reporting template for tracking sentiment, risks, and advocacy signals
+  across social + community channels.
+---
+
+# Community Sentiment Dashboard Skill
+
+## When to Use
+- Weekly/monthly social listening readouts.
+- Real-time monitoring during launches, incidents, or crisis scenarios.
+- Executive updates that require quantified sentiment + qualitative insights.
+
+## Framework
+1. **Signal Sources** – social listening feeds, community platforms, support tags, surveys.
+2. **Sentiment Stack** – volume, sentiment %, topics, influencer tiers, escalation status.
+3. **Risk/Opportunity Board** – flagged issues, severity, owners, response progress.
+4. **Advocacy Spotlight** – top advocates, UGC, partnership opportunities.
+5. **Action Register** – follow-ups routed to comms, product, support, leadership.
+
+## Templates
+- Dashboard slide layout (KPI tiles + trend graphs + highlights/lowlights).
+- Escalation tracker with severity, owner, due date, next update.
+- Advocate tracker with contact info, potential activation ideas.
+
+## Tips
+- Set alert thresholds per channel to avoid noise fatigue.
+- Pair qualitative snippets with data visuals for executive context.
+- Use with `monitor-community-sentiment` for automated packet generation.
+
+---

skills/creative-iteration-playbook/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: creative-iteration-playbook
+description: Framework for briefing, testing, and scaling social creative variations.
+---
+
+# Creative Iteration Playbook Skill
+
+## When to Use
+- Refreshing creative fatigued campaigns.
+- Coordinating rapid creative experiments across paid + organic teams.
+- Documenting learnings with reusable creative formulas.
+
+## Framework
+1. **Creative Brief Template** – hook, CTA, proof, editing guidelines, mandatory/legal notes.
+2. **Testing Matrix** – map variables (concept, format, CTA, length, hook) across channels.
+3. **Production Workflow** – intake → concept → script/copy → edit → QA → publish.
+4. **Measurement & Tagging** – UTM/tag schema, performance scoreboard, insights log.
+5. **Scaling Guidelines** – roll-out thresholds, localization, evergreen library updates.
+
+## Templates
+- Single-slide creative brief + checklist.
+- Experiment tracker w/ hypotheses, variants, outcomes, next steps.
+- Evergreen asset library structure with tagging conventions.
+- **GTM Agents Hook/CTA Library** – per-channel prompt bank pulled from GTM Agents Social Media Manager playbooks @puerto/README.md#183-212.
+- **Runbook for Paid + Organic Sync** – outlines Monday creative standup, Wednesday QA, Friday results readout.
+- **Guardrail Sheet** – min engagement/CVR per channel before pausing or pivoting.
+
+## Tips
+- Pair qualitative notes (comments, watch time) with quantitative metrics.
+- Rotate creators and formats to avoid burnout and discover new winners.
+- Use with `build-social-calendar` and `campaign-optimization-manager` workflows.
+- Define success + kill thresholds before launching (e.g., CTR ≥1.5% for X, hook retention ≥35% on Reels).
+- Mirror GTM Agents escalation tree: Social Strategist → Marketing Director → Comms lead within 15 mins if sentiment spikes negative.
+- Keep Serena + Playwright handy for rapid landing page tweaks + visual QA.
+
+## GTM Agents Creative Iteration Overlay
+1. **Cadence**
+   - Monday: backlog grooming + prioritization (use hook library to seed briefs).
+   - Tuesday/Wednesday: production + QA (Pair design + copy pods, run Playwright visual checks).
+   - Thursday: launch + monitor guardrails in near real-time.
+   - Friday: learning sync → update evergreen library + share top performers in Weekly Packet.
+2. **Guardrail Actions**
+   - If two variants miss guardrails consecutively, trigger Sequential Thinking mini-RCA.
+   - Pause paid boosts if CPA worsens >20% vs baseline; notify Growth + RevOps.
+3. **Insight Logging**
+   - Capture quote-sized "formula" (hook + format + CTA) for each winning asset; store with metrics + reuse plan.
+
+## Tool Hooks
+- **Serena** – patch landing page snippets or marketing automation flows referenced in creative tests.
+- **Context7** – pull latest platform best-practice docs (LinkedIn ads specs, TikTok ratios) without leaving Claude.
+- **Sequential Thinking** – facilitate post-test retros and iteration hypotheses.
+- **Playwright** – automate screenshot packs for creative QA and stakeholder review.
+
+---

skills/social-calendar-system/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: social-calendar-system
+description: Operational template for building social content calendars with approvals
+  and publishing workflows.
+---
+
+# Social Calendar System Skill
+
+## When to Use
+- Planning monthly/quarterly content cadences across multiple channels.
+- Coordinating creative, copy, compliance, and publishing teams.
+- Tracking asset production status, approvals, and performance follow-ups.
+
+## Framework
+1. **Planning Grid** – date, channel, campaign, hook, CTA, creative needs, owner.
+2. **Workflow Stages** – concept → copy → creative → compliance → scheduled → published → recap.
+3. **Approval Matrix** – stakeholder list, SLAs, fallback approvers, escalation criteria.
+4. **Publishing Toolkit** – UTMs, tagging, asset specs, accessibility checklist.
+5. **Retrospective Tracker** – performance snapshot, learnings, reuse tags.
+
+## Templates
+- Calendar spreadsheet template with filters and status columns.
+- Approval routing form + automated reminder checklist.
+- Publishing checklist with QA steps per platform.
+- **GTM Agents Channel Prompt Library** – CTA + hook examples per LinkedIn, X, TikTok, YouTube Shorts @puerto/README.md#183-212.
+- **Weekly Performance Packet** – table covering reach, engagement, click/share ratio, SQL influence, sentiment summary.
+- **Crisis Escalation Tree** – Social Media Manager → Marketing Director → Comms lead.
+
+## Tips
+- Define color-coding or status chips to quickly spot blockers.
+- Record creative/performance notes to accelerate future refresh cycles.
+- Pair with `build-social-calendar` for auto-populated grids.
+- Set guardrails: per-channel minimum engagement rate (e.g., LinkedIn ≥2.5%, X ≥1.5%), unsubscribe or opt-out thresholds for paid boosts.
+- Mirror GTM Agents cadence: Monday plan review, Wednesday creative QA, Friday performance readout.
+- Keep an escalation macro ready—if sentiment dips below GTM Agents's acceptable range (RAG red), pause scheduled posts within 15 minutes.
+
+## GTM Agents Social Orchestration Overlay
+1. **Channel Pods** – assign pod leads per platform with shared brief + KPIs.
+2. **Creative Sprint Sync** – align with design/creative team on asset counts, format specs, and deadlines.
+3. **Distribution Tree** – map how primary stories cascade into derivative assets (threads, carousels, reels, shorts).
+4. **Insights Loop** – every Friday, share the Weekly Performance Packet with Growth, Demand Gen, and Exec comms.
+
+## Reporting Template
+```
+Week Ending: <Date>
+
+Channel | Goal | Target KPI | Actual | Guardrail | Notes
+LinkedIn | Demand gen POV | Engagement ≥2.5% | 3.1% | 1.8% | Exceeded; repurpose for email snippet
+X | Thought leadership | CTR ≥1.5% | 1.1% | 1.0% | Slight dip; test hook variant
+...
+
+Top Performing Assets:
+- <Title> – reason, reuse plan
+
+Risks/Escalations:
+- <Issue> – owner, action
+```
+
+## Guardrail Actions
+- Pause channel queue if guardrail broken twice in 48h and notify Marketing Director.
+- Trigger Playwright-driven QA if landing page links change mid-campaign.
+- Use Sequential Thinking to run a quick RCA when sentiment scores fall below threshold for two consecutive reports.
+
+---