invos 1.0.0

package/kit/.agents/squads/instagram-carrossel/pipeline/data/research-brief.md

@@ -0,0 +1,135 @@
+# Research Brief — Instagram Carousel Squad
+**Squad:** instagram-carrossel
+**Prepared:** 2026-03-03
+**Domains researched:** 4
+
+---
+
+## Domain 1: Copywriting para Carrossel de Instagram
+
+### Key Findings
+
+1. **O primeiro slide decide tudo.** Carrosséis que param o scroll usam headlines provocativas, perguntas desafiadoras ou estatísticas surpreendentes nos primeiros 125 caracteres. A promessa de valor deve ser clara e imediata.
+   - Confidence: HIGH | Sources: Hootsuite, Planoly, Sked Social, 2024-2025
+
+2. **Carrosséis educacionais são os que mais geram saves.** Posts que ensinam algo concreto (passo a passo, mitos vs. fatos, dados reveladores) acumulam saves — o sinal mais importante para o algoritmo do Instagram em 2025.
+   - Confidence: HIGH | Sources: Growth Curve, Full Stop Social Media, 2025
+
+3. **Estrutura PAS (Problem-Agitate-Solution) é a mais eficaz para conteúdo tech/IA.** Slide 1 apresenta o problema, slides 2-3 aprofundam a dor ou revelam o dado surpreendente, slides 4-6 entregam a solução, slide final tem CTA claro.
+   - Confidence: HIGH | Sources: Octospark, Thistle Media, 2025
+
+4. **Cada slide deve ter UMA ideia.** Densidade excessiva por slide reduz o tempo de permanência. Máximo de 3-4 linhas de texto visível por slide.
+   - Confidence: HIGH | Sources: Avramify, Hootsuite, 2025
+
+5. **CTA final deve ser específico e orientado a ação.** "Salva pra não perder", "Comenta X" e "Compartilha com alguém que precisa ver isso" superam CTAs genéricos como "Segue a gente".
+   - Confidence: HIGH | Sources: Buffer, Resont, 2025
+
+### Frameworks Found
+- **PAS** (Problem-Agitate-Solution): Mais eficaz para conteúdo de awareness em tech/IA
+- **AIDA** (Attention-Interest-Desire-Action): Ideal para primeira exposição à marca
+- **Myth vs. Fact**: Performa excepcionalmente bem em nichos de tecnologia e IA
+- **Data-first storytelling**: Dado → Contexto → Implicação → Ação
+
+### Trending Angles for Tech/AI Carousels
+- "Você está fazendo X errado e nem sabe" — Lifecycle: Growth
+- "Os dados que a mídia não te mostra" — Lifecycle: Growth
+- "O que acontece quando você compara A vs. B" — Lifecycle: Emerging
+- "Passo a passo de como fazer X sem saber programar" — Lifecycle: Mature but effective
+
+---
+
+## Domain 2: Design Visual Bold e Colorido para Tech/IA no Instagram
+
+### Key Findings
+
+1. **Hyper-brights e gradientes digitais dominam o feed tech em 2025.** Paletas neon, contrastes extremos e gradientes inspirados em UI de IA são a tendência predominante para marcas de tecnologia e educação digital.
+   - Confidence: HIGH | Sources: AZ Media Maven, Versa Creative, 2025
+
+2. **Tipografia chunky e bold como protagonista visual.** Fontes sem serifa pesadas (700+ weight) em tamanho grande com muito espaço ao redor criam impacto visual imediato. Inter, Montserrat e Poppins lideram as escolhas para tech.
+   - Confidence: HIGH | Sources: Accio, Font Fabric, Aesthetic Speaking, 2025
+
+3. **Uma ideia visual por slide, sem poluição.** O design bold funciona com poucas cores (3-5 max) e muito contraste. Fundos sólidos ou gradientes simples superam backgrounds complexos para slides educacionais.
+   - Confidence: HIGH | Sources: Avramify, Hootsuite, 2025
+
+4. **Ratio WCAG AA (4.5:1) é mínimo obrigatório.** Texto branco em fundo escuro ou texto escuro em fundo claro. Nunca texto sobre imagem sem overlay de proteção.
+   - Confidence: HIGH | Source: Image Designer agent spec
+
+5. **Carrosséis verticais (1080×1440px ou 1080×1350px) ocupam mais tela e geram mais engajamento.** Instagram atualizou para privilegiar 4:5 ratio em feeds. Proporção 3:4 (1080×1440) também funciona bem.
+   - Confidence: HIGH | Sources: Hootsuite, Social Media Today, 2025
+
+### Design System Recommendations for Sem Codar
+- **Primary color:** Dark navy ou preto profundo (fundo que faz cores vibrantes saltarem)
+- **Accent:** Cor vibrante única por série (coral, electric blue, neon green) para consistência visual
+- **Text:** Branco puro (#FFFFFF) em fundos escuros — contraste máximo
+- **Highlight:** Amarelo ouro ou verde neon para números e dados importantes
+- **Font:** Inter ou Poppins — profissional, legível, tech-friendly
+
+---
+
+## Domain 3: Psicologia de Engajamento no Instagram (Carrosséis)
+
+### Key Findings
+
+1. **"Saves" e "shares" têm peso 5x maior que likes no algoritmo de 2025.** Conteúdo que gera salvamentos (checklists, dados, tutoriais) é priorizadopelo feed algorítmico.
+   - Confidence: HIGH | Sources: Growth Curve, Buffer, Social Media Today, 2025
+
+2. **Instagram re-exibe carrosséis para usuários que scrollaram sem engajar.** Se o usuário passou pelo slide 1 sem interagir, o Instagram pode reapresentar o carrossel começando por um slide diferente. Isso significa que cada slide precisa ser forte o suficiente para ser uma "porta de entrada".
+   - Confidence: HIGH | Sources: Buffer, Growthcurve, 2025
+
+3. **Tempo médio de retenção em carrosséis (6-8 slides) é 3x maior que posts simples.** O swipe cria comprometimento progressivo — cada slide gera um micro-investimento do leitor que o engaja mais.
+   - Confidence: HIGH | Source: Sked Social, Hootsuite, 2025
+
+4. **Carrosséis com música têm alcance ampliado (elegíveis para aba de Reels).** Adicionar faixa de áudio aumenta distribuição sem necessidade de produzir vídeo.
+   - Confidence: MEDIUM | Source: YouTube creators, Instagram updates, 2025
+
+5. **A pergunta na legenda aumenta comentários em 40%.** Uma pergunta direta ao final da caption ("Você já passou por isso?", "Qual foi sua reação?") é o gatilho mais eficaz para comentários.
+   - Confidence: MEDIUM | Sources: Nextleveldata, Fullstop Social, 2025
+
+### Psychological Triggers that Drive Carousel Engagement
+- **Curiosity gap**: Mostrar que existe uma resposta sem revelar ela no slide 1 (open loop)
+- **Social proof + FOMO**: Dados que revelam que outros já estão fazendo algo
+- **Cognitive dissonance**: Afirmação contrária ao que o leitor acredita
+- **Completeness drive**: "Swipe para ver os 5 passos" ativa o desejo de completar a sequência
+- **Identity-based content**: "Se você usa IA, precisa saber isso" — faz parte da identidade do leitor
+
+---
+
+## Domain 4: Instagram Graph API — Publicação de Carrosséis
+
+### Key Findings
+
+1. **Carrosséis suportam 2 a 10 imagens ou vídeos.** Cada post de carrossel conta como 1 item no limite de 100 posts/24h via API.
+   - Confidence: HIGH | Source: Meta for Developers, 2025
+
+2. **Formato obrigatório: JPG ou PNG.** JPEG é o mais compatível. PNG é aceito mas recomenda-se converter para JPEG para melhor compatibilidade.
+   - Confidence: HIGH | Source: Meta for Developers, Sprout Social, 2025
+
+3. **Todas as imagens do carrossel devem ter o mesmo aspect ratio.** A API default para 1:1 se não especificado. Para feed vertical (4:5): 1080×1350px. Para o formato 3:4 usado no squad: 1080×1440px precisa ser validado.
+   - Confidence: HIGH | Source: Meta for Developers, AdManage, 2025
+
+4. **As imagens devem estar em servidor público acessível.** O Instagram faz curl das URLs durante criação dos media containers. Ferramentas como imgbb são usadas para hosting temporário antes do publish.
+   - Confidence: HIGH | Source: Meta for Developers, Stack Overflow, 2025
+
+5. **Processo em 3 etapas: containers individuais → container de carrossel → publicar.** O instagram-publisher skill já abstrai todo esse processo.
+   - Confidence: HIGH | Source: Meta for Developers, instagram-publisher skill, 2025
+
+6. **IMPORTANTE — Deprecação em 2025:** A partir de maio de 2025, o Graph API exige uso dos novos objetos (IG User, IG Media) em lugar dos legados (Instagram User, Instagram Media). O instagram-publisher skill precisa estar atualizado para usar os novos endpoints.
+   - Confidence: HIGH | Source: Meta for Developers, 2025
+
+### API Specs Summary
+| Campo | Valor |
+|-------|-------|
+| Formato | JPG / PNG |
+| Imagens por carrossel | 2-10 |
+| Aspect ratio | Consistente entre slides |
+| Tamanho máximo por arquivo | 30MB |
+| Caption máximo | 2.200 caracteres |
+| Hashtags recomendados | 5-8 |
+| Limite de posts | 100 / 24h |
+
+---
+
+## Gaps Identified
+- Não encontramos dados específicos sobre CTR médio de carrosséis para nicho de No-Code/IA no Brasil
+- O formato exato 1080×1440 (3:4) precisa ser validado contra a API — o formato oficial suportado é 4:5 (1080×1350). Pode ser necessário ajustar para 1080×1350px
+- Não há dados sobre melhor horário de publicação específico para audiência tech no Brasil (recomendação geral: terça a sexta, 7-9h ou 18-20h horário de Brasília)

package/kit/.agents/squads/instagram-carrossel/pipeline/data/tone-of-voice.md

@@ -0,0 +1,32 @@
+# Tone of Voice — Carrossel (INVOS)
+
+**Fonte canônica de voz e marca:** `marca/marca.md` + `memoria/empresa.md` + `memoria/perfil.md`.  
+Este arquivo é o **método** de copy de carrossel; se conflitar com `marca/`, **vence a marca do usuário**.
+
+---
+
+## Antes de escrever qualquer slide
+
+1. Ler `marca/marca.md` (tom, pode/não dizer, cores).  
+2. Ler oferta e ICP em `memoria/empresa.md`.  
+3. Se a marca ainda for template: avisar 1 linha e usar tom direto PT-BR sem guru.
+
+---
+
+## Regras de carrossel (produção)
+
+1. **Dado ou prova quando existir** — número com fonte, ou caso real do negócio (`clientes/`, histórico). Sem inventar estatística.  
+2. **Contexto que surpreende** — o “por quê” depois do fato.  
+3. **Lógica de início a fim** — cada slide é consequência do anterior (história, não cards soltos).  
+4. **Fecho que faz pensar** — pergunta ou tensão construtiva no CTA (sem agressão).  
+5. **Zero copy vazia** — se cortar a frase e não perde nada, corte.  
+6. **Linguagem humana** — conversa inteligente; sem “revolucione”, “incrível”, jargão corporativo.  
+7. **ICP no centro** — o leitor se vê no problema; não é post sobre a ferramenta do prestador só.
+
+---
+
+## Fallback se marca/ vazia
+
+- Tom: direto, informal com correção, PT-BR.  
+- Sem em-dash de IA (`—`); prefira ponto ou vírgula no texto final de slide/caption.  
+- Nível: claro pra leigo motivado.

package/kit/.agents/squads/instagram-carrossel/pipeline/pipeline.yaml

@@ -0,0 +1,136 @@
+name: "Pipeline — Fábrica de Carrosséis"
+version: "2.0.0"
+created: "2026-03-03"
+squad: "instagram-carrossel"
+
+description: >
+  Pipeline INVOS: tema → research → ângulos → copy → visual → slides → review →
+  pack de publicação. Dono só aprova checkpoints (ou modo turbo). Runtime:
+  seguir squad RUN.md em qualquer harness.
+
+mode: "alta-performance"
+
+steps:
+  - id: step-01
+    name: "Entrada de Conteúdo"
+    type: checkpoint
+    file: steps/step-01-input-content.md
+
+  - id: step-02
+    name: "Pesquisa de Notícias"
+    type: agent
+    agent: researcher
+    tasks:
+      - find-and-rank-news
+    file: steps/step-02-find-news.md
+    depends_on: step-01
+
+  - id: step-03
+    name: "Seleção de Notícia"
+    type: checkpoint
+    file: steps/step-03-select-story.md
+    depends_on: step-02
+
+  - id: step-04
+    name: "Geração de Ângulos"
+    type: agent
+    agent: copywriter
+    tasks:
+      - generate-angles
+    file: steps/step-04-generate-angles.md
+    depends_on: step-03
+
+  - id: step-05
+    name: "Seleção de Ângulo"
+    type: checkpoint
+    file: steps/step-05-select-angle.md
+    depends_on: step-04
+
+  - id: step-06
+    name: "Criação do Copy"
+    type: agent
+    agent: copywriter
+    tasks:
+      - create-slides
+      - optimize-copy
+    file: steps/step-06-create-copy.md
+    depends_on: step-05
+
+  - id: step-07
+    name: "Aprovação do Texto"
+    type: checkpoint
+    file: steps/step-07-approve-copy.md
+    depends_on: step-06
+
+  - id: step-08
+    name: "Proposta Visual"
+    type: agent
+    agent: image-designer
+    tasks:
+      - propose-visual-identities
+    file: steps/step-08-propose-visuals.md
+    depends_on: step-07
+
+  - id: step-09
+    name: "Seleção de Identidade Visual"
+    type: checkpoint
+    file: steps/step-09-select-visual.md
+    depends_on: step-08
+
+  - id: step-10
+    name: "Criação dos Slides"
+    type: agent
+    agent: image-designer
+    tasks:
+      - create-slides
+      - render-export
+    file: steps/step-10-create-slides.md
+    depends_on: step-09
+
+  - id: step-11
+    name: "Aprovação das Imagens"
+    type: checkpoint
+    file: steps/step-11-approve-images.md
+    depends_on: step-10
+
+  - id: step-12
+    name: "Revisão de Qualidade"
+    type: agent
+    agent: reviewer
+    optional: true
+    tasks:
+      - score-content
+      - generate-feedback
+    file: steps/step-12-review.md
+    depends_on: step-11
+
+  - id: step-13
+    name: "Publicação no Instagram"
+    type: agent
+    agent: publisher
+    tasks:
+      - validate-publish
+    file: steps/step-13-publish.md
+    depends_on: step-12
+
+checkpoints:
+  - step-01  # Input: tema + prazo
+  - step-03  # Seleção de notícia
+  - step-05  # Seleção de ângulo
+  - step-07  # Aprovação do texto
+  - step-09  # Seleção de identidade visual
+  - step-11  # Aprovação das imagens
+
+output:
+  artifacts:
+    - output/ranked-stories.yaml
+    - output/selected-story.yaml
+    - output/angles-brief.yaml
+    - output/selected-angle.yaml
+    - output/carousel-draft.md
+    - output/selected-visual.yaml
+    - output/design-system.md
+    - output/slides/
+    - output/slides/rendered/
+    - output/review-final.md
+    - output/publish-report.md

package/kit/.agents/squads/instagram-carrossel/pipeline/steps/step-01-input-content.md

@@ -0,0 +1,38 @@
+---
+step: "01"
+name: "Entrada de Conteúdo"
+type: checkpoint
+description: O usuário define o tema e o período de pesquisa que será transformado em carrossel.
+---
+
+# 🛑 Checkpoint: Entrada de Conteúdo
+
+## Para o Pipeline Runner
+
+Este é o checkpoint de entrada do pipeline. Solicitar ao usuário o tema e o período de pesquisa.
+
+## Solicitação ao Usuário
+
+🎯 Vamos criar um carrossel de Instagram.
+
+Qual é o **tema** que você quer explorar hoje?
+Pode ser um tema geral (ex: "IA para empreendedores"), uma área específica (ex: "no-code", "automações") ou qualquer assunto relevante para sua audiência.
+
+Qual é o **período de pesquisa**?
+Exemplos: "últimas 24 horas", "última semana", "março de 2026".
+
+## Ação do Pipeline Runner
+
+1. Receber o tema e o período fornecidos pelo usuário
+2. Salvar em `output/research-focus.md` no formato abaixo
+3. Avançar para o Step 02 (Pesquisador — Busca de Notícias)
+
+## Formato de Salvamento
+
+```markdown
+# Research Focus
+
+**Topic:** [tema fornecido pelo usuário]
+**Time Range:** [período fornecido pelo usuário]
+**Date:** YYYY-MM-DD
+```

package/kit/.agents/squads/instagram-carrossel/pipeline/steps/step-02-find-news.md

@@ -0,0 +1,42 @@
+---
+step: "02"
+name: "Pesquisa de Notícias"
+type: agent
+agent: researcher
+tasks:
+  - find-and-rank-news
+depends_on: step-01
+---
+
+# Step 02: Pesquisador — Busca e Ranqueamento de Notícias
+
+## Para o Pipeline Runner
+
+Executar a task find-and-rank-news do Pesquisador.
+
+O Pesquisador deve fazer **pelo menos 3 buscas** com ângulos diferentes sobre o tema e retornar as 5-7 notícias mais relevantes e interessantes, ranqueadas por potencial de engajamento.
+
+## Inputs para este Step
+
+- `output/research-focus.md` → tema e período definidos pelo usuário no Step 01
+- `memoria/empresa.md + marca/marca.md` → contexto da empresa (público-alvo, nicho, tom)
+
+## Expected Outputs
+
+- `output/ranked-stories.yaml` → lista de 5-7 notícias ranqueadas com título, resumo, fonte, URL e score de potencial viral
+
+## Execution Mode
+
+- **Modo:** Subagente
+- **Skills permitidas:** web_search, web_fetch
+
+## Quality Gate
+
+Antes de avançar para o Step 03, verificar:
+- [ ] ranked-stories.yaml existe
+- [ ] Contém entre 5 e 7 notícias
+- [ ] Cada notícia tem: title, summary, source, url, date, viral_potential_score, why_interesting
+- [ ] As notícias são do período solicitado pelo usuário
+- [ ] Notícias estão ordenadas por viral_potential_score (decrescente)
+
+Se qualquer verificação falhar, solicitar que o Pesquisador refaça a busca.

package/kit/.agents/squads/instagram-carrossel/pipeline/steps/step-03-select-story.md

@@ -0,0 +1,59 @@
+---
+step: "03"
+name: "Seleção de Notícia"
+type: checkpoint
+depends_on: step-02
+---
+
+# 🛑 Checkpoint: Seleção de Notícia
+
+## Para o Pipeline Runner
+
+Apresentar ao usuário as notícias encontradas pelo Pesquisador e aguardar seleção antes de avançar para o Copywriter.
+
+## Formato de Apresentação ao Usuário
+
+Ler `output/ranked-stories.yaml` e apresentar no formato:
+
+```
+🔍 Pesquisador encontrou [N] notícias sobre [tema].
+
+Aqui estão as mais interessantes, ranqueadas por potencial de engajamento:
+
+---
+1️⃣ [Título da notícia 1]
+📰 [Fonte] — [Data]
+🔗 [URL]
+📝 [Resumo em 1-2 linhas]
+⚡ Por que é viral: [why_interesting]
+
+---
+2️⃣ [Título da notícia 2]
+...
+
+---
+Qual notícia quer transformar em carrossel? (responda com o número)
+Ou: "busca mais" se nenhuma te interessou
+```
+
+## Ação do Pipeline Runner após Seleção
+
+1. Registrar a notícia escolhida
+2. Salvar em `output/selected-story.yaml`:
+
+```yaml
+story_id: 1
+title: "Título exato da notícia"
+source: "Nome da fonte"
+url: "URL da notícia"
+date: "Data da notícia"
+summary: "Resumo de 2-3 linhas"
+selected_at: "YYYY-MM-DD HH:MM"
+```
+
+3. Avançar para Step 04 (Copywriter — Geração de Ângulos)
+
+## Opções Especiais
+
+- **"busca mais"** → Solicitar que o Pesquisador faça novas buscas com perspectivas diferentes. Voltar ao Step 02.
+- **"[número] + ajuste"** → Registrar o ajuste junto com a seleção em `user_notes` no selected-story.yaml

package/kit/.agents/squads/instagram-carrossel/pipeline/steps/step-04-generate-angles.md

@@ -0,0 +1,45 @@
+---
+step: "04"
+name: "Geração de Ângulos"
+type: agent
+agent: copywriter
+tasks:
+  - generate-angles
+depends_on: step-03
+---
+
+# Step 04: Carlos Carrossel — Geração de Ângulos Virais
+
+## Para o Pipeline Runner
+
+Executar a task generate-angles do Carlos Carrossel.
+
+O Copywriter lê a notícia selecionada, extrai os insights mais fortes e gera **exatamente 5 ângulos virais distintos** para o carrossel.
+
+## Inputs para este Step
+
+- `output/selected-story.yaml` → notícia escolhida pelo usuário (URL e contexto)
+- `pipeline/data/domain-framework.md` → framework de ângulos e construção de carrossel
+- `memoria/empresa.md + marca/marca.md` → contexto da empresa e público-alvo
+- `pipeline/data/tone-of-voice.md` → tom de voz aprovado
+
+## Expected Outputs
+
+- `output/insights-brief.yaml` → fatos e tensão central extraídos da notícia
+- `output/angles-brief.yaml` → 5 ângulos virais distintos com hook rascunho e estrutura
+
+## Execution Mode
+
+- **Modo:** Subagente
+- **Skills permitidas:** web_search, web_fetch (para acessar e ler a notícia selecionada)
+
+## Quality Gate
+
+Antes de avançar para o Step 05, verificar:
+- [ ] insights-brief.yaml existe com `core_tension` preenchido
+- [ ] angles-brief.yaml existe com exatamente 5 ângulos
+- [ ] Cada ângulo tem: title, type, hook_draft, slide_structure, strength, weakness
+- [ ] Os 5 ângulos são claramente distintos entre si (não variações da mesma ideia)
+- [ ] Pelo menos um ângulo usa um dado numérico verificável no hook_draft
+
+Se qualquer verificação falhar, solicitar que Carlos Carrossel refaça a task específica.

package/kit/.agents/squads/instagram-carrossel/pipeline/steps/step-05-select-angle.md

@@ -0,0 +1,64 @@
+---
+step: "05"
+name: "Seleção de Ângulo"
+type: checkpoint
+depends_on: step-04
+---
+
+# 🛑 Checkpoint: Seleção de Ângulo
+
+## Para o Pipeline Runner
+
+Apresentar ao usuário os 5 ângulos gerados pelo Carlos Carrossel e aguardar seleção.
+
+## Formato de Apresentação ao Usuário
+
+Ler `output/angles-brief.yaml` e apresentar no formato:
+
+```
+✍️ Carlos Carrossel gerou 5 ângulos para o carrossel.
+⭐ Ângulo recomendado: #[X] — [justificativa]
+
+---
+1️⃣ [Título] — [tipo: Revelador/Comparativo/etc.]
+Hook: [hook_draft completo]
+Estrutura: [slide_structure resumido]
+✅ Força: [strength] | ⚠️ Risco: [weakness]
+
+---
+2️⃣ [Título] — [tipo]
+...
+
+---
+Qual ângulo quer desenvolver? (responda com o número)
+Ou: descreva ajustes que quer fazer em algum ângulo
+```
+
+## Ação do Pipeline Runner após Seleção
+
+1. Registrar o ângulo selecionado e qualquer ajuste do usuário
+2. Salvar em `output/selected-angle.yaml`:
+
+```yaml
+angle_id: 1
+angle_title: "Nome do ângulo"
+angle_type: "Revelador"
+hook_draft: "[hook exato do ângulo selecionado]"
+slide_structure:
+  - slide_2: "Tema do slide 2"
+  - slide_3: "Tema do slide 3"
+  - slide_4: "Tema do slide 4"
+  - slide_5: "Tema do slide 5"
+  - slide_6: "Reflexão"
+  - slide_7: "CTA"
+user_adjustments: "[ajustes solicitados, ou vazio]"
+selected_at: "YYYY-MM-DD HH:MM"
+```
+
+3. Avançar para Step 06 (Carlos Carrossel — Criação do Copy)
+
+## Opções Especiais
+
+- **"0" ou "nenhum"** → Solicitar que Carlos Carrossel gere novos ângulos com perspectivas diferentes. Voltar ao Step 04.
+- **"ajustar [N]"** → Registrar o ajuste em `user_adjustments` antes de avançar
+- **"combinar [N] e [M]"** → Pedir ao Carlos para criar um ângulo híbrido antes de avançar

package/kit/.agents/squads/instagram-carrossel/pipeline/steps/step-06-create-copy.md

@@ -0,0 +1,51 @@
+---
+step: "06"
+name: "Criação do Copy"
+type: agent
+agent: copywriter
+tasks:
+  - create-slides
+  - optimize-copy
+depends_on: step-05
+---
+
+# Step 06: Carlos Carrossel — Criação e Otimização do Copy
+
+## Para o Pipeline Runner
+
+Executar as duas tasks do Carlos Carrossel em sequência:
+
+1. **create-slides**: Cria o copy completo de todos os slides (7-9 slides) + legenda completa com hashtags
+2. **optimize-copy**: Revisa e otimiza o rascunho, aplica a checklist de qualidade e documenta as mudanças
+
+## Inputs para este Step
+
+- `output/selected-angle.yaml` → ângulo selecionado e ajustes do usuário
+- `output/insights-brief.yaml` → todos os dados verificados e fontes
+- `pipeline/data/tone-of-voice.md` → guia de tom aprovado com amostra de referência
+- `pipeline/data/output-examples.md` → exemplos de carrosséis de qualidade de referência
+- `pipeline/data/anti-patterns.md` → erros a evitar
+
+## Expected Outputs
+
+- `output/carousel-draft.md` → copy completo de todos os slides + legenda + optimization log
+
+## Execution Mode
+
+- **Modo:** Inline
+- **Skills permitidas:** web_search (para verificar dados adicionais se necessário)
+
+## Quality Gate
+
+Antes de avançar para o Step 07, verificar:
+- [ ] carousel-draft.md existe e tem todos os slides numerados
+- [ ] Slide 1 tem dado específico com fonte identificável
+- [ ] Existe slide de Reflexão identificado
+- [ ] Caption está presente com hashtags
+- [ ] Optimization log documenta as revisões feitas
+
+Se qualquer verificação falhar, solicitar que Carlos Carrossel revise o item específico antes de prosseguir.
+
+## Nota Especial
+
+O Carlos Carrossel tem instrução de auto-verificar contra a quality checklist antes de entregar. Se ele concluir que há itens a corrigir internamente, deve iterar autonomamente antes de declarar a task concluída. O Pipeline Runner deve aguardar a entrega final, não o primeiro rascunho.

package/kit/.agents/squads/instagram-carrossel/pipeline/steps/step-07-approve-copy.md

@@ -0,0 +1,52 @@
+---
+step: "07"
+name: "Aprovação do Texto"
+type: checkpoint
+depends_on: step-06
+---
+
+# 🛑 Checkpoint: Aprovação do Texto
+
+## Para o Pipeline Runner
+
+Apresentar ao usuário o copy completo (todos os slides + legenda) e aguardar aprovação antes de passar para o Designer.
+
+## Formato de Apresentação ao Usuário
+
+Ler `output/carousel-draft.md` e apresentar no formato:
+
+```
+✍️ Carlos Carrossel concluiu o texto do carrossel!
+
+📝 **SLIDE 1 (Hook):**
+[Mostrar o copy completo do slide 1]
+
+📝 **SLIDES 2-N (Resumo):**
+[Listar um bullet por slide com o headline ou ponto central]
+
+📝 **LEGENDA:**
+[Mostrar os primeiros 150 chars]...
+[Hashtags]
+
+---
+O texto está bom para o Designer criar as imagens?
+
+1. ✅ Aprovar e avançar para o Designer
+2. 🔄 Pedir ajustes no texto → Carlos refaz apenas o solicitado
+3. ↩️ Voltar ao ângulo → Escolher um ângulo diferente
+```
+
+## Ação do Pipeline Runner após Decisão
+
+### Se opção 1 (Aprovar):
+- Avançar para Step 08 (Davi Design — Proposta Visual)
+
+### Se opção 2 (Ajustes de texto):
+- Coletar as instruções específicas do usuário
+- Retornar ao Step 06 com contexto das correções solicitadas
+- O Carlos Carrossel refaz APENAS as partes indicadas
+- Após correções, retornar ao Step 07
+
+### Se opção 3 (Novo ângulo):
+- Retornar ao Step 05 (seleção de ângulo)
+- Preservar o insights-brief.yaml existente