edusquads-cli 0.1.0

package/base/matriz-mestre-dos-especialistas.md

@@ -0,0 +1,579 @@
+# Matriz Mestre dos Especialistas
+
+## Objetivo
+Conectar, de forma operacional, cada especialista-base do EduSquads aos squads, agentes e skills que devem carregar sua doutrina.
+
+Esta matriz serve para:
+- evitar sobreposição confusa entre agentes
+- manter coerência de fundamento
+- acelerar criação de novos squads
+- orientar expansão da biblioteca de especialistas
+- padronizar quais skills nascem de qual escola
+
+---
+
+# 1. Visão resumida
+
+| Especialista | Área principal | Squads prioritários | Função no sistema |
+| --- | --- | --- | --- |
+| Pedro Sobral | Tráfego pago | Tráfego Pago, Growth | Gestão de mídia, orçamento, leitura de métricas, teste com critério |
+| Russell Brunson | Funil e copy de conversão | Copy, Oferta, Growth | Arquitetura de funil, escada de valor, Hook/Story/Offer, follow-up |
+| Joanna Wiebe | Copy de conversão | Copy, Growth, UX e Experiência | Pesquisa de mensagem, estrutura de copy, edição orientada à conversão |
+| April Dunford | Posicionamento | Estratégia, Posicionamento, Comercial | Categoria, diferenciação, valor contextual, narrativa competitiva |
+| Marty Neumeier | Branding | Branding, Design, Estratégia | Diferenciação de marca, ponte entre estratégia e design |
+| Donald Miller | Clareza de mensagem | Copy, Branding, Comercial, Conteúdo | Clareza, soundbites, narrativa repetível, CTA derivado da mensagem |
+
+---
+
+# 2. Matriz por especialista
+
+## 2.1. Pedro Sobral
+
+### Área-base
+Tráfego pago
+
+### Doutrina central no EduSquads
+- objetivo antes de orçamento
+- funil antes de escala
+- dados antes de palpite
+- gestão de tráfego como processo contínuo
+- leitura de métricas por etapa
+
+### Squads prioritários
+- Squad de Tráfego Pago
+- Squad de Growth
+- apoio ao Squad de Oferta
+
+### Agentes que devem nascer dessa base
+- Estrategista de Tráfego Pago
+- Planejador de Campanhas
+- Analista de Métricas e Otimização
+- Escalador de Campanhas
+- Auditor de Contas e Campanhas
+- Revisor de Performance
+
+### Skills que devem carregar essa base
+- definir-tese-de-aquisicao
+- montar-plano-de-campanha
+- calcular-faixa-de-investimento
+- ler-metricas-de-trafego
+- montar-plano-de-testes
+- auditar-campanha
+- revisar-prontidao-para-escala
+
+### Tipos de decisão onde essa base manda mais
+- escolha de objetivo de campanha
+- cálculo de verba inicial
+- leitura de CPC, CTR, CAC, ROAS
+- decisão de escalar ou não
+- separação entre problema de mídia e problema de funil
+
+---
+
+## 2.2. Russell Brunson
+
+### Área-base
+Funil, oferta e copy de conversão
+
+### Doutrina central no EduSquads
+- pensar em jornada e funil, não peça solta
+- estruturar escada de valor
+- usar lead capture e follow-up como parte do sistema
+- tratar upsell, downsell e order bump como alavancas
+- usar Hook, Story, Offer quando adequado
+
+### Squads prioritários
+- Squad de Copy
+- Squad de Oferta e Monetização
+- Squad de Growth
+- apoio ao Squad Comercial
+
+### Agentes que devem nascer dessa base
+- Copywriter de Landing Page
+- Roteirista de Funil
+- Estruturador de Oferta em Copy
+- Copywriter de Follow-up
+- Arquiteto de Oferta
+- Planejador de Escada de Valor
+- Especialista em Sequência de Conversão
+
+### Skills que devem carregar essa base
+- estruturar-hook-story-offer
+- desenhar-copy-de-captura
+- montar-sequencia-de-follow-up
+- criar-escada-de-valor-em-copy
+- desenhar-upsell-downsell
+- mapear-pontos-de-conversao-do-funil
+
+### Tipos de decisão onde essa base manda mais
+- qual etapa do funil a peça atende
+- que oferta deve entrar primeiro
+- como escalar valor por jornada
+- como organizar sequência narrativa e CTA
+- onde encaixar follow-up e monetização secundária
+
+---
+
+## 2.3. Joanna Wiebe
+
+### Área-base
+Copy de conversão
+
+### Doutrina central no EduSquads
+- copy existe para converter
+- estrutura e pesquisa antecedem o texto final
+- edição forte aumenta performance
+- clareza e persuasão devem coexistir
+- IA sem direção gera copy frouxa
+
+### Squads prioritários
+- Squad de Copy
+- Squad de Growth
+- Squad de UX e Experiência
+- apoio ao Squad Comercial
+
+### Agentes que devem nascer dessa base
+- Pesquisador de Mensagem
+- Estruturador de Copy de Conversão
+- Editor de Copy de Performance
+- Especialista em Microcopy de Conversão
+- Crítico de Conversão
+- Revisor-Chefe de Copy
+
+### Skills que devem carregar essa base
+- mapear-mensagem-de-conversao
+- transformar-pesquisa-em-copy
+- revisar-copy-por-funcao
+- cortar-friccao-verbal
+- reforcar-cta-com-precisao
+- editar-copy-para-conversao
+
+### Tipos de decisão onde essa base manda mais
+- o que precisa ser dito antes do CTA
+- qual parte da copy está frouxa ou funcional
+- como transformar pesquisa em mensagem prática
+- como editar para aumentar precisão e intenção
+- como usar IA sem perder critério de copy chief
+
+---
+
+## 2.4. April Dunford
+
+### Área-base
+Posicionamento
+
+### Doutrina central no EduSquads
+- posicionamento é processo, não slogan
+- diferenciação depende de alternativas competitivas
+- categoria influencia percepção e venda
+- valor diferenciado nasce da relação entre capacidade e contexto
+- marketing e vendas precisam falar a mesma lógica competitiva
+
+### Squads prioritários
+- Squad de Estratégia
+- Squad de Posicionamento
+- Squad Comercial
+- apoio ao Squad de Branding
+
+### Agentes que devem nascer dessa base
+- Especialista em Posicionamento
+- Analista de Alternativas Competitivas
+- Estrategista de Categoria
+- Arquiteto de Valor Diferenciado
+- Tradutor de Posicionamento para Vendas
+- Revisor Estratégico de Posicionamento
+
+### Skills que devem carregar essa base
+- mapear-alternativas-competitivas
+- definir-categoria-e-diferencial
+- traduzir-capacidades-em-valor
+- escolher-segmento-prioritario
+- estruturar-narrativa-de-posicionamento
+- revisar-aderencia-competitiva-da-mensagem
+
+### Tipos de decisão onde essa base manda mais
+- qual mercado/categoria ocupar
+- contra quem o produto realmente compete
+- qual diferencial deve ser comunicado
+- qual segmento perceberá mais valor
+- como alinhar marketing e vendas na mesma tese
+
+---
+
+## 2.5. Marty Neumeier
+
+### Área-base
+Branding
+
+### Doutrina central no EduSquads
+- branding conecta estratégia e execução
+- marca forte precisa de diferenciação deliberada
+- design deve servir a tese competitiva
+- experiência valida a promessa da marca
+- sem distinção, a marca vira commodity percebida
+
+### Squads prioritários
+- Squad de Branding
+- Squad de Design
+- Squad de Estratégia
+- apoio ao Squad de Conteúdo
+
+### Agentes que devem nascer dessa base
+- Estrategista de Marca
+- Arquiteto de Diferenciação de Marca
+- Designer de Identidade Estratégica
+- Guardião de Consistência de Marca
+- Revisor de Distinção Visual
+- Revisor de Coerência entre Marca e Execução
+
+### Skills que devem carregar essa base
+- definir-tese-de-marca
+- mapear-diferenciacao-radical
+- alinhar-identidade-com-estrategia
+- revisar-gap-entre-marca-e-execucao
+- construir-principios-de-experiencia-de-marca
+- auditar-coerencia-de-marca
+
+### Tipos de decisão onde essa base manda mais
+- como a marca se diferencia de verdade
+- se a identidade traduz a tese estratégica
+- se a experiência confirma ou enfraquece a marca
+- se o design está servindo percepção correta
+- como evitar uma marca “me-too”
+
+---
+
+## 2.6. Donald Miller
+
+### Área-base
+Clareza de mensagem e narrativa comercial
+
+### Doutrina central no EduSquads
+- clareza antes de sofisticação
+- mensagem precisa ser repetível
+- problema claro gera relevância
+- linguagem da empresa deve ser unificada
+- CTA e geração de demanda derivam da mensagem central
+
+### Squads prioritários
+- Squad de Copy
+- Squad de Branding
+- Squad Comercial
+- Squad de Conteúdo
+- apoio ao Squad de UX e Experiência
+
+### Agentes que devem nascer dessa base
+- Estrategista de Clareza de Mensagem
+- Criador de Soundbites
+- Revisor de Clareza
+- Arquiteto de Narrativa Comercial
+- Unificador de Linguagem de Marca
+- Especialista em CTA Narrativo
+
+### Skills que devem carregar essa base
+- criar-soundbites-principais
+- simplificar-mensagem-central
+- alinhar-cta-com-promessa
+- revisar-clareza-comercial
+- transformar-oferta-em-linguagem-repetivel
+- reduzir-confusao-da-mensagem
+
+### Tipos de decisão onde essa base manda mais
+- o que a marca deve dizer de forma curta e repetível
+- como simplificar a proposta sem empobrecer valor
+- como alinhar site, vendas, produto e conteúdo
+- como reduzir confusão verbal
+- como construir CTA coerente com a narrativa principal
+
+---
+
+# 3. Matriz por squad
+
+## 3.1. Squad de Tráfego Pago
+
+### Especialistas-base principais
+- Pedro Sobral
+
+### Especialistas-base secundários futuros
+- Ben Heath
+- Jon Loomer
+- Molly Pittman
+
+### Tipos de agentes desse squad
+- estratégia de aquisição
+- campanha
+- criativo de performance
+- público
+- métricas
+- remarketing
+- escala
+- auditoria
+
+### Skills-base prioritárias
+- definir-tese-de-aquisicao
+- montar-plano-de-campanha
+- calcular-faixa-de-investimento
+- ler-metricas-de-trafego
+- montar-plano-de-testes
+- auditar-campanha
+
+---
+
+## 3.2. Squad de Copy
+
+### Especialistas-base principais
+- Russell Brunson
+- Joanna Wiebe
+- Donald Miller
+
+### Especialistas-base secundários futuros
+- Eugene Schwartz
+- David Ogilvy
+- Dan Kennedy
+
+### Distribuição ideal de doutrina
+- Russell Brunson: funil, oferta, estrutura de jornada
+- Joanna Wiebe: pesquisa, edição, precisão de conversão
+- Donald Miller: clareza, repetição, mensagem central
+
+### Skills-base prioritárias
+- estruturar-hook-story-offer
+- mapear-mensagem-de-conversao
+- simplificar-mensagem-central
+- editar-copy-para-conversao
+- revisar-clareza-comercial
+- montar-sequencia-de-follow-up
+
+---
+
+## 3.3. Squad de Estratégia
+
+### Especialistas-base principais
+- April Dunford
+- Marty Neumeier
+
+### Especialistas-base secundários futuros
+- Seth Godin
+- Al Ries
+- Jack Trout
+
+### Distribuição ideal de doutrina
+- April Dunford: posicionamento e categoria
+- Marty Neumeier: diferenciação e ligação com marca
+
+### Skills-base prioritárias
+- definir-categoria-e-diferencial
+- mapear-alternativas-competitivas
+- definir-tese-de-marca
+- estruturar-narrativa-de-posicionamento
+
+---
+
+## 3.4. Squad de Branding
+
+### Especialistas-base principais
+- Marty Neumeier
+- Donald Miller
+
+### Especialistas-base secundários futuros
+- Seth Godin
+- Simon Sinek
+
+### Distribuição ideal de doutrina
+- Marty Neumeier: diferenciação e ponte estratégia-execução
+- Donald Miller: clareza verbal e mensagem repetível
+
+### Skills-base prioritárias
+- definir-tese-de-marca
+- criar-soundbites-principais
+- alinhar-identidade-com-estrategia
+- auditar-coerencia-de-marca
+
+---
+
+## 3.5. Squad Comercial
+
+### Especialistas-base principais
+- April Dunford
+- Donald Miller
+- Russell Brunson
+
+### Especialistas-base secundários futuros
+- Chris Voss
+- Oren Klaff
+- Jeb Blount
+
+### Distribuição ideal de doutrina
+- April Dunford: narrativa competitiva
+- Donald Miller: clareza e repetição
+- Russell Brunson: sequência de conversão e oferta
+
+### Skills-base prioritárias
+- traduzir-posicionamento-para-vendas
+- simplificar-mensagem-central
+- estruturar-pitch-comercial
+- criar-cta-de-fechamento
+
+---
+
+## 3.6. Squad de Growth
+
+### Especialistas-base principais
+- Pedro Sobral
+- Russell Brunson
+- Joanna Wiebe
+
+### Especialistas-base secundários futuros
+- Sean Ellis
+- Brian Balfour
+- Andrew Chen
+
+### Distribuição ideal de doutrina
+- Pedro Sobral: mídia e performance
+- Russell Brunson: funil e monetização por jornada
+- Joanna Wiebe: experimentação de copy e conversão
+
+### Skills-base prioritárias
+- desenhar-hipoteses-de-crescimento
+- revisar-gargalo-de-funil
+- priorizar-teste-de-copy-ou-midia
+- mapear-pontos-de-alavancagem
+
+---
+
+# 4. Matriz por tipo de skill
+
+## 4.1. Skills de tráfego pago
+Base principal:
+- Pedro Sobral
+
+### Exemplos
+- calcular-faixa-de-investimento
+- ler-metricas-de-trafego
+- auditar-campanha
+- revisar-prontidao-para-escala
+
+## 4.2. Skills de funil e oferta
+Base principal:
+- Russell Brunson
+
+### Exemplos
+- estruturar-hook-story-offer
+- criar-escada-de-valor-em-copy
+- montar-sequencia-de-follow-up
+- desenhar-upsell-downsell
+
+## 4.3. Skills de copy de conversão
+Base principal:
+- Joanna Wiebe
+- Donald Miller
+
+### Exemplos
+- mapear-mensagem-de-conversao
+- editar-copy-para-conversao
+- simplificar-mensagem-central
+- revisar-clareza-comercial
+
+## 4.4. Skills de posicionamento
+Base principal:
+- April Dunford
+
+### Exemplos
+- mapear-alternativas-competitivas
+- definir-categoria-e-diferencial
+- traduzir-capacidades-em-valor
+- estruturar-narrativa-de-posicionamento
+
+## 4.5. Skills de branding
+Base principal:
+- Marty Neumeier
+
+### Exemplos
+- definir-tese-de-marca
+- mapear-diferenciacao-radical
+- alinhar-identidade-com-estrategia
+- auditar-coerencia-de-marca
+
+---
+
+# 5. Regras de uso da matriz
+
+## Regra 1
+Nenhum agente deve ter fundamento “decorativo”.
+Se um especialista estiver citado, sua doutrina precisa aparecer em:
+- princípios
+- heurísticas
+- anti-padrões
+- critérios de qualidade
+
+## Regra 2
+Um mesmo agente pode combinar escolas, mas deve haver base dominante.
+Exemplo:
+- Copywriter de Landing Page
+  - dominante: Russell Brunson
+  - complementar: Joanna Wiebe
+  - complementar: Donald Miller
+
+## Regra 3
+Quando houver conflito entre escolas, declarar a prioridade.
+Exemplo:
+- clareza de mensagem pode ter prioridade sobre sofisticação estilística
+- margem e viabilidade podem ter prioridade sobre vontade de escalar mídia
+
+## Regra 4
+Especialista novo só entra como base oficial após:
+- pesquisa web documentada
+- arquivo em `especialistas/`
+- vínculo claro com pelo menos um squad e uma skill
+
+---
+
+# 6. Prioridade de expansão
+
+## Próxima leva recomendada
+1. Alex Hormozi
+2. Ben Heath
+3. Eugene Schwartz
+4. Seth Godin
+5. Brian Dean
+6. Chris Voss
+
+## Motivo
+Esses nomes completam lacunas importantes em:
+- oferta
+- mídia paga avançada
+- consciência de mercado e copy
+- marca e permissão
+- SEO
+- negociação e fechamento
+
+---
+
+# 7. Uso prático pelo comando `/edusquads`
+
+Quando o comando `/edusquads` receber um pedido, esta matriz deve orientar:
+1. quais especialistas-base ativar
+2. quais squads sugerir
+3. quais agentes propor
+4. quais skills reutilizar ou criar
+5. quais conflitos de doutrina resolver
+
+## Exemplo 1
+Pedido: "quero montar operação de tráfego para vender um infoproduto"
+
+Resposta orientada pela matriz:
+- especialista principal: Pedro Sobral
+- especialista complementar: Russell Brunson
+- squads: Tráfego Pago + Copy + Oferta
+- agentes: Estrategista de Tráfego Pago, Copywriter de Landing Page, Estruturador de Oferta em Copy
+- skills: calcular-faixa-de-investimento, estruturar-hook-story-offer, criar-escada-de-valor-em-copy
+
+## Exemplo 2
+Pedido: "quero reposicionar minha marca e clarificar mensagem"
+
+Resposta orientada pela matriz:
+- especialista principal: April Dunford
+- especialistas complementares: Marty Neumeier, Donald Miller
+- squads: Estratégia + Branding + Copy
+- agentes: Especialista em Posicionamento, Estrategista de Marca, Estrategista de Clareza de Mensagem
+- skills: definir-categoria-e-diferencial, definir-tese-de-marca, criar-soundbites-principais

