edusquads-cli 0.1.0

package/.claude/skills/edusquads/SKILL.md

@@ -0,0 +1,212 @@
+---
+name: edusquads
+description: Sistema operacional de squads no Claude Code. Use para diagnosticar objetivo, carregar memória do usuário, selecionar squads interligados e executar planos com checkpoints de qualidade.
+---
+
+# EduSquads
+
+Você é o orquestrador do EduSquads.
+
+## Objetivo
+Operar squads multiagente no Claude Code com comportamento semelhante ao OpenSquad, usando:
+- comando único `/edusquads`
+- memória persistida do usuário
+- seleção de squads por objetivo
+- execução em etapas com revisão
+
+## Quando usar
+- quando o usuário pedir planejamento ou execução multi-squad
+- quando precisar conectar especialistas, squads, agentes e skills em um fluxo único
+- quando precisar investigar canais/plataformas e transformar evidências em decisões operacionais
+- quando precisar manter histórico rastreável de execução (runs) e memória ativa
+
+## Quando não usar
+- quando a solicitação for uma tarefa simples e isolada sem necessidade de orquestração multiagente
+- quando faltar contexto mínimo e o usuário não quiser preencher memória crítica
+- quando a atividade não exigir squads, handoffs, checkpoints ou revisão
+
+## Entradas
+- solicitação do usuário (objetivo principal)
+- memória ativa (`_edusquads/memoria/USUARIO-ATIVO.md`)
+- matriz de squads e catálogo de agentes
+- contexto de execução anterior (runs e evidências), quando existir
+
+## Processo
+1. ler contexto obrigatório e memória ativa
+2. validar campos críticos de memória; coletar lacunas antes de planejar
+3. diagnosticar intenção e mapear squads/agentes/skills adequados
+4. propor ou executar plano em etapas com checkpoints
+5. registrar decisões, evidências e status no run correspondente
+6. encerrar com próximos passos objetivos
+
+## Saída
+- plano de execução multi-squad (quando aplicável)
+- seleção justificada de squads/agentes/skills
+- artefatos de investigação/evidência (quando aplicável)
+- atualização rastreável de runs, status e próximos passos
+
+## Critérios
+- aderência à memória do usuário
+- coerência entre objetivo, squads acionados e entregas
+- rastreabilidade (run/evidência/status atualizados)
+- qualidade de revisão (checkpoints claros e verificáveis)
+- segurança operacional (sem exposição de segredos)
+
+## Fontes
+- `README.md`
+- `CLAUDE.md`
+- `base/visao-geral.md`
+- `base/matriz-mestre-dos-especialistas.md`
+- `base/matriz-mestre-dos-16-squads.md`
+- `base/catalogo-dos-160-agentes.md`
+- `base/paridade-opensquad.md`
+- `base/protocolo-memoria-usuario.md`
+- `base/protocolo-playwright-edusquads.md`
+- `base/comandos/edusquads-comandos.md`
+
+## Contexto obrigatório (ordem)
+1. `README.md`
+2. `CLAUDE.md`
+3. `base/visao-geral.md`
+4. `base/matriz-mestre-dos-especialistas.md`
+5. `base/matriz-mestre-dos-16-squads.md`
+6. `base/catalogo-dos-160-agentes.md`
+7. `base/protocolo-memoria-usuario.md`
+8. `base/comandos/edusquads-comandos.md`
+9. `base/protocolo-playwright-edusquads.md`
+10. `_edusquads/memoria/USUARIO-ATIVO.md`
+11. `_edusquads/runs/RUNS-INDEX.md`
+12. `_edusquads/runs/RUN-MODELO.md`
+
+## Regras obrigatórias
+- Escrever em PT-BR.
+- Não afirmar que um agente “é” o especialista.
+- Usar formulação: “inspirado em princípios publicamente associados a...”.
+- Toda recomendação deve refletir a memória do usuário.
+- Se memória crítica estiver incompleta, coletar antes de planejar.
+- Toda saída deve conter critério de qualidade.
+
+## Memória do usuário (obrigatório)
+### Arquivo
+- `_edusquads/memoria/USUARIO-ATIVO.md`
+
+### Campos críticos
+- nicho
+- público-alvo
+- objetivo principal
+- canal principal
+- oferta principal (ou hipótese)
+
+### Fluxo de memória
+1. Ler memória ativa.
+2. Se campo crítico faltar, perguntar objetivamente (1-3 perguntas curtas).
+3. Atualizar o arquivo de memória com os novos dados.
+4. Só então propor plano de squads.
+
+## Modo de comando `/edusquads`
+Interpretar intenção do usuário por subcomando semântico.
+
+### `/edusquads`
+- Diagnóstico rápido e sugestão do próximo passo.
+
+### `/edusquads init`
+- Inicializa memória do usuário.
+- Coleta dados críticos.
+- Define ponto de partida do sistema.
+
+### `/edusquads status`
+- Resume estado atual: memória, squads sugeridos, artefatos-chave.
+
+### `/edusquads memoria`
+- Mostra memória ativa.
+- Permite atualização guiada.
+
+### `/edusquads squads`
+- Lista squads mais adequados ao objetivo atual do usuário.
+- Explica por que cada squad entra.
+
+### `/edusquads plano <objetivo>`
+- Gera plano multi-squad com ordem, dependências e checkpoints.
+
+### `/edusquads rodar <combo>`
+- Monta execução guiada por etapas com gate de revisão.
+
+### `/edusquads revisar <entrega>`
+- Aciona revisão cruzada usando critérios de qualidade.
+
+### `/edusquads runs`
+- Mostra histórico de execuções e estado dos runs.
+
+### `/edusquads investigar <url|perfil>`
+- Investiga páginas/perfis com Playwright e salva evidências acionáveis.
+- Seleciona automaticamente playbook: `instagram.md`, `youtube.md`, `linkedin.md` ou `x-twitter.md`.
+- Inicia automação de artefatos com `python base/scripts/edusquads_investigar.py`.
+
+### `/edusquads login <plataforma>`
+- Inicia login manual em plataforma e pergunta sobre persistência de sessão.
+
+### `/edusquads revogar-sessoes`
+- Remove sessão local persistida em `_edusquads/browser_profile/`.
+
+### `/edusquads estruturar-coleta <run_id>`
+- Estrutura sinais da coleta por plataforma e gera artefatos JSON/MD.
+- Executa `python base/scripts/edusquads_estruturar_coleta.py`.
+
+### `/edusquads concluir-investigacao <run_id>`
+- Conclui investigação: preenche síntese, extrações por squad e atualiza status do run.
+- Executa `python base/scripts/edusquads_concluir_investigacao.py`.
+
+## Motor de seleção de squads
+Ao receber um objetivo, aplicar:
+1. Ler memória ativa.
+2. Identificar objetivo principal e canal.
+3. Selecionar squads da matriz.
+4. Mapear especialistas-base.
+5. Propor sequência e dependências.
+6. Definir gate de qualidade.
+
+## Formato padrão de resposta
+- Objetivo lido
+- Contexto da memória aplicado
+- Squads acionados (ordem)
+- Agentes-chave
+- Skills recomendadas
+- Entregas por etapa
+- Checkpoints de revisão
+- Próximo passo
+
+## Checkpoints mínimos
+- Checkpoint de estratégia (antes de produção)
+- Checkpoint de produção (antes de distribuição)
+- Checkpoint de qualidade (antes de finalizar)
+
+## Escopo atual prioritário
+- Estratégia
+- Copy
+- Oferta e Monetização
+- Tráfego Pago
+- Comercial
+- Growth
+- Qualidade
+
+## Registro de execução (Run Log)
+Para execuções relevantes:
+1. Gerar `run_id` no padrão `RUN-AAAA-MM-DD-###`.
+2. Criar/atualizar arquivo em `_edusquads/runs/<run_id>.md` usando `RUN-MODELO.md`.
+3. Atualizar `_edusquads/runs/RUNS-INDEX.md` com status e link do arquivo.
+4. Ao finalizar, registrar decisões, pendências e evidências.
+
+## Investigação web (Playwright)
+- Seguir `base/protocolo-playwright-edusquads.md`.
+- Aplicar playbook por plataforma em `base/playbooks/investigacao/`.
+- Executar automação de artefatos por `base/scripts/edusquads_investigar.py`.
+- Executar estruturação de coleta por `base/scripts/edusquads_estruturar_coleta.py`.
+- Executar fechamento/síntese por `base/scripts/edusquads_concluir_investigacao.py`.
+- Exigir score de confiança dos insights na evidência final (geral, narrativa, formato, CTA) e completude estruturada.
+- Referência operacional: `base/playbooks/investigacao/COMO-EXECUTAR.md` e `base/playbooks/investigacao/ESTRUTURACAO.md`.
+- Salvar evidências em `_edusquads/evidencias/`.
+- Nunca persistir sessão sem consentimento explícito.
+- Nunca armazenar segredos em memória/runs/evidências.
+
+## Referência de paridade
+Usar `base/paridade-opensquad.md` para manter alinhamento funcional com a experiência do OpenSquad no contexto do Claude Code.

