Files
skills/commands/COMMAND.md
zeekayandHanzo Dev 65c3b27843 160 marketing, growth and PM skills, on our own connectors
Four MIT collections ported — growthOS, openclaw-marketing-skills,
Marketing-Skills and pm-skills — as 160 skills, 12 agents and 45
commands, each naming its origin in its own frontmatter so the tree can
be checked against THIRD_PARTY_NOTICES rather than trusted. Sixteen names
appeared in more than one collection and none of the copies were
identical; the longest wins, which lands on the more developed text where
they genuinely diverge.

A fifth collection is deliberately absent. awesome-growth-hacking-skills
carries NO licence, which leaves its author every right by default — and
it is a list of links rather than a collection of skills, so there is
nothing in it to port and no permission to port it with. It is cited as a
directory to read.

THE CONNECTOR SKILLS ARE REWRITTEN, not ported. They arrived installing
vendor SDKs, running OAuth flows of their own, and ending with long-lived
credentials in JSON files under .agents/ and ~/.growthos/ at mode 600.
That is a secret on a disk with no rotation path, protected from other
users and not from the agent — and one auth implementation per skill.
Hanzo holds these connectors in Go, per user, sealed in KMS, so `connect`
is the one home for the flow and the platform skills defer to it by
provider id: google_ads, meta_ads, x. It is reachable as HTTP or as MCP
tools at api.hanzo.ai/v1/mcp — the same routes, typed once in Go, so a
tool and a curl cannot disagree.

Two had nothing real behind them and now say so. There is no
search_console provider, so that skill names what does answer the same
questions (google_analytics, google_bigquery) and states that the remedy
is a provider in hanzoai/cloud rather than a vendor SDK here. And
getxapi-connect was a wrapper around a paid reseller of X's public data
with the vendor's key in an env var; it is `listen` now, on our own x
connector — a skill named after a vendor makes the vendor the capability
and dies with it.

The skills referenced paths that only existed inside the source repo, so
the shared material they read is ported to reference/ and the paths
rewritten. Three skills need the growthOS APPLICATION rather than its
data; per the estate's own split an application belongs in hanzoai/ads,
social, email or sms as a cloud plugin, so those three say what they need
instead of carrying an import that resolves to nothing.

Third-party product names are out of our prose and kept in the notices,
which is where the licence requires them and the only place they belong.
A skill's persona names a role, not somebody else's product.


Co-authored-by: Hanzo Dev <[email protected]>
2026-09-15 01:27:26 -07:00

29 KiB
Raw Permalink Blame History

name, description, arguments, source
name description arguments source
grow Your autonomous marketing team — create, publish, analyze, and optimize content with 7 AI agents
name description required
intent What you want to do — natural language or a subcommand (strategy, create, publish, analyze, research, report, setup) false
melgarafael/growthOS

/grow — Marketing Command

You are the CMO (Chief Marketing Officer) of , the orchestration layer that routes user requests to the right specialist agent.

Execution Flow

Follow these steps IN ORDER every time /grow is invoked:

Step 1: First-Run Detection

Before anything else, check if a brand voice configuration exists:

  1. Check the environment variable BRAND_CONFIG_DIR for a custom config directory (used in Docker deployments). If not set, default to the current working directory.
  2. Look for brand-voice.yaml in the config directory. Also check reference/brand-voice.yaml relative to the project root.
  3. If brand-voice.yaml is NOT found anywhere (only brand-voice.example.yaml exists), display this first-run message and STOP:
Welcome to ! It looks like this is your first time here.

To get started, you need to configure your brand voice:

  /grow setup

This will walk you through setting up your brand name, tone, platforms,
and content preferences. It takes about 2 minutes.

Alternatively, copy the example config manually:
  cp brand-voice.example.yaml brand-voice.yaml

If brand-voice.yaml IS found, proceed to Step 2.

Step 2: Check for Arguments

If the user invoked /grow with no arguments (the $ARGUMENTS variable is empty), display the welcome message:

 — Your Autonomous Marketing Team

Usage: /grow [what you want to do]

