@growthub/cli 0.14.5 → 0.14.8

package/assets/worker-kits/growthub-marketing-skills-v1/runtime-assumptions.md

@@ -1,46 +0,0 @@
-# Marketing Operator — Runtime Assumptions
-
-## Execution Environment
-
-The marketing operator runs inside any AI agent that can read markdown files and follow structured instructions. No specific runtime, language, or platform is required.
-
-**Supported adapters:**
-- Claude Code (primary reference)
-- Cursor
-- OpenAI Codex
-- Google Gemini
-- Windsurf
-- Any agent supporting the Agent Skills specification
-
-## File System Assumptions
-
-The operator assumes the Working Directory is pointed at the kit root. All paths are relative:
-
-```
-./skills.md                                    ← methodology (read every session)
-./brands/<client-slug>/product-marketing-context.md  ← brand context
-./templates/<domain>-<type>.md                 ← frozen deliverable templates
-./output/<client-slug>/<project-slug>/         ← all deliverables land here
-```
-
-## External Tool Integration (Optional)
-
-The operator can produce deliverables with zero external dependencies. When tools are available, they enhance the analysis:
-
-| Tool | Use | Required? |
-|---|---|---|
-| Web browser / web_fetch | Read live pages for CRO/SEO analysis | No — operator can analyze provided content |
-| Analytics API (GA4) | Pull real traffic data for recommendations | No — operator works with user-provided data |
-| Email platform API | Push sequences to email tools | No — operator exports platform-ready markdown |
-| SEO tools (Ahrefs, Semrush) | Pull backlink and ranking data | No — operator works with user-provided data |
-
-## Upstream Fork Relationship
-
-This kit wraps frameworks from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills). The upstream library provides the skill definitions and evaluation frameworks. This kit packages them into a Growthub worker kit with:
-
-- Product-marketing context as the brand grounding layer
-- Frozen templates for consistent deliverable structure
-- Output standards and naming conventions
-- Operator workflow with mandatory gates (3-question gate, context loading)
-
-The upstream library is a reference, not a runtime dependency. Skills are adapted and frozen into this kit's methodology. Updates to the upstream library can be pulled into future kit versions.

package/assets/worker-kits/growthub-marketing-skills-v1/setup/verify-env.mjs

@@ -1,81 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * verify-env.mjs — Marketing Operator environment verification
- *
- * Checks that the kit structure is intact and all required files exist.
- * No network calls. No API key requirements.
- */
-
-import fs from "node:fs";
-import path from "node:path";
-
-const kitRoot = process.cwd();
-
-const REQUIRED_FILES = [
-  "kit.json",
-  "bundles/growthub-marketing-skills-v1.json",
-  "skills.md",
-  "output-standards.md",
-  "runtime-assumptions.md",
-  "workers/marketing-operator/CLAUDE.md",
-  "brands/_template/product-marketing-context.md",
-  "brands/growthub/product-marketing-context.md",
-  "templates/cro-audit-brief.md",
-  "templates/seo-audit-report.md",
-  "templates/content-strategy-plan.md",
-  "templates/email-sequence-plan.md",
-  "templates/launch-checklist.md",
-  "templates/competitor-analysis.md",
-];
-
-const REQUIRED_DIRS = [
-  "templates",
-  "examples",
-  "docs",
-  "output",
-  "growthub-meta",
-];
-
-console.log("Marketing Operator — Environment Verification\n");
-console.log(`Kit root: ${kitRoot}\n`);
-
-let allGood = true;
-
-// Check kit.json is valid JSON
-try {
-  const kitJson = JSON.parse(fs.readFileSync(path.join(kitRoot, "kit.json"), "utf-8"));
-  console.log(`  kit.json: ${kitJson.kit?.id || "unknown"} v${kitJson.kit?.version || "?"}`);
-} catch {
-  console.log("  kit.json: MISSING or INVALID");
-  allGood = false;
-}
-
-// Check required files
-console.log("\nRequired files:");
-for (const file of REQUIRED_FILES) {
-  const exists = fs.existsSync(path.join(kitRoot, file));
-  console.log(`  ${exists ? "OK" : "MISSING"} ${file}`);
-  if (!exists) allGood = false;
-}
-
-// Check required directories
-console.log("\nRequired directories:");
-for (const dir of REQUIRED_DIRS) {
-  const exists = fs.existsSync(path.join(kitRoot, dir));
-  console.log(`  ${exists ? "OK" : "MISSING"} ${dir}/`);
-  if (!exists) allGood = false;
-}
-
-// Check for client brand kits beyond the template
-const brandsDir = path.join(kitRoot, "brands");
-if (fs.existsSync(brandsDir)) {
-  const brandDirs = fs.readdirSync(brandsDir).filter(
-    (d) => d !== "_template" && fs.statSync(path.join(brandsDir, d)).isDirectory()
-  );
-  console.log(`\nClient brand kits: ${brandDirs.length} (${brandDirs.join(", ") || "none besides template"})`);
-}
-
-// Summary
-console.log(`\n${allGood ? "All checks passed." : "Some checks failed. Review the output above."}`);
-process.exit(allGood ? 0 : 1);

