edusquads-cli 0.2.1 → 0.2.2

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

@@ -87,10 +87,14 @@ Operar squads multiagente no Claude Code com comportamento semelhante ao OpenSqu
 - Toda saída deve conter critério de qualidade.
 
 ## Memória do usuário (obrigatório)
-### Arquivo
-- `_edusquads/memoria/USUARIO-ATIVO.md`
+### Arquivos
+- ativo: `_edusquads/memoria/USUARIO-ATIVO.md`
+- modelo: `_edusquads/memoria/USUARIO-MODELO.md`
+- perfis: `_edusquads/memoria/usuarios/<slug>.md`
 
 ### Campos críticos
+- nome preferido
+- projeto/negócio
 - nicho
 - público-alvo
 - objetivo principal
@@ -99,9 +103,19 @@ Operar squads multiagente no Claude Code com comportamento semelhante ao OpenSqu
 
 ### 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.
+2. Se campo crítico faltar, iniciar onboarding de briefing completo.
+3. Salvar briefing no perfil individual (`usuarios/<slug>.md`).
+4. Atualizar `USUARIO-ATIVO.md` com o briefing coletado.
+5. Só então propor plano de squads.
+
+### Roteiro de briefing obrigatório
+1. identidade da pessoa (nome, papel)
+2. negócio/oferta principal
+3. público-alvo e nicho
+4. objetivo principal (30-90 dias)
+5. canais e formato preferido
+6. restrições (tempo, equipe, orçamento)
+7. stack, ativos e dados disponíveis
 
 ## Modo de comando `/edusquads`
 Interpretar intenção do usuário por subcomando semântico.
@@ -110,9 +124,11 @@ Interpretar intenção do usuário por subcomando semântico.
 - 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.
+- Inicia onboarding do usuário.
+- Coleta briefing completo e salva perfil + usuário ativo.
+
+### `/edusquads onboarding`
+- Força nova coleta de briefing para troca/atualização de usuário.
 
 ### `/edusquads status`
 - Resume estado atual: memória, squads sugeridos, artefatos-chave.

package/README.md

@@ -29,8 +29,13 @@ 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 e grava a memória automaticamente.
+
+
 Depois da instalação, abra o projeto no Claude Code e use:
 
 - `/edusquads`
@@ -43,7 +48,7 @@ Como o Claude Code suporta skills em `.claude/skills/<nome>/SKILL.md`, a skill `
 - `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/memoria/`: memória operacional do usuário (ativo + perfis em `usuarios/`)
 - `_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

package/_edusquads/memoria/USUARIO-ATIVO.md

@@ -1,42 +1,40 @@
 # Memória do Usuário Ativo
 
 ## Identidade
-- Nome preferido: não informado
-- Projeto/negócio: EduSquads
-- Papel do usuário: arquiteto/produto do framework
+- Nome preferido:
+- Projeto/negócio:
+- Papel do usuário:
 
 ## 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)
+- Nicho principal:
+- Público-alvo:
+- Oferta principal:
+- Maturidade da operação (inicial/intermediária/avançada):
 
 ## 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
+- Objetivo principal (30-90 dias):
+- Objetivo secundário:
+- KPI principal:
 
 ## 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
+- Canais prioritários:
+- Estilo de comunicação:
+- Formato de entrega preferido:
 
 ## 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`
+- Tempo disponível:
+- Equipe disponível:
+- Orçamento aproximado:
+- Limites operacionais:
 
 ## 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
+- Ferramentas atuais:
+- Ativos existentes (lista/email/site/perfis):
+- Dados disponíveis:
 
 ## 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
+- Data:
+- Origem da atualização:

package/base/comandos/edusquads-comandos.md

@@ -6,7 +6,10 @@
 
 ## Subcomandos semânticos (via args)
 - `/edusquads init`
-  - inicializa memória do usuário e contexto do projeto
+  - inicia onboarding e coleta briefing completo da pessoa usuária
+  - salva perfil em `_edusquads/memoria/usuarios/` e atualiza `USUARIO-ATIVO.md`
+- `/edusquads onboarding`
+  - força nova coleta de briefing para troca/atualização de usuário
 - `/edusquads status`
   - resume estado dos squads, memória e artefatos
 - `/edusquads memoria`
