caption-writer

Caption Writer

Escreve legendas prontas para copiar e publicar, uma versão por plataforma (não uma única legenda colada em todos os lugares). Você é o escritor; o script scripts/captions.py verifica limites e qualidade básica, e então organiza o arquivo de saída.

Fluxo de trabalho

1. Colete a entrada.
   • Conteúdo: tópico, tipo (carrossel, reel, foto, story, depoimento, promoção) e seu texto quando fornecido (texto do carrossel, roteiro do reel, gancho). Se o usuário fornecer o texto do conteúdo, a legenda deve ser consistente com ele e não repetir todo o conteúdo do slide.
   • Plataformas de destino. Se não forem mencionadas, pergunte uma vez; se o usuário quiser rapidez, use Instagram e TikTok.
   • Objetivo (educação, salvar/compartilhar, consulta, vendas), CTA da marca e voz da marca (use Brand Lock / Voice Lock se anexado; caso contrário, deduza do conteúdo e mencione as suposições).
2. Escreva por plataforma seguindo references/caption-guide.md: gancho na primeira linha, 2-3 frases de valor, CTA, hashtag. Cada plataforma tem um ângulo e comprimento diferentes.
3. Dados que devem vir do usuário (citações de clientes, nomes, preços, datas/períodos de promoção, números, métricas de resultados): não invente. Use [INSERIR AQUI: descrição] ou pergunte em uma única mensagem curta.
4. Escreva captions.json (python scripts/captions.py --example para o esquema) e então execute python scripts/captions.py render captions.json /mnt/user-data/outputs/caption_<topico>.md.
   • Corrija todos os Erros (limite excedido, legenda vazia, chaves, hashtag mal formatada).
   • Leia os Avisos e corrija os que forem razoáveis: gancho muito longo, número de hashtags, link não clicável (mude para "link na bio"), afirmações exageradas, nenhum CTA, legendas muito semelhantes entre plataformas. Avisos podem ser mantidos se houver justificativa, mas mencione o motivo.
5. Entregue. Uma ou duas plataformas: exiba a legenda diretamente na resposta em um bloco de código. Três ou mais plataformas: salve o arquivo .md e present_files. Inclua uma lista de placeholders [INSERIR AQUI] restantes e notas relevantes (ex.: link na bio).

Princípios

• Gancho primeiro. A primeira linha deve fazer a pessoa parar antes de "ver mais" (Instagram cerca de 125 caracteres, LinkedIn cerca de 140). Forneça 2 alternativas de gancho para as plataformas principais.
• Adapte, não copie. Instagram: caloroso e conciso; TikTok: muito curto, acompanhando o vídeo; LinkedIn: profissional e estruturado; X: uma declaração única; Pinterest: palavras-chave que as pessoas pesquisam; YouTube Shorts: título claro. O script sinaliza legendas com >85% de similaridade.
• CTA suave e único. Um único chamado para ação por legenda (salvar, compartilhar, comentar, consultar). No Instagram e TikTok, links na legenda não são clicáveis, então direcione para "link na bio".
• Hashtags poucas e relevantes (cerca de 3-5 no Instagram, TikTok, LinkedIn; 0-2 no X e Facebook). Misture uma ou duas amplas com outras específicas de nicho. No TikTok, as hashtags contam para o limite de caracteres.
• Texto alternativo para imagens/carrossel: uma frase que descreva o conteúdo visual, sem "imagem de".
• Não invente e não exagere: sem "garantido", "com certeza", "100%", números de resultados ou depoimentos não fornecidos pelo usuário.
• Limites de caracteres podem mudar. Os números no script são limites seguros e conservadores de fontes públicas não uniformes (ex.: TikTok relatado como 2.200 ou 4.000, Pinterest 500 ou 800). Se o usuário perguntar sobre os limites atuais, pesquise fontes oficiais da plataforma.

Arquivos

• scripts/captions.py - render, check, --example, --limits
• references/caption-guide.md - estrutura da legenda, fórmula do gancho, regras por plataforma, texto alternativo, exemplos por tipo de conteúdo