@growthub/cli 0.14.4 → 0.14.6

package/assets/worker-kits/growthub-hyperframes-studio-v1/workers/hyperframes-studio-operator/CLAUDE.md

@@ -1,40 +0,0 @@
-# Hyperframes Studio Operator
-
-**Kit:** `growthub-hyperframes-studio-v1`  
-**Worker ID:** `hyperframes-studio-operator`  
-**Version:** `1.0.0`
-
-## Role
-
-You convert campaign goals into implementation-ready Hyperframes composition and render artifacts.
-
-## Required startup
-
-1. Read `skills.md`.
-2. Read `runtime-assumptions.md`.
-3. Read `docs/hyperframes-fork-integration.md`.
-4. Verify environment with `node setup/verify-env.mjs`.
-
-If setup checks fail, stop and return remediation only.
-
----
-
-## Governed-workspace primitives (v1.2)
-
-This workspace carries the six architectural primitives every Growthub fork inherits. The contract is capability-agnostic (`@growthub/api-contract/skills::SkillManifest`); kit-specific specialisation lives in `skills.md` above.
-
-1. **`SKILL.md`** at the kit root — the discovery entry / routing menu. Read before `skills.md`.
-2. **Repo-root `AGENTS.md` pointer** — Cursor / Claude / Codex all read the same contract.
-3. **`.growthub-fork/project.md`** — session memory, seeded at init/import from `templates/project.md`. Append a dated entry after every material change.
-4. **Self-evaluation (`selfEval.criteria` + `maxRetries`)** — generate → apply → evaluate → record; retry up to 3; every attempt writes to both `project.md` (human) and `trace.jsonl` (machine). Use `recordSelfEval` (`cli/src/skills/self-eval.ts`); never bypass the fork-trace primitive.
-5. **Nested `skills/<slug>/SKILL.md`** — sub-skill lanes for parallel sub-agents on heavy or narrow work.
-6. **`helpers/<verb>.{sh,mjs,py}`** — safe shell tool layer; promote any inline shell that gets used twice.
-
-Command surface from inside this fork:
-
-- `growthub skills list` — enumerate this fork’s SKILL.md tree
-- `growthub skills validate` — strict shape check
-- `growthub skills session show` — print the current `.growthub-fork/project.md`
-- `growthub skills session init --kit <kit-id>` — (re-)seed session memory
-
-Full user-facing narrative: `cli/assets/worker-kits/growthub-custom-workspace-starter-v1/docs/governed-workspace-primitives.md` (also shipped into any workspace forked from the starter kit).

package/assets/worker-kits/growthub-marketing-skills-v1/.env.example

@@ -1,7 +0,0 @@
-# Growthub Marketing Skills — Environment Config
-# Copy this file to .env and fill in keys as needed.
-# Never commit .env to version control.
-
-# Optional model/provider keys for enhanced research and generation.
-ANTHROPIC_API_KEY=your_anthropic_key_here
-OPENAI_API_KEY=your_openai_key_here

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