@@ -28,13 +31,18 @@
   - inicia fluxo de autenticação manual para sessão Playwright
 - `/edusquads revogar-sessoes`
   - remove sessão local persistida em `_edusquads/browser_profile/`
+- `/edusquads estruturar-coleta <run_id>`
+  - converte coleta bruta em sinais estruturados por plataforma
+  - usa `python base/scripts/edusquads_estruturar_coleta.py`
 - `/edusquads concluir-investigacao <run_id>`
   - preenche síntese/extrações automaticamente e fecha run
   - usa `python base/scripts/edusquads_concluir_investigacao.py`
 
 ## Regras
 - todos os subcomandos usam `_edusquads/memoria/USUARIO-ATIVO.md`
-- se memória crítica estiver vazia, coletar antes de executar o plano
+- onboarding é obrigatório quando memória crítica estiver vazia
+- onboarding pode ser executado por `base/scripts/edusquads_onboarding_memoria.py`
+- onboarding deve salvar perfil em `_edusquads/memoria/usuarios/` e atualizar `USUARIO-ATIVO.md`
 - cada execução relevante deve gerar/atualizar um run em `_edusquads/runs/`
 - toda investigação web deve seguir `base/protocolo-playwright-edusquads.md`
 - toda investigação web deve aplicar o playbook da plataforma em `base/playbooks/investigacao/`
@@ -42,5 +50,4 @@
 - para estruturar coleta, usar `base/scripts/edusquads_estruturar_coleta.py`
 - para fechar investigação, usar `base/scripts/edusquads_concluir_investigacao.py`
 - nunca persistir sessão sem consentimento explícito
-- decisões relevantes devem ser registradas na seção de histórico da memória e no run ativo
-ões relevantes devem ser registradas na seção de histórico da memória e no run ativo
+- decisões relevantes devem ser registradas na memória e no run ativo

package/base/protocolo-memoria-usuario.md

@@ -1,27 +1,17 @@
 # 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`.
+Manter uma memória operacional da pessoa usuária para personalizar a atuação dos squads no comando `/edusquads`.
 
-## Arquivo ativo
-- `_edusquads/memoria/USUARIO-ATIVO.md`
+## Arquivos de memória
+- ativo: `_edusquads/memoria/USUARIO-ATIVO.md`
+- modelo: `_edusquads/memoria/USUARIO-MODELO.md`
+- perfis por pessoa: `_edusquads/memoria/usuarios/<slug>.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
+3. Quando houver troca de usuário ou mudança relevante de nicho/objetivo/estilo
 
 ## Princípios
 - coletar apenas dados úteis para execução
@@ -29,22 +19,37 @@ Manter uma memória operacional do usuário para personalizar a atuação dos sq
 - 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
+- se campos críticos estiverem vazios, executar onboarding (briefing completo)
+- salvar briefing no perfil individual e atualizar o usuário ativo
 - toda recomendação deve refletir esse contexto
 
 ## Campos críticos (não seguir sem isso)
+- nome preferido
+- projeto/negócio
 - nicho
 - público-alvo
 - objetivo principal
 - canal principal
 - oferta principal (ou hipótese de oferta)
+
+## Roteiro obrigatório de briefing (onboarding)
+1. Quem é a pessoa e qual papel dela no projeto
+2. Qual é o negócio/oferta principal
+3. Quem é o público-alvo e qual nicho
+4. Qual é o objetivo principal nos próximos 30-90 dias
+5. Quais canais e formatos de entrega priorizar
+6. Quais restrições de tempo/equipe/orçamento existem
+7. Quais ferramentas, ativos e dados já existem
+
+## Formato de atualização
+Sempre atualizar por bloco:
+1. `## Identidade`
+2. `## Estado atual`
+3. `## Objetivos em andamento`
+4. `## Preferências`
+5. `## Restrições`
+6. `## Stack e ativos`
+7. `## Histórico de decisões`
+8. `## Última atualização`

