edusquads-cli 0.1.0

package/base/paridade-opensquad.md

@@ -0,0 +1,49 @@
+# Paridade OpenSquad → EduSquads (Claude Code)
+
+## Fonte lida
+- https://raw.githubusercontent.com/renatoasse/opensquad/master/README.md
+
+## Objetivo
+Aproximar a experiência do OpenSquad no contexto deste projeto com comando `/edusquads`, squads interligados e memória do usuário.
+
+## Mapeamento de funcionalidades
+
+### 1) Menu/comando principal
+- OpenSquad: `/opensquad`
+- EduSquads: `/edusquads` ✅ já disponível via `.claude/skills/edusquads/SKILL.md`
+
+### 2) Criação e execução de squads em linguagem natural
+- OpenSquad: create/run/list/edit
+- EduSquads: fluxo semântico em `/edusquads` com diagnóstico + plano + execução guiada ✅
+
+### 3) Pipeline multiagente com checkpoints
+- OpenSquad: pipeline com pausas de aprovação
+- EduSquads: checkpoints orientados por revisão (Squad de Qualidade + revisores naturais) ✅
+
+### 4) Catálogo e estrutura de squads
+- OpenSquad: squads em diretórios
+- EduSquads: 16 squads oficiais + 160 agentes ✅
+
+### 5) Memória do usuário
+- OpenSquad: contexto de execução por projeto/squad
+- EduSquads: memória operacional em `_edusquads/memoria/USUARIO-ATIVO.md` ✅
+
+### 6) Comandos operacionais
+- OpenSquad: help/create/run/list/edit/skills/install/uninstall
+- EduSquads: subcomandos semânticos definidos em `base/comandos/edusquads-comandos.md` ✅
+
+## Gap atual
+- dashboard visual 2D (estilo escritório virtual) → não implementado
+- runner CLI dedicado externo (npm package) → não implementado neste repositório
+
+## Decisão de implementação
+Neste projeto, a experiência será centrada em:
+1. comando `/edusquads`
+2. memória do usuário persistida em markdown
+3. matrizes de decisão + catálogo de agentes
+4. execução guiada com checkpoints textuais e revisão
+
+## Próxima evolução sugerida
+- criar `base/playbooks/` por combo (lançamento, reposicionamento, conteúdo)
+- criar `base/checkpoints/` com critérios objetivos por etapa
+- criar um `status-board.md` em `_edusquads/` para rastrear execuções

package/base/playbooks/investigacao/COMO-EXECUTAR.md

@@ -0,0 +1,51 @@
+# Como executar `/edusquads investigar` (Fase 3 + Fase 4 + Fase 6)
+
+## Etapa 1 — Abrir investigação (automação de artefatos)
+```bash
+python base/scripts/edusquads_investigar.py "<url-ou-perfil>" --objetivo "<objetivo de negócio>"
+```
+
+## Opções da etapa 1
+- `--plataforma instagram|youtube|linkedin|x-twitter` (opcional, autodetect por URL)
+- `--profundidade rápida|profunda` (padrão: rápida)
+- `--consentimento-sessao` (marcar quando houver consentimento explícito para persistir sessão)
+
+## Saídas da etapa 1
+1. novo run em `_edusquads/runs/RUN-AAAA-MM-DD-###.md`
+2. nova evidência em `_edusquads/evidencias/EVIDENCIA-RUN-...-<plataforma>.md`
+3. atualização de `_edusquads/runs/RUNS-INDEX.md`
+
+## Etapa 2 — Coleta web real
+1. executar navegação com Playwright/browser runtime
+2. salvar conteúdo-base em arquivo markdown (ex.: `_edusquads/evidencias/FONTE-<run_id>.md`)
+
+## Etapa 3 — Estruturar coleta por plataforma (Fase 6)
+```bash
+python base/scripts/edusquads_estruturar_coleta.py <run_id> --fonte <arquivo-markdown-da-coleta>
+```
+
+### Resultado da etapa 3
+- gera `ESTRUTURADA-<run_id>.json` e `ESTRUTURADA-<run_id>.md`
+- calcula score de completude da coleta estruturada
+
+## Etapa 4 — Concluir investigação (síntese automática + fechamento do run)
+```bash
+python base/scripts/edusquads_concluir_investigacao.py <run_id> --fonte <arquivo-markdown-da-coleta>
+```
+
+### Resultado da etapa 4
+- preenche síntese interpretativa
+- preenche extrações úteis por squad
+- calcula score de confiança (`geral`, `narrativa`, `formato`, `cta`)
+- incorpora completude da coleta estruturada
+- fecha o run e sincroniza status no índice
+
+### Opções da etapa 4
+- `--limites "<texto dos limites da evidência>"`
+
+## Exemplo ponta a ponta
+```bash
+python base/scripts/edusquads_investigar.py "https://www.instagram.com/exemplo" --objetivo "Mapear padrões de carrossel de IA" --profundidade rápida
+python base/scripts/edusquads_estruturar_coleta.py RUN-2026-04-11-004 --fonte _edusquads/evidencias/FONTE-RUN-2026-04-11-004.md
+python base/scripts/edusquads_concluir_investigacao.py RUN-2026-04-11-004 --fonte _edusquads/evidencias/FONTE-RUN-2026-04-11-004.md --limites "A plataforma exigiu login; análise parcial sem autenticação."
+```

