Curso Prático
Construindo Agentes de
Social Media com IA
Não é teoria solta. É a documentação da estrutura real que construímos: organização por cliente, formatos, skills, agentes, publicação e escala.
5
Skills principais
7
Agentes especializados
1
Sistema completo validado
Módulo 01
Como os agentes pensam na prática
Não é mágica. É contexto, decisão e execução em loop.
O loop real

O agente recebe contexto, entende o objetivo, observa o projeto, decide a próxima ação e volta a observar o resultado. Ele lê → decide → age → valida — e repete até terminar. Foi exatamente assim que construímos esse sistema.

1. Contexto vem antes de ferramenta

O agente só performa bem quando entende a estrutura, o padrão de nomes, a pasta certa e a intenção do projeto. Sem contexto, ele inventa.

2. A pasta ensina o agente

Boa parte da inteligência do sistema vem da organização. A estrutura de pastas vira contexto operacional — o agente lê e entende onde está.

3. Skill é comportamento reutilizável

Quando o agente aprende um fluxo em uma skill, ele deixa de improvisar toda vez e passa a repetir o processo com consistência.

4. Orquestrar é decidir ordem

O agente orquestrador não faz tudo. Ele entende qual skill precisa entrar primeiro e em que momento parar ou publicar.

Chave prática: quanto melhor o system prompt e mais organizada a pasta, mais direto o agente chega ao resultado. Estrutura e prompt andam juntos.
Módulo 02
Arquitetura real que usamos
Pasta-mãe, depois cliente, depois formato — nessa ordem.
📁 Automação de Postagens - clientes/
📁 renanlevinski_/
📁 assets-cliente/
📁 carrossel/
📁 post-twitter/
📁 cortes/
📁 hellograf/
📁 assets-cliente/
📁 carrossel/
📁 estatico/
📁 [novo-cliente]/
📁 assets-cliente/
📁 ...

Pasta-mãe com propósito claro

Automação de Postagens - clientes deixa claro o propósito do sistema inteiro desde o nome.

Cliente no topo

Cada cliente tem seu espaço próprio. Isso evita mistura de identidade, conta, assets e projetos entre contas diferentes.

Formato dentro do cliente

Carrossel, estático, cortes e Twitter coexistem no mesmo cliente, cada um com seu fluxo e suas skills próprias.

Escala sem bagunça

Esse padrão permite crescer para N clientes sem precisar reinventar onde fica cada coisa — a estrutura se replica.

Módulo 03
Estrutura real do formato carrossel
O que de fato existe dentro de um projeto de carrossel.
📁 Automação de Postagens - clientes/
📁 renanlevinski_/
📁 carrossel/
📁 carrosseis/
📁 2026-04-06-comportamento-marketing-digital/
📄 roteiro.md
📄 legenda.txt
📄 index.html
📄 publicacao.json
📁 png/
🖼 slide-01.png
🖼 slide-02.png
📁 assets/
📁 instagram-carrossel/
📄 SKILL.md
📁 instagram-legenda/
📄 SKILL.md
📁 instagram-publicador/
📄 SKILL.md
📄 config.local.json
📁 instagram-orquestrador/
📄 SKILL.md
📁 projeto-cliente-criador/
📄 SKILL.md
Decisão importante: o fluxo de produção fica dentro do formato. O que é da marca fica em assets-cliente/. O que é operação de carrossel fica em carrossel/.
O orquestrador lê os arquivos: publicacao.json ausente = ainda não publicado. legenda.txt ausente = falta legendar. Ele se auto-orienta pelos arquivos existentes.
Módulo 04
As skills que criamos
Cada skill resolve uma etapa específica do sistema.

$instagram-carrossel

Transforma texto-base em carrossel completo. Cria roteiro, HTML, PNGs e pasta própria por post com data + tema.

$instagram-legenda

Entra em carrosseis/, encontra pastas sem legenda.txt, lê o roteiro e escreve a legenda com palavras-chave e 5 hashtags.

$instagram-publicador

Pega os PNGs e o legenda.txt, sobe para URL temporária e publica via Graph API, salvando publicacao.json.

$instagram-orquestrador

Lê o estado do projeto e decide qual skill chamar: criar, legendar, publicar ou completar pendências. Ele não faz — ele decide.

$projeto-cliente-criador

Cria novos clientes e novos projetos, monta a estrutura padrão, abre assets-cliente e registra briefing visual.

Por que skills e não prompts soltos

A skill não é só uma instrução. Ela é a forma de codificar o processo para o agente repetir sem se perder. É documentação viva que o agente executa.