@@ -1,111 +0,0 @@
-# Growthub Marketing Operator — Quickstart
-
-**Kit:** `growthub-marketing-skills-v1`
-**Worker:** `marketing-operator`
-**Upstream:** [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)
-
----
-
-## What This Kit Does
-
-The Growthub Marketing Operator is a self-contained AI agent environment for executing structured marketing workflows. It wraps proven frameworks from the open-source marketingskills library into a Growthub worker kit with brand context, templates, and output standards.
-
-Domains covered:
-- **CRO** — Landing page, signup flow, form, popup, paywall, and onboarding optimization
-- **SEO** — Technical audit, on-page, content quality, AI search visibility, schema markup
-- **Content** — Strategy, editorial planning, distribution, pillar mapping
-- **Email** — Welcome, nurture, re-engagement, cold outbound, event-based sequences
-- **Launch** — Pre-launch, launch day, post-launch phased playbooks
-- **Competitive** — Positioning gap analysis, feature matrices, messaging teardowns
-- **Growth** — Marketing ideas, pricing, referrals, free tools, churn prevention
-- **Copy** — Landing pages, ads, email, social — grounded in brand voice
-
----
-
-## Setup — 4 Steps
-
-### Step 1 — Point Your Working Directory
-
-Export this kit to a local folder and point your AI agent's Working Directory at the kit root. All paths are relative to the kit root.
-
-### Step 2 — Copy the Environment File
-
-```bash
-cp .env.example .env
-```
-
-No API keys are required for core analysis. The operator works with any AI agent that can read markdown files.
-
-### Step 3 — Verify the Environment
-
-```bash
-node setup/verify-env.mjs
-```
-
-This confirms the kit structure is intact and all required files are present.
-
-### Step 4 — Set Up Your Product Context
-
-Copy the template and fill it in:
-
-```bash
-cp brands/_template/product-marketing-context.md brands/<your-company>/product-marketing-context.md
-```
-
-This is the single most important step. The product-marketing context grounds every deliverable in your specific product, audience, and positioning. Without it, the operator produces generic marketing advice instead of actionable recommendations.
-
----
-
-## First Run
-
-1. Tell the operator: **"Run a CRO audit on [your landing page URL]"** or any marketing task
-2. The operator reads your product-marketing context for brand grounding
-3. The operator identifies the marketing domain and asks 3 clarifying questions
-4. The operator applies the appropriate framework and produces structured deliverables
-5. Output is saved to `output/<client-slug>/<project-slug>/`
-
----
-
-## New Client Setup
-
-```bash
-cp brands/_template/product-marketing-context.md brands/<client-slug>/product-marketing-context.md
-# Fill in the 12 sections in the new file
-```
-
-The 12 sections: Product Overview, Target Audience, Personas, Problems & Pain Points, Competitive Landscape, Differentiation, Objections, Switching Dynamics, Customer Language, Brand Voice, Proof Points, Goals.
-
----
-
-## Available Domains
-
-Tell the operator which marketing domain you need:
-
-| Domain | Example Request |
-|---|---|
-| CRO | "Audit this landing page for conversions" |
-| SEO | "Run an SEO audit on my site" |
-| Content | "Build a content strategy for my blog" |
-| Email | "Design a welcome email sequence" |
-| Launch | "Create a launch checklist for my new feature" |
-| Competitive | "Analyze my top 3 competitors" |
-| Copy | "Write homepage copy for my SaaS" |
-| Growth | "Give me 10 marketing ideas for my startup" |
-
-The operator will map your request to the correct framework and template automatically.
-
----
-
-## Key Files
-
-| File | Purpose |
-|---|---|
-| `workers/marketing-operator/CLAUDE.md` | Agent operating instructions (start here) |
-| `skills.md` | Full methodology and skill dispatch table |
-| `brands/_template/product-marketing-context.md` | Blank product context template |
-| `brands/growthub/product-marketing-context.md` | Growthub reference example |
-| `templates/` | Frozen deliverable templates per domain |
-| `output/README.md` | Output directory structure and naming |
-| `docs/fork-integration.md` | How this kit relates to marketingskills |
-| `docs/skill-dispatch-methodology.md` | How skill routing works |
-| `docs/evaluation-frameworks.md` | Scoring and evaluation criteria |

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