package/base/modelos/modelo-de-agente.md

@@ -0,0 +1,62 @@
+# Modelo de Agente
+
+## Nome
+[Nome do agente]
+
+## Squad
+[Nome do squad]
+
+## Papel
+[Função principal]
+
+## Missão
+[O que entrega repetidamente]
+
+## Base de fundamento
+### Especialistas de referência
+- [Especialista 1]
+- [Especialista 2]
+
+### Fontes-base
+- [URL 1]
+- [URL 2]
+
+### Princípios centrais
+- [Princípio 1]
+- [Princípio 2]
+- [Princípio 3]
+
+### Heurísticas operacionais
+- [Heurística 1]
+- [Heurística 2]
+
+### Anti-padrões
+- [Erro 1]
+- [Erro 2]
+
+## Responsabilidades
+- [Responsabilidade 1]
+- [Responsabilidade 2]
+
+## Não faz
+- [Fora de escopo 1]
+- [Fora de escopo 2]
+
+## Entradas esperadas
+- briefing
+- contexto
+- transferência
+- materiais de apoio
+
+## Entregas esperadas
+- [Entrega 1]
+- [Entrega 2]
+
+## Critérios de qualidade
+- clareza
+- aderência ao objetivo
+- consistência com o fundamento
+- aplicabilidade
+
+## Revisor natural
+[Agente revisor]

package/base/modelos/modelo-de-skill.md

@@ -0,0 +1,55 @@
+# Modelo de Skill
+
+## Nome
+[Nome da skill]
+
+## Objetivo
+[O que esta skill resolve]
+
+## Fundamentação
+### Especialistas de referência
+- [Especialista 1]
+- [Especialista 2]
+
+### Fontes-base
+- [URL 1]
+- [URL 2]
+
+### Princípios aplicados
+- [Princípio 1]
+- [Princípio 2]
+
+### Critérios de decisão
+- [Critério 1]
+- [Critério 2]
+
+### Anti-padrões
+- [Erro 1]
+- [Erro 2]
+
+## Quando usar
+- [Caso 1]
+- [Caso 2]
+
+## Quando não usar
+- [Caso 1]
+- [Caso 2]
+
+## Entradas
+- [Entrada 1]
+- [Entrada 2]
+
+## Processo
+1. [Passo 1]
+2. [Passo 2]
+3. [Passo 3]
+
+## Entrega esperada
+- [Saída 1]
+- [Saída 2]
+
+## Critérios de qualidade
+- clareza
+- lógica
+- aplicabilidade
+- aderência ao fundamento