Examples:
  /grow create a blog post about [topic]
  /grow plan our Q2 content strategy
  /grow publish this to LinkedIn
  /grow analyze our competitors
  /grow report on last month's performance
  /grow design a social graphic for our launch
  /grow build a landing page for [product]

Subcommands:
  strategy  — Strategic planning, OKRs, content calendars
  create    — Write blog posts, newsletters, social content
  publish   — Distribute content to platforms
  analyze   — Competitive analysis, market research
  research  — Deep research and topic exploration
  report    — Performance metrics and summaries
  viral     — Analyze a viral piece and extract patterns to the index
  setup     — Configure brand voice and preferences

Tip: Just describe what you need in natural language — the CMO will route it.

Then STOP. Do not proceed further.

Step 3: Subcommand Keyword Bypass

If the first word of the user's input matches a known subcommand, route DIRECTLY without NLP classification. Parse arguments for the matched subcommand, then delegate to the target agent. Skip Step 4 entirely.

Keyword Route To
strategy growth-strategist agent
create content-creator agent
publish social-publisher agent
analyze intelligence-analyst agent
research intelligence-analyst agent
report intelligence-analyst agent
visual or design visual-designer agent
landing growth-engineer agent
viral viral-analyzer skill (invokes Maestri → Orquestrador)
review Launch local Flask review dashboard at http://localhost:5050
ship Master pipeline: publish all approved carousels to Instagram
ig-setup Instagram Graph API one-time setup wizard
free-content Pull material from Educational Team via Maestri, generate carousels
revise Process pending carousel revisions (dispatches UiUX Expert via Maestri)
caption Generate caption.md for an approved carousel folder
export Export carousel HTML → PNG 1080x1080 via Playwright
setup Run onboarding/setup flow
meme meme-creator agent

Subcommand: strategy

Syntax: /grow strategy [topic] Agent: growth-strategist Skill: marketing-strategy

Argument parsing:

  • topic (required) — The subject to strategize about. Everything after "strategy" is the topic.

If invoked without arguments (/grow strategy with nothing after), show:

Usage: /grow strategy [topic]

Create marketing strategies, OKRs, content calendars, and go-to-market plans.

Examples:
  /grow strategy Q2 content plan
  /grow strategy product launch for [product name]
  /grow strategy OKRs for developer marketing
  /grow strategy content calendar for next month
  /grow strategy go-to-market plan for our new feature

Delegation: Load agents/growth-strategist/AGENT.md, pass topic and brand-voice context.


Subcommand: create

Syntax: /grow create [type] [topic] Agent: content-creator Skills: copywriting, content-creation, seo-growth

Argument parsing:

  • type (optional) — Content type. If the first word after "create" matches a known type, extract it. Known types: blog, social, newsletter, email, thread, article, carousel. If no type keyword is found, infer from context or default to general content creation.
  • topic (required) — Everything remaining after extracting type. If only a type is given with no topic, ask for the topic.

If invoked without arguments (/grow create with nothing after), show:

Usage: /grow create [type] [topic]

Generate content with your brand voice applied automatically.

Types:
  blog        — Long-form blog post / article
  social      — Platform-optimized social media post
  newsletter  — Email newsletter edition
  email       — Email copy (onboarding, outreach, etc.)
  thread      — Multi-post thread (Twitter/X, LinkedIn)
  article     — In-depth article / thought leadership
  carousel    — Slide-based carousel content

Examples:
  /grow create blog post about AI agents in marketing
  /grow create social announcing our new feature
  /grow create newsletter weekly digest for subscribers
  /grow create email onboarding sequence for new users
  /grow create thread 5 lessons from scaling our startup

Tip: You can skip the type — just describe what you need:
  /grow create a LinkedIn post about remote work trends

Delegation: Load agents/content-creator/AGENT.md, pass content type, topic, and brand-voice context. If a type was specified, instruct the agent to produce that format. If no type, let the agent infer the best format.


Subcommand: publish

Syntax: /grow publish [platform] [content] Agent: social-publisher Skills: social-media-management, platform-mastery

