edusquads-cli 0.2.4 → 0.2.5

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

@@ -55,7 +55,7 @@ Operar squads multiagente no Claude Code com comportamento semelhante ao OpenSqu
 
 ## Fontes
 - `README.md`
-- `CLAUDE.md`
+- `EDUSQUADS-RULES.md`
 - `base/visao-geral.md`
 - `base/matriz-mestre-dos-especialistas.md`
 - `base/matriz-mestre-dos-16-squads.md`
@@ -67,7 +67,7 @@ Operar squads multiagente no Claude Code com comportamento semelhante ao OpenSqu
 
 ## Contexto obrigatório (ordem)
 1. `README.md`
-2. `CLAUDE.md`
+2. `EDUSQUADS-RULES.md`
 3. `base/visao-geral.md`
 4. `base/matriz-mestre-dos-especialistas.md`
 5. `base/matriz-mestre-dos-16-squads.md`
@@ -86,6 +86,8 @@ Operar squads multiagente no Claude Code com comportamento semelhante ao OpenSqu
 - 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.
+- Para carrossel, exigir `APIFY_API_TOKEN` e `UNSPLASH_ACCESS_KEY` antes de gerar copy/HTML.
+- Nunca expor ou persistir API keys em markdown, logs, runs ou evidências.
 
 ## Memória do usuário (obrigatório)
 ### Arquivos
@@ -172,6 +174,11 @@ Interpretar intenção do usuário por subcomando semântico.
 - Conclui investigação: preenche síntese, extrações por squad e atualiza status do run.
 - Executa `python base/scripts/edusquads_concluir_investigacao.py`.
 
+### `/edusquads carrossel <tema>`
+- Gera copy de carrossel e prepara dashboard de personalização.
+- Antes de qualquer geração, exigir `APIFY_API_TOKEN` e `UNSPLASH_ACCESS_KEY`.
+- Não gerar HTML final sem essas credenciais válidas.
+
 ## Motor de seleção de squads
 Ao receber um objetivo, aplicar:
 1. Ler memória ativa.

package/CLAUDE.md

@@ -1,40 +1,6 @@
 # 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
+Este arquivo mantém compatibilidade com Claude Code.
 
-## 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`
+Fonte canônica das regras do projeto:
+- `EDUSQUADS-RULES.md`

package/EDUSQUADS-RULES.md

@@ -0,0 +1,56 @@
+# EDUSQUADS-RULES.md
+
+Regras canônicas do framework EduSquads, válidas para qualquer IDE.
+
+## Convenções do 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]".
+
+## Estrutura obrigatória de agente
+Todo agente deve ter:
+- missão
+- responsabilidades
+- não faz
+- entradas
+- entregas
+- critérios de qualidade
+- fundamento
+- heurísticas
+- anti-padrões
+
+## Estrutura obrigatória de skill
+Toda skill deve ter:
+- objetivo
+- quando usar
+- quando não usar
+- entradas
+- processo
+- saída
+- critérios
+- fontes
+
+## Estrutura obrigatória de pesquisa web
+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, priorizar o uso do skill/comando:
+- `/edusquads`
+
+## Regra obrigatória para carrossel
+Quando a solicitação envolver criação de carrossel:
+- solicitar e validar `APIFY_API_TOKEN` antes de pesquisar tendências/copy
+- solicitar e validar `UNSPLASH_ACCESS_KEY` antes de buscar imagens
+- não gerar HTML final sem credenciais válidas
+- usar coleta segura de segredo quando disponível (nunca pedir chave em markdown)
+- nunca registrar tokens/chaves em arquivos de saída, runs ou evidências

package/README.md

@@ -52,6 +52,7 @@ Depois da instalação, abra o projeto no Claude Code e use:
 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
