marketing-anasps

v1.0.5

Published

6 hours ago

Framework de agentes, skills e inteligência de marketing institucional e previdenciário para Claude Code e Antigravity — ANASPS

0High
0Medium
0Low

pedrohsl1

anasps claude-code antigravity gemini ai-agents marketing-ai previdencia-social servidores-publicos faculdade-anasps ffmpeg opus social-media institutional-marketing

🏛️ ANASPS Marketing AI Framework

Guia Oficial, Didático e Prático de Inteligência de Marketing Institucional e Previdenciário para Claude Code
Associação Nacional dos Servidores Públicos — ANASPS (Fundada em 18 de agosto de 1992)

📖 1. O Que É Este Projeto?

O ANASPS Marketing AI Framework é uma central inteligente de trabalho colaborativo criada para a equipe de comunicação e marketing da ANASPS.

Ele funciona integrado ao Claude Code (a ferramenta oficial da Anthropic para terminais) e transforma solicitações em linguagem natural em peças completas de marketing institucional, roteiros de vídeos curtos, carrosséis educativos para o Instagram, calendários editoriais e relatórios de auditoria factual.

Por que ele foi criado?

Explicar a Previdência Social sem "juridiquês": Traduzir regras complexas (RPPS, RGPS, EC 103/2019, abono de permanência, pensão por morte) para linguagem cidadã, didática e clara.
Divulgar a Faculdade ANASPS: Comunicar os cursos autorizados e reconhecidos pelo MEC (com destaque para o curso de Gestão Pública com Nota Máxima 5).
Respeitar rigorosamente a verdade: Proibir invenção de informações, verificar dados antes de escrever e bloquear qualquer publicação automática sem revisão humana.
Editar e dirigir vídeos de alta retenção: Gerar roteiros e executar cortes reais de vídeos para Reels, Shorts e TikTok usando ferramentas locais 100% gratuitas (FFmpeg), sem gastar com plataformas pagas.

📦 2. O Que Tem Dentro Deste Repositório?

O repositório é uma solução completa organizada em 7 blocos principais:

marketing-anasps/
├── 🤖 .claude/agents/        ──▶ 12 Subagentes especializados (Diretor, Roteirista, Auditor, etc.)
├── ⚡ .claude/skills/        ──▶ 19 Metodologias e habilidades ativadas sob demanda
├── ⌨️  .claude/commands/      ──▶ 7 Comandos rápidos de atalho (/anasps-video, /anasps-post, etc.)
├── 📚 knowledge/             ──▶ Base de conhecimento institucional e 6 guias de identidade de marca
├── 🎬 scripts/               ──▶ Utilitário local de edição de vídeo (corte, probing e conversão 9:16)
├── 🧪 evaluations/           ──▶ 20 Casos de testes estruturados com 209 verificações automáticas
├── 📂 output/                ──▶ Diretório seguro onde os conteúdos gerados são armazenados (EM REVISÃO)
└── 📄 CLAUDE.md              ──▶ Regras mestras de orquestração carregadas na abertura do Claude Code

🤖 Os 12 Subagentes Especializados

| Agente | Arquivo | O Que Ele Faz? | | :--- | :--- | :--- | | Marketing Director | marketing-director.md | O maestro da equipe: analisa pedidos complexos, distribui tarefas e consolida o pacote final de entrega. | | Previdência Specialist | previdencia-specialist.md | Especialista jurídico em RPPS e RGPS; verifica marcos temporais e artigos da CF/88 e EC 103/2019. | | Faculdade ANASPS | faculdade-anasps.md | Divulgador acadêmico; fundamenta pautas nos cursos reais credenciados pelo MEC (Nota 5 em Gestão Pública). | | Institutional Comm. | institutional-communication.md | Comunica a história de 34 anos da ANASPS, os 94 fundadores e os serviços de apoio ao servidor público. | | Content Strategist | content-strategist.md | Estrategista de campanhas; equilibra os 4 pilares editoriais e monta cronogramas multicanal. | | Trend Researcher | trend-researcher.md | Pesquisa tendências em redes sociais em 3 níveis (A: público, B: fornecido, C: oficial) sem dados inventados. | | Creative Ref. Analyst | creative-reference-analyst.md | Analisa grandes campanhas e extrai técnicas narrativas sem copiar layouts, logos ou slogans de terceiros. | | Scriptwriter | scriptwriter.md | Roteirista de vídeos curtos verticais no Framework WATCH (áudio desligado primeiro, 3 ganchos iniciais). | | Video Editing Director | video-editing-director.md | Diretor audiovisual (Opus prioritário quando disponível); gera decupagem e executa cortes via FFmpeg local. | | Social Media & Copy | social-media.md | Redator de carrosséis em 4 zonas e posts individuais com texto acessível #PraTodosVerem. | | Fact Checker | fact-checker.md | Auditor factual rigoroso em 5 níveis (CONFIRMADA, PARCIAL, NÃO CONFIRMADA, DESATUALIZADA, HUMANA). | | Editorial Reviewer | editorial-reviewer.md | Guardião do tom cidadão; elimina clichês de IA (ex: "não é sobre X, é sobre Y" ou falsos contrastes). |

