invos 1.0.0 → 2.0.2

package/kit/.agents/skills/publicar-tema/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: publicar-tema
+description: >
+  Orquestra a criação completa de uma peça de conteúdo SEO + redes sociais a partir de um tema.
+  Pega um tema (manual ou da estratégia de conteúdo do SEO), escreve o artigo de blog completo,
+  gera o carrossel resumo via skill /carrossel, e produz as legendas pra Instagram, Facebook e
+  LinkedIn — tudo amarrado, com o carrossel apontando pro blog.
+  Use quando o usuário pedir "publicar tema", "gera o conteúdo do tema X", "transforma esse tema
+  em post", "cria o conteúdo completo", ou /publicar-tema.
+---
+
+# /publicar-tema — Pipeline de conteúdo SEO + redes sociais
+
+Skill orquestradora. Pega um tema → entrega artigo no blog + carrossel + 3 legendas (Insta, FB, LinkedIn), tudo conectado.
+
+## Dependências
+
+- **Estratégia de conteúdo:** `marketing/seo/05-estrategia-conteudo.md` (lista mestra de temas, criada pelo `/seo`)
+- **Outras pesquisas SEO:** `marketing/seo/01-pesquisa-demanda.md`, `02-analise-concorrencia.md`, `08-geo-otimizacao-ia.md`
+- **Skill carrossel:** `.agents/skills/carrossel/SKILL.md` — usar pra fase do carrossel
+- **Site (blog):** `site/` — destino dos artigos. Estrutura comum: Astro em `site/astro-site/src/content/blog/`, ou WordPress, ou outro. Se ainda não tiver site, perguntar antes
+- **Tom de voz:** `_memoria/preferencias.md`
+- **Contexto:** `_memoria/empresa.md`, `marca/design-guide.md`
+
+---
+
+## Workflow
+
+### Passo 0 — Escolher o tema
+
+Se o usuário passou um tema explícito → usar.
+
+Se não passou nada → ler `marketing/seo/05-estrategia-conteudo.md`, listar os artigos satélite + a página pilar, e perguntar:
+
+> "Qual tema da estratégia? (lista de opções)"
+
+Marcar mentalmente quais já viraram blog (checar pasta do blog) pra não duplicar.
+
+### Passo 1 — Pesquisa rápida
+
+Antes de escrever, ler o que tem nas pesquisas SEO sobre esse tema:
+- Keyword principal e variações (`01-pesquisa-demanda.md`)
+- Como concorrentes tratam (`02-analise-concorrencia.md`) — pra fugir do óbvio
+- Ângulo GEO se aplicável (`08-geo-otimizacao-ia.md`) — perguntas que IAs respondem
+
+### Passo 2 — Escrever o blog post
+
+**Destino:** depende do stack do site. Padrões comuns:
+- Astro: `site/astro-site/src/content/blog/<slug>.md`
+- WordPress: gerar markdown que o usuário cola no editor
+- Outro: confirmar com o usuário
+
+**Slug:** kebab-case curto, sem stopwords. Ex: "Como conservar carne salgada no restaurante" → `conservar-carne-salgada`.
+
+**Frontmatter (se o stack usa markdown com frontmatter):**
+
+```yaml
+---
+title: "Título atrativo, próximo da keyword"
+description: "Meta description 150-160 caracteres, com keyword e benefício pro leitor"
+publishedAt: YYYY-MM-DD
+author: "<nome configurado em _memoria/empresa.md>"
+keywords:
+  - keyword principal
+  - variação 1
+  - variação 2
+draft: true
+---
+```
+
+**Sempre começar com `draft: true`.** O usuário revisa e flipa pra `false` quando aprovar.
+
+**Estrutura do artigo (800-1500 palavras):**
+
+1. **Lead (1-2 parágrafos):** problema concreto do público, sem enrolação
+2. **H2 explicativo:** o quê e por quê
+3. **H2 prático:** como fazer / o que olhar
+4. **H2 comparativo ou de detalhe técnico** (opcional)
+5. **H2 onde a empresa se encaixa:** conexão natural com o produto, sem ser propaganda
+6. **CTA final:** link WhatsApp / formulário / contato configurado
+
+**Regras de escrita** (seguir `_memoria/preferencias.md` estritamente):
+- Sem jargão de marketing/inglês quando o público não usa
+- Frases curtas, parágrafos de 2-4 linhas
+- Concreto: números, certificações, datas, valores quando souber
+- Markdown limpo: `##` pra H2, `###` pra H3, listas com `-`, links em `[texto](url)`
+
+### Passo 3 — Carrossel resumo
+
+**Sem perguntar, partir direto pra criação do carrossel** chamando `.agents/skills/carrossel/SKILL.md` (tipo 1: carrossel texto puro).
+
+**Pasta:** `marketing/conteudo/<slug-do-blog>-<YYYY-MM-DD>/`
+
+Estrutura de slides do resumo:
+- **Slide 1 — capa:** mesmo título do blog (ou variação enxuta)
+- **Slides 2-6:** os pontos-chave do blog (1 ideia por slide, frase natural, não bullet seco)
+- **Slide final — CTA pro blog:** "Texto completo no nosso blog" + URL `<dominio>/blog/<slug>`
+
+**Capa:** seguir sequência alternada do feed (claro → foto/escuro → cor principal → repete) — checar `marketing/conteudo/` mais recente.
+
+### Passo 4 — Legendas (3 versões)
+
+Salvar todas em `marketing/conteudo/<pasta-do-carrossel>/`:
+
+**`legenda.md`** (Instagram + Facebook — mesmo texto):
+- Hook na primeira linha
+- 2-3 parágrafos de contexto (frases naturais, sem corporativês)
+- CTA pro carrossel ("Arraste pro lado") + CTA pro blog ("Texto completo no link da bio" ou URL direta)
+- Bloco oferta da empresa (diferenciais, contato)
+- 10-15 hashtags (público + nicho + local)
+
+**`legenda-linkedin.md`** (LinkedIn — mais formal, sem hashtags):
+- Hook (pode ser provocativo, profissional)
+- 3-5 parágrafos analíticos — LinkedIn aceita texto longo
+- Sem "arraste pro lado" (público diferente, comportamento diferente)
+- CTA: link direto pro blog
+- Sem bloco de oferta agressivo — fechar com 1 linha de quem é a empresa
+- Máx 3 hashtags no final, do nicho profissional
+
+### Passo 5 — Resumo de entrega
+
+No fim, mostrar pro usuário uma lista clara:
+
+```
+✓ Blog post: <caminho>/<slug>.md (draft)
+✓ Carrossel: marketing/conteudo/<pasta>/
+  - carrossel.html + render.js
+  - PNGs em instagram/
+✓ Legendas:
+  - legenda.md (Insta + FB)
+  - legenda-linkedin.md
+
+Pra publicar:
+1. Revisar o blog → flipar draft: false
+2. Rebuild do site (se Astro/Hugo/etc) ou copiar pro CMS
+3. Renderizar PNGs do carrossel: cd marketing/conteudo/<pasta> && node render.js
+4. Postar carrossel no Insta + FB com legenda.md (ou usar /aprovar-post)
+5. Postar texto + link no LinkedIn com legenda-linkedin.md
+```
+
+---
+
+## Quando NÃO usar essa skill
+
+- Pedido de carrossel avulso (sem blog) → usar `/carrossel` direto
+- Atualização de artigo existente → editar direto o .md
+- Post único, frase de impacto → `/carrossel`
+
+## Princípios
+
+1. **Blog é a peça-mãe.** Carrossel e legendas são derivados dele, não o contrário.
+2. **Tudo conectado.** Cada peça referencia a outra (carrossel linka pro blog, blog tem CTA pro contato).
+3. **Draft sempre.** Nunca publicar automaticamente — usuário revisa antes (ou usa `/aprovar-post`).
+4. **Linguagem do público real.** Sem corporativês. Sempre.

