EduSquads

Framework em PT-BR para organizar squads, agentes, skills e fundamentos de especialistas dentro do Claude Code.

Objetivo

Transformar conhecimento operacional de mercado em um sistema invocável por comando, com base em:

• squads especializados
• agentes com escopo claro
• skills reutilizáveis
• fundamentos inspirados em especialistas reconhecidos
• fluxos com revisão e critérios de qualidade

Instalação via npx (CLI)

Este repositório já está preparado como pacote npm (edusquads-cli) para instalar o framework em qualquer projeto.

Comandos:

npx edusquads-cli install

Se --ide não for informado, o instalador pergunta no terminal qual(s) IDE(s) você quer.

Opções úteis:

npx edusquads-cli install --target <pasta-do-projeto>
npx edusquads-cli install --ide claude,codex,opencode,kilocode,antigravity
npx edusquads-cli install --ide all
npx edusquads-cli install --force
npx edusquads-cli install --dry-run
npx edusquads-cli install --skip-onboarding

Após instalar, o CLI pergunta no terminal se a pessoa quer preencher o briefing na hora. Se aceitar, ele executa onboarding enxuto e grava a memória automaticamente.

Briefing enxuto coleta apenas:

• o que a pessoa faz
• o que vende e onde vende
• meta principal (30-90 dias)
• formato favorito
• público inicial (rascunho)

Depois disso, o sistema refina o público com a skill de ICP.

Depois da instalação, abra o projeto no Claude Code e use:

• /edusquads

Como o Claude Code suporta skills em .claude/skills/<nome>/SKILL.md, a skill edusquads vira comando automaticamente.

Estrutura inicial

• EDUSQUADS-RULES.md: regras canônicas do framework (agnóstico de IDE)
• base/: visão, princípios, matrizes mestras, comandos e protocolos
• base/playbooks/investigacao/: playbooks por plataforma para /edusquads investigar
• especialistas/: biblioteca de fundamentos por especialista
• squads/: definição dos squads e agentes oficiais
• pesquisa/web/: sínteses com fontes públicas
• _edusquads/memoria/: memória operacional do usuário (ativo + perfis em usuarios/)
• squads/02-pesquisa/skills/refinar-icp.md: skill para refinar público a partir do briefing
• _edusquads/runs/: histórico de execuções do /edusquads
• _edusquads/browser_profile/: sessão local de navegação (Playwright)
• _edusquads/evidencias/: evidências de investigação web
• gerador_carrossel.html: dashboard visual para personalizar carrossel (inclui campo da Unsplash API)
• .claude/skills/edusquads/: skill/comando principal

Estado atual

Sistema operacional implementado com foco em:

• comando /edusquads
• paridade funcional base inspirada no OpenSquad
• memória persistida do usuário (_edusquads/memoria/USUARIO-ATIVO.md)
• onboarding interativo enxuto de briefing (base/scripts/edusquads_onboarding_memoria.py)
• refino de público via skill ICP (squads/02-pesquisa/skills/refinar-icp.md)
• regra obrigatória de credenciais para carrossel (APIFY_API_TOKEN + UNSPLASH_ACCESS_KEY)
• gate obrigatório do Squad 03-Copy para versão final de carrossel
• regra editorial de copy: sem travessão/hífen de separação
• histórico de runs (_edusquads/runs/)
• protocolo de investigação web com Playwright (base/protocolo-playwright-edusquads.md)
• playbooks por plataforma (base/playbooks/investigacao/)
• automação de abertura de investigação (base/scripts/edusquads_investigar.py)
• estruturação de coleta por plataforma (base/scripts/edusquads_estruturar_coleta.py)
• automação de conclusão/síntese de investigação (base/scripts/edusquads_concluir_investigacao.py)
• score de confiança dos insights por investigação (geral, narrativa, formato, CTA)
• score de completude da coleta estruturada
• 16 squads oficiais
• 160 agentes oficiais catalogados (base/catalogo-dos-160-agentes.md)
• matriz de especialistas e matriz de squads

Biblioteca de especialistas

Já documentados:

• tráfego pago: Pedro Sobral
• copy: Russell Brunson, Joanna Wiebe
• posicionamento: April Dunford
• branding: Marty Neumeier
• mensagem e clareza: Donald Miller

Pendentes de aprofundamento:

• Alex Hormozi
• Ben Heath
• Jon Loomer
• Eugene Schwartz
• David Ogilvy
• Dan Kennedy
• Brian Dean
• Seth Godin

Publicação npm

Guia completo em:

• PUBLISH-NPM.md

Próxima expansão sugerida

1. detalhar os 16 squads
2. criar agentes individuais por squad
3. criar skills operacionais por função
4. criar combos prontos por operação
5. aprofundar especialistas pendentes