⚡ As 19 Skills e Metodologias Operacionais

anasps-context: Contexto institucional mestre, pilares e restrições éticas.
institutional-brand-voice: Tom de voz acolhedor, linguagem cidadã e filtro anti-vícios de IA.
previdencia-research: Protocolo de pesquisa em legislação previdenciária e jurisprudência.
official-source-verification: Classificação de fontes oficiais em Níveis A, B, C e D.
institutional-content-writing: Redação de artigos institucionais em pirâmide invertida.
social-media-strategy: Mapeamento de canais e públicos do funcionalismo federal.
social-post-creation: Produção de posts individuais e cards informativos.
carousel-creation: Carrosséis educativos de 6 a 10 slides na Arquitetura de 4 Zonas (Capa, Contexto, Corpo, CTA).
short-video-script: Roteiro de vídeo vertical (até 60s) no Framework WATCH.
video-storyboarding: Direção de arte, enquadramentos de câmera, B-roll e motion design.
content-repurposing: Desdobramento multicanal 1 → 5 (1 artigo virando 5 formatos nativos).
editorial-calendar: Grade editorial equilibrada nos 4 pilares com datas flexíveis.
campaign-planning: Campanhas temáticas em 4 fases integradas.
accessibility-review: Auditoria de acessibilidade digital e audiodescrição #PraTodosVerem.
content-quality-audit: Auditoria de qualidade em 5 dimensões com nota de corte.
fact-checking: Decomposição de afirmações e laudo formal nos 5 níveis de certeza.
institutional-approval-package: Consolidação de ativos com status compulsório de EM REVISÃO.
trend-research: Metodologia de pesquisa de tendências em 10 etapas metódicas.
video-post-production: Pipeline em 5 fases de edição e formatação local com FFmpeg.

⚙️ 3. O Que Preciso Ter Instalado? (Pré-Requisitos)

Antes de rodar, verifique se seu computador possui os programas gratuitos abaixo:

🩺 Como checar se tudo está pronto com 1 comando:

Execute no terminal:

npx marketing-anasps doctor

Se todos os itens exibirem um check verde ✔, seu ambiente está 100% pronto!

🚀 4. Como Instalar e Começar a Usar

Opção A: Usando NPM / NPX (Recomendado)

Você pode instalar globalmente no seu computador:

npm install -g marketing-anasps

Ou executar comandos diretamente via npx:

# Diagnosticar pré-requisitos instalados
npx marketing-anasps doctor

# Ver o resumo do framework
npx marketing-anasps info

# Executar a bateria de 20 testes automatizados
npx marketing-anasps test

Opção B: Clonando pelo Git

Se preferir clonar o código-fonte para editar ou adicionar fontes:

git clone https://github.com/pedrohenriquesanchesleal4-debug/MarketingAnasps.git
cd MarketingAnasps

💡 5. Como Usar no Dia a Dia (Guia Prático Passo a Passo)

Passo 1: Iniciar a Sessão do Claude Code

Abra o terminal dentro da pasta do projeto e digite:

claude

O Claude Code inicializará e lerá automaticamente o arquivo de governança CLAUDE.md, carregando os 12 agentes, as 19 skills e as diretrizes da ANASPS.

Passo 2: Fazer Pedidos em Linguagem Natural

Você pode conversar normalmente com o assistente:

🔹 Exemplo 1: Explicar um tema previdenciário

"Crie uma publicação educativa explicando para os servidores federais como funciona a regra de transição do pedágio de 100% na aposentadoria."

🔹 Exemplo 2: Divulgar a Faculdade ANASPS

"Elabore um texto institucional informando que o curso de Tecnologia em Gestão Pública da Faculdade ANASPS obteve Nota Máxima 5 no MEC e destaque os diferenciais para servidores."

🔹 Exemplo 3: Roteirizar vídeo vertical para redes sociais

"Escreva um roteiro de vídeo vertical de 45 segundos sobre como se proteger de golpes do falso empréstimo consignado, com 3 opções de ganchos iniciais e decupagem cena a cena."

🔹 Exemplo 4: Pesquisar tendências criativas sem plágio

"Pesquise vídeos educativos em alta sobre planejamento para aposentadoria e analise quais recursos visuais e ganchos foram usados, propondo uma versão original adaptada à ANASPS."

Passo 3: Usar os Comandos Rápidos de Atalho