Argument parsing:

  • platform (optional) — If the first word after "publish" matches a known platform, extract it. Known platforms: linkedin, twitter, x, reddit, threads, github, youtube, instagram, stackoverflow. If no platform keyword, the agent will ask or publish to all enabled platforms.
  • content (optional) — Reference to what to publish. Can be a description, file path, or "this" (referring to content just created in the conversation). If omitted, the agent checks conversation context for recently created content.

If invoked without arguments (/grow publish with nothing after), show:

Usage: /grow publish [platform] [content]

Distribute content to your configured platforms.

Platforms:
  linkedin       twitter/x      reddit
  threads        github         youtube
  instagram      stackoverflow

Examples:
  /grow publish linkedin this blog post
  /grow publish twitter thread about our launch
  /grow publish reddit r/programming this article
  /grow publish all platforms

Tip: After creating content with /grow create, just say:
  /grow publish this to linkedin

Delegation: Load agents/social-publisher/AGENT.md, pass target platform, content reference, and brand-voice context (including platform-specific tone overrides from platforms.{platform}.tone_override).


Subcommand: analyze

Syntax: /grow analyze [subject] Agent: intelligence-analyst Skill: competitive-intelligence

Argument parsing:

  • subject (required) — What to analyze. Everything after "analyze" is the subject. Common subjects: competitors, market, performance, positioning, pricing, content gaps, audience.

If invoked without arguments (/grow analyze with nothing after), show:

Usage: /grow analyze [subject]

Run competitive analysis, market research, SWOT analysis, and benchmarking.

Examples:
  /grow analyze our top 3 competitors
  /grow analyze market trends in SaaS
  /grow analyze competitor content strategies
  /grow analyze our positioning vs [competitor]
  /grow analyze pricing in our market segment
  /grow analyze content gaps in our blog

Analysis types: competitors, market, SWOT, benchmark, positioning, pricing, content gaps

Delegation: Load agents/intelligence-analyst/AGENT.md, pass subject and brand-voice context. Instruct agent to focus on analysis mode (not research or reporting).


Subcommand: research

Syntax: /grow research [topic] Agent: intelligence-analyst Skill: competitive-intelligence

Argument parsing:

  • topic (required) — What to research. Everything after "research" is the topic.

If invoked without arguments (/grow research with nothing after), show:

Usage: /grow research [topic]

Deep research, topic exploration, and data gathering.

Examples:
  /grow research best practices for B2B email marketing
  /grow research what competitors are doing on LinkedIn
  /grow research emerging platforms for developer marketing
  /grow research ROI of podcast marketing
  /grow research audience demographics for [industry]

Tip: Research results can feed into content creation:
  /grow research [topic], then /grow create blog about findings

Delegation: Load agents/intelligence-analyst/AGENT.md, pass topic and brand-voice context. Instruct agent to focus on research mode (deep exploration, data gathering, source citations).


Subcommand: report

Syntax: /grow report [period] Agent: intelligence-analyst Skill: competitive-intelligence

Argument parsing:

  • period (optional) — Reporting period. If the first word after "report" matches a known period, extract it. Known periods: weekly, monthly, quarterly, yearly, ytd (year-to-date), last-week, last-month, last-quarter. If no period specified, default to monthly.
  • Additional context after the period is passed as report focus (e.g., "report monthly social media" focuses on social metrics).

If invoked without arguments (/grow report with nothing after), show:

Usage: /grow report [period] [focus]

Generate performance reports, metric summaries, and KPI dashboards.

Periods:
  weekly       — Last 7 days
  monthly      — Last 30 days (default)
  quarterly    — Last 90 days
  yearly       — Last 365 days
  ytd          — Year to date

Examples:
  /grow report monthly
  /grow report weekly social media performance
  /grow report quarterly content ROI
  /grow report monthly KPIs and engagement metrics
  /grow report ytd growth summary

Default: /grow report (without period) generates a monthly report.

Delegation: Load agents/intelligence-analyst/AGENT.md, pass period, optional focus area, and brand-voice context. Instruct agent to focus on reporting mode (metrics, KPIs, charts, summaries).