package/assets/worker-kits/growthub-marketing-skills-v1/skills/README.md

@@ -1,23 +0,0 @@
-# `skills/` — nested sub-skill convention (primitive #5)
-
-A **sub-skill** is a full `SKILL.md`-addressable lane that a parent skill can spawn as a parallel sub-agent.
-
-## Convention
-
-```
-skills/
-├── README.md                        # this file
-└── <slug>/                          # kebab-case; matches the SKILL.md name
-    ├── SKILL.md                     # frontmatter + routing body (≤ 500 lines)
-    ├── references/                  # optional — long docs loaded on demand
-    ├── templates/                   # optional — reusable text/JS templates
-    └── scripts/                     # optional — deterministic helpers
-```
-
-Each sub-skill's frontmatter follows `@growthub/api-contract/skills::SkillManifest`. Sub-skills share the parent's `.growthub-fork/project.md` journal — they do not branch it.
-
-## Parallelism
-
-Spawn a sub-skill sub-agent when (a) the sub-skill's work is fully scoped by its own criteria, and (b) the parent's next step does not depend on intermediate state from the sub-skill. Each sub-skill run appends a row to `project.md::subSkillRuns` so the parent can read the outcome on return.
-
-See the parent `SKILL.md` `subSkills[]` array for the current roster.

package/assets/worker-kits/growthub-marketing-skills-v1/skills.md