@@ -71,6 +72,7 @@ Sistema operacional implementado com foco em:
 - 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`)
 - histórico de runs (`_edusquads/runs/`)
 - protocolo de investigação web com Playwright (`base/protocolo-playwright-edusquads.md`)
 - playbooks por plataforma (`base/playbooks/investigacao/`)

package/_edusquads/memoria/USUARIO-MODELO.md

@@ -0,0 +1,31 @@
+# Memória do Usuário Ativo
+
+## Identidade
+- Nome preferido:
+- O que a pessoa faz:
+
+## Negócio e Canal
+- O que vende:
+- Onde vende:
+
+## Meta principal
+- Meta (30-90 dias):
+
+## Público
+- Público inicial (rascunho):
+- ICP prioritário (refinado):
+- Variações de ICP:
+  -
+  -
+  -
+
+## Preferências
+- Formato favorito:
+- Estilo de comunicação preferido:
+
+## Histórico de decisões
+- [ ]
+
+## Última atualização
+- Data:
+- Origem da atualização:

package/_edusquads/memoria/usuarios/README.md

@@ -0,0 +1,15 @@
+# Perfis de Usuário (EduSquads)
+
+Esta pasta armazena perfis individuais de briefing.
+
+## Convenção
+- Um arquivo por pessoa: `<slug-nome>.md`
+- Exemplo: `joao-silva.md`
+
+## Fluxo
+1. Onboarding coleta briefing completo.
+2. Salva perfil em `usuarios/<slug>.md`.
+3. Atualiza `_edusquads/memoria/USUARIO-ATIVO.md` com esse perfil.
+
+## Observação
+- Nunca salvar segredos (tokens/senhas) na memória.

package/base/comandos/edusquads-comandos.md

@@ -52,5 +52,8 @@
 - toda investigação web deve usar (ou refletir) a automação de artefatos `base/scripts/edusquads_investigar.py`
 - para estruturar coleta, usar `base/scripts/edusquads_estruturar_coleta.py`
 - para fechar investigação, usar `base/scripts/edusquads_concluir_investigacao.py`
+- para carrossel, exigir `APIFY_API_TOKEN` e `UNSPLASH_ACCESS_KEY` antes de gerar copy/HTML
 - nunca persistir sessão sem consentimento explícito
+- nunca salvar API keys em markdown, logs, runs ou evidências
 - decisões relevantes devem ser registradas na memória e no run ativo
+emória e no run ativo

package/bin/edusquads.js

@@ -53,6 +53,7 @@ const IDE_SKILL_PATHS = {
 };
 
 const SHARED_INSTALL_ITEMS = [
+  { src: "EDUSQUADS-RULES.md", dest: "EDUSQUADS-RULES.md" },
   { src: "base", dest: "base" },
   { src: "especialistas", dest: "especialistas" },
   { src: "pesquisa", dest: "pesquisa" },

package/carrosseis.md

@@ -10,10 +10,10 @@ Antes de iniciar, **sempre** coletar e validar as credenciais da pessoa usuaria:
 - `UNSPLASH_ACCESS_KEY` (para busca de fotos)
 
 Regras:
-- Nao iniciar roteiro, HTML ou imagens sem essas duas chaves.
+- Nao iniciar roteiro, copy final, HTML ou imagens sem essas duas chaves.
 - Se alguma chave faltar, pausar e pedir a chave primeiro.
+- Sempre usar coleta segura de segredo quando disponivel.
 - Nunca expor a chave em resposta, log, markdown ou print.
-- Quando o ambiente suportar coleta segura, usar fluxo seguro de segredo (ex.: coleta mascarada).
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "edusquads-cli",
-  "version": "0.2.4",
-  "description": "Instalador do framework EduSquads para Claude Code via npx.",
+  "version": "0.2.5",
+  "description": "Instalador do framework EduSquads multi-IDE via npx.",
   "bin": {
     "edusquads": "bin/edusquads.js"
   },
@@ -17,11 +17,14 @@
     "pesquisa",
     "squads",
     "_edusquads/memoria/USUARIO-ATIVO.md",
+    "_edusquads/memoria/USUARIO-MODELO.md",
+    "_edusquads/memoria/usuarios/README.md",
     "_edusquads/runs/RUN-MODELO.md",
     "_edusquads/runs/RUNS-INDEX.md",
     "_edusquads/evidencias/EVIDENCIA-MODELO.md",
     "carrosseis.md",
     "README.md",
+    "EDUSQUADS-RULES.md",
     "CLAUDE.md"
   ],
   "scripts": {