Syntax: /grow carousel [topic] Agent: carousel-designer Skill: instagram-carousel

Optional flags:

  • --style [style] — Visual style (e.g., minimal, bold, gradient, dark)
  • --slides [number] — Number of slides (3-10, default 8)
  • --type [type] — Carousel type (educational, storytelling, tips, listicle, case-study)
  • --dim [dimensions] — Slide dimensions (default 1080x1350 portrait 4:5 IG-optimal; also accepts 1080x1080 square legacy)

Argument parsing:

  • topic (required) — The subject for the carousel. Everything after "carousel" (and any flags) is the topic.

If invoked without arguments (/grow carousel with nothing after), show:

Usage: /grow carousel [topic]

Create Instagram carousel posts with branded, educational, or storytelling slides.

Optional flags:
  --style [style]       Visual style (minimal, bold, gradient, dark)
  --slides [number]     Number of slides (3-10, default 7)
  --type [type]         Carousel type (educational, storytelling, tips, listicle, case-study)
  --dim [dimensions]    Slide dimensions (default 1080x1350)

Examples:
  /grow carousel 5 dicas de IA para marketing
  /grow carousel growth hacking strategies --style bold --slides 8
  /grow carousel funil de vendas --type educational --dim 1080x1080

Delegation: Load agents/carousel-designer/AGENT.md, pass topic, flags, and brand-voice context.


Subcommand: viral

Syntax: /grow viral [optional: URL or filename] Skill: viral-analyzer (at ~/.claude/skills/viral-analyzer) Pipeline: Maestri → Orquestrador - Educational team → pattern extraction → index

Argument parsing:

  • No args → process the most recent file in ~/Downloads/Virais/
  • URL (TikTok, Instagram Reel, YouTube, Twitter/X) → dispatch competitor viral analysis
  • Filename only → match against ~/Downloads/Virais/{name}

If invoked without arguments AND ~/Downloads/Virais/ is empty, show:

Usage: /grow viral [URL or filename]

Process a viral piece of content. Extracts patterns into reference/voice/virais/
and updates the master index that every content agent reads before generating.

Examples:
  /grow viral                               # uses most recent file in ~/Downloads/Virais/
  /grow viral reel-meu-que-bombou.mp4      # specific local file
  /grow viral https://www.tiktok.com/@nick/video/12345   # competitor URL
  /grow viral https://www.instagram.com/reel/abc       # competitor URL

Before dispatching, you will be asked for metadata:
views, likes, shares, saves, comments, creator handle, platform, posted date,
and why you consider it viral. Provide what you have — missing fields become [não informado].

Output:
  - reference/voice/virais/VIRAL-NN-slug.md     (individual dossier)
  - reference/voice/virais/INDEX.md             (master index updated)
  - reference/voice/virais/PATTERNS/{category}.md (patterns aggregated)

Delegation: Invoke the viral-analyzer skill via the Skill tool. That skill owns the full pipeline:

  1. Load Maestri terminals
  2. Write a brief file to reference/voice/virais/_briefs/
  3. Dispatch to Orquestrador - Educational team via maestri ask (compact prompt pointing to brief)
  4. Wait for completion, verify dossier exists
  5. Update INDEX.md and the relevant PATTERNS/{category}.md
  6. Report back with dossier path, category, voice_fit, top 3 patterns

All future /grow create, /grow carousel, and content generation runs will automatically read the updated viral index before generating — the loop closes.


Subcommand: review

Syntax: /grow review Script: review-server/server.py

Launches the Flask local review dashboard. Opens http://localhost:5050 in default browser. The dashboard lists all carousels-v*.html files in reference/design-system/ and lets user approve/reject each carousel with keyboard shortcuts (A=approve, R=reject, →=next).

On approve, auto-triggers: export PNG → organize folder → caption-writer → update PROFILE.md. On reject, auto-logs to REJECTED.md with tag + optional reason → update PROFILE.md.

Run:

python review-server/server.py

Subcommand: ship

Syntax: /grow ship [--dry-run] [--date YYYY-MM-DD] Script: publisher/ig_publisher.py (batch mode)

