@pixeleducacao/curso-openclaw 2026.5.8

package/assets/skills/starter/wizard-agente/evals/evals.json

@@ -0,0 +1,204 @@
+{
+  "skill": "wizard-agente",
+  "version": "1.0",
+  "description": "4 cenários cobrindo: criação do zero, detecção de pré-existente, parcial, comando exemplo durante",
+  "scenarios": [
+    {
+      "id": "criacao-do-zero",
+      "name": "Caminho feliz — sem nada pré-existente",
+      "description": "Aluno chega ao passo 1 com workspace limpo. Faz entrevista, cria os 3 arquivos.",
+      "setup": {
+        "workspace_state": "sem IDENTITY, SOUL, AGENTS",
+        "memory_flags": {
+          "kit_intro_done": true,
+          "whisper_configured": true,
+          "onboarding_current_step": 1
+        }
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado pela onboarding-checklist]",
+          "expected_agent_behavior": [
+            "executa Princípio 11 — checa IDENTITY, SOUL, AGENTS",
+            "encontra todos ausentes",
+            "narra promessa do passo (4min, 3 arquivos, SOUL stub)",
+            "começa entrevista pela pergunta 1 (nome)"
+          ]
+        },
+        {
+          "user": "Atlas",
+          "expected_agent_behavior": [
+            "salva nome_agente=Atlas",
+            "vai pra pergunta 2 (gênero)"
+          ]
+        },
+        {
+          "user": "neutro",
+          "expected_agent_behavior": [
+            "salva genero=neutro",
+            "vai pra pergunta 3 (tom)"
+          ]
+        },
+        {
+          "user": "casual + direto + brasileiro",
+          "expected_agent_behavior": [
+            "salva tom",
+            "vai pra pergunta 4 (anti-pattern)"
+          ]
+        },
+        {
+          "user": "nunca usa linguagem de coach",
+          "expected_agent_behavior": [
+            "mostra resumo de tudo que vai criar",
+            "pede confirmação antes de criar arquivos"
+          ],
+          "must_not": [
+            "criar arquivos sem mostrar resumo",
+            "criar arquivos sem aluno confirmar"
+          ]
+        },
+        {
+          "user": "vai",
+          "expected_agent_behavior": [
+            "checa Princípio 1 (backup) — não tem nada existente, pula backup",
+            "cria IDENTITY.md, SOUL.md (stub), AGENTS.md a partir dos templates",
+            "substitui placeholders ({NOME_AGENTE}=Atlas, etc)",
+            "confirma criação com tamanhos",
+            "roda pergunta-âncora"
+          ]
+        },
+        {
+          "user": "automático",
+          "expected_agent_behavior": [
+            "valida resposta correta",
+            "menciona aula B1 + grupo",
+            "marca agente_configured=true",
+            "atualiza onboarding_current_step=2",
+            "devolve controle pra onboarding-checklist"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "IDENTITY, SOUL, AGENTS criados com placeholders substituídos",
+        "agente_configured=true em MEMORY.md",
+        "decisão (nome, gênero, tom, anti-pattern) registrada",
+        "onboarding_current_step=2",
+        "aula B1 mencionada"
+      ]
+    },
+    {
+      "id": "ja-configurado-detecta-e-pula",
+      "name": "Aluno já tem os 3 arquivos preenchidos",
+      "description": "Cenário comum quando aluno seguiu aula B1 antes do kit, ou rodou wizard antes em sessão anterior.",
+      "setup": {
+        "workspace_state": "IDENTITY+SOUL+AGENTS preenchidos",
+        "memory_flags": {}
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado pela onboarding-checklist]",
+          "expected_agent_behavior": [
+            "lê IDENTITY.md, SOUL.md, AGENTS.md",
+            "valida que estão preenchidos (não placeholder)",
+            "narra '✓ Detectei seu agente já configurado: nome={extraído}, etc'",
+            "NÃO faz entrevista",
+            "NÃO sobrescreve nada",
+            "vai direto pra pergunta-âncora"
+          ],
+          "must_not": [
+            "sobrescrever arquivos existentes",
+            "fazer entrevista",
+            "duplicar info no MEMORY"
+          ]
+        },
+        {
+          "user": "automático",
+          "expected_agent_behavior": [
+            "valida, marca agente_configured=true",
+            "decisões já existem no MEMORY (preserva, não duplica)"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "wizard rodou em <30s",
+        "0 arquivos modificados",
+        "agente_configured=true sem fazer entrevista"
+      ]
+    },
+    {
+      "id": "parcial-tem-identity-falta-resto",
+      "name": "Workspace parcial — IDENTITY existe mas SOUL/AGENTS não",
+      "description": "Aluno criou IDENTITY manual mas parou. Wizard completa o que falta.",
+      "setup": {
+        "workspace_state": "IDENTITY existe e preenchido, SOUL e AGENTS ausentes",
+        "memory_flags": {}
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado pela onboarding-checklist]",
+          "expected_agent_behavior": [
+            "detecção: IDENTITY ✓, SOUL ⏳, AGENTS ⏳",
+            "lê nome, gênero etc do IDENTITY existente",
+            "narra estado parcial: '✓ IDENTITY pronto, vou criar SOUL e AGENTS sem mexer no IDENTITY'",
+            "pula perguntas que já tem resposta no IDENTITY",
+            "pergunta só tom + anti-pattern (pra SOUL)"
+          ],
+          "must_not": [
+            "modificar IDENTITY existente",
+            "perguntar nome/gênero (já tem)"
+          ]
+        },
+        {
+          "user": "casual / nunca abre com Ótima pergunta",
+          "expected_agent_behavior": [
+            "cria SOUL.md (stub) e AGENTS.md",
+            "preserva IDENTITY",
+            "pergunta-âncora",
+            "marca configurado"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "IDENTITY.md NÃO foi modificado",
+        "SOUL e AGENTS criados",
+        "agente_configured=true"
+      ]
+    },
+    {
+      "id": "comando-exemplo-meio-entrevista",
+      "name": "Aluno trava na pergunta de tom e pede exemplo",
+      "description": "Testa que comando exemplo carrega trecho da Amora e volta pra pergunta sem perder contexto.",
+      "setup": {
+        "workspace_state": "limpo",
+        "memory_flags": {}
+      },
+      "interaction_flow": [
+        {
+          "user": "[entrevista no momento da pergunta sobre tom]",
+          "expected_agent_behavior": ["pergunta sobre tom"]
+        },
+        {
+          "user": "exemplo",
+          "expected_agent_behavior": [
+            "carrega seção Tom de exemplos/SOUL-amora.md",
+            "mostra com header 'esse é o jeito que a Amora fala'",
+            "lembra que não é pra copiar",
+            "volta pra pergunta original ('agora que viu, me manda como o {nome} fala')"
+          ]
+        },
+        {
+          "user": "casual mas não corporativo, fala como amigo de boteco",
+          "expected_agent_behavior": [
+            "salva tom",
+            "vai pra próxima pergunta normalmente"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "exemplo foi mostrado",
+        "fluxo voltou pra pergunta sem reset",
+        "tom_agente foi salvo no final"
+      ]
+    }
+  ]
+}

package/assets/skills/starter/wizard-aluno/SKILL.md

@@ -0,0 +1,353 @@
+---
+name: wizard-aluno
+status: ATIVO
+category: starter
+owner: aluno
+version: 1.0
+mode: guided
+estimated_time: 3min (ou 30s se já configurado)
+model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4, gemini-pro]
+description: Use when student types "configura usuário" / "cria meu perfil" / "USER.md", OR when dispatched by onboarding-checklist as passo 2. Creates USER.md with student's basic info (nome, timezone, o que faz, tom preferido). Detects existing USER.md first (Princípio 11). Templates Amora opt-in via "exemplo". Pergunta-âncora: "onde isso ficou salvo? edit direto pega automático?".
+---
+
+# Wizard Aluno — Passo 2 (Personalidade do aluno)
+
+## Promessa
+
+Em 3 minutos, agente passa a saber quem é o aluno: nome real, timezone, o que faz, jeito de falar preferido. 1 arquivo (`USER.md`) que o agente lê toda mensagem.
+
+A diferença prática: agente para de te chamar de "aluno" / "usuário" / nada. Começa a chamar pelo seu nome, ajustar tom, considerar seu contexto profissional.
+
+## Quando disparar
+
+**Trigger automático:**
+- `onboarding-checklist` despacha como passo 2
+
+**Trigger explícito (standalone):**
+- "configura usuário"
+- "cria meu perfil"
+- "preenche USER"
+- "muda quem eu sou"
+
+**NÃO disparar se:**
+- `aluno_configured=true` em `MEMORY.md` E `USER.md` existe com `nome` preenchido (não-placeholder)
+
+Se aluno mandar trigger explícito mesmo já configurado:
+
+```
+"Você já configurou seu perfil em {data}. Quer:
+a) Refazer do zero (backup do atual antes)
+b) Editar trecho específico (manda 'muda meu nome', 'muda tom', etc)
+c) Cancelar"
+```
+
+## Princípio 11 — Detecção antes de pedir
+
+```
+1. USER.md existe?
+   - Sim e tem campo `nome:` ou `Nome:` preenchido com valor real: ✓
+   - Sim mas placeholder ou vazio: ⏳ tratar como nada
+   - Não: ⏳
+```
+
+### 3 estados detectáveis
+
+| Estado | Ação |
+|---|---|
+| **Preenchido** | "✓ Detectei seu USER.md já preenchido (nome: {nome_extraído}). Não vou mexer. Vou direto pra pergunta-âncora." |
+| **Existe mas placeholder** | Tratar como "nada feito", avisar: "Detectei USER.md mas tá com placeholders ainda — vou completar agora" |
+| **Nada feito** | Fluxo normal |
+
+## Fluxo principal (entrevista)
+
+### 1. Narrar promessa
+
+```
+"Vamos configurar a SUA personalidade — quem você é. 3min, 1 arquivo.
+
+USER.md vai ter o básico de você: nome, timezone, o que você faz,
+como prefere que eu fale com você.
+
+Esse arquivo eu leio toda vez que vou responder. Se editar lá direto
+depois, muda na hora. Você sempre tem controle do que eu sei sobre você.
+
+Vou te perguntar 4 coisas. Se travar em alguma, manda 'exemplo' que
+mostro como o Bruno Okamoto fez."
+```
+
+### 2. Pergunta 1 — Nome e como chamar
+
+```
+"Qual seu nome completo? E como você quer que eu te chame?
+
+Ex:
+- Carlos Eduardo Silva → me chama de Carlos
+- Bianca → me chama de Bia
+- Rodrigo Pereira → Rodrigo (formal mesmo)
+"
+```
+
+Salvar `nome_completo` + `como_chamar`.
+
+### 3. Pergunta 2 — Timezone / cidade
+
+```
+"Onde você mora? (Cidade + país já basta)
+
+Isso me ajuda a saber se 'amanhã 9h' são 9h da manhã pra você
+ou outro fuso. E pra contextualizar 'tá frio', 'final de semana
+chovendo', etc."
+```
+
+Inferir timezone:
+- Curitiba/SP/RJ/Brasil → America/Sao_Paulo (UTC-3)
+- Lisboa/Portugal → Europe/Lisbon (UTC+0/+1)
+- NYC/EUA → America/New_York
+- etc
+
+Se cidade ambígua (ex: "Belo Horizonte" — pode ser BH-Brasil ou ES-EUA), perguntar.
+
+Salvar `cidade` + `timezone`.
+
+### 4. Pergunta 3 — O que você faz
+
+```
+"Em 1 frase: o que você faz?
+
+Não precisa ser cargo formal. Pode ser projeto, área, contexto.
+
+Exemplos:
+- 'Dono de padaria pequena em Curitiba'
+- 'Designer freelancer pra startups SaaS'
+- 'Médico cardiologista, consultório próprio'
+- 'Estudo medicina, no 4° ano, USP'
+- 'Founder de agência de marketing em Lisboa'
+- 'Aposentado, mas crio conteúdo de jardinagem'
+
+Pode mandar mais que 1 frase se tiver contexto importante."
+```
+
+Salvar `o_que_faz`.
+
+### 5. Pergunta 4 — Tom preferido
+
+```
+"Como você quer que eu fale com você?
+
+3 dimensões:
+
+1) Quão direto?
+   - Bem direto: 'isso aqui tá errado, faz X'
+   - Cuidadoso: 'sugiro considerar X'
+
+2) Quão técnico?
+   - Técnico: assume que você sabe os termos da sua área
+   - Explicado: explico contexto, não assumo
+
+3) Quão pessoal?
+   - Mais formal: 'você' / linguagem profissional
+   - Mais informal: 'tu', gírias, jargão de internet
+
+Manda em 1 frase ou descreve do seu jeito."
+```
+
+Salvar `tom_preferido`.
+
+### 6. Confirmação
+
+```
+"Vou criar:
+
+📄 USER.md
+    Nome: {nome_completo}
+    Como chamar: {como_chamar}
+    Timezone: {timezone} ({cidade})
+    O que faz: {o_que_faz}
+    Tom preferido: {tom_preferido}
+
+Confirma que pode criar?"
+```
+
+### 7. Aplicar Princípio 1 — backup se já existe
+
+```bash
+if [ -f "$WORKSPACE/USER.md" ]; then
+    BACKUP_DIR="$HOME/backups/pre-wizard-aluno-$(date +%Y-%m-%d-%H%M)"
+    mkdir -p "$BACKUP_DIR"
+    cp "$WORKSPACE/USER.md" "$BACKUP_DIR/"
+fi
+```
+
+### 8. Criar USER.md a partir de template
+
+Template em `starter-kit/templates/USER.template.md`. Substituir placeholders:
+
+| Placeholder | Substitui por |
+|---|---|
+| `{NOME_COMPLETO}` | `nome_completo` |
+| `{COMO_CHAMAR}` | `como_chamar` |
+| `{CIDADE}` | `cidade` |
+| `{TIMEZONE}` | `timezone` |
+| `{IDIOMA}` | inferir do timezone (BR → "Português brasileiro", PT → "Português europeu", US → "English (American)") |
+| `{O_QUE_FAZ}` | `o_que_faz` |
+| `{TOM_PREFERIDO}` | `tom_preferido` |
+| `{DATA}` | data atual |
+
+Salvar em `$WORKSPACE/USER.md`.
+
+Confirmar:
+
+```
+"✓ Criado: /workspace/USER.md ({tamanho} bytes)
+
+A partir de agora, em vez de te chamar de 'aluno', vou te chamar
+de {como_chamar}. Considerando o que você faz ({o_que_faz_resumido}),
+e seu tom preferido ({tom_preferido_resumido}).
+
+Você pode abrir o USER.md em qualquer momento e editar direto.
+Eu uso a versão atual sempre — não tem cache."
+```
+
+### 9. Pergunta-âncora
+
+```
+"Rapidão antes de fechar este passo: você acabou de me passar
+várias coisas sobre você. Onde isso ficou salvo? E se você editar
+lá direto, eu pego?"
+```
+
+| Resposta esperada | Validação |
+|---|---|
+| "USER.md" / "no workspace" + "sim, automático" | "Isso. USER.md no seu workspace. Mesma regra do IDENTITY: edit lá = mudança imediata aqui." |
+| Só primeira parte (não menciona automatic) | "Quase. Sim, USER.md. E sim — edit direto pega na hora seguinte. Não precisa me avisar." |
+| Errou ambas | "USER.md no seu workspace. Mesma regra do IDENTITY: edit direto, mudança imediata. Você sempre tem controle do que eu sei sobre você." |
+
+Fechar com:
+
+```
+"Se quer aprofundar como o agente usa USER.md (e qual a diferença
+pra MEMORY.md), a aula que detalha isso é a *B1* (Identidade
+completa) — manda 'aula B1' que eu te passo o link.
+
+E se ficou alguma dúvida que eu não cobri, dois caminhos no grupo:
+- resposta rápida 24/7: chama @Openclawzinho (bot IA) no tópico Suporte
+- ajuda humana: pergunta nos outros tópicos
+https://t.me/cursoopenclaw
+
+Marquei o passo 2 como feito. Bora pro passo 3 (liberar autonomia
+pra eu trabalhar sem te interromper a cada coisa)?"
+```
+
+### 10. Atualizar MEMORY.md
+
+```markdown
+## Flags
+aluno_configured: true
+nome_aluno: {como_chamar}
+
+## Decisões da jornada
+- {data}: Configurou USER. Nome: {nome_completo}. Cidade: {cidade}. Faz: {o_que_faz}. Tom: {tom_resumo}.
+```
+
+Atualizar `onboarding_current_step: 3`.
+
+### 11. Devolver controle
+
+## Comando "exemplo" durante este wizard
+
+Se aluno mandar "exemplo":
+
+| Pergunta atual | Carrega |
+|---|---|
+| Nome | `exemplos/USER-amora.md` linhas 1-15 (cabeçalho) |
+| Timezone | `exemplos/USER-amora.md` linhas 11-15 |
+| O que faz | `exemplos/USER-amora.md` seção "Quem é o Bruno" + "Negócios Atuais" |
+| Tom | `exemplos/USER-amora.md` seção "Tom e Voz" |
+| Outros (genérico) | Mostra o arquivo inteiro |
+
+Header padrão ao mostrar:
+
+```
+"Esse é o USER.md do Bruno Okamoto, que a Amora consulta. É um
+exemplo de USER.md MADURO — Bruno usou o agente por meses e foi
+adicionando contexto.
+
+Você não precisa começar tão completo. Manda o básico agora — pode
+expandir depois. Aula B1 ensina a expandir.
+
+Volta pra pergunta: {repetir pergunta original}"
+```
+
+## Critérios de sucesso
+
+- [ ] `USER.md` criado com `nome`, `como_chamar`, `timezone`, `o_que_faz`, `tom_preferido` preenchidos (sem placeholders)
+- [ ] Backup feito se `USER.md` já existia
+- [ ] `aluno_configured=true` em `MEMORY.md`
+- [ ] `nome_aluno` salvo em `MEMORY.md` (pra outros wizards usarem)
+- [ ] `onboarding_current_step=3`
+- [ ] Pergunta-âncora respondida + validada
+- [ ] Aula B1 mencionada
+
+## Erros comuns
+
+- **Aluno responde "qualquer coisa" pra tom:** insistir mais 1x. "Sério: 1 frase de como você quer que eu fale. Sem isso, eu vou no tom default (que tende ao corporativo). Manda algo tipo 'fala como amigo' ou 'fala formal mas sem rodeios'."
+- **Aluno mistura USER com SOUL:** explicar diferença. "USER.md é sobre VOCÊ — quem é, o que faz. SOUL.md é sobre o AGENTE — como ele pensa e fala. Os 2 são diferentes."
+- **Aluno não quer dar nome real:** ok, aceita. "Beleza, vou te chamar de {apelido}. USER.md preserva privacidade — tudo que você manda fica só no SEU workspace, não vaza."
+- **Aluno descreve cidade ambígua:** perguntar (ex: "Belo Horizonte do Brasil ou EUA?"). Não assumir.
+- **Aluno tem contexto profissional complexo (ex: 3 negócios):** ok, deixa ele descrever em 2-3 frases. USER.md aceita contexto rico — modelo lê tudo.
+
+## Aplicação dos princípios defensivos
+
+Esta skill herda os princípios universais da `onboarding-checklist`. Ver: [`../onboarding-checklist/references/principios-defensivos.md`](../onboarding-checklist/references/principios-defensivos.md).
+
+### Aplicação específica
+
+- **Princípio 1 (backup antes de sobrescrever):** se `USER.md` existir, backup timestamped antes.
+- **Princípio 2 (confirmação humana):** confirma antes de criar arquivo.
+- **Princípio 4 (narrar antes de fazer):** explica os 4 campos antes de perguntar.
+- **Princípio 5 (atualizar MEMORY ao concluir):** marca `aluno_configured=true` + `nome_aluno`.
+- **Princípio 6 (respeitar customização manual):** se USER.md já tem campo preenchido, NÃO sobrescreve sem perguntar.
+- **Princípio 8 (logging de decisões):** salva escolhas no MEMORY.
+- **Princípio 11 (detectar antes de pedir):** lê USER.md primeiro. Se preenchido, pula entrevista.
+
+## Modo A vs Modo B
+
+**Modo A:**
+```
+"Bora pro Módulo 2 — Sua personalidade.
+Aula correspondente: B1 (Identidade completa) — mesma da personalidade do agente.
+Reforço: assista a B1 antes pra entender como agente USA o USER.md."
+[entrevista numerada 1/4, 2/4...]
+```
+
+**Modo B:**
+```
+"Agora você. Quem é? 4 coisas — nome, onde mora, o que faz, jeito
+que prefere que eu fale com você."
+[fluído, sem numeração]
+```
+
+## Templates usados
+
+- `USER.template.md` em `starter-kit/templates/`
+
+## Referências
+
+### Internas
+- Princípios: [`../onboarding-checklist/references/principios-defensivos.md`](../onboarding-checklist/references/principios-defensivos.md)
+- Comandos: [`../onboarding-checklist/references/comandos-canonicos.md`](../onboarding-checklist/references/comandos-canonicos.md)
+- Pergunta-âncora oficial: [`../onboarding-checklist/references/mapa-aulas.md`](../onboarding-checklist/references/mapa-aulas.md) (passo 2)
+- Decisão D21 (separar agente vs aluno em 2 wizards): [`../../../../DECISOES-ARQUITETURA.md`](../../../../DECISOES-ARQUITETURA.md)
+
+### Externas
+- Exemplo Amora: [`starter-kit/exemplos/USER-amora.md`](../../../exemplos/USER-amora.md)
+
+## Status
+
+✅ ATIVO desde v1 do Starter Kit (02/05/2026).
+
+## Roadmap
+
+- v1.1: Detectar timezone via locale do sistema operacional como fallback
+- v1.2: Pergunta opcional sobre família/contexto pessoal (com aviso de privacidade)
+- v2: Multi-perfil — "perfil profissional" e "perfil pessoal" em USER.md