package/base/playbooks/investigacao/ESTRUTURACAO.md

@@ -0,0 +1,28 @@
+# Estruturação de Coleta (Fase 6)
+
+## Objetivo
+Transformar coleta bruta em sinais padronizados por plataforma para elevar a qualidade da síntese final.
+
+## Script
+```bash
+python base/scripts/edusquads_estruturar_coleta.py <run_id> --fonte <arquivo-fonte.md>
+```
+
+## Saídas
+- `_edusquads/evidencias/ESTRUTURADA-<run_id>.json`
+- `_edusquads/evidencias/ESTRUTURADA-<run_id>.md`
+
+## Sinais estruturados
+- formatos detectados
+- CTAs detectados
+- hashtags
+- links
+- tópicos recorrentes
+- campos específicos da plataforma (booleanos)
+- score de completude da coleta
+
+## Regra de uso
+1. Rodar `edusquads_investigar.py` para abrir run/evidência.
+2. Coletar fonte bruta.
+3. Rodar `edusquads_estruturar_coleta.py`.
+4. Rodar `edusquads_concluir_investigacao.py` para síntese final com score.

package/base/playbooks/investigacao/PLAYBOOK-GERAL.md

@@ -0,0 +1,34 @@
+# Playbook Geral — Investigação Web (/edusquads investigar)
+
+## Objetivo
+Executar investigação estruturada por URL/perfil com coleta de evidências acionáveis para os squads.
+
+## Pré-condições
+1. Ler `_edusquads/memoria/USUARIO-ATIVO.md`.
+2. Ler `base/protocolo-playwright-edusquads.md`.
+3. Definir `run_id` ativo.
+4. Confirmar escopo (qual pergunta de negócio será respondida).
+
+## Entradas mínimas
+- plataforma
+- url/perfil alvo
+- objetivo da investigação
+- profundidade (`rápida` ou `profunda`)
+
+## Fluxo padrão
+1. **Definir hipótese**: o que queremos descobrir.
+2. **Navegar no alvo**: coletar sinais visuais/editoriais/comerciais.
+3. **Capturar evidências**: prints + pontos observáveis.
+4. **Extrair padrões**: formato, frequência, CTA, posicionamento.
+5. **Converter em ação**: recomendações por squad.
+6. **Registrar**: salvar evidência + atualizar run.
+
+## Saída obrigatória
+- arquivo `_edusquads/evidencias/EVIDENCIA-<run_id>-<plataforma>.md`
+- atualização do run ativo em `_edusquads/runs/<run_id>.md`
+
+## Critérios de qualidade
+- utilidade prática para execução
+- links e sinais observáveis rastreáveis
+- sem inferências soltas sem evidência
+- sem dados sensíveis