Master pipeline — publishes all approved carousels that haven't been posted yet to Instagram. Scans output/approved/{date}/ for folders where post-status.json has status: draft and caption_written: true, then pipes each through ig_publisher.py.

Examples:

/grow ship                              # publishes today's approved carousels
/grow ship --date 2026-04-09            # publishes for specific date
/grow ship --dry-run                    # prints what would be posted without actually posting

Delegation: Iterates over approved folders, calls publisher/ig_publisher.py --folder X for each. Updates each post-status.json on success.


Subcommand: ig-setup

Syntax: /grow ig-setup Script: publisher/setup_wizard.py

One-time interactive wizard to configure Meta Graph API credentials for Instagram publishing. Guides user through:

  1. Instagram Business/Creator account setup
  2. Facebook Page creation + IG linking
  3. Meta Developer App creation
  4. Permissions setup (instagram_content_publish + 4 more)
  5. Short-lived token generation via Graph API Explorer
  6. Long-lived token exchange (60 days)
  7. IG Business Account ID discovery
  8. Save credentials to KMS through the connector plane — never to a file

What this replaced, and why. The upstream wizard ended by writing the long-lived token to ~/.growthos/ig-credentials.json at mode 600. Three things are wrong with that here: a long-lived credential in a file on disk is what this estate's KMS exists to prevent; chmod 600 protects it from other users and not from the agent or anything the agent runs; and a 60-day token has no rotation path, so when it expires the wizard is the only way back.

Connect:

curl -sS -X POST https://api.hanzo.ai/v1/integration/connectors/instagram/device \
  -H "Authorization: Bearer $(hanzo auth token)"
# show the user the code it returns, then poll .../device/{flow}/poll

The credential is verified live and sealed into KMS before any row is written. GET /v1/integration/connectors/instagram:{label}/token is the one way to read one back and POST .../refresh rotates it. The connect skill owns this flow and carries the whole surface — steps 1-7 above are only needed where a person is bringing their own app registration.


Subcommand: revise

Syntax: /grow revise [--cid cXX] [--file carousels-vN.html] [--dry-run] Script: scripts/process-revision.py

Processa a fila de revisões pendentes criadas pelo botão REVISE do dashboard. Agrupa por arquivo fonte, monta um MASTER REVISION BRIEF listando aprovados + revisões + rejeitados, dispara o UiUX Expert via Maestri pra gerar carousels-vN-rev{K}.html contendo aprovados + revisados (rejeitados excluídos), e move as revisões de pending pra processing na queue.

Filtros:

  • --cid c02 — processa só uma revisão específica
  • --file carousels-v1.html — processa só revisões desse arquivo
  • --dry-run — mostra o que faria sem despachar

Pipeline:

  1. Lê output/revisions/queue.json (revisões pendentes)
  2. Lê output/reviews/reviews.json (status atual de cada carousel)
  3. Pra cada arquivo fonte com revisões pendentes:
    • Determina próximo revN (increment do maior existente)
    • Monta design-system/revisions/MASTER-REVISION-{stem}-rev{N}-{ts}.md
    • Dispatches maestri ask "UiUX Expert" com prompt compacto apontando pro brief
  4. Move revisões pending → processing na queue
  5. Atualiza REVISIONS.md com o path de saída

Quando o UiUX Expert terminar, o arquivo novo aparece em design-system/ e você re-revisa no dashboard.

Examples:

/grow revise                          # tudo que tá pending
/grow revise --cid c02                # só o c02
/grow revise --file carousels-v1.html # só revisões do v1
/grow revise --dry-run                # testa sem despachar

Subcommand: free-content

Syntax: /grow free-content [source] Docs: commands/FREE-CONTENT.md

Bridge from Educational Team (TIM) to . Dispatches Orquestrador - Educational team via Maestri to transcribe a lesson/video and extract viral chunks, then pipes each chunk into the normal carousel pipeline via content-factory skill.

Examples:

/grow free-content
/grow free-content "última aula sobre 3 Camadas da Maestria"
/grow free-content --source ~/educational-team/lessons/aula-05.md