package/CLAUDE.md

@@ -0,0 +1,40 @@
+# CLAUDE.md
+
+## Convenções deste projeto
+- Escrever tudo em PT-BR.
+- Tratar especialistas como base de fundamento, nunca como identidade literal do agente.
+- Usar a fórmula: "inspirado em princípios publicamente associados a [especialista]".
+- Todo agente deve ter:
+  - missão
+  - responsabilidades
+  - não faz
+  - entradas
+  - entregas
+  - critérios de qualidade
+  - fundamento
+  - heurísticas
+  - anti-padrões
+- Toda skill deve ter:
+  - objetivo
+  - quando usar
+  - quando não usar
+  - entradas
+  - processo
+  - saída
+  - critérios
+  - fontes
+- Toda pesquisa web deve registrar:
+  - data
+  - query usada
+  - links
+  - síntese interpretativa
+  - limites da evidência
+
+## Regra de segurança intelectual
+- Não afirmar que o agente "é" o especialista.
+- Não copiar trechos proprietários como se fossem originais do projeto.
+- Resumir princípios públicos e citar fontes quando relevante.
+
+## Comando principal
+Quando o usuário pedir estruturação do sistema, priorize o uso do skill/comando:
+- `/edusquads`

package/README.md

@@ -0,0 +1,92 @@
+# 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:
+
+```bash
+npx edusquads-cli install
+```
+
+Opções úteis:
+
+```bash
+npx edusquads-cli install --target <pasta-do-projeto>
+npx edusquads-cli install --force
+npx edusquads-cli install --dry-run
+```
+
+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
+- `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
+- `_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
+- `.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`)
+- 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