@@ -1,90 +0,0 @@
----
-name: growthub-marketing-skills-v1
-description: "Self-contained marketing execution environment wrapping the open-source marketingskills library — CRO, SEO, content strategy, email, launch, pricing, competitor, ASO. Use when the user says: \"page cro\", \"seo audit\", \"content strategy\", \"launch strategy\", \"competitor analysis\". Session memory tracks dispatched intents, chosen framework+template, and deliverable outcomes."
-triggers:
-  - marketing skills
-  - marketing operator
-  - fork growthub-marketing-skills-v1
-progressiveDisclosure: true
-sessionMemory:
-  path: .growthub-fork/project.md
-selfEval:
-  criteria:
-    - Operator contract (workers/marketing-operator/CLAUDE.md) read before any material change.
-    - .growthub-fork/project.md appended to at each material change.
-    - .growthub-fork/trace.jsonl receives a typed event for each material change.
-    - Kit-specific QUICKSTART / runtime-assumptions / output-standards honoured.
-  maxRetries: 3
-  traceTo: .growthub-fork/trace.jsonl
-helpers: []
-subSkills: []
-mcpTools: []
----
-
-# Growthub Agent Worker Kit — Marketing Operator
-
-Discovery entry + routing menu for the `growthub-marketing-skills-v1` worker kit. Family: `operator`. Agent contract: `workers/marketing-operator/CLAUDE.md`.
-
-## When to use this skill
-
-When the user's intent matches any of the triggers above — or when an agent has been dropped into a fork whose `.growthub-fork/fork.json` declares `kitId: "growthub-marketing-skills-v1"`.
-
-## Decision tree
-
-```
-Fork exists (this directory contains .growthub-fork/fork.json)?
-├── No  → run: growthub starter init --out <path>   (or import-repo / import-skill)
-│         then: growthub kit download growthub-marketing-skills-v1 --out <path>
-│
-└── Yes → read in this order:
-          1. .growthub-fork/project.md                         — session memory (primitive #3)
-          2. SKILL.md  (this file)                             — routing menu  (primitive #1)
-          3. skills.md                                         — operator runbook
-          4. workers/marketing-operator/CLAUDE.md                              — agent contract
-          5. QUICKSTART.md                                     — first-run steps
-          6. runtime-assumptions.md                            — host expectations
-          7. .growthub-fork/policy.json                        — what you may touch
-          8. .growthub-fork/trace.jsonl (tail 20)              — recent machine history
-```
-
-## The six primitives (same shape across every Growthub worker kit)
-
-1. **`SKILL.md`** — this file.
-2. **Symlinked pointer** — repo-root `AGENTS.md` is authoritative.
-3. **`.growthub-fork/project.md`** — session memory, seeded by the CLI from `templates/project.md` at init/import time.
-4. **Self-evaluation** — generate → apply → evaluate → record; retry up to `selfEval.maxRetries` (default 3); mirrors the Fork Sync Agent's preview → apply → trace loop (primitive #4). Contract: `@growthub/api-contract/skills::SkillSelfEval`.
-5. **`skills/`** — nested sub-skills for parallel sub-agents on heavy / narrow work.
-6. **`helpers/`** — safe shell tool layer. Promote inline shell here whenever the same snippet is re-used.
-
-## Self-evaluation (primitive #4)
-
-Enforce `selfEval.maxRetries: 3`. At the ceiling, park with a `needs_confirmation` note in `project.md` and stop. Record every attempt to both `project.md` and `trace.jsonl`.
-
-## Session memory (primitive #3)
-
-`.growthub-fork/project.md` is the only cross-session continuity surface for this fork. Append at every material change, approval boundary, and self-eval outcome.
-
-## Sub-skills (primitive #5)
-
-(None declared at the baseline; populate `skills/` and the frontmatter `subSkills[]` array as specialist lanes emerge.)
-
-## Helpers (primitive #6)
-
-(None declared at the baseline; populate `helpers/` and the frontmatter `helpers[]` array as inline shell matures.)
-
-## MCP routing (optional)
-
-List concrete MCP tool IDs in `mcpTools[]` when a fork runs an MCP server for auth-heavy actions. Declarative only at v1.
-
-## Related files
-
-- `skills.md` — operator runbook (deep)
-- `QUICKSTART.md` — first-run steps
-- `runtime-assumptions.md` — host expectations
-- `output-standards.md` — output locations + manifest shape
-- `validation-checklist.md` — pre-flight checklist (if present)
-- `templates/project.md` — session-memory template
-- `templates/self-eval.md` — self-evaluation template
-- `helpers/README.md` — safe shell tool layer convention
-- `skills/README.md` — sub-skill convention
-- `workers/marketing-operator/CLAUDE.md` — agent contract

package/assets/worker-kits/growthub-marketing-skills-v1/brands/_template/product-marketing-context.md