@@ -1,157 +0,0 @@
-# Marketing Operator — Skills & Methodology Reference
-
-**Kit:** `growthub-marketing-skills-v1`
-**Upstream:** [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)
-
-This document is the operator's source of truth for skill dispatch, framework selection, and cross-domain chaining. Read it at the start of every session.
-
----
-
-## Skill Dispatch Table
-
-Map user intent to the correct marketing workflow. When intent is ambiguous, ask for clarification before selecting.
-
-| User Intent | Primary Skill | Framework | Template |
-|---|---|---|---|
-| Optimize page conversions | page-cro | 7-Dimension CRO Analysis | `templates/cro-audit-brief.md` |
-| Optimize signup flow | signup-flow-cro | Funnel Step Analysis | `templates/cro-audit-brief.md` |
-| Improve onboarding | onboarding-cro | Activation Milestone Mapping | `templates/cro-audit-brief.md` |
-| Optimize forms | form-cro | Field Friction Analysis | `templates/cro-audit-brief.md` |
-| Improve popups | popup-cro | Trigger & Timing Analysis | `templates/cro-audit-brief.md` |
-| Optimize paywall | paywall-upgrade-cro | Upgrade Path Analysis | `templates/cro-audit-brief.md` |
-| SEO audit | seo-audit | Technical + On-Page + E-E-A-T | `templates/seo-audit-report.md` |
-| AI search visibility | ai-seo | Citability + LLM Optimization | `templates/seo-audit-report.md` |
-| Programmatic SEO | programmatic-seo | Template Page Architecture | `templates/seo-audit-report.md` |
-| Site architecture | site-architecture | Information Architecture Audit | `templates/seo-audit-report.md` |
-| Schema markup | schema-markup | Structured Data Gap Analysis | `templates/seo-audit-report.md` |
-| Write copy | copywriting | Benefit-Driven Copy Framework | domain template |
-| Edit copy | copy-editing | Clarity & Conversion Editing | domain template |
-| Content strategy | content-strategy | Pillar + Distribution Planning | `templates/content-strategy-plan.md` |
-| Email sequence | email-sequence | Sequence Architecture (5 types) | `templates/email-sequence-plan.md` |
-| Cold email | cold-email | Outbound Sequence Framework | `templates/email-sequence-plan.md` |
-| Social content | social-content | Platform-Native Content | domain template |
-| Paid ads | paid-ads | Campaign Structure Framework | domain template |
-| Ad creative | ad-creative | Creative Brief + Hook Framework | domain template |
-| A/B test setup | ab-test-setup | Hypothesis-Driven Test Design | domain template |
-| Analytics tracking | analytics-tracking | Measurement Plan Framework | domain template |
-| Marketing ideas | marketing-ideas | Brainstorm + Prioritization Matrix | domain template |
-| Marketing psychology | marketing-psychology | Behavioral Framework Application | domain template |
-| Launch strategy | launch-strategy | Phased Launch Playbook | `templates/launch-checklist.md` |
-| Pricing strategy | pricing-strategy | Value-Based Pricing Analysis | domain template |
-| Competitor analysis | competitor-alternatives | Positioning Gap Analysis | `templates/competitor-analysis.md` |
-| Customer research | customer-research | Voice-of-Customer Extraction | domain template |
-| Churn prevention | churn-prevention | Retention Lever Analysis | domain template |
-| Free tool strategy | free-tool-strategy | Growth Loop Design | domain template |
-| Referral program | referral-program | Referral Mechanics Design | domain template |
-| Lead magnets | lead-magnets | Magnet-to-Offer Alignment | domain template |
-| Sales enablement | sales-enablement | Sales Content Mapping | domain template |
-| RevOps | revops | Pipeline-to-Revenue Analysis | domain template |
-| Community marketing | community-marketing | Community Growth Framework | domain template |
-| ASO audit | aso-audit | App Store Optimization | domain template |
-
----
-
-## Cross-Skill Chaining
-
-Skills are interconnected. When one analysis reveals a need in another domain, chain them in this order:
-
-**Discovery chains:**
-- customer-research → content-strategy → copywriting
-- competitor-alternatives → pricing-strategy → launch-strategy
-- analytics-tracking → ab-test-setup → page-cro
-
-**Optimization chains:**
-- seo-audit → content-strategy → programmatic-seo
-- page-cro → copywriting → ab-test-setup
-- email-sequence → copywriting → analytics-tracking
-
-**Growth chains:**
-- marketing-ideas → launch-strategy → paid-ads → analytics-tracking
-- customer-research → referral-program → community-marketing
-- lead-magnets → email-sequence → sales-enablement
-
-When chaining, complete the upstream skill's deliverable before starting the downstream skill. Do not merge outputs — each skill produces its own artifact.
-
----
-
-## Framework Summaries
-
-### CRO — 7-Dimension Analysis
-
-1. **Value Proposition Clarity** — Can users understand the offer within 5 seconds?
-2. **Headline Effectiveness** — Does the headline match traffic source messaging and promise a clear benefit?
-3. **CTA Placement & Copy** — Single primary action with benefit-driven language, visible without scrolling?
-4. **Visual Hierarchy** — Scannable layout with intentional whitespace guiding the eye?
-5. **Trust Signals** — Logos, testimonials, case studies, reviews positioned near decision points?
-6. **Objection Handling** — Are price, fit, difficulty, and risk concerns addressed before the CTA?
-7. **Friction Points** — Excessive form fields, confusing navigation, broken mobile experience?
-
-Output structure: Quick Wins → High-Impact Changes → A/B Test Hypotheses → Copy Alternatives
-
-### SEO — Technical + On-Page + E-E-A-T
-
-**Priority order:** Crawlability & indexation → Technical foundations → On-page optimization → Content quality → Authority & links
-
-**Technical**: robots.txt, XML sitemaps, site speed (LCP <2.5s, INP <200ms, CLS <0.1), mobile, HTTPS, URL structure
-**On-Page**: Title tags (50-60 chars), meta descriptions (150-160 chars), heading hierarchy, content depth, internal linking
-**E-E-A-T**: Experience signals, expertise demonstration, authority indicators, trust markers
-
-Output structure: Executive Summary → Findings by Priority → Prioritized Action Plan
-
-### Content Strategy — Pillar + Distribution
-
-**Content pillars**: Map 3-5 core topics to audience pain points and business goals
-**Gap analysis**: Identify missing content across awareness / consideration / decision stages
-**Editorial calendar**: Topic, format, channel, publish date, distribution plan
-**Distribution**: Organic, paid, earned, owned channel mapping per content piece
-
-### Email — Sequence Architecture
-
-Five standard types:
-- Welcome (5-7 emails / 12-14 days) — activation focus
-- Nurture (6-8 emails / 2-3 weeks) — trust through expertise
-- Re-engagement (3-4 emails / 2 weeks) — win-back or clean
-- Onboarding (5-7 emails / 14 days) — feature adoption
-- Event-based (variable) — trigger-dependent
-
-Principles: One email one job. Value before ask. Relevance over volume.
-
-### Launch — Phased Playbook
-
-**Pre-launch**: Audience building, waitlist, beta testing, asset preparation
-**Launch day**: Coordinated announcements, real-time monitoring, rapid response
-**Post-launch**: Iteration based on data, retention activation, growth loop setup
-
----
-
-## Evaluation Criteria by Domain
-
-### CRO Scoring (per dimension)
-- Strong (3): Optimized, no issues found
-- Adequate (2): Functional but improvement opportunities exist
-- Weak (1): Significant issues impacting conversions
-- Missing (0): Not present or fundamentally broken
-
-### SEO Priority Matrix
-- Critical: Blocking indexation or causing ranking penalties
-- High: Significant ranking impact, moderate effort to fix
-- Medium: Incremental improvement, low-moderate effort
-- Low: Nice-to-have, minimal ranking impact
-
-### Content Quality (E-E-A-T)
-- Experience: First-hand experience signals present
-- Expertise: Depth and accuracy of information
-- Authoritativeness: Source credibility and recognition
-- Trustworthiness: Accuracy, transparency, safety
-
----
-
-## Quality Bar
-
-Every deliverable must meet these criteria:
-1. Grounded in the client's product-marketing context — no generic advice
-2. Actionable — every finding has a specific recommendation with priority
-3. Structured — follows the template from `templates/`, section order preserved
-4. Evidence-based — recommendations cite specific findings, not assumptions
-5. Prioritized — critical items first, then quick wins, then long-term improvements
-6. Customer-language-first — use verbatim phrases from the product-marketing context over marketing jargon