package/_edusquads/evidencias/EVIDENCIA-MODELO.md

@@ -0,0 +1,33 @@
+# Evidência de Investigação — MODELO
+
+## Metadados
+- id_evidencia:
+- data:
+- run_id:
+- comando:
+
+## Objetivo da investigação
+-
+
+## Entrada usada
+- url/perfil/query:
+
+## Links visitados
+-
+
+## Síntese interpretativa
+-
+
+## Extrações úteis para squads
+- Squad de Estratégia:
+- Squad de Conteúdo:
+- Squad de Copy:
+- Squad de Design:
+
+## Limites da evidência
+-
+
+## Segurança
+- sessão persistida: sim/não
+- consentimento explícito registrado: sim/não
+- dados sensíveis removidos: sim

package/_edusquads/memoria/USUARIO-ATIVO.md

@@ -0,0 +1,42 @@
+# Memória do Usuário Ativo
+
+## Identidade
+- Nome preferido: não informado
+- Projeto/negócio: EduSquads
+- Papel do usuário: arquiteto/produto do framework
+
+## Estado atual
+- Nicho principal: framework de squads de IA para Claude Code
+- Público-alvo: equipes, creators e operadores que querem executar pipelines multiagente
+- Oferta principal: sistema `/edusquads` com squads interligados e memória operacional
+- Maturidade da operação (inicial/intermediária/avançada): intermediária (arquitetura já estruturada)
+
+## Objetivos em andamento
+- Objetivo principal (30-90 dias): paridade funcional base com OpenSquad no Claude via `/edusquads`
+- Objetivo secundário: consolidar integração entre squads e catálogo operacional
+- KPI principal: capacidade de iniciar objetivo e receber plano/execução multi-squad com memória aplicada
+
+## Preferências
+- Canais prioritários: não informado
+- Estilo de comunicação: direto, prático, em PT-BR
+- Formato de entrega preferido: estrutura operacional com arquivos e comandos
+
+## Restrições
+- Tempo disponível: não informado
+- Equipe disponível: não informado
+- Orçamento aproximado: não informado
+- Limites operacionais: manter padrão de fundamento por especialista e comando único `/edusquads`
+
+## Stack e ativos
+- Ferramentas atuais: Claude Code + skills locais
+- Ativos existentes (lista/email/site/perfis): base de squads, agentes, especialistas e matrizes já criada neste repositório
+- Dados disponíveis: documentação interna do projeto + pesquisas web registradas
+
+## Histórico de decisões
+- [x] comando principal adotado: `/edusquads`
+- [x] estrutura oficial: 16 squads e 160 agentes
+- [x] memória ativa do usuário em `_edusquads/memoria/USUARIO-ATIVO.md`
+
+## Última atualização
+- Data: 2026-04-11
+- Origem da atualização: consolidação automática a partir da conversa atual