@@ -1,147 +0,0 @@
-# Product Marketing Context — [Company Name]
-
-> This file is the foundation for every marketing deliverable the operator produces. Fill in each section with real data — the more specific, the better the output. Use customer language, not polished marketing copy.
-
----
-
-## 1. Product Overview
-
-| Field | Value |
-|---|---|
-| Product name | |
-| One-liner | |
-| Category | |
-| Product type | SaaS / Physical / Service / Marketplace / Other |
-| Pricing model | Free / Freemium / Subscription / One-time / Usage-based |
-| Starting price | |
-| Website | |
-
----
-
-## 2. Target Audience
-
-| Field | Value |
-|---|---|
-| Company type | B2B / B2C / B2B2C |
-| Company size | |
-| Industry verticals | |
-| Decision-maker titles | |
-| Primary use case | |
-| Secondary use cases | |
-
----
-
-## 3. Personas
-
-| Persona | Role | Key Motivation | Primary Objection |
-|---|---|---|---|
-| | | | |
-| | | | |
-
----
-
-## 4. Problems & Pain Points
-
-1. **Core problem**: 
-2. **Cost of inaction**: 
-3. **Emotional tension**: 
-4. **Failed alternatives**: 
-
----
-
-## 5. Competitive Landscape
-
-| Competitor | Type | Key Difference |
-|---|---|---|
-| | Direct | |
-| | Direct | |
-| | Indirect | |
-
----
-
-## 6. Differentiation
-
-- **Key differentiator 1**: 
-- **Key differentiator 2**: 
-- **Key differentiator 3**: 
-- **Why customers choose you over alternatives**: 
-
----
-
-## 7. Objections & Anti-Personas
-
-**Common objections:**
-1. 
-2. 
-3. 
-
-**Anti-personas** (who is NOT the right customer):
-- 
-
----
-
-## 8. Switching Dynamics
-
-| Force | Description |
-|---|---|
-| Push (away from status quo) | |
-| Pull (toward your product) | |
-| Habit (keeps them where they are) | |
-| Anxiety (fear of switching) | |
-
----
-
-## 9. Customer Language
-
-> Paste verbatim phrases from customer interviews, reviews, support tickets, or sales calls. These are more valuable than any polished positioning statement.
-
-- ""
-- ""
-- ""
-
----
-
-## 10. Brand Voice
-
-| Attribute | Value |
-|---|---|
-| Tone | |
-| Style | |
-| Personality | |
-| Words we use | |
-| Words we avoid | |
-
----
-
-## 11. Proof Points
-
-| Type | Detail |
-|---|---|
-| Key metric | |
-| Testimonial | |
-| Case study | |
-| Award/recognition | |
-
----
-
-## 12. Goals
-
-| Goal | Metric | Target |
-|---|---|---|
-| Primary conversion action | | |
-| Secondary goal | | |
-| Revenue target | | |
-
----
-
-## Messaging Guardrails
-
-- Never claim: 
-- Always include: 
-- Compliance notes: 
-
----
-
-## Deliverables Log
-
-<!-- Append a line after every operator session -->

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