package/kit/.agents/skills/relatorio-ads/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: relatorio-ads
+description: >
+  Gera relatório semanal de performance de anúncios pagos (Google Ads + Meta Ads). Lê CSVs
+  exportados das plataformas (ou prints) e devolve análise executiva com KPIs, top criativos,
+  alertas (queima de orçamento, CTR baixo, conversões caindo) e recomendações práticas pra
+  semana seguinte.
+  Use quando o usuário pedir "relatório de ads", "relatório de campanha", "como foram os ads",
+  "performance da semana", "relatorio meta", "relatorio google ads", ou /relatorio-ads.
+---
+
+# /relatorio-ads — Relatório semanal de Google Ads + Meta Ads
+
+Skill que transforma exports brutos das plataformas em relatório executivo que o dono entende sem precisar abrir a interface do Google ou da Meta.
+
+## Dependências
+
+- **Contexto:** `_memoria/empresa.md`, `_memoria/estrategia.md`
+- **Tom de voz:** `_memoria/preferencias.md`
+- **Inputs:** CSVs do Google Ads e/ou Meta Ads Manager. Print também aceito (transcrever)
+- **Histórico:** `marketing/campanhas/relatorios/` (criar se não existir)
+
+---
+
+## Como rodar
+
+Usuário roda o comando e cola/aponta os arquivos:
+
+```
+/relatorio-ads
+dados/google-ads-2026-05-12.csv
+dados/meta-ads-2026-05-12.csv
+```
+
+Ou simplesmente:
+
+```
+/relatorio-ads
+```
+
+Aí a skill pergunta onde estão os exports da semana.
+
+## Workflow
+
+### Passo 1 — Ler os exports
+
+**Google Ads:** colunas mínimas esperadas — Campanha, Grupo, Impressões, Cliques, CTR, CPC médio, Custo, Conversões, CPA, Conv. rate.
+
+**Meta Ads:** colunas mínimas esperadas — Campanha, Conjunto, Impressões, Alcance, Cliques no link, CTR, CPM, Frequência, Custo, Resultados, Custo por resultado.
+
+Se faltar coluna crítica (Conversões / Resultados), avisar e seguir só com tráfego.
+
+### Passo 2 — Comparar com a semana anterior
+
+Buscar em `marketing/campanhas/relatorios/` o relatório anterior. Se existir, calcular variação semana vs semana:
+
+- Investimento total
+- Cliques / Impressões
+- CTR (clique / impressão)
+- CPC / CPM
+- Conversões totais (Google + Meta)
+- CPA (custo / conversão)
+- Custo por canal
+
+Se não existir, é a primeira leitura — sinalizar como baseline.
+
+### Passo 3 — Resumo executivo (topo do relatório)
+
+Uma página, leitura de 2 minutos. Estrutura:
+
+```markdown
+# Relatório de Ads — semana <DD/MM> a <DD/MM>
+
+## Resumo executivo
+
+**Investimento:** R$ X.XXX (▼/▲ Y% vs semana anterior)
+**Conversões:** N (▼/▲ Y%)
+**CPA médio:** R$ X.XX (▼/▲ Y%)
+
+**Canais:**
+- Google Ads: R$ X.XXX → N conversões (CPA R$ X.XX)
+- Meta Ads:   R$ X.XXX → N conversões (CPA R$ X.XX)
+
+**Headline da semana:** 1 frase do que mais importa (campanha que estourou, criativo que matou,
+alerta de orçamento, queda inesperada).
+```
+
+### Passo 4 — Detalhamento por canal
+
+Pra cada canal, listar:
+
+**Top 3 campanhas/grupos por performance** (menor CPA, maior conv. rate)
+**Bottom 3** (maior CPA, menor conv. rate) — sinalizar pra pausar ou ajustar
+**Top criativos** (Meta): impressões + CTR + custo por resultado
+**Bottom criativos** (Meta): pra trocar ou pausar
+**Palavras-chave com mais custo e zero conversão** (Google) — virar negativas
+
+### Passo 5 — Alertas automáticos
+
+Varrer os dados e gerar alertas em vermelho/amarelo:
+
+| Alerta | Critério |
+|---|---|
+| 🔴 Queima de orçamento | Campanha gastou >R$X com 0 conversões |
+| 🔴 CTR despencou | CTR caiu >30% vs semana anterior |
+| 🟡 Frequência alta (Meta) | Conjunto com freq > 3.0 — público saturado |
+| 🟡 Conv. rate baixa | <1% em campanha Search |
+| 🟡 CPC subindo | CPC médio +20% vs semana anterior |
+| 🟢 Oportunidade | Campanha com CTR/conv acima da média + orçamento limitado → considerar aumentar |
+
+### Passo 6 — Recomendações pra semana
+
+Lista curta (3-5 itens) de ações concretas:
+
+```markdown
+## Pra fazer na próxima semana
+
+1. **Pausar** Grupo "X" — gastou R$ 230 sem conversão em 7 dias
+2. **Adicionar negativas:** [lista de termos que apareceram nos search terms e não convertem]
+3. **Trocar criativo Meta** do conjunto "Y" — frequência 4.2, performance caindo
+4. **Aumentar orçamento** da campanha "Z" — CPA R$ 12, abaixo do alvo
+5. **Testar** novo RSA com headline "<sugestão baseada em concorrência atual>"
+```
+
+### Passo 7 — Salvar
+
+```
+marketing/campanhas/relatorios/<YYYY-MM-DD>-relatorio.md
+```
+
+Frontmatter com:
+```yaml
+---
+periodo_inicio: YYYY-MM-DD
+periodo_fim: YYYY-MM-DD
+investimento_total: 0000.00
+conversoes_total: 0
+cpa_medio: 00.00
+canais: [google-ads, meta-ads]
+---
+```
+
+Esse frontmatter facilita comparações futuras com scripts e a leitura de longo prazo.
+
+### Passo 8 — Entrega
+
+Mostrar o resumo executivo direto no chat (Passos 3 + 5 + 6) e apontar pro arquivo completo:
+
+> "Relatório completo em `marketing/campanhas/relatorios/<data>-relatorio.md`. Quer que eu envie por email pro cliente?"
+
+Se sim, chamar `/email-profissional` com o resumo executivo + link/anexo.
+
+---
+
+## Regras
+
+- **Nunca inventar números.** Se o export tá truncado ou ilegível, dizer "dados incompletos" e seguir só com o que dá.
+- **Comparação é o que importa.** Número solto ("R$ 1.200 essa semana") não significa nada sem o comparativo.
+- **Alertas em ordem.** Vermelho primeiro, amarelo depois, verde por último.
+- **Recomendações concretas.** "Pausar Grupo X" > "Otimizar campanhas". Nome da campanha, valor, motivo.
+- **Linguagem do dono.** Seguir `_memoria/preferencias.md`. CPM, CTR, CPA são OK se o dono já entende; se não, traduzir ("custo por mil pessoas que viram", "% de quem clicou", "quanto custou cada cliente").
+- **Frequência boa pra Meta:** 1.5–3.0. Acima de 3.0 já satura. Acima de 4.0 vira ruído.
+- **Quando reportar perda:** não amenizar. "A campanha X queimou R$ 200 sem trazer venda" é mais útil que "a campanha X teve performance abaixo do esperado".