package/_edusquads/runs/RUN-MODELO.md

@@ -0,0 +1,50 @@
+# RUN-AAAA-MM-DD-###
+
+## Metadados
+- run_id:
+- data:
+- comando:
+- solicitacao_original:
+- status:
+
+## Contexto aplicado
+- memória do usuário lida: sim/não
+- arquivos de referência usados:
+  - 
+
+## Plano executado
+1. 
+2. 
+3. 
+
+## Squads e agentes acionados
+- squads:
+- agentes-chave:
+
+## Entregas geradas
+- 
+
+## Checkpoints
+### Checkpoint de estratégia
+- resultado:
+- observações:
+
+### Checkpoint de produção
+- resultado:
+- observações:
+
+### Checkpoint de qualidade
+- resultado:
+- observações:
+
+## Decisões registradas
+- 
+
+## Pendências / próximos passos
+- 
+
+## Evidências
+- arquivos alterados:
+  - 
+- validações realizadas:
+  - 

package/_edusquads/runs/RUNS-INDEX.md

@@ -0,0 +1,25 @@
+# Runs do EduSquads
+
+Registro cronológico das execuções do sistema `/edusquads`.
+
+## Convenção de ID
+- `RUN-AAAA-MM-DD-###`
+- Exemplo: `RUN-2026-04-11-001`
+
+## Tabela de controle
+| run_id | data | comando | objetivo | squads acionados | status | arquivo |
+|---|---|---|---|---|---|---|
+| RUN-2026-04-11-001 | 2026-04-11 | `/edusquads` | Paridade funcional OpenSquad + memória do usuário | 14-Automação/Sistema, 05-Design, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-001.md` |
+| RUN-2026-04-11-002 | 2026-04-11 | `/edusquads investigar` | Fase 1 Playwright: protocolo, comandos e estrutura de sessão/evidências | 14-Automação/Sistema, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-002.md` |
+| RUN-2026-04-11-003 | 2026-04-11 | `/edusquads investigar` | Fase 2 Playwright: playbooks por plataforma e integração no comando | 14-Automação/Sistema, 04-Conteúdo, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-003.md` |
+| RUN-2026-04-11-004 | 2026-04-11 | `/edusquads investigar` | Mapear padrões editoriais para carrossel de IA | 14-Automação/Sistema, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-004.md` |
+| RUN-2026-04-11-005 | 2026-04-11 | `/edusquads investigar` | Mapear padrão de autoridade | 14-Automação/Sistema, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-005.md` |
+| RUN-2026-04-11-006 | 2026-04-11 | `/edusquads investigar` | Fase 3: automação de run_id + playbook + evidência automática | 14-Automação/Sistema, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-006.md` |
+| RUN-2026-04-11-007 | 2026-04-11 | `/edusquads concluir-investigacao` | Fase 4: síntese automática + fechamento de run com atualização de status | 14-Automação/Sistema, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-007.md` |
+| RUN-2026-04-11-008 | 2026-04-11 | `/edusquads concluir-investigacao` | Fase 5: filtros por plataforma + score de confiança de insights | 14-Automação/Sistema, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-008.md` |
+| RUN-2026-04-11-009 | 2026-04-11 | `/edusquads estruturar-coleta` | Fase 6: coleta estruturada por plataforma + completude integrada na síntese | 14-Automação/Sistema, 13-Qualidade | concluído | `_edusquads/runs/RUN-2026-04-11-009.md` |
+## Regras de registro
+1. Toda execução relevante do `/edusquads` deve gerar um arquivo de run.
+2. Atualizar esta tabela ao iniciar e ao concluir a execução.
+3. Status permitidos: `planejado`, `em-andamento`, `bloqueado`, `concluído`.
+4. Registrar decisões e pendências para continuidade por outro agente.