package/base/playbooks/investigacao/instagram.md

@@ -0,0 +1,23 @@
+# Playbook — Instagram
+
+## Objetivo
+Mapear padrões de conteúdo e conversão em perfil/post do Instagram.
+
+## Checklist de coleta
+- bio (promessa, nicho, prova)
+- destaques (temas e hierarquia)
+- últimos 9 posts (formatos e temas)
+- carrosséis: estrutura (hook, narrativa, CTA)
+- reels: estilo de abertura e CTA
+- sinais de oferta (link, DM, comentário fixado)
+
+## Extrações para squads
+- Estratégia: tese de posicionamento percebida
+- Conteúdo: pilares editoriais e cadência
+- Copy: padrões de headline/hook/CTA
+- Design: padrões visuais e composição
+- Tráfego Pago: possíveis criativos reaproveitáveis
+
+## Entrega
+Salvar evidência como:
+- `_edusquads/evidencias/EVIDENCIA-<run_id>-instagram.md`

package/base/playbooks/investigacao/linkedin.md

@@ -0,0 +1,23 @@
+# Playbook — LinkedIn
+
+## Objetivo
+Mapear padrão de autoridade e geração de demanda em perfil/posts LinkedIn.
+
+## Checklist de coleta
+- headline e about (clareza de proposta)
+- linha editorial dos últimos posts
+- formatos (texto, carrossel, vídeo, enquete)
+- padrão de abertura e fechamento de posts
+- CTA (comentário, DM, link externo)
+- sinais de prova social (engajamento, cases, depoimentos)
+
+## Extrações para squads
+- Estratégia: posicionamento profissional dominante
+- Conteúdo: temas com maior recorrência
+- Copy: estrutura de argumentação
+- Design: padrão de carrossel/document post
+- Comercial: gatilhos de reunião/contato
+
+## Entrega
+Salvar evidência como:
+- `_edusquads/evidencias/EVIDENCIA-<run_id>-linkedin.md`

package/base/playbooks/investigacao/x-twitter.md

@@ -0,0 +1,23 @@
+# Playbook — X (Twitter)
+
+## Objetivo
+Mapear padrões de distribuição, narrativa curta e autoridade em threads/posts.
+
+## Checklist de coleta
+- bio e link principal
+- frequência e tipos de post
+- threads: estrutura de abertura/meio/fechamento
+- tweets de maior engajamento (tema e formato)
+- CTA para comunidade/newsletter/produto
+- sinais de networking (respostas, co-criação, menções)
+
+## Extrações para squads
+- Estratégia: narrativa de categoria/opinião
+- Conteúdo: formatos de alto alcance
+- Copy: fórmulas de abertura e fechamento
+- Design: uso de mídia de apoio
+- Growth: loops de distribuição e colaboração
+
+## Entrega
+Salvar evidência como:
+- `_edusquads/evidencias/EVIDENCIA-<run_id>-x.md`

package/base/playbooks/investigacao/youtube.md

@@ -0,0 +1,23 @@
+# Playbook — YouTube
+
+## Objetivo
+Mapear padrões editoriais e de retenção em canal/vídeo.
+
+## Checklist de coleta
+- proposta do canal (banner, about, playlists)
+- padrão de títulos e thumbs
+- frequência e temas recorrentes
+- estrutura narrativa dos vídeos mais vistos
+- CTA de inscrição/oferta/comunidade
+- sinais de funil (descrição, links, lead magnet)
+
+## Extrações para squads
+- Estratégia: categoria e narrativa dominante
+- Conteúdo: formatos que geram tração
+- Copy: construção de títulos e promessas
+- Design: linguagem visual de thumb
+- Comercial/Oferta: pontos de entrada no funil
+
+## Entrega
+Salvar evidência como:
+- `_edusquads/evidencias/EVIDENCIA-<run_id>-youtube.md`