package/kit/.agents/skills/responder-avaliacoes/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: responder-avaliacoes
+description: >
+  Escreve respostas curtas e humanas pras avaliações do Google Meu Negócio.
+  Mantém o padrão: nome do cliente, agradecimento variado, frase concreta sobre
+  o produto/serviço da empresa, emoji opcional. Nada de resposta automática de
+  empresa grande.
+  Use quando o usuário disser "responder avaliação", "resposta pro Google",
+  "tem uma avaliação nova", "me ajuda a responder essas reviews",
+  "avaliação do GMB", ou colar texto/print de uma review do Google.
+---
+
+# /responder-avaliacoes — Respostas pras avaliações do Google
+
+## Dependências
+
+- **Tom de voz:** `_memoria/preferencias.md`
+- **Contexto do negócio:** `_memoria/empresa.md`
+
+---
+
+## Padrão de resposta
+
+Respostas são **curtas** (1 a 2 frases), **pessoais** e **concretas**. Nada de resposta automática de empresa grande.
+
+### Regras fixas
+
+1. **Sempre citar o nome do cliente.** Primeiro nome, com capitalização correta (mesmo que o perfil esteja em minúsculo, ex: "jj nascimento" → "JJ"; "alexandre fior" → "Alexandre"). Se o nome for ambíguo ou parecer username, usar um agradecimento genérico caloroso sem forçar o nome.
+2. **Sempre agradecer.** Variar: "Obrigado", "Muito obrigado", "Que bom", "Valeu" — pra não parecer robô.
+3. **Frase concreta, não genérica.** Puxar algo específico da review ou algo da empresa (produto, processo, cuidado, tradição). Evitar "seu feedback é muito importante pra nós", "estamos sempre à disposição", "agradecemos a preferência".
+4. **Emoji no final — opcional, na maioria das vezes sim.** Usar em reviews calorosas/elogiosas. Pular em reviews formais, curtas secas, ou críticas. Nunca mais de 1 emoji.
+5. **Tom:** seguir `_memoria/preferencias.md`. Sem jargão de marketing. Sem "premium", "qualidade ímpar", "experiência diferenciada".
+
+### Exemplos genéricos (adaptar ao negócio)
+
+- Cliente (5★ "Produto excelente, recomendo.")
+  → *"Obrigado [Nome]! Saber que o produto agradou é o nosso maior orgulho. 🤩"*
+- Cliente (5★ "Atendimento ótimo")
+  → *"Que bom que gostou do atendimento, [Nome]! Caprichamos em cada detalhe."*
+- Cliente (5★ sem texto)
+  → *"Muito obrigado pelo carinho, [Nome]."*
+
+### Emojis do repertório
+
+- **Calorosos (elogio):** 🤩 😊 🙏 ❤️
+- **Específicos do nicho:** depende do negócio — comida 🔥👏🥩, beleza 💅✨ (com cuidado), serviços 👏🙌
+- **Evitar (tom de marketing genérico):** ✨ 🎉 💯 🚀 (a menos que combine com o tom da marca em `_memoria/preferencias.md`)
+
+---
+
+## Workflow
+
+### Passo 1 — Receber a(s) avaliação(ões)
+
+O usuário vai colar texto, print ou lista de reviews. Extrair pra cada uma:
+- Nome do autor
+- Nota (estrelas)
+- Texto da review (se tiver)
+
+Se for print (imagem), ler e transcrever os dados antes de responder.
+
+### Passo 2 — Escrever a resposta
+
+Pra cada review, escrever **uma única resposta** seguindo o padrão acima.
+
+**Calibrar pelo tipo de review:**
+
+| Tipo | Abordagem |
+|---|---|
+| 5★ elogio específico (produto, atendimento) | Agradecer + eco da coisa elogiada + emoji caloroso |
+| 5★ genérica/curta ("ótimo", "recomendo") | Agradecer + frase sobre cuidado/processo + emoji opcional |
+| 5★ sem texto | Agradecimento curto pelo carinho, sem inventar contexto |
+| 4★ elogio com ressalva | Agradecer + reconhecer o ponto levantado + compromisso simples, sem emoji |
+| 3★ ou menos | **Parar e alinhar com o usuário antes de responder** — review negativa merece resposta sob medida. Não responder no automático. |
+
+### Passo 3 — Entregar em formato fácil de copiar
+
+Listar cada resposta abaixo da review, pronta pra colar no GMB. Formato:
+
+```
+**[Nome do autor]** — [estrelas] — "[trecho curto da review]"
+→ [resposta]
+```
+
+Se forem muitas (5+), entregar em bloco corrido com separador claro entre cada uma.
+
+### Passo 4 — Salvar o histórico (opcional)
+
+Se o usuário pedir pra guardar, salvar em `marketing/avaliacoes-google/YYYY-MM-DD-respostas.md` com review + resposta publicada. Só criar a pasta se o usuário quiser registro. Não fazer por padrão.
+
+---
+
+## Regras
+
+- Nunca copiar respostas idênticas pra reviews diferentes. Variar sempre.
+- Não prometer nada que não depende só da empresa (logística terceirizada, prazo de fabricante, etc.).
+- Não pedir que o cliente entre em contato por DM/telefone na resposta pública, a menos que o usuário peça (gera ruído na resposta).
+- Não usar nome completo do cliente na resposta (só primeiro nome).
+- Não mencionar concorrentes, mesmo se o cliente mencionar.
+- Em reviews negativas: reconhecer, não se defender, oferecer canal privado só se o usuário autorizar.