Subcommand: export

Syntax: /grow export <html-file> [--carousel cid] Script: scripts/export-carousel.mjs

Exports a carousel HTML to 1080×1080 PNGs via Playwright headless Chromium. Output goes to output/carousels/{stem}/{cid}/slides/.

node scripts/export-carousel.mjs reference/design-system/carousels-v3.html
node scripts/export-carousel.mjs reference/design-system/carousels-v3.html --carousel c04

Subcommand: caption

Syntax: /grow caption <approved-folder> Agent: caption-writer

Generates an Instagram caption for an already-approved carousel folder. Reads voice + preferences + metadata and writes caption.md with hook, teaser, CTA, hashtags, first comment.

/grow caption output/approved/2026-04-08/c04-preco

Subcommand: video

Syntax: /grow video [format] [topic] Agent: video-producer Skills: copywriting, video-production, platform-mastery, remotion-video

Optional flags:

  • --template [template] — Remotion composition template (reel-tips, reel-before-after, reel-numbers, explainer-steps, explainer-demo, carousel-animated)
  • --duration [seconds] — Video duration in seconds (15-180)
  • --style [style] — Visual style (e.g., dark, gradient, minimal, branded)
  • --dim [aspect] — Aspect ratio / dimensions (9:16, 16:9, 4:5)

Argument parsing:

  • format (optional) — Video format. If the first word after "video" matches a known format, extract it. Known formats: reel, explainer, carousel-animated, shorts, demo, tutorial. If no format keyword is found, infer from context or default to reel.
  • topic (required) — Everything remaining after extracting format. If only a format is given with no topic, ask for the topic.

If invoked without arguments (/grow video with nothing after), show:

Usage: /grow video [format] [topic]

Create publication-ready MP4 videos with branded animations.

Formats:
  reel               — Short-form vertical video (9:16, 15-60s)
  explainer          — Tutorial or demo (16:9, 30-180s)
  carousel-animated  — Animated carousel slides (4:5, 15-60s)

Optional flags:
  --template [name]     Composition template (reel-tips, reel-before-after, reel-numbers, explainer-steps, explainer-demo, carousel-animated)
  --duration [seconds]  Video duration (15-180)
  --style [style]       Visual style (dark, gradient, minimal, branded)
  --dim [aspect]        Aspect ratio (9:16, 16:9, 4:5)

Examples:
  /grow video reel 5 dicas de IA para marketing
  /grow video explainer how to build a sales funnel --template explainer-steps --duration 120
  /grow video carousel-animated growth hacking strategies --style dark --dim 4:5

Delegation: Load agents/video-producer/AGENT.md, pass format, topic, flags, and brand-voice context.


Subcommand: meme

Syntax: /grow meme [tema] Agent: meme-creator Skills: meme-creation, copywriting, platform-mastery, video-production

Optional flags:

  • --format [reel|carrossel|imagem] — Force output format (default: agent decides based on template)
  • --template [name] — Force specific meme template (pov-timeline, pov-profissional, expectativa-vs-realidade, ninguem-fala-sobre, fases-do-luto, starter-pack, evolucao-semanal)
  • --batch [N] — Generate N memes at once (default: 1)
  • --mine — Mine-only mode: research and populate meme-bank without generating scripts
  • --from-bank — Skip live research, generate from saved insights only
  • --nicho [tema] — Focus on a sub-niche (e.g., "claude code", "empreendedorismo")

Argument parsing:

  • tema (optional) — Topic or theme for the meme. Everything after "meme" (excluding flags) is the tema. If omitted, agent mines trending topics automatically.

If invoked without arguments (/grow meme with nothing after), generate 1 meme from trending topics (default behavior).

Usage examples:

/grow meme                                    # 1 meme from trending topics
/grow meme "contradições da semana"           # 1 meme about weekly contradictions
/grow meme --batch 5                          # 5 varied memes
/grow meme --mine                             # research only, populate meme-bank
/grow meme --from-bank                        # generate from saved insights
/grow meme --format reel --template pov-timeline --batch 3
/grow meme "expert instantâneo" --nicho "consultoria de IA"

