sinapse-ai 9.3.0 → 9.5.0

package/squads/squad-content/knowledge-base/ai-native-content-loop.md

@@ -0,0 +1,220 @@
+# AI-Native Content Loop — Canon Playbook
+
+> **Status:** Canon (squad-content v2.0)
+> **Owner:** content-orqx (Nexus) with cross-agent collaboration
+> **Created:** 2026-04-12 for Story fw-v2.4
+> **Relationship to existing KBs:** Builds on `content-spine-engine.md`, `ai-leverage-content-framework.md`, `content-measurement-framework.md` and `ai-content-production.md`. This KB is the **canonical end-to-end pipeline** — the other KBs are mechanisms inside phases of this loop.
+
+---
+
+## 1. Why This Exists
+
+In 2026, the content pipeline for any mature SINAPSE user is no longer `brief → writer → editor → publish → measure`. AI assistance is now a load-bearing layer at every step, and the real bottleneck has shifted to **where humans intervene and why**.
+
+This playbook canonizes the 6-phase loop that squad-content runs for every content program, regardless of client, language or platform. It makes the human-in-the-loop decision explicit so that AI-native work does not mean commodity work.
+
+## 2. The 6-Phase Loop
+
+```
+┌───────────────────────────────────────────────────────────────────────┐
+│                                                                       │
+│   1. SIGNAL → 2. AI DRAFT → 3. HUMAN EDIT → 4. PLATFORM ADAPT →       │
+│         ↑                                                  ↓          │
+│         └────────── 6. RETROFEED ←── 5. MEASURE ←──────────┘          │
+│                                                                       │
+└───────────────────────────────────────────────────────────────────────┘
+```
+
+The loop is **closed** on purpose. Phase 6 (Retrofeed) is what turns a one-shot pipeline into a compounding asset.
+
+---
+
+## 3. Phase-by-Phase Specification
+
+### Phase 1 — SIGNAL
+
+| Field | Value |
+|-------|-------|
+| **Lead agent** | `signal-intelligence` (Radar) |
+| **Inputs** | Editorial pillars, client brief, calendar gaps, opportunity windows |
+| **Outputs** | Classified signal (type, temperature, pillar, opportunity window), signal brief (1 paragraph + evidence) |
+| **Tool stack** | Google Trends, X/Twitter API v2, TikTok Research API, Reddit API, Apify actors, Substack RSS, YouTube Data API, Exploding Topics, SparkToro |
+| **Quality gate** | Signal-quality score ≥ 3/5 on (relevance, novelty, evidence, actionability, pillar fit) |
+| **Failure modes** | Low-evidence hype, pillar drift, redundant signal (already covered), stale signal (window closed), competitor-exclusive signal (not adaptable) |
+| **Hands off to** | Phase 2 only if quality gate passes; otherwise returns to source scan or archives signal with notes |
+
+### Phase 2 — AI DRAFT
+
+| Field | Value |
+|-------|-------|
+| **Lead agent** | `content-engineer` (Arc) with structured prompt template |
+| **Inputs** | Signal brief, Espinha Dorsal template (tese/mecanismo/prova/direcao), client voice profile, format target |
+| **Outputs** | First-draft artifact (carousel/post/thread/script/article) grounded on the Espinha Dorsal; draft-confidence score (self-reported by the AI), list of claims needing verification |
+| **Tool stack** | Claude / GPT / in-house prompts (see `ai-content-production.md`), retrieval over client KBs for voice lock, `content-spine-engine.md` as structural contract |
+| **Quality gate** | Draft has: (a) one thesis explicit, (b) mechanism explained, (c) at least 1 proof item, (d) direction/CTA, (e) no invented facts flagged, (f) voice within ±1 on Halvorson Voice & Tone scale |
+| **Failure modes** | Drift from Espinha Dorsal, invented facts ("hallucination"), commodity phrasing, voice drift, format-agnostic output that ignores target platform |
+| **Hands off to** | Phase 3 with structured annotations from the AI (what it is confident about, what it is guessing) |
+
+### Phase 3 — HUMAN EDIT
+
+| Field | Value |
+|-------|-------|
+| **Lead agent** | `editorial-strategist` (North) for high-stakes content; `content-governor` (Index) for compliance/voice enforcement; human editor in the client-side loop |
+| **Inputs** | AI draft + AI annotations, client voice profile, brand guidelines from squad-brand, editorial preferences log |
+| **Outputs** | Edited master version (format-agnostic), edit-reason log (what was changed and why), voice-lock confirmation |
+| **Tool stack** | Markdown diff, `content-quality-checklist.md`, `editorial-governance.md`, preference tracking (`preferences/`) |
+| **Quality gate** | Zero invented facts remaining, voice within ±0.5, E-E-A-T signals preserved or added, claims either removed or cited, hook/pattern-interrupt verified per `viral-potential-scoring.md` |
+| **Failure modes** | Over-editing (losing AI's useful phrasing), under-editing (shipping invented facts), voice-scrubbing (removing brand specificity), missing human-in-the-loop on high-stakes pieces |
+| **Hands off to** | Phase 4 after the master version is signed off |
+
+### Phase 4 — PLATFORM ADAPT
+
+| Field | Value |
+|-------|-------|
+| **Lead agent** | `platform-specialist` (Morph) |
+| **Inputs** | Edited master version, target platform set, `template-contract-system.md` contracts |
+| **Outputs** | Platform-native variants (carousel for IG, thread for X, reel script, LinkedIn post, newsletter section, etc.), each bound to a Template Contract |
+| **Tool stack** | `platform-algorithm-intelligence.md`, `content-atomization-repurposing.md`, `template-contract-system.md`, platform previewers, character counters |
+| **Quality gate** | Each variant respects its Template Contract 100% (character limits, field counts, formatting); algorithmic hooks verified per `verify-algorithmic-hooks` task; no variant loses the core thesis during atomization |
+| **Failure modes** | Contract violations, hook dilution, algorithm mismatch (wrong format for platform), lost thesis in atomization, copy-paste across platforms without nativization |
+| **Hands off to** | Phase 5 via client publishing pipeline (outside squad authority) |
+
+### Phase 5 — MEASURE
+
+| Field | Value |
+|-------|-------|
+| **Lead agent** | `content-analyst` (Lens) |
+| **Inputs** | Published variants across platforms, analytics windows (24h, 7d, 30d), client KPIs |
+| **Outputs** | Performance report per variant + cross-platform rollup; top-performer identification; underperformer diagnosis; retrofeed dataset |
+| **Tool stack** | Parse.ly, Semrush, BuzzSumo, native analytics APIs, `content-scoring-models.md`, `content-measurement-framework.md`, `viral-potential-scoring.md` |
+| **Quality gate** | Metrics collected for every variant (no missing variants), attribution model applied, benchmarks set, insights ranked by actionability |
+| **Failure modes** | Vanity metrics only, no attribution, missing variants, retroactive benchmark inflation, platform-silo analysis with no cross-platform rollup |
+| **Hands off to** | Phase 6 with structured retrofeed payload |
+
+### Phase 6 — RETROFEED
+
+| Field | Value |
+|-------|-------|
+| **Lead agent** | `content-orqx` (Nexus) as coordinator; updates flow to Radar (signal tuning), North (pillar/calendar adjustment), Arc (prompt library update), Morph (template contract refinement), Index (preference log) |
+| **Inputs** | Phase 5 performance dataset, hypotheses that produced each piece, prompt versions used |
+| **Outputs** | Updated signal-quality scoring weights, refined editorial pillars, refreshed AI prompt library, updated template contracts, updated preferences/ log for the client |
+| **Tool stack** | `generate-retrofeed-insights` task, preference log template, `ai-content-production.md` prompt library versioning |
+| **Quality gate** | Every update is traceable to a phase-5 insight (no invented tuning); previous prompt/pillar/contract versions archived, not overwritten |
+| **Failure modes** | Retrofeed ignored ("one-shot pipeline"), overfitting to single-post noise, loss of previous version history, no communication of changes to the other phases |
+| **Hands off to** | Phase 1 of the next cycle (loop closes) |
+
+---
+
+## 4. Human-in-the-Loop Decision Tree
+
+The biggest decision of the AI-native loop is **when AI draft ships with light touch vs. when a human must intervene heavily**. This decision happens at the Phase 2 → Phase 3 transition.
+
+```
+                     ┌──────────────────┐
+                     │  AI draft ready  │
+                     └────────┬─────────┘
+                              │
+                    Has any of these?
+       ┌──────────────────────┴─────────────────────┐
+       │ YES                                        │ NO
+       ▼                                            ▼
+  Human REQUIRED                             Evaluate stakes
+  (Heavy intervention)                        and signals
+       │                                            │
+       │                                            ▼
+       │                               ┌────────────────────┐
+       │                               │ High-stakes piece? │
+       │                               │ (Manifesto,        │
+       │                               │ flagship, PR,      │
+       │                               │ crisis response)   │
+       │                               └────┬───────────┬───┘
+       │                                    │ YES       │ NO
+       │                                    ▼           ▼
+       │                              Human heavy   Awareness
+       │                              review        level high?
+       │                                            (L4/L5
+       │                                             Schwartz)
+       │                                                 │
+       │                                        ┌────────┴───────┐
+       │                                        │ YES            │ NO
+       │                                        ▼                ▼
+       │                                   Human light      AI draft
+       │                                   review only      can ship
+       │                                   (craft polish)   with voice
+       │                                                    check only
+       └── "Human REQUIRED" triggers:
+           - Invented fact flagged by AI itself
+           - Legal/compliance topic (health, finance, legal)
+           - Crisis response or reputation-sensitive
+           - Brand new concept not covered in prior content
+           - Voice drift score >1.0 on client voice-tone scale
+           - Opinion piece or manifesto (voice IS the product)
+```
+
+### Gate Signals Table
+
+| Signal | Weight | Where to check |
+|--------|--------|---------------|
+| Copy/content type (opinion vs informational) | HIGH | Editorial calendar tag |
+| Market awareness level (Schwartz L1-L5) | HIGH | Editorial brief + audience research |
+| Stakes (flagship/manifesto vs daily post) | HIGH | Editorial pillars priority |
+| Brand voice criticality | MEDIUM | Client preferences log |
+| Legal/compliance category | CRITICAL | `validate-content-compliance` task |
+| AI self-reported confidence | MEDIUM | Phase 2 annotations |
+| Novelty of subject matter | MEDIUM | Prior content overlap check |
+
+---
+
+## 5. Tool Stack per Phase (Canonical Stack)
+
+| Phase | Required KBs | Required Tasks | Required Templates |
+|-------|-------------|----------------|-------------------|
+| 1. Signal | `signal-detection-methods.md`, `signal-intelligence-v2.md`, `competitor-analysis-methods.md` | `scan-daily-signals`, `classify-signal-temperature`, `map-signal-to-pillar` | `weekly-signal-briefing-template.md` |
+| 2. AI Draft | `content-spine-engine.md`, `ai-content-production.md`, `narrative-structures-library.md`, `hook-formulas-library.md` | `design-content-spine`, `write-*` family | `content-spine-template.md`, `content-brief-template.md` |
+| 3. Human Edit | `editorial-governance.md`, `content-quality-criteria.md`, `writing-rules-engine.md`, `brazilian-content-context.md` | `validate-content-quality`, `check-brand-consistency` | `content-quality-checklist.md` |
+| 4. Platform Adapt | `template-contract-system.md`, `platform-algorithm-intelligence.md`, `content-atomization-repurposing.md`, `viral-potential-scoring.md` | `adapt-for-*` family, `verify-algorithmic-hooks`, `batch-platform-adaptation` | `template-contract-registry-template.md` |
+| 5. Measure | `content-measurement-framework.md`, `content-scoring-models.md`, `eeat-quality-standards.md` | `analyze-content-performance`, `score-content-quality`, `generate-content-report` | `content-performance-report-template.md` |
+| 6. Retrofeed | `content-strategy-master-reference.md`, `content-governance-principles.md` | `generate-retrofeed-insights`, `update-content-preferences` | `preference-log-template.md` |
+
+---
+
+## 6. Anti-Patterns (Loop Violations)
+
+- **Shipping Phase 2 as final** — skipping human edit for speed destroys the voice differential.
+- **Skipping Phase 6** — without retrofeed the loop becomes a forever-beginner pipeline that never learns from performance.
+- **Phase 4 before Phase 3** — platform adapting an unedited draft wastes work when the master version changes.
+- **Phase 1 as gut feeling** — signals without quality gates produce noisy calendars and pillar drift.
+- **Phase 5 with no attribution** — performance data that can't be traced back to hypotheses cannot retrofeed.
+- **Bypassing the Espinha Dorsal at Phase 2** — AI drafts without thesis/mechanism/proof/direction collapse into commodity content.
+- **Phase 3 voice-scrubbing** — editors removing brand specificity to make content "safer" kills the differentiation.
+- **Cross-platform copy-paste at Phase 4** — ignoring Template Contracts is a contract violation per `template-contract-system.md`.
+
+---
+
+## 7. Success Criteria
+
+The loop is operating at v2 standard when:
+
+1. Every phase has its lead agent identified in the sprint plan
+2. Every Phase 2 output carries AI annotations (confidence + claims to verify)
+3. Every Phase 4 variant passes its Template Contract before publishing
+4. Every cycle closes with a Phase 6 retrofeed payload that updates at least one upstream parameter
+5. No piece ships without passing the Phase 3 human-in-the-loop gate
+6. Cross-phase metrics are cross-referenced (signal type → performance type)
+
+---
+
+## 8. Relationship to Other Canon KBs
+
+- `content-spine-engine.md` — structural contract for Phase 2 (AI draft must be spine-grounded)
+- `template-contract-system.md` — contract enforcement for Phase 4
+- `ai-content-production.md` — prompt library feeding Phase 2
+- `ai-leverage-content-framework.md` — strategic framing for AI-about-AI pieces specifically
+- `signal-intelligence-v2.md` (sibling KB from this story) — source taxonomy for Phase 1
+- `task-ownership-map.md` (sibling KB from this story) — which of the 90 tasks live in which phase
+
+---
+
+## Change Log
+
+- 2026-04-12 — v1.0 authored as part of Story fw-v2.4 (squad-content v2.0 upgrade)

package/squads/squad-content/knowledge-base/brazilian-content-context.md

@@ -0,0 +1,176 @@
+# Brazilian Content Context — Contexto Brasileiro de Conteudo
+
+> Fonte: MS-008 Content Strategy Research (2026-04-07). Dados verificados: DataReportal Digital 2025: Brazil.
+
+---
+
+## 1. O Mercado Brasileiro de Conteudo
+
+Brasil: maior mercado de conteudo digital da America Latina e um dos maiores do mundo.
+
+**Dados de mercado (2025):**
+- 183 milhoes de usuarios de internet (penetracao de 86.2%) — DataReportal
+- 144 milhoes de identidades de usuarios de redes sociais (67.8% da populacao)
+- 3o maior consumo de video online do mundo
+- Brasileiros gastam em media 3h49min por dia em redes sociais — o maior tempo do mundo
+- Brasil e o 2o maior mercado de podcasts do mundo (apos EUA), com ~44% da populacao ouvindo semanalmente
+
+**Caracteristicas unicas:**
+
+| Aspecto | Especificidade Brasileira |
+|---------|--------------------------|
+| **Idioma** | Portugues brasileiro tem nuances proprias. "Voce" vs "tu", regionalismos, girias |
+| **WhatsApp** | Canal de conteudo, e-commerce, atendimento, newsletters informais |
+| **Video** | Brasil e top 3 em consumo de YouTube. Forte cultura de creators |
+| **Infoprodutos** | Mercado massivo de cursos online (Hotmart, Kiwify, Eduzz) |
+| **Sazonalidade** | Black Friday brasileira e a maior do ano. Carnaval, Dia das Maes, Natal |
+| **Regulacao** | CONAR para publicidade, #publi obrigatorio, LGPD para dados |
+| **Pagamento** | PIX facilitou microtransacoes (tip jars, assinaturas baratas) |
+
+---
+
+## 2. Nuances do Portugues Brasileiro para Conteudo
+
+Escrever para o publico brasileiro requer atencao a nuances que ferramentas de IA frequentemente erram:
+
+**Registros de linguagem:**
+- **Formal:** Documentos corporativos, B2B enterprise, relatorios
+- **Semiformal:** Blog posts B2B, newsletters profissionais, LinkedIn
+- **Informal:** Redes sociais, newsletters de creators, comunidades
+- **Coloquial:** TikTok, Twitter, memes, comunidade jovem
+
+**Erros comuns (especialmente por IA):**
+- Usar portugues de Portugal ("utilizador" vs "usuario", "telemovel" vs "celular")
+- Tom excessivamente formal para canal informal
+- Ignorar girias relevantes que conectam com o publico
+- Traduzir expressoes do ingles literalmente ("bottom line" → ?)
+- Nao adaptar formatos: R$ vs $, DD/MM/YYYY vs MM/DD, ponto vs virgula decimal
+
+---
+
+## 3. Plataformas Brasileiras de Conteudo e Infoprodutos
+
+### Hotmart
+- Maior plataforma de infoprodutos da America Latina
+- Fundada em Belo Horizonte em 2011
+- 26 milhoes de usuarios, 370.000+ produtos digitais, vendas em 185+ paises
+- Ecossistema completo: marketplace, checkout, afiliados, area de membros
+- Taxa: ~9.9% + R$1.00 por venda
+
+### Kiwify
+- Concorrente brasileira da Hotmart, fundada em 2020
+- Crescimento rapido por interface simplificada e checkout de alta conversao
+- Taxa: 8.99% + R$2.49 por venda
+- Em 2026: marketplace publico e aberto, forte adocao por grandes produtores
+- Area de membros integrada
+
+### Eduzz
+- Plataforma brasileira de produtos digitais
+- Diferencial: checkout otimizado, analytics avancado
+- Forte em nichos de saude, fitness, financas
+
+### Publishers Brasileiros de Referencia
+- **Meio & Mensagem** — B2B, marketing e publicidade
+- **Rock Content** — content marketing
+- **Resultados Digitais (RD Station)** — marketing digital PME
+- **Hotmart Blog** — creators e infoprodutores
+- **Tecmundo, Canaltech, B9** — tecnologia e conteudo geral
+
+---
+
+## 4. Regulatorio Brasileiro
+
+### CONAR (Conselho Nacional de Autorregulamentacao Publicitaria)
+- Autorregulacao da publicidade brasileira (nao e orgao governamental)
+- Processa denuncias de propaganda enganosa/abusiva
+- Pode recomendar alteracao ou suspensao de campanha
+- Peso moral e de industria significativo
+
+### Disclosure Obrigatorio (#publi)
+- Conteudo patrocinado DEVE ser identificado claramente
+- Formas aceitas: `#publi`, `#publicidade`, "Patrocinado por [marca]"
+- Vale para posts, stories, videos, podcasts, newsletters
+- CONAR e PROCON podem atuar contra publi oculta
+- Instagram marcacao de "parceria paga" e recomendada
+
+### LGPD (Lei Geral de Protecao de Dados)
+- Lei 13.709/2018, em vigor desde 2020
+- ANPD (Autoridade Nacional de Protecao de Dados) fiscaliza
+- **Relevancia para conteudo:** formularios de captura, cookies, email marketing
+- Consentimento explicito para captura de dados
+- Direito de exclusao (unsubscribe facil, dados deletaveis)
+- Multas: ate 2% do faturamento, limitado a R$50 milhoes por infracao
+
+---
+
+## 5. Ecossistema de Creators Brasileiros
+
+Brasil tem um dos maiores e mais ativos ecossistemas de criadores de conteudo do mundo.
+
+**Creators de referencia por vertical:**
+
+| Vertical | Creators | Formato Principal |
+|----------|---------|------------------|
+| **Marketing Digital** | Erico Rocha, Conrado Adolpho, Rafael Kiso | Video + infoprodutos |
+| **Negocios/Empreendedorismo** | Flavio Augusto, Joel Jota, Thiago Nigro | YouTube + podcasts |
+| **Tecnologia** | Fabio Akita, Filipe Deschamps, Lucas Montano | YouTube |
+| **Financas** | Me Poupe (Nathalia Arcuri), Primo Rico | YouTube + infoprodutos |
+| **Produtividade** | Tiago Forte (brasileiro), Rodrigo Giaffredo | Newsletter + cursos |
+| **Dev/Tech Content** | Rocketseat, Alura, Digital Innovation One | Plataformas educacionais |
+
+**Tendencias do mercado brasileiro de creators (2025-2026):**
+- Profissionalizacao (creators contratando equipes, criando empresas)
+- Diversificacao de receita (nao so ads — produtos, comunidades, SaaS)
+- Consolidacao de plataformas educacionais brasileiras
+- Crescimento de newsletters pagas em portugues
+- TikTok como canal principal para Gen Z brasileira
+- Podcasts brasileiros alcancando audiencias globais lusofonas
+
+---
+
+## 6. Calendario Cultural Brasileiro para Conteudo
+
+| Mes | Eventos/Datas | Oportunidades de Conteudo |
+|-----|--------------|--------------------------|
+| Jan | Volta as aulas, planejamento anual | "Melhores ferramentas para 2026", planejamento |
+| Fev | Carnaval | Conteudo leve, cultural, pausa estrategica |
+| Mar | Dia da Mulher (8), inicio outono | Conteudo sobre diversidade, empoderamento |
+| Abr | Pascoa, Dia do Livro (18) | Listas de livros, conteudo educacional |
+| Mai | Dia das Maes (2o domingo) | Campanhas emocionais, presentes |
+| Jun | Dia dos Namorados (12), Festa Junina | Conteudo romantico, cultural |
+| Jul | Ferias escolares | Conteudo de entretenimento, listas |
+| Ago | Dia dos Pais (2o domingo) | Similar ao Dia das Maes |
+| Set | Dia da Independencia (7) | Conteudo patriotico, empreendedorismo |
+| Out | Dia das Criancas (12) | Conteudo familiar, presentes |
+| Nov | **Black Friday** (ultima sexta), Consciencia Negra (20) | MAIOR oportunidade comercial do ano |
+| Dez | Natal, Ano Novo | Retrospectivas, previsoes, emocional |
+
+---
+
+## 7. WhatsApp como Canal de Conteudo
+
+WhatsApp tem penetracao unica no Brasil (presente em ~99% dos smartphones brasileiros) e se tornou canal de distribuicao de conteudo relevante.
+
+**Usos de WhatsApp para conteudo:**
+- **Listas de transmissao:** Distribuicao de newsletters informais, atualizacoes, curadoria
+- **Grupos de comunidade:** Engajamento de audiencia fiel, suporte, comunidade
+- **Canais (WhatsApp Channels):** Formato broadcasting unidirecional, similar a newsletter
+- **Atendimento via conteudo:** Chatbots que entregam conteudo educacional
+- **Campanhas de lancamento:** Distribuicao de conteudo de lancamento para lista quente
+
+**Limitacoes:**
+- Nao e rastreavel como email (sem metricas detalhadas)
+- Conteudo efemero (nao indexado, sem SEO)
+- Risco de ser banido por spam se mal usado
+
+---
+
+## Referências
+
+- DataReportal — Digital 2025: Brazil (datareportal.com/reports/digital-2025-brazil)
+- Nieman Lab — Brazil is the second largest podcast market
+- Hotmart — hotmart.com (dados da plataforma)
+- Rock Content — rockcontent.com
+- Resultados Digitais — resultadosdigitais.com.br
+- CONAR — conar.org.br
+- ANPD — gov.br/anpd

package/squads/squad-content/knowledge-base/competitor-analysis-methods.md

@@ -57,9 +57,48 @@ O que NINGUEM cobre = First Mover Advantage
 
 ---
 
+---
+
+## Processo de Analise SEO Competitiva
+
+```
+1. Identificar 3-5 concorrentes diretos em SEO
+2. Usar Ahrefs Content Gap ou SEMrush Keyword Gap
+3. Filtrar: keywords que 2+ concorrentes rankeiam, voce nao
+4. Classificar por volume, dificuldade, intent, relevancia
+5. Priorizar: alto volume + baixa dificuldade + alta relevancia
+6. Mapear gaps de formato (eles tem video, voce so tem texto?)
+7. Criar conteudo que supere os concorrentes (10x content)
+```
+
+**Tipos de gap a mapear:**
+- **Topico gap** — temas que concorrentes cobrem e voce nao
+- **Formato gap** — concorrentes tem video, voce so tem texto
+- **Profundidade gap** — concorrentes cobrem superficialmente
+- **Freshness gap** — conteudo dos concorrentes esta desatualizado
+- **Experience gap** — ninguem traz dados proprios e experiencia real
+
+---
+
+## Share of Voice
+
+Share of voice e a participacao da sua marca na conversa total do setor.
+
+**Como medir:**
+- Ferramentas de social listening (Brandwatch, Sprout Social, Stilingue)
+- SEO: % de keywords do cluster que voce rankeia vs concorrentes
+- Social: mencoes organicas vs mencoes totais do setor
+
+**Interpretacao:**
+- SoV crescendo = estrategia de conteudo funcionando
+- SoV caindo = concorrentes ganhando terreno — revisar strategy
+
+---
+
 ## Referências
 
 - Andy Crestodina — Competitive content gap analysis
-- Ahrefs — Content gap tool methodology
+- Ahrefs — Content gap tool (ahrefs.com/blog/content-gap-analysis)
 - SparkToro — Audience overlap analysis
 - SEMrush — Competitive benchmarking
+- Brandwatch — Share of voice methodology

package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md

@@ -0,0 +1,206 @@
+# Content Architecture & Taxonomy
+
+> Fonte: MS-008 Content Strategy Research (2026-04-07). Baseado em Halvorson, DITA, e praticas de headless CMS.
+
+---
+
+## 1. Arquitetura de Informacao para Conteudo
+
+**Arquitetura de Informacao (AI)** e a disciplina de organizar, estruturar e rotular conteudo de forma eficaz. Termo cunhado por Richard Saul Wurman nos anos 70, desenvolvido por Peter Morville e Louis Rosenfeld (o "livro do urso polar", 1998).
+
+**Os 4 Sistemas de AI:**
+
+1. **Sistemas de Organizacao** — Como o conteudo e agrupado (por topico, cronologia, tipo, publico)
+2. **Sistemas de Rotulacao** — Como o conteudo e nomeado (titulos, categorias, tags)
+3. **Sistemas de Navegacao** — Como o usuario se move entre conteudos (menus, breadcrumbs, links internos)
+4. **Sistemas de Busca** — Como o conteudo e encontrado (search, filtros, faceted navigation)
+
+> Boa arquitetura responde: "Se eu tiver 1.000 pecas de conteudo, como alguem encontra a peca certa em menos de 3 cliques?"
+
+---
+
+## 2. Content Models
+
+Um **Content Model** define a estrutura de cada tipo de conteudo. Diferente de um template (visual), o content model e estrutural — define quais campos, atributos e relacoes cada tipo possui.
+
+**Exemplo — Modelo de Blog Post:**
+
+```yaml
+blog_post:
+  fields:
+    - title: string (max 60 chars)
+    - slug: string (auto-generated)
+    - excerpt: string (max 160 chars)
+    - body: rich_text
+    - featured_image: media
+    - author: reference(author)
+    - category: reference(category)     # 1 categoria principal
+    - tags: reference(tag)[]             # multiplas tags
+    - pillar: reference(content_pillar)
+    - seo_title: string (max 60)
+    - seo_description: string (max 160)
+    - published_at: datetime
+    - status: enum(draft, review, published, archived)
+    - reading_time: computed(body)
+    - cta_type: enum(newsletter, demo, ebook, none)
+    - funnel_stage: enum(tofu, mofu, bofu)
+    - content_tier: enum(hero, hub, help)
+```
+
+Content models sao fundamentais para headless CMS (Contentful, Sanity, Strapi) onde conteudo e separado da apresentacao. Habilitam reuso: uma peca pode ser renderizada como blog post na web, card no app mobile, snippet no email.
+
+---
+
+## 3. Taxonomias e Folksonomias
+
+**Taxonomias** sao sistemas de classificacao hierarquicos (vocabulario controlado):
+
+```
+Marketing Digital
+├── SEO
+│   ├── SEO On-Page
+│   ├── SEO Tecnico
+│   └── Link Building
+├── Content Marketing
+│   ├── Blog
+│   ├── Video
+│   └── Podcast
+└── Midia Paga
+    ├── Google Ads
+    └── Meta Ads
+```
+
+**Folksonomias** sao classificacoes criadas pelos usuarios (tags livres). Exemplo: sistema de tags do WordPress ou hashtags no Instagram. Sao mais flexiveis, mas menos consistentes.
+
+**Melhor pratica:** Combinar ambas:
+- **Taxonomia controlada** para categorias principais (hierarquia fixa, vocabulario controlado)
+- **Tags livres** para classificacao granular (permitindo emergencia de novos temas)
+
+---
+
+## 4. Metadados Essenciais para Conteudo
+
+| Metadado | Tipo | Proposito |
+|----------|------|-----------|
+| Titulo | Descritivo | Identificacao e SEO |
+| Autor | Referencia | Credibilidade, E-E-A-T |
+| Data de publicacao | Temporal | Freshness, relevancia |
+| Categoria | Taxonomia | Organizacao |
+| Tags | Folksonomia | Descoberta |
+| Estagio do funil | Classificacao | Alinhamento com jornada |
+| Persona alvo | Referencia | Personalizacao |
+| Formato | Enum | Filtragem (video, texto, audio) |
+| Status | Workflow | Gestao editorial |
+| Content score | Computado | Priorizacao |
+
+---
+
+## 5. Structured Content — DITA, Headless CMS e Content-as-Data
+
+**Conteudo estruturado** e conteudo separado de sua apresentacao, organizado em componentes reutilizaveis com metadados ricos. E o oposto de conteudo monolitico (um documento Word com formatacao embutida).
+
+**DITA (Darwin Information Typing Architecture):**
+Padrao XML da OASIS para documentacao tecnica estruturada. Usado por IBM, Microsoft, SAP. Organiza conteudo em "topics" (concept, task, reference) que podem ser compostos em "maps" — habilitando reuso massivo.
+
+### Headless CMS Principais (2025-2026)
+
+| CMS | Modelo | Destaque |
+|-----|--------|----------|
+| **Contentful** | Cloud | Lider enterprise, 300K+ clientes |
+| **Sanity** | Cloud/Self-hosted | GROQ query language, real-time collaboration |
+| **Strapi** | Open-source | Node.js, auto-generated API, extensivel |
+| **Hygraph** | Cloud | GraphQL-native, content federation |
+| **Directus** | Open-source | Database-first, qualquer SQL DB |
+| **Payload** | Open-source | TypeScript-native, Next.js integration |
+
+### Content-as-Data
+
+Trata todo conteudo como dados estruturados que podem ser consultados, transformados, combinados e entregues programaticamente. Habilita:
+- Personalizacao em escala
+- Testes A/B de conteudo
+- Integracao com IA
+- Multi-canal sem retrabalho
+
+---
+
+## 6. Catalogo de Content Types
+
+| Tipo | Formato | Extensao Media | Cadencia | Funil | Recurso Primario |
+|------|---------|---------------|----------|-------|------------------|
+| Blog Post (Help) | Texto + imagens | 1.500-2.500 palavras | 3-5/semana | TOFU | Writer + SEO |
+| Blog Post (Hub) | Texto + midia | 3.000-5.000 palavras | 1/semana | MOFU | Sr. Writer + Designer |
+| Case Study | Texto + dados | 1.500-2.000 palavras | 1-2/mes | BOFU | Writer + Cliente |
+| Whitepaper | PDF longo | 5.000-10.000 palavras | 1/trimestre | MOFU | Expert + Designer |
+| Infografico | Visual + texto | N/A | 1-2/mes | TOFU | Designer + Writer |
+| Video Tutorial | Video | 5-15 min | 2/semana | Help | Videomaker |
+| Podcast Episode | Audio | 30-60 min | 1/semana | Hub | Host + Convidado |
+| Social Post | Texto/visual | Varia | Diario | TOFU | Social Manager |
+| Email Newsletter | Texto | 500-1.000 palavras | 1/semana | Hub | Editor |
+| Webinar | Video ao vivo | 45-60 min | 1/mes | MOFU | Expert + Moderador |
+| Template/Tool | Funcional | N/A | Ad hoc | MOFU | Developer/Designer |
+| Landing Page | Web | N/A | Por campanha | BOFU | Copywriter + Designer |
+
+---
+
+## 7. Content Brief — Template Padrao
+
+O content brief e o documento mais importante do workflow editorial. Um brief mal feito resulta em conteudo que precisa ser refeito.
+
+```markdown
+## Content Brief
+
+### Metadata
+- Titulo provisorio: ___
+- Tipo: Blog Post / Video / Podcast / ...
+- Pilar: ___
+- Persona: ___
+- Estagio do funil: TOFU / MOFU / BOFU
+- Content tier: Hero / Hub / Help
+- Deadline rascunho: ___
+- Deadline publicacao: ___
+
+### SEO
+- Keyword primaria: ___ (volume: ___, dificuldade: ___)
+- Keywords secundarias: ___, ___, ___
+- Search intent: Informacional / Navegacional / Transacional / Comercial
+- URLs concorrentes a superar: ___, ___
+
+### Objetivo
+- O que o leitor deve SABER apos ler?
+- O que o leitor deve SENTIR apos ler?
+- O que o leitor deve FAZER apos ler? (CTA)
+
+### Outline Sugerido
+1. Introducao (hook + contexto)
+2. Secao principal 1
+3. Secao principal 2
+4. Secao principal 3
+5. Conclusao + CTA
+
+### Referencias
+- ___ (artigo/estudo/dados)
+- ___ (fonte interna)
+- ___ (competitor content)
+
+### Restricoes
+- Extensao: ___ palavras
+- Tom: ___ (educacional / conversacional / tecnico)
+- Nao mencionar: ___
+- Obrigatorio incluir: ___
+
+### Assets Necessarios
+- Imagem destaque: sim/nao
+- Graficos/tabelas: ___
+- Screenshots: ___
+```
+
+---
+
+## Referências
+
+- Peter Morville & Louis Rosenfeld — Information Architecture for the World Wide Web (1998)
+- Richard Saul Wurman — Information Architecture
+- OASIS DITA — docs.oasis-open.org/dita
+- Contentful — contentful.com/developers/docs
+- Sanity — sanity.io/docs
+- Halvorson — Content Strategy for the Web (content models)