package/base/protocolo-memoria-usuario.md

@@ -0,0 +1,50 @@
+# Protocolo de Memória do Usuário (EduSquads)
+
+## Objetivo
+Manter uma memória operacional do usuário para personalizar a atuação dos squads no comando `/edusquads`.
+
+## Arquivo ativo
+- `_edusquads/memoria/USUARIO-ATIVO.md`
+
+## Quando coletar memória
+1. Primeira execução do `/edusquads` no projeto
+2. Quando o usuário pedir atualização de contexto pessoal/profissional
+3. Quando houver mudança relevante de nicho, objetivo ou estilo
+
+## Campos mínimos
+- nome preferido
+- projeto/negócio principal
+- nicho
+- público-alvo
+- objetivos atuais
+- canais prioritários
+- stack/ferramentas
+- restrições (tempo, orçamento, equipe)
+- estilo de comunicação preferido
+- decisões já tomadas
+
+## Princípios
+- coletar apenas dados úteis para execução
+- resumir em linguagem operacional
+- separar fato de inferência
+- nunca registrar segredos/token/senhas na memória
+
+## Formato de atualização
+Sempre atualizar por bloco:
+1. `## Estado atual`
+2. `## Objetivos em andamento`
+3. `## Preferências`
+4. `## Restrições`
+5. `## Histórico de decisões`
+
+## Regras de uso no comando
+- antes de planejar squads, ler `USUARIO-ATIVO.md`
+- se campos críticos estiverem vazios, perguntar objetivamente
+- toda recomendação deve refletir esse contexto
+
+## Campos críticos (não seguir sem isso)
+- nicho
+- público-alvo
+- objetivo principal
+- canal principal
+- oferta principal (ou hipótese de oferta)

package/base/protocolo-playwright-edusquads.md

@@ -0,0 +1,48 @@
+# Protocolo Playwright do EduSquads
+
+## Objetivo
+Habilitar investigação web e coleta de evidências no fluxo `/edusquads`, com comportamento semelhante ao OpenSquad, mantendo segurança e rastreabilidade.
+
+## Estrutura de diretórios
+- `_edusquads/browser_profile/` → sessão persistida (cookies/storage local)
+- `_edusquads/evidencias/` → capturas e extrações por execução
+- `_edusquads/playwright/` → artefatos operacionais e instruções de execução
+
+## Comandos semânticos
+- `/edusquads investigar <url|perfil>`
+- `/edusquads login <plataforma>`
+- `/edusquads revogar-sessoes`
+
+## Fluxo operacional
+1. Ler memória do usuário (`_edusquads/memoria/USUARIO-ATIVO.md`).
+2. Definir objetivo de investigação (o que extrair e por quê).
+3. Executar navegação controlada via Playwright.
+4. Coletar evidências (print + síntese + links).
+5. Salvar evidências em `_edusquads/evidencias/`.
+6. Registrar no run ativo em `_edusquads/runs/`.
+
+## Consentimento e privacidade
+- Nunca persistir sessão sem consentimento explícito da pessoa usuária.
+- Antes de salvar sessão: pedir confirmação objetiva.
+- Se usuário negar, sessão é temporária e deve ser descartada ao final.
+- Nunca registrar credenciais, tokens, senhas ou cookies em arquivos markdown.
+
+## Escopo de acesso
+- Navegar apenas nos URLs necessários ao objetivo declarado.
+- Evitar exploração ampla sem justificativa operacional.
+- Registrar no run os domínios visitados.
+
+## Formato mínimo de evidência
+Cada investigação deve gerar um arquivo em `_edusquads/evidencias/` com:
+- data
+- objetivo da investigação
+- query/entrada usada
+- links visitados
+- síntese interpretativa
+- limites da evidência
+
+## Critérios de qualidade
+- relevância: evidências ligadas ao objetivo
+- rastreabilidade: links e data registrados
+- segurança: sem segredos vazados
+- utilidade: síntese acionável para os squads seguintes