@@ -1,145 +0,0 @@
-# Product Marketing Context — Growthub
-
----
-
-## 1. Product Overview
-
-| Field | Value |
-|---|---|
-| Product name | Growthub |
-| One-liner | Local-first AI agent runtime for go-to-market and developer experience teams |
-| Category | AI Development Tools / GTM Infrastructure |
-| Product type | SaaS + Open Source CLI |
-| Pricing model | Freemium (open-source CLI + hosted features) |
-| Starting price | Free (CLI), hosted plans TBD |
-| Website | growthub.ai |
-
----
-
-## 2. Target Audience
-
-| Field | Value |
-|---|---|
-| Company type | B2B |
-| Company size | Startups to mid-market (5-200 employees) |
-| Industry verticals | SaaS, Developer Tools, Marketing Technology |
-| Decision-maker titles | Founders, Growth Leads, Marketing Directors, DevRel Leads |
-| Primary use case | Run AI agent worker kits locally for marketing and growth execution |
-| Secondary use cases | Content production pipelines, SEO auditing, email marketing automation |
-
----
-
-## 3. Personas
-
-| Persona | Role | Key Motivation | Primary Objection |
-|---|---|---|---|
-| Solo Founder | CEO / Founder | Ship marketing without hiring an agency | "I don't have time to learn another tool" |
-| Growth Operator | Growth / Marketing Lead | Scale output without scaling headcount | "How is this different from ChatGPT?" |
-| Developer Advocate | DevRel / DX Engineer | Build agent-native workflows for the team | "Does it work with my existing stack?" |
-
----
-
-## 4. Problems & Pain Points
-
-1. **Core problem**: Marketing execution doesn't scale — founders and small teams can't produce enough high-quality marketing output
-2. **Cost of inaction**: Slower growth, missed launch windows, inconsistent brand messaging across channels
-3. **Emotional tension**: Knowing what needs to be done but not having the bandwidth to do it well
-4. **Failed alternatives**: Generic AI chatbots produce disconnected, off-brand output that needs heavy editing
-
----
-
-## 5. Competitive Landscape
-
-| Competitor | Type | Key Difference |
-|---|---|---|
-| ChatGPT / Claude (raw) | Indirect | No environment context, no brand grounding, no output standards |
-| Jasper / Copy.ai | Direct | Cloud-only, template-driven, no local execution or agent orchestration |
-| Generic prompt libraries | Indirect | No structure, no brand context, no quality bar enforcement |
-
----
-
-## 6. Differentiation
-
-- **Key differentiator 1**: Local-first execution — your data stays on your machine
-- **Key differentiator 2**: Environment packaging — kits bundle prompts, templates, brand context, and output standards into one exportable unit
-- **Key differentiator 3**: Agent-agnostic — works with Claude Code, Cursor, Codex, Gemini, any local adapter
-- **Why customers choose you over alternatives**: Repeatable agent performance from structured environments, not scattered prompts
-
----
-
-## 7. Objections & Anti-Personas
-
-**Common objections:**
-1. "I can just use ChatGPT for this" — You can, but without brand context and output standards, you'll spend more time editing than creating
-2. "This seems complex to set up" — One command to download a kit, point your agent at it, and start producing
-3. "What if I don't use Claude Code?" — Kits work with any agent that reads markdown — Cursor, Codex, Gemini, etc.
-
-**Anti-personas:**
-- Enterprise teams with existing full-service agencies and no interest in AI-assisted execution
-- Users who want a click-and-generate web app, not a local development environment
-
----
-
-## 8. Switching Dynamics
-
-| Force | Description |
-|---|---|
-| Push | Frustration with generic AI output that doesn't match brand voice |
-| Pull | Structured environments that produce consistent, on-brand deliverables |
-| Habit | "I've been getting by with ChatGPT and manual editing" |
-| Anxiety | "Will this actually save time or just add another tool to learn?" |
-
----
-
-## 9. Customer Language
-
-- "I need something that understands my product, not just generates generic marketing copy"
-- "We can't afford an agency but we need agency-quality output"
-- "I want to set it up once and have it produce consistent results every time"
-- "ChatGPT gives me a starting point but I spend 80% of the time editing"
-
----
-
-## 10. Brand Voice
-
-| Attribute | Value |
-|---|---|
-| Tone | Direct, technical, confident without being arrogant |
-| Style | Concise — say more with fewer words |
-| Personality | Builder-first, practical, results-oriented |
-| Words we use | Ship, execute, build, operator, environment, local-first |
-| Words we avoid | Revolutionary, game-changing, disruptive, synergy, leverage |
-
----
-
-## 11. Proof Points
-
-| Type | Detail |
-|---|---|
-| Key metric | 4 production worker kits shipped and publicly available |
-| Open source | CLI is MIT-licensed and published on npm |
-| Ecosystem | Works with 5+ AI agent platforms out of the box |
-
----
-
-## 12. Goals
-
-| Goal | Metric | Target |
-|---|---|---|
-| Primary conversion action | CLI install (`npx @growthub/create-growthub-local`) | Growth in weekly installs |
-| Secondary goal | Kit downloads via discovery hub | Active kit exports per week |
-| Awareness | GitHub stars and contributor PRs | Community growth |
-
----
-
-## Messaging Guardrails
-
-- Never claim specific revenue or ROI numbers without sourced data
-- Always position as "local-first" — never suggest data leaves the user's machine unless they opt into hosted features
-- Compliance notes: No testimonials that aren't from real users
-
----
-
-## Deliverables Log
-
-<!-- Append a line after every operator session -->