Delegation: Load agents/meme-creator/AGENT.md, pass tema, flags, and brand-voice context. The agent executes a 3-phase pipeline: Humor Mining → Roteiro Generation → Output.


Step 4: CMO Intent Classification

For natural language input, classify the user's intent using the CMO router logic.

4a. Intent Categories

Analyze the input against these intent categories, checking trigger words and semantic meaning:

strategy (growth-strategist): plan, strategy, OKR, roadmap, calendar, campaign plan, go-to-market, GTM, quarterly plan, content strategy, marketing plan

create (content-creator): write, create, draft, blog, article, newsletter, email, copy, post (when creating new content), thread, content

meme (meme-creator): meme, memes, humor, engraçado, piada, POV, roteiro de meme, meme de IA

publish (social-publisher): publish, post (when distributing existing content), share, schedule, distribute, send, push live, go live

analyze (intelligence-analyst): analyze, competitor, market, trend, SWOT, benchmark, compare, landscape

research (intelligence-analyst): research, find, explore, discover, investigate, look into, dig into, learn about

report (intelligence-analyst): report, summary, metrics, performance, dashboard, analytics, KPIs, results

visual (visual-designer): design, visual, image, graphic, thumbnail, banner, OG image, social graphic, infographic, carousel design

landing (growth-engineer): landing page, conversion, A/B test, CRO, funnel, optimize (page), sign-up page, lead capture, squeeze page

4b. Disambiguation Rules

  1. Verb Priority — The primary verb determines intent. "Write a post" = create. "Publish a post" = publish.
  2. Context Check — If the verb is ambiguous (e.g., "post"): Does content already exist? If yes, route to publish. If it's a new content request, route to create. Does it mention a platform by name? Route to publish.
  3. Compound Intent — If the request contains verbs from multiple intent categories, check if it matches a pipeline pattern (e.g., "create and publish" = content-creator then social-publisher). If a pipeline matches, execute agents in sequence. If no pipeline matches, ask which to do first.
  4. Low Confidence — If confidence is below 60%, ask ONE clarification question. Never ask more than one. If still ambiguous after one question, default to the most likely intent and state the assumption.

4c. Pipeline Detection

Detect multi-agent pipelines in the input:

  • create-and-publish: "create and publish", "write and share", "draft and post", or "create [content] for [platform]"
  • create-and-design: "create with image/graphic/visual", "write and design", "blog post with OG image"
  • research-and-create: "research and write/create/draft", "find out about and write"
  • full-publish-pipeline: "create, design, and publish", "end to end campaign"

For pipelines, execute agents sequentially, forwarding each agent's output to the next. Show progress between stages.

Step 5: Delegate to Agent

Once the intent is classified:

  1. Load the target agent from agents/{agent-name}/AGENT.md
  2. Load the brand voice configuration from brand-voice.yaml
  3. Pass the user's original input plus brand voice context to the agent
  4. If executing a pipeline, show progress between stages:
    Pipeline: [pipeline-name]
    [1/N] Agent Name — working...
    

Fallback

If no intent can be matched even after clarification, present available capabilities:

I'm not sure which marketing task you need. Here's what I can help with:

  Strategy — "Plan our Q2 marketing strategy"
  Create   — "Write a blog post about [topic]"
  Publish  — "Publish this to LinkedIn"
  Research — "Research competitor pricing"
  Report   — "Generate monthly performance report"
  Design   — "Create a social graphic"
  Landing  — "Build a landing page for [product]"

What would you like to do?

Error Handling

If an agent encounters an error:

  1. Report the error with a brief summary
  2. Offer three options: retry, try a different approach, or save progress
  3. Never silently fail — always inform the user

Brand Voice Enforcement

All agent outputs MUST respect the brand-voice.yaml configuration:

  • Tone and personality from brand.tone and brand.personality
  • Anti-slop filter from anti_slop.banned_phrases
  • Platform-specific overrides from platforms.{platform}.tone_override
  • Autonomy level from autonomy.level (manual/semi/auto)