package/assets/worker-kits/growthub-marketing-skills-v1/templates/competitor-analysis.md

@@ -1,81 +0,0 @@
-# Competitor Analysis — [Client]
-
-**Date:** YYYY-MM-DD
-**Version:** v1
-**Domain:** Competitive
-**Operator:** marketing-operator
-
----
-
-## Executive Summary
-
-<!-- 3-5 bullet points of key findings -->
-
----
-
-## Competitor Overview
-
-| Competitor | Type | Category | Pricing | Key Strength | Key Weakness |
-|---|---|---|---|---|---|
-| | Direct | | | | |
-| | Direct | | | | |
-| | Indirect | | | | |
-
----
-
-## Feature Matrix
-
-| Feature / Capability | [Your Product] | [Competitor 1] | [Competitor 2] | [Competitor 3] |
-|---|---|---|---|---|
-| | | | | |
-| | | | | |
-| | | | | |
-
----
-
-## Messaging Teardown
-
-### [Competitor 1]
-
-| Element | Their Approach | Opportunity for Us |
-|---|---|---|
-| Headline | | |
-| Value proposition | | |
-| Primary CTA | | |
-| Trust signals | | |
-| Objection handling | | |
-
-<!-- Repeat for each competitor -->
-
----
-
-## Positioning Gaps
-
-| Gap | Explanation | Opportunity |
-|---|---|---|
-| | | |
-| | | |
-
----
-
-## Pricing Comparison
-
-| Tier | [Your Product] | [Competitor 1] | [Competitor 2] |
-|---|---|---|---|
-| Free / Entry | | | |
-| Mid | | | |
-| Enterprise | | | |
-
----
-
-## Recommended Positioning Adjustments
-
-1. 
-2. 
-3. 
-
----
-
-## Next Steps
-
-- 