package/assets/worker-kits/growthub-marketing-skills-v1/bundles/growthub-marketing-skills-v1.json

@@ -1,52 +0,0 @@
-{
-  "schemaVersion": 2,
-  "bundle": {
-    "id": "growthub-marketing-skills-v1",
-    "version": "1.0.0",
-    "kitId": "growthub-marketing-skills-v1",
-    "workerId": "marketing-operator"
-  },
-  "briefType": "marketing-operator",
-  "publicExampleBrandPaths": [
-    "brands/growthub/product-marketing-context.md"
-  ],
-  "requiredFrozenAssets": [
-    "QUICKSTART.md",
-    ".env.example",
-    "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",
-    "examples/landing-page-cro-sample.md",
-    "examples/seo-audit-sample.md",
-    "examples/email-sequence-sample.md",
-    "docs/fork-integration.md",
-    "docs/skill-dispatch-methodology.md",
-    "docs/evaluation-frameworks.md",
-    "setup/verify-env.mjs",
-    "output/README.md",
-    "growthub-meta/README.md",
-    "growthub-meta/kit-standard.md",
-    "SKILL.md",
-    "templates/project.md",
-    "templates/self-eval.md",
-    "helpers/README.md",
-    "skills/README.md"
-  ],
-  "optionalPresets": [],
-  "export": {
-    "folderName": "growthub-agent-worker-kit-marketing-skills-v1",
-    "zipFileName": "growthub-agent-worker-kit-marketing-skills-v1.zip"
-  },
-  "activationModes": [
-    "export"
-  ]
-}

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

@@ -1,53 +0,0 @@
-# Evaluation Frameworks
-
-## Frameworks by Domain
-
-### CRO — 7-Dimension Analysis
-
-Scoring: 0-3 per dimension, 0-21 composite.
-
-| Dimension | What It Measures |
-|---|---|
-| Value Proposition Clarity | Can users understand the offer within 5 seconds? |
-| Headline Effectiveness | Does headline match traffic source and promise a benefit? |
-| CTA Placement & Copy | Single primary action, benefit-driven, visible without scroll? |
-| Visual Hierarchy | Scannable layout, intentional whitespace, eye flow? |
-| Trust Signals | Logos, testimonials, reviews near decision points? |
-| Objection Handling | Price, fit, difficulty, risk addressed before CTA? |
-| Friction Points | Form fields, navigation, mobile experience? |
-
-### SEO — Priority Matrix
-
-| Priority | Criteria |
-|---|---|
-| Critical | Blocking indexation or causing ranking penalties |
-| High | Significant ranking impact, moderate fix effort |
-| Medium | Incremental improvement, low-moderate effort |
-| Low | Nice-to-have, minimal ranking impact |
-
-### SEO — E-E-A-T Assessment
-
-| Signal | What It Measures |
-|---|---|
-| Experience | First-hand experience signals in content |
-| Expertise | Depth, accuracy, and domain knowledge |
-| Authoritativeness | Source credibility and external recognition |
-| Trustworthiness | Accuracy, transparency, and safety signals |
-
-### Email — Sequence Quality Principles
-
-1. **One email, one job** — each message has a single purpose and CTA
-2. **Value before ask** — trust-building precedes conversion requests
-3. **Relevance over volume** — quality messaging outperforms frequency
-
-### Content — Gap Analysis Matrix
-
-| Axis | Categories |
-|---|---|
-| Funnel stage | Awareness / Consideration / Decision |
-| Content type | Blog / Guide / Tool / Case study / Comparison |
-| Competitor coverage | Covered / Gap / Opportunity |
-
-## Source Attribution
-
-These frameworks are adapted from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) (MIT license). The upstream library provides the detailed skill definitions; this document summarizes the evaluation criteria used by the operator.