O framework possui 7 comandos slash prontos para acelerar sua produção:

Passo 4: Editar Vídeos Localmente com FFmpeg (Sem Custos de APIs)

Se você tem gravações brutas (palestras, entrevistas, webinários) e precisa transformá-las em vídeos finalizados ou cortes para redes sociais, utilize o utilitário incluído scripts/video_editor.py:

# 1. Diagnosticar metadados (duração, resolução, taxa de quadros e áudio)
python scripts/video_editor.py probe --input palestra_gravada.mp4

# 2. Cortar trecho selecionado por minutagem exata
python scripts/video_editor.py cut --input palestra_gravada.mp4 --start 00:03:15 --end 00:03:58 --output corte.mp4

# 3. Converter formato horizontal (16:9) em vertical (9:16) com fundo desfocado elegante para Reels/Shorts
python scripts/video_editor.py format-vertical --input corte.mp4 --output corte_reels_9x16.mp4

# 4. Extrair frames representativos em JPG para inspeção visual rápida
python scripts/video_editor.py extract-frames --input corte.mp4 --output-dir ./frames --fps 1

Passo 5: Rodar os Testes de Conformidade

Para garantir que todos os arquivos, frontmatters, regras de segurança e os 20 cenários de teste continuam válidos:

npm test
# ou diretamente:
python evaluations/test_runner.py

O teste examina 209 regras automaticamente e gera o relatório detalhado em evaluations/results/test_report.md.

🛡️ 6. As 4 Regras de Ouro e Governança da ANASPS

🚫 Proibição Absoluta de Fabricação e Alucinação:
- Nunca invente cursos da Faculdade ANASPS (só divulgue os reais: Gestão Pública Nota 5 MEC, Pedagogia, ADS, Secretariado).
- Nunca prometa valores de causas jurídicas sem decisão homologada.
- Toda informação previdenciária deve indicar marco temporal e ressalvar a necessidade de análise individual.
👤 Aprovação Humana Obrigatória (Sem Publicação Automática):
- Todo arquivo gerado é salvo na pasta output/ com o status inicial compulsório de EM REVISÃO.
- O status APROVADO só pode ser concedido por um ser humano da equipe de marketing. O assistente não publica sozinho em redes sociais.
💰 Custo Zero em APIs Comerciais:
- Não depende de assinaturas ou ferramentas de edição pagas (HeyGen, Runway, ElevenLabs).
- Utiliza processamento local gratuito com FFmpeg e Python.
🎨 Identidade Própria e Política Anti-Plágio:
- É proibido copiar layouts, slogans ou identidades visuais de outras instituições.
- Referências externas servem apenas para estudar técnicas narrativas, sempre adaptadas com originalidade à missão da ANASPS.

📁 7. Guia das Pastas do Projeto

.claude/agents/: Instruções dos 12 agentes especializados em formato Markdown nativo do Claude Code.
.claude/skills/: As 19 pastas de skills contendo instruções operacionais detalhadas em SKILL.md.
.claude/commands/: Os 7 comandos de atalho rápido.
knowledge/editorial-guidelines/: Diretrizes oficiais:
- anasps-brand-foundation.md: Fundação histórica e pilares institucionais.
- anasps-tone-of-voice.md: Guia de linguagem cidadã e matriz de termos proibidos.
- anasps-visual-identity.md: Cores oficiais (Azul Marinho #1A365D, Verde #2E7D32) e tipografia.
- anasps-content-pillars.md: Os 4 pilares de distribuição temática.
- external-reference-policy.md: Diretrizes éticas e combate ao plágio.
- video-style.md: Especificações técnicas para vídeos, enquadramentos e legendas.
knowledge/TEMPLATE-FONTE.md: Modelo padrão para catalogar novos editais, portarias e atas.
output/: Onde as produções são salvas (subpastas: campaigns/, video-scripts/, social-posts/, carousels/, editorial-calendars/, verification-reports/).
scripts/video_editor.py: O motor de corte e conversão FFmpeg local.
evaluations/: O test-runner em Python e os 20 casos de testes em JSON.
docs/: Documentação técnica aprofundada sobre arquitetura, governança e uso consciente de modelos.

📄 8. Licença e Atribuições

Este projeto está licenciado sob a Licença MIT — veja o arquivo LICENSE para mais detalhes.

Repositórios de Referência Metodológica Adaptados:

coreyhaines31/marketingskills (MIT License, Copyright © 2025 Corey Haines): Princípios de alegações fundamentadas ("Claims must be supportable") e eliminação de vícios de redação de IA ("No AI Tells").

ANASPS — Associação Nacional dos Servidores Públicos
SCS Quadra 03, Bloco A, Edifício ANASPS, Brasília - DF
Portal Oficial: anasps.org.br | Faculdade: faculdadeanasps.edu.br