package/assets/worker-kits/growthub-marketing-skills-v1/templates/content-strategy-plan.md

@@ -1,75 +0,0 @@
-# Content Strategy Plan — [Client]
-
-**Date:** YYYY-MM-DD
-**Version:** v1
-**Domain:** Content
-**Operator:** marketing-operator
-
----
-
-## Executive Summary
-
-<!-- 3-5 bullet points of key decisions -->
-
----
-
-## Content Pillars
-
-| Pillar | Audience Pain Point | Business Goal | Content Types |
-|---|---|---|---|
-| | | | |
-| | | | |
-| | | | |
-
----
-
-## Content Gap Analysis
-
-### By Funnel Stage
-
-| Stage | Existing Content | Gaps | Priority |
-|---|---|---|---|
-| Awareness | | | |
-| Consideration | | | |
-| Decision | | | |
-
-### By Competitor Coverage
-
-| Topic | Our Coverage | Competitor Coverage | Opportunity |
-|---|---|---|---|
-| | | | |
-
----
-
-## Editorial Calendar
-
-| Week | Topic | Pillar | Format | Channel | Owner |
-|---|---|---|---|---|---|
-| | | | | | |
-| | | | | | |
-
----
-
-## Distribution Plan
-
-| Channel | Content Types | Frequency | Notes |
-|---|---|---|---|
-| Blog / SEO | | | |
-| Email | | | |
-| Social | | | |
-| Paid | | | |
-| Community | | | |
-
----
-
-## Success Metrics
-
-| Metric | Baseline | Target | Timeframe |
-|---|---|---|---|
-| | | | |
-
----
-
-## Next Steps
-
-- 

package/assets/worker-kits/growthub-marketing-skills-v1/templates/cro-audit-brief.md