Módulo 05
Ferramentas que ninguém fala
As melhores IDEs agênticas para desenvolver esse sistema.
OpenAI Codex
Surgiu: maio 2021 — Descontinuado: março 2023
Motor por trás do GitHub Copilot. Primeiro modelo de código treinado em bilhões de linhas do GitHub. Mostrou que IA podia entender e gerar código de forma confiável — abriu caminho para os agentes de hoje.
Pioneiro no códigoBase do CopilotVia API (legacy)
Hoje substituído pelo GPT-4o com capacidades de código direto no ChatGPT e API.
Claude Code
Surgiu: fevereiro 2025 — Ativo e evoluindo
CLI agêntica da Anthropic. Roda no terminal, lê toda a estrutura do seu projeto, escreve arquivos, executa comandos e faz commits. Diferente do Cursor, ele age de verdade — não só sugere.
Agente realLê o projeto inteiroExecuta no terminalRecomendado
Por que é melhor aqui: ele entende a estrutura de pastas, lê as skills, cria os SKILL.md e testa tudo — exatamente o que esse sistema precisa.

Quando usar Claude Code

  • Criar e organizar estrutura de pastas
  • Escrever e ajustar SKILL.md
  • Criar scripts de integração com APIs
  • Testar agentes no terminal

Como instalar

npm install -g @anthropic-ai/claude-code # Na pasta do projeto: claude # Abre sessão interativa

Fluxo prático

  • Abrir na pasta-mãe do projeto
  • Pedir para criar estrutura do cliente
  • Ditar o conteúdo de cada SKILL.md
  • Testar e iterar
Módulo 06
Agente Designer de Carrossel
Como a criação do post foi codificada como processo consistente.
O Problema

IA tende a criar algo diferente toda vez. Para uma marca, isso é um desastre. O agente designer precisa ser condicionado a seguir regras editoriais e visuais fixas — como um designer que absorveu o manual da marca.

Regras editoriais no SKILL.md

  • Falar como o autor — sem terceira pessoa
  • Manter texto aprovado exatamente
  • Não remover acentos
  • Sem CTA genérico
  • Voz definida por cliente

Regras visuais no SKILL.md

  • 2 a 4 imagens por carrossel
  • Estilo editorial escuro + futurista
  • Tipografia pesada
  • Cor de destaque definida por cliente
  • Exportação PNG 1080×1350

Saída esperada da skill

  • roteiro.md com o conteúdo
  • index.html com os slides
  • png/slide-01.png etc.
  • assets/ com as imagens usadas

Organização por post

Cada carrossel ganha uma pasta nova com data + slug. Isso foi uma decisão importante — nunca sobrescreve trabalho anterior e facilita o orquestrador a identificar o estado.

Módulo 07
Agente de Legenda
A legenda nasce do carrossel, não do chute.
📁

carrosseis/
📄

roteiro.md
🧠
Extrai tema
e palavras-chave
💾
Salva
legenda.txt

Regra central da skill

A skill entra nas pastas dentro de carrosseis/ que ainda não têm legenda.txt. Isso evita retrabalho e mantém o processo rastreável.

Estrutura da legenda

  • Abertura forte
  • 1 a 3 parágrafos curtos
  • Palavras-chave do tema
  • Exatamente 5 hashtags

Por que isso importa

A legenda deixa de ser uma etapa manual solta e passa a ser continuação lógica do carrossel. O agente não inventa — ele lê o roteiro e deriva a legenda.

Saída

O arquivo legenda.txt sempre fica dentro da própria pasta do carrossel. Isso simplifica o trabalho do publicador — tudo no mesmo lugar.

Módulo 08
Agente Publicador
Como o sistema chega até a conta do Instagram via Graph API.
  • 1

    Ler pasta pronta

    O publicador só trabalha quando existem PNGs e legenda.txt. Sem os dois, ele para.

  • 2

    Subir arquivos

    Os slides são enviados para uma URL pública temporária antes de entrar na Graph API.

  • 3

    Criar containers

    Um container por imagem do carrossel, com espera entre chamadas para evitar rate limit do Meta.

  • 4

    Publicar e registrar

    Após publicação, salva publicacao.json na pasta do post — o sinal de que esse post foi concluído.

# Fluxo do publicador PNG + legenda.txt → upload temporário → Graph API /media (container) → Graph API /media_publish → publicacao.json salvo # Config da conta (local, não versionado) instagram-publicador/config.local.json # Protegido no .gitignore instagram-publicador/config.local.json
Decisão importante: a credencial de publicação não fica misturada com a documentação do projeto. Ela fica isolada em config.local.json e protegida pelo .gitignore.
Módulo 09
Agente de Corte de Vídeo
Como montar o prompt e quais ferramentas esse agente usa.