package/kit/.agents/skills/salvar/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: salvar
+description: >
+  Salva o trabalho do INVOS no GitHub (commit + push). Na primeira vez configura o repositório
+  remoto. Use quando o usuário disser "salvar", "salva no github", "commit", "push", "/salvar"
+  ou pedir backup do trabalho.
+---
+
+# /salvar — Salvar no GitHub
+
+Skill de uma função só: garantir que o trabalho do usuário está no GitHub. Fácil pra quem nunca usou git.
+
+## Workflow
+
+### Primeira vez (repositório não inicializado)
+
+Detectar com `git rev-parse --is-inside-work-tree`. Se falhar:
+
+1. Perguntar:
+   > "Esse é o primeiro syncar. Você já tem um repositório criado no GitHub pra esse workspace?
+   > 1. Sim, me passa a URL (ex: https://github.com/usuario/nome.git)
+   > 2. Não, vou criar agora — me dá um nome pro repositório (ex: meu-invos)"
+
+2. **Se opção 1:** rodar `git init`, `git add .`, `git commit -m "Setup inicial do INVOS"`, `git branch -M main`, `git remote add origin <URL>`, `git push -u origin main`.
+
+3. **Se opção 2:** verificar se o `gh` CLI está instalado (`gh --version`). 
+   - Se sim: rodar `git init`, criar commit inicial, e `gh repo create <nome> --private --source=. --push`.
+   - Se não: instruir o usuário a instalar `gh` (https://cli.github.com/) ou criar o repo manualmente em github.com/new e voltar com a URL.
+
+### Commits seguintes (já configurado)
+
+1. Rodar `git status`. Se não tiver mudanças, responder "Tá tudo sincronizado, sem mudança nova" e parar.
+
+2. Mostrar o `git status` curto pro usuário e perguntar:
+   > "Vou comitar tudo isso. Quer descrever a mudança em uma frase ou usa o resumo automático?"
+
+3. Se o usuário fornecer mensagem, usar. Se não, gerar uma mensagem baseada nos arquivos alterados (1 linha, formato: "Atualiza X" ou "Adiciona Y" ou "Cria proposta pra cliente Z").
+
+4. `git add .` → `git commit -m "<mensagem>"` → `git push`.
+
+5. Confirmar com link do repositório (extrair de `git remote get-url origin`):
+   > "Sincronizado. Ver no GitHub: <URL>"
+
+## Regras
+
+- Nunca usar `--force` sem o usuário pedir explicitamente
+- Nunca rodar `git reset --hard` ou outras destrutivas sem confirmação clara
+- Se o push falhar por divergência (alguém comitou no remoto), avisar o usuário e oferecer `git pull --rebase` antes de tentar de novo
+- Se o usuário ainda não tiver `git` configurado (`user.name` / `user.email`), perguntar e configurar com `git config --global` na primeira vez