Skip to content

README.pt-BR.md

Latest commit

 

History

History
168 lines (131 loc) · 9.07 KB

README.pt-BR.md

File metadata and controls

168 lines (131 loc) · 9.07 KB
Raw

Marketing Engine

🇧🇷 Versão em português. Read this in English: README.md.

Engine de marketing AI provider-agnostic. Cai em qualquer projeto, escaneia, gera posts, publica em 9 plataformas — tudo configurável via .env.

CI

Veja o explainer das skills (90s)

Um walkthrough renderizado em Remotion do pipeline e de cada skill em .skills/. Renderizado em português; uma versão em inglês também está disponível.

https://github.com/wesleysimplicio/marketing-engine/raw/main/video/out/marketing-engine-skills.mp4

Player não carregou? Clique para a thumbnail / download direto

Marketing Engine — capa do explainer das skills

▶︎ Abrir marketing-engine-skills.mp4  ·  como foi feito

Tour visual cena a cena

Etapa Cena
pipeline brief → script → creative → caption → compliance → publish → metrics → ads
provider-agnostic llm-router orbitado por claude, codex, deepseek, higgsfield, topview, wavespeed
llm-router task_type resolvida num provider concreto
copywriter-curto hook, caption, headline com contador de caracteres
revisao-humanizada diff antes/depois removendo fingerprints de IA
caption-multi-platform uma base copy adaptada para Instagram, TikTok, LinkedIn e X
higgsfield-prompt-builder viewport cinematográfico com lente, motion e mood
topview-prompt-builder avatar UGC com script falado tokenizado
wavespeed-batch grid 3x2 de variantes A/B com winner glow
gpt-image-prompt-builder slides de quote-card / carrossel
video-prompt-builder brief roteado para higgsfield, topview ou wavespeed
compliance-generic escudo bloqueando claims médicos e garantias financeiras
qa-tech-specs aspect, duração, codec e safe-area
definition-of-done os 6 gates que um piece precisa passar

Tour visual cena a cena

Etapa Cena
pipeline brief → script → creative → caption → compliance → publish → metrics → ads
provider-agnostic llm-router orbitado por claude, codex, deepseek, higgsfield, topview, wavespeed
llm-router task_type resolvida num provider concreto
copywriter-curto hook, caption, headline com contador de caracteres
revisao-humanizada diff antes/depois removendo fingerprints de IA
caption-multi-platform uma base copy adaptada para Instagram, TikTok, LinkedIn e X
higgsfield-prompt-builder viewport cinematográfico com lente, motion e mood
topview-prompt-builder avatar UGC com script falado tokenizado
wavespeed-batch grid 3x2 de variantes A/B com winner glow
gpt-image-prompt-builder slides de quote-card / carrossel
video-prompt-builder brief roteado para higgsfield, topview ou wavespeed
compliance-generic escudo bloqueando claims médicos e garantias financeiras
qa-tech-specs aspect, duração, codec e safe-area
definition-of-done os 6 gates que um piece precisa passar

O que faz

  • Escaneia o projeto host (package.json, README, árvore de fontes, assets de marca existentes) e rascunha brand, persona e content-pillar specs pra você revisar.
  • Gera copy via camada LLM roteada (Claude, Codex, DeepSeek, Copilot, Ollama) escolhida por task type.
  • Gera imagens e vídeos via providers roteados (gpt-image, Higgsfield, TopView, Wavespeed) selecionados por formato.
  • Roda audit de compliance antes de qualquer publish e bloqueia peças que falham no gate.
  • Publica caption set de 4 plataformas via AdaptlyPost (Instagram, TikTok, Facebook, LinkedIn, X, Threads, Pinterest, Shorts, YouTube — 9 ao total).
  • Puxa analytics em schedule, classifica top performers, rascunha campanhas Meta Ads dos vencedores.

Quick start

cd /caminho/do/seu-projeto
npx marketing-engine init
cp .marketing-engine/.env.example .marketing-engine/.env
# preencha ANTHROPIC_API_KEY no mínimo
npx marketing-engine check
npx marketing-engine generate    # DRY_RUN por default

Por que provider-agnostic

Nenhum provider é hardcoded. PROVIDERS.md + .env decidem qual LLM, image ou video service trata cada task. Trocar provider é uma mudança de env, não refactor. Skills declaram task_type abstrato (copy-short, image-carousel, video-reel); o router resolve o vendor concreto em runtime e aplica fallback automático.

Stack suportada

Camada Providers (default primeiro)
LLM claude, codex, deepseek, copilot, ollama
Image gpt-image, higgsfield, topview, wavespeed
Video higgsfield, topview, wavespeed
Publishing adaptlypost (9 plataformas)
Ads meta-ads

Regras de roteamento e racional em .specs/architecture/PROVIDERS.md.

Comandos CLI

Comando O que faz
init Faz scaffold do .marketing-engine/ no projeto host
scan Re-escaneia o projeto host pra atualizar specs draft
check Valida chaves de env dos providers
generate Roda loop de geração (DRY_RUN-safe)
promote Roda loop de promoção

Arquitetura

Pipeline: brief → script → creative → caption → compliance → publish → metrics → ads. O router faz broker de toda chamada externa pra que troca de vendor seja só config.

flowchart LR
    brief[Brief / piece.md] --> router[lib/router.ts]
    router --> llm[LLM]
    router --> media[Image / Video]
    llm --> compliance[Compliance Gate]
    media --> compliance
    compliance -->|pass| publish[AdaptlyPost / 9 plataformas]
    publish --> metrics[Analytics]
    metrics --> ads[Meta Ads draft]
Loading

Design completo: .specs/architecture/DESIGN.md.

Layout do repo

.specs/        # product, architecture, workflow, sprints — docs canônicas
.skills/       # skills reutilizáveis (provider-neutral)
.ralph/        # scripts operacionais (loops, sync, checks)
lib/           # router + adapters de provider + publish + ads
bin/           # entry da CLI (marketing-engine.mjs)
e2e/           # specs Playwright

Detalhes de setup: SETUP.md. Contrato com agente e Definition of Done: AGENTS.md.

Desenvolver

npm install
npm run typecheck
npm run test:e2e
node bin/marketing-engine.mjs help

Contribuindo

Veja CONTRIBUTING.md. Issues e PRs bem-vindos. Conventional commits obrigatórios. CI tem que passar checks de DoD antes do merge.

Licença

Apache-2.0. Veja LICENSE.