O que esse agente usa

  • ffmpeg — corte e extração de frames, via terminal
  • Whisper (OpenAI) — transcrição do áudio
  • Python subprocess — executa os comandos
  • Pasta cortes/ dentro do cliente

Fluxo

  1. Recebe vídeo bruto na pasta entrada/
  2. Transcreve o áudio com Whisper
  3. Identifica os melhores momentos
  4. Gera cortes com ffmpeg (9:16)
  5. Salva clipes em cortes/ com nome descritivo

Como montar o SKILL.md

# System prompt do agente de corte Você é um editor de vídeo vertical para redes sociais. Dado um vídeo longo, você deve: 1. Transcrever usando Whisper 2. Identificar trechos com: - Insights objetivos (máx 60s) - Histórias com gancho - Momentos de emoção 3. Usar ffmpeg para recortar 4. Formato: 9:16 vertical 5. Salvar em cortes/ com nome descritivo do conteúdo 6. NÃO cortar: silêncios longos, ruído, erros, hesitações
Dica de ouro: diga ao agente o que você NÃO quer que ele corte. Silêncios longos, momentos com ruído e partes com erros devem ser listados explicitamente.
Módulo 10
Agente de Capas para Reels
Mesmo conceito do designer, mas focado em thumbnails 9:16.
Por que um agente separado?

Capa de Reel tem regras diferentes de um carrossel. Precisa ter título impactante visível, funcionar como thumbnail pequeno e ser lido em menos de 1 segundo. As regras visuais são diferentes.

Input do agente

  • Título do clipe (do agente de corte)
  • Frame extraído pelo ffmpeg
  • Logo do cliente (de assets-cliente/)
  • Paleta da marca (do briefing-visual.md)

Regras da capa

  • Formato 1080×1920px (9:16)
  • Texto grande e legível em thumbnail
  • Contraste alto
  • Logo presente mas discreto
  • Identidade visual do cliente

Diferença do carrossel

  • Proporção vertical (não quadrado)
  • Texto mais curto e direto
  • Sempre tem título do clipe
  • Frame do vídeo como fundo
Fluxo integrado: agente de corte gera clipe → extrai frame com ffmpeg → agente de capa recebe frame + título → gera capa PNG → salva junto ao clipe em cortes/.
Módulo 11
Agente Orquestrador
A skill que entende o estado do sistema e decide o próximo passo.
A função real dele

O orquestrador não desenha, não escreve legenda e não publica diretamente. Ele olha para o projeto e entende se falta criar, legendar, publicar ou só informar status. É o agente que decide a ordem.

👤
Usuário
🧠
Orquestrador
🎨
Carrossel
✍️
Legenda
📤
Publicador

Como ele lê o status

  • tem roteiro.md, HTML e PNGs? o carrossel existe
  • falta legenda.txt? precisa de legenda
  • tem legenda, falta publicacao.json? pronto para publicar
  • tem publicacao.json? já foi publicado — não reprocessar

Por que isso é forte

Você para de precisar lembrar manualmente em que etapa cada post está. O sistema se auto-organiza a partir dos arquivos presentes na pasta — os arquivos são o estado.

Ponto de aprovação humana: o orquestrador pode ser configurado para pausar antes da publicação e aguardar confirmação. Nunca automatize 100% sem esse checkpoint inicial.
Módulo 12
Skill que gera clientes e projetos
A peça que permite escalar a estrutura para novos clientes sem bagunça.

A skill $projeto-cliente-criador

  • 1

    Modo cliente

    Cria pasta do cliente, assets-cliente/ com subpastas (logo, fontes, cores, referencias, elementos), cliente.md e formatos iniciais.

  • 2

    Modo projeto

    Entra em cliente existente, cria o novo formato, registra projeto.md e briefing-visual.md desde o início.

  • 3

    Reuso do fluxo

    Se o formato criado for carrossel, ela já duplica o fluxo validado com todas as skills internas.

  • 4

    Orienta o usuário

    A skill também instrui a abastecer assets-cliente/ com logo, fontes, manual de cores e referências.

# Resultado do modo cliente Automação de Postagens - clientes/ hellograf/ assets-cliente/ logo/ fontes/ cores/ referencias/ elementos/ cliente.md carrossel/ instagram-carrossel/SKILL.md instagram-legenda/SKILL.md instagram-publicador/SKILL.md instagram-orquestrador/SKILL.md carrosseis/ estatico/
O briefing-visual.md é a chave: é onde você registra estilo, tom, referências, cores e sensação da marca — o documento que o agente designer lê antes de qualquer criação.
Sistema completo documentado
Agora a aula ensina exatamente o que foi construído. 🎉