package/base/scripts/edusquads_onboarding_memoria.py

@@ -0,0 +1,132 @@
+#!/usr/bin/env python3
+"""
+Onboarding de memória do EduSquads.
+
+Coleta briefing completo no terminal e salva em:
+- _edusquads/memoria/USUARIO-ATIVO.md
+- _edusquads/memoria/usuarios/<slug>.md
+"""
+
+from __future__ import annotations
+
+import argparse
+import datetime as dt
+import re
+from pathlib import Path
+
+
+def ask(prompt: str, required: bool = True) -> str:
+    while True:
+        value = input(f"{prompt}: ").strip()
+        if value or not required:
+            return value
+        print("Campo obrigatório. Preencha para continuar.")
+
+
+def slugify(text: str) -> str:
+    t = text.strip().lower()
+    t = re.sub(r"[^a-z0-9\s-]", "", t)
+    t = re.sub(r"\s+", "-", t)
+    t = re.sub(r"-+", "-", t)
+    return t or "usuario"
+
+
+def render_memory(data: dict, source: str) -> str:
+    today = dt.date.today().isoformat()
+    return f"""# Memória do Usuário Ativo
+
+## Identidade
+- Nome preferido: {data['nome']}
+- Projeto/negócio: {data['projeto']}
+- Papel do usuário: {data['papel']}
+
+## Estado atual
+- Nicho principal: {data['nicho']}
+- Público-alvo: {data['publico']}
+- Oferta principal: {data['oferta']}
+- Maturidade da operação (inicial/intermediária/avançada): {data['maturidade']}
+
+## Objetivos em andamento
+- Objetivo principal (30-90 dias): {data['objetivo_principal']}
+- Objetivo secundário: {data['objetivo_secundario']}
+- KPI principal: {data['kpi']}
+
+## Preferências
+- Canais prioritários: {data['canais']}
+- Estilo de comunicação: {data['estilo']}
+- Formato de entrega preferido: {data['formato_entrega']}
+
+## Restrições
+- Tempo disponível: {data['tempo']}
+- Equipe disponível: {data['equipe']}
+- Orçamento aproximado: {data['orcamento']}
+- Limites operacionais: {data['limites']}
+
+## Stack e ativos
+- Ferramentas atuais: {data['ferramentas']}
+- Ativos existentes (lista/email/site/perfis): {data['ativos']}
+- Dados disponíveis: {data['dados']}
+
+## Histórico de decisões
+- [x] briefing inicial coletado no onboarding
+
+## Última atualização
+- Data: {today}
+- Origem da atualização: {source}
+"""
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Onboarding de memória EduSquads")
+    parser.add_argument("--target", default=".", help="Diretório do projeto")
+    args = parser.parse_args()
+
+    root = Path(args.target).resolve()
+    mem_dir = root / "_edusquads" / "memoria"
+    users_dir = mem_dir / "usuarios"
+    mem_dir.mkdir(parents=True, exist_ok=True)
+    users_dir.mkdir(parents=True, exist_ok=True)
+
+    print("\n=== Onboarding EduSquads: briefing do usuário ===\n")
+    print("Preencha de forma objetiva. Isso será usado para personalizar os squads.\n")
+
+    data = {
+        "nome": ask("Nome preferido"),
+        "projeto": ask("Projeto/negócio"),
+        "papel": ask("Papel do usuário (ex: fundador, gestor, creator)"),
+        "nicho": ask("Nicho principal"),
+        "publico": ask("Público-alvo"),
+        "oferta": ask("Oferta principal (produto/serviço)", required=False) or "não informado",
+        "maturidade": ask("Maturidade da operação (inicial/intermediária/avançada)"),
+        "objetivo_principal": ask("Objetivo principal (30-90 dias)"),
+        "objetivo_secundario": ask("Objetivo secundário", required=False) or "não informado",
+        "kpi": ask("KPI principal", required=False) or "não informado",
+        "canais": ask("Canais prioritários", required=False) or "não informado",
+        "estilo": ask("Estilo de comunicação preferido", required=False) or "não informado",
+        "formato_entrega": ask("Formato de entrega preferido", required=False) or "não informado",
+        "tempo": ask("Tempo disponível", required=False) or "não informado",
+        "equipe": ask("Equipe disponível", required=False) or "não informado",
+        "orcamento": ask("Orçamento aproximado", required=False) or "não informado",
+        "limites": ask("Limites operacionais", required=False) or "não informado",
+        "ferramentas": ask("Ferramentas atuais", required=False) or "não informado",
+        "ativos": ask("Ativos existentes (lista/email/site/perfis)", required=False) or "não informado",
+        "dados": ask("Dados disponíveis", required=False) or "não informado",
+    }
+
+    content = render_memory(data, source="onboarding-interativo")
+
+    active_path = mem_dir / "USUARIO-ATIVO.md"
+    active_path.write_text(content, encoding="utf-8")
+
+    slug = slugify(data["nome"])
+    profile_path = users_dir / f"{slug}.md"
+    profile_path.write_text(content, encoding="utf-8")
+
+    print("\n✅ Briefing salvo com sucesso:")
+    print(f"- ativo: {active_path}")
+    print(f"- perfil: {profile_path}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/bin/edusquads.js

@@ -3,11 +3,13 @@
 const fs = require("fs");
 const path = require("path");
 const readline = require("readline");
+const { spawnSync } = require("child_process");
 
 const args = process.argv.slice(2);
 const command = args.find((a) => !a.startsWith("-")) || "install";
 const force = args.includes("--force");
 const dryRun = args.includes("--dry-run");
+const skipOnboarding = args.includes("--skip-onboarding");
 const targetArgIndex = args.findIndex((a) => a === "--target");
 const targetDir =
   targetArgIndex >= 0 && args[targetArgIndex + 1]
@@ -56,6 +58,7 @@ Opções:
                    Se omitido, o CLI pergunta no terminal.
   --force          Sobrescreve arquivos existentes
   --dry-run        Simula instalação sem gravar arquivos
+  --skip-onboarding Não pergunta briefing após instalar
 `);
 }
 
@@ -165,6 +168,34 @@ function ask(promptText) {
   });
 }
 
+async function askOnboarding() {
+  if (skipOnboarding || dryRun) return false;
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
+  const ans = (await ask("Deseja fazer agora o briefing do usuário? (s/N): ")).trim().toLowerCase();
+  return ["s", "sim", "y", "yes"].includes(ans);
+}
+
+function runOnboarding(target) {
+  const script = path.join(target, "base", "scripts", "edusquads_onboarding_memoria.py");
+  if (!fs.existsSync(script)) {
+    console.log("\n⚠️ Script de onboarding não encontrado. Pule e rode manualmente depois.");
+    return;
+  }
+
+  const pyCmd = process.platform === "win32" ? "python" : "python3";
+  const r = spawnSync(pyCmd, [script, "--target", target], {
+    stdio: "inherit",
+    cwd: target,
+    env: process.env,
+  });
+
+  if (r.status !== 0) {
+    console.log("\n⚠️ Não foi possível concluir o onboarding automaticamente.");
+    console.log("Rode manualmente:");
+    console.log(`  ${pyCmd} base/scripts/edusquads_onboarding_memoria.py --target ${target}`);
+  }
+}
+
 async function resolveIdes() {
   if (ideArg) return parseIdes(ideArg);
 
@@ -247,6 +278,12 @@ async function install() {
   console.log(`Arquivos ignorados (já existiam): ${report.skipped}`);
   console.log(`.gitignore atualizado: ${gitignoreChanged ? "sim" : "não"}`);
 
+  const doOnboarding = await askOnboarding();
+  if (doOnboarding) {
+    console.log("\nIniciando onboarding de briefing...\n");
+    runOnboarding(targetDir);
+  }
+
   console.log("\nComandos esperados por IDE (após abrir o projeto na IDE):");
   for (const ide of ides) {
     if (ide === "claude") console.log("- Claude Code: /edusquads");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edusquads-cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Instalador do framework EduSquads para Claude Code via npx.",
   "bin": {
     "edusquads": "bin/edusquads.js"