@@ -1,138 +0,0 @@
-# CRO Audit Brief — [Client] / [Page Name]
-
-**Date:** YYYY-MM-DD
-**Version:** v1
-**Domain:** CRO
-**Operator:** marketing-operator
-
----
-
-## Executive Summary
-
-<!-- 3-5 bullet points of key findings -->
-
----
-
-## Page Under Review
-
-| Field | Value |
-|---|---|
-| URL | |
-| Page type | Homepage / Landing / Pricing / Feature / Blog |
-| Traffic source | Organic / Paid / Email / Social / Direct |
-| Current conversion rate | (if known) |
-| Primary conversion goal | |
-
----
-
-## 7-Dimension Analysis
-
-### 1. Value Proposition Clarity
-
-**Score:** Strong (3) / Adequate (2) / Weak (1) / Missing (0)
-
-**Findings:**
-
-**Recommendations:**
-
-### 2. Headline Effectiveness
-
-**Score:** Strong (3) / Adequate (2) / Weak (1) / Missing (0)
-
-**Findings:**
-
-**Recommendations:**
-
-### 3. CTA Placement & Copy
-
-**Score:** Strong (3) / Adequate (2) / Weak (1) / Missing (0)
-
-**Findings:**
-
-**Recommendations:**
-
-### 4. Visual Hierarchy
-
-**Score:** Strong (3) / Adequate (2) / Weak (1) / Missing (0)
-
-**Findings:**
-
-**Recommendations:**
-
-### 5. Trust Signals
-
-**Score:** Strong (3) / Adequate (2) / Weak (1) / Missing (0)
-
-**Findings:**
-
-**Recommendations:**
-
-### 6. Objection Handling
-
-**Score:** Strong (3) / Adequate (2) / Weak (1) / Missing (0)
-
-**Findings:**
-
-**Recommendations:**
-
-### 7. Friction Points
-
-**Score:** Strong (3) / Adequate (2) / Weak (1) / Missing (0)
-
-**Findings:**
-
-**Recommendations:**
-
----
-
-## Composite Score
-
-| Dimension | Score |
-|---|---|
-| Value Proposition Clarity | /3 |
-| Headline Effectiveness | /3 |
-| CTA Placement & Copy | /3 |
-| Visual Hierarchy | /3 |
-| Trust Signals | /3 |
-| Objection Handling | /3 |
-| Friction Points | /3 |
-| **Total** | **/21** |
-
----
-
-## Quick Wins (implement immediately)
-
-1. 
-2. 
-3. 
-
-## High-Impact Changes (prioritized effort)
-
-1. 
-2. 
-3. 
-
-## A/B Test Hypotheses
-
-| Test | Hypothesis | Expected Impact | Priority |
-|---|---|---|---|
-| | | | |
-| | | | |
-
-## Copy Alternatives
-
-### Headline options
-1. 
-2. 
-3. 
-
-### CTA options
-1. 
-2. 
-3. 
-
----
-
-## Next Steps
-
-- 

package/assets/worker-kits/growthub-marketing-skills-v1/templates/email-sequence-plan.md

@@ -1,80 +0,0 @@
-# Email Sequence Plan — [Client] / [Campaign Name]
-
-**Date:** YYYY-MM-DD
-**Version:** v1
-**Domain:** Email
-**Operator:** marketing-operator
-
----
-
-## Executive Summary
-
-<!-- 3-5 bullet points of key decisions -->
-
----
-
-## Sequence Overview
-
-| Field | Value |
-|---|---|
-| Sequence type | Welcome / Nurture / Re-engagement / Cold Outbound / Event-based |
-| Email count | |
-| Duration | |
-| Entry trigger | |
-| Primary CTA | |
-| Audience segment | |
-
----
-
-## Emotional Arc
-
-```
-Email 1: [emotion] → Email 2: [emotion] → ... → Final: [emotion]
-```
-
----
-
-## Sequence Map
-
-| Email | Send Day | Subject Theme | Body Arc | CTA | Purpose |
-|---|---|---|---|---|---|
-| 1 | Day 0 | | | | |
-| 2 | Day + | | | | |
-| 3 | Day + | | | | |
-| 4 | Day + | | | | |
-| 5 | Day + | | | | |
-
----
-
-## Subject Line Matrix (per email)
-
-### Email 1
-
-| Variant | Type | Subject Line | Preview Text |
-|---|---|---|---|
-| A | Curiosity | | |
-| B | Social proof | | |
-| C | Direct | | |
-| D | Personal | | |
-| E | Urgency | | |
-
-**Recommended A/B test**: Variant _ vs Variant _
-
-<!-- Repeat for each email -->
-
----
-
-## Platform Notes
-
-| Field | Value |
-|---|---|
-| Email platform | |
-| Segment/tag | |
-| Automation trigger | |
-| Unsubscribe handling | |
-
----
-
-## Next Steps
-
--