@pixeleducacao/curso-openclaw 2026.5.8

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

@@ -0,0 +1,192 @@
+{
+  "skill": "wizard-aluno",
+  "version": "1.0",
+  "description": "4 cenários cobrindo: criação do zero, USER já preenchido, cidade ambígua, aluno relutante em dar nome real",
+  "scenarios": [
+    {
+      "id": "criacao-do-zero",
+      "name": "Caminho feliz",
+      "description": "Aluno chega ao passo 2 sem USER.md, faz entrevista, cria.",
+      "setup": {
+        "workspace_state": "sem USER.md",
+        "memory_flags": {
+          "aluno_configured": false,
+          "agente_configured": true,
+          "onboarding_current_step": 2
+        }
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado pela onboarding-checklist]",
+          "expected_agent_behavior": [
+            "checa USER.md (não existe)",
+            "narra promessa (3min, 1 arquivo, 4 perguntas)",
+            "pergunta nome"
+          ]
+        },
+        {
+          "user": "Carlos Eduardo Silva. Pode me chamar de Carlos.",
+          "expected_agent_behavior": [
+            "salva nome_completo + como_chamar",
+            "pergunta cidade"
+          ]
+        },
+        {
+          "user": "Curitiba, Brasil",
+          "expected_agent_behavior": [
+            "infere timezone=America/Sao_Paulo",
+            "salva cidade + timezone",
+            "pergunta o que faz"
+          ]
+        },
+        {
+          "user": "tenho uma padaria pequena, 8 funcionários",
+          "expected_agent_behavior": [
+            "salva o_que_faz",
+            "pergunta tom"
+          ]
+        },
+        {
+          "user": "casual, direto, sem formalidade",
+          "expected_agent_behavior": [
+            "salva tom",
+            "mostra resumo, pede confirmação"
+          ]
+        },
+        {
+          "user": "vai",
+          "expected_agent_behavior": [
+            "Princípio 1 (sem backup, não existia)",
+            "cria USER.md com placeholders substituídos",
+            "confirma criação",
+            "roda pergunta-âncora"
+          ]
+        },
+        {
+          "user": "USER.md no workspace, sim automático",
+          "expected_agent_behavior": [
+            "valida resposta",
+            "menciona aula B1 + grupo",
+            "marca aluno_configured=true",
+            "salva nome_aluno=Carlos em MEMORY",
+            "atualiza onboarding_current_step=3",
+            "devolve controle"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "USER.md criado e preenchido",
+        "aluno_configured=true",
+        "nome_aluno=Carlos em MEMORY",
+        "onboarding_current_step=3"
+      ]
+    },
+    {
+      "id": "user-ja-existe-detecta",
+      "name": "USER.md já preenchido",
+      "description": "Aluno fez antes ou seguiu B1 antes do kit. Wizard detecta e pula.",
+      "setup": {
+        "workspace_state": "USER.md preenchido com nome real",
+        "memory_flags": {}
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado pela onboarding-checklist]",
+          "expected_agent_behavior": [
+            "lê USER.md, detecta nome preenchido",
+            "narra '✓ Detectei seu USER.md já preenchido (nome: {extraído})'",
+            "NÃO faz entrevista",
+            "vai direto pra pergunta-âncora",
+            "marca aluno_configured=true"
+          ],
+          "must_not": [
+            "fazer entrevista",
+            "sobrescrever USER.md",
+            "duplicar info no MEMORY"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "wizard rodou em <30s",
+        "0 arquivos modificados",
+        "aluno_configured=true sem entrevista"
+      ]
+    },
+    {
+      "id": "cidade-ambigua",
+      "name": "Aluno mandou cidade ambígua",
+      "description": "Belo Horizonte (Brasil) ou Belo Horizonte (Espírito Santo / EUA?). Wizard pergunta antes de inferir.",
+      "setup": {
+        "workspace_state": "limpo",
+        "memory_flags": {}
+      },
+      "interaction_flow": [
+        {
+          "user": "[entrevista, no momento da cidade]",
+          "expected_agent_behavior": ["pergunta cidade"]
+        },
+        {
+          "user": "Belo Horizonte",
+          "expected_agent_behavior": [
+            "detecta ambiguidade (BH-Brasil vs BH-USA)",
+            "pergunta qual: 'Belo Horizonte do Brasil (MG) ou outro?'",
+            "NÃO assume Brasil silenciosamente"
+          ],
+          "must_not": [
+            "inferir timezone sem confirmar"
+          ]
+        },
+        {
+          "user": "Brasil, Minas Gerais",
+          "expected_agent_behavior": [
+            "salva cidade=Belo Horizonte/MG, timezone=America/Sao_Paulo",
+            "segue pra próxima pergunta"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "cidade ambígua foi confirmada antes de salvar",
+        "timezone correto inferido (UTC-3)"
+      ]
+    },
+    {
+      "id": "aluno-relutante-nome-real",
+      "name": "Aluno não quer dar nome real (privacidade)",
+      "description": "Aluno preocupado com privacidade quer usar apelido/pseudônimo. Wizard respeita sem fricção.",
+      "setup": {
+        "workspace_state": "limpo",
+        "memory_flags": {}
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado, no momento da pergunta de nome]",
+          "expected_agent_behavior": ["pergunta nome completo + como chamar"]
+        },
+        {
+          "user": "prefiro não dar meu nome real, pode me chamar de Lobo",
+          "expected_agent_behavior": [
+            "aceita sem fricção (Princípio 7 — em dúvida, perguntar; aluno foi claro)",
+            "salva como_chamar=Lobo",
+            "explica que USER.md fica só no workspace dele (privacidade preservada)",
+            "deixa nome_completo vazio ou usa 'Lobo' também",
+            "segue pra próxima pergunta normalmente"
+          ],
+          "must_not": [
+            "insistir em nome real",
+            "dar lição de moral sobre privacidade",
+            "marcar como caso problemático"
+          ]
+        },
+        {
+          "user": "Curitiba, Brasil",
+          "expected_agent_behavior": ["fluxo normal, infere timezone, segue"]
+        }
+      ],
+      "success_criteria": [
+        "como_chamar=Lobo respeitado",
+        "aluno_configured=true sem nome real",
+        "explicação sobre privacidade do workspace foi dada"
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,391 @@
+---
+name: wizard-autonomia
+status: ATIVO
+category: starter
+owner: aluno
+version: 1.1
+mode: guided
+estimated_time: 5min (manual no terminal Hostinger + validação)
+model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4, gemini-pro]
+description: Use when student types "libera autonomia" / "ativa yolo" / "configura exec-policy", OR when dispatched by onboarding-checklist as passo 3. Guides student to manually run `openclaw exec-policy preset yolo` in the OpenClaw CLI of the Hostinger panel (Princípio 3 — agent NEVER executes privilege elevation silently). Detects current state first via `openclaw exec-policy show`. Validates that student ran the command before marking complete. Includes step-by-step tutorial of HOW to open the CLI in Hostinger Managed.
+---
+
+# Wizard Autonomia — Passo 3 (Liberar exec-policy yolo)
+
+## Promessa
+
+Em ~5min, aluno transforma "agente que pede aprovação a cada coisinha" em "agente que executa direto e te avisa". Sem isso, a partir do passo 4 (workspace), aluno é interrompido a cada criação de pasta/arquivo/comando.
+
+Este passo é o ÚNICO em que aluno cola comando no terminal manualmente. O agente NÃO executa esses comandos. Razão: Princípio 3 (comandos de elevação de privilégio jamais via agente).
+
+Boa notícia: o terminal NÃO é SSH local. É terminal **web**, dentro do painel da Hostinger. Tutorial passo-a-passo abaixo.
+
+## Quando disparar
+
+**Trigger automático:**
+- `onboarding-checklist` despacha como passo 3
+
+**Trigger explícito (standalone):**
+- "libera autonomia"
+- "ativa yolo"
+- "configura exec-policy"
+- "tira o ask"
+
+**NÃO disparar se:**
+- `autonomia_liberada=true` em `MEMORY.md` E `openclaw exec-policy show` retorna `yolo`
+
+## Princípio 11 — Detecção antes de pedir
+
+Antes de pedir aluno fazer nada, agente lê o estado atual:
+
+```bash
+openclaw exec-policy show
+```
+
+### 3 estados detectáveis
+
+| exec-policy atual | Ação |
+|---|---|
+| `yolo` | "✓ Já liberado. Não precisa fazer nada nesse passo." (vai pra pergunta-âncora) |
+| outro valor (`ask`, default, etc) | Fluxo normal (1 comando) |
+| comando falha (sem CLI no path) | Investigar (provavelmente OpenClaw não instalado ou aluno em path errado) |
+
+### Mensagem padrão ao detectar tudo já liberado
+
+```
+"✓ Detectei que sua autonomia já tá liberada (exec-policy: yolo).
+Eu executo direto e te aviso. Se algo errado, reverto.
+
+Vou direto pra pergunta-âncora.
+
+[pergunta-âncora abaixo]"
+```
+
+## Fluxo principal (modo manual)
+
+### 1. Narrar promessa + por que é manual
+
+```
+"Vamos liberar sua autonomia. Sem isso, a partir do próximo passo
+você vai se irritar — eu vou pedir aprovação a CADA coisa que faço:
+'posso criar essa pasta?', 'posso salvar esse arquivo?', 'posso
+executar esse comando?'.
+
+Com autonomia liberada (modo yolo), eu executo direto e te aviso ao
+final. Se algo errado, reverto.
+
+Atenção importante: ESSE passo você faz manual. Eu te passo 1 comando,
+você cola no terminal web do Managed e roda.
+
+Por que manual? Segurança. Comando que aumenta minha permissão
+não pode partir de mim — esse design protege você se eu fosse
+hackeado. Você tem palavra final.
+
+É reversível: a qualquer momento você roda `openclaw exec-policy reset`
+e eu volto a pedir aprovação a cada ação.
+
+Bora?"
+```
+
+### 2. Tutorial — abrir o terminal do Managed (passo a passo)
+
+Aluno PME PME tipicamente nunca usou terminal. Isso aqui é a parte mais sensível do kit. Caminho EXATO no Hostinger:
+
+```
+"Antes do comando, abre o terminal do seu OpenClaw Managed.
+Sem SSH, sem Docker — é tudo no painel da Hostinger.
+
+Caminho passo-a-passo:
+
+1. Abre https://hpanel.hostinger.com/ (logado)
+2. Menu lateral esquerdo → clica em **OpenClaw**
+   (ícone de uma garra; fica abaixo de VPS)
+3. Aparece a lista dos seus OpenClaws
+4. No seu OpenClaw (o que você usa pra esse agente), embaixo do
+   nome tem um link **'Abrir linha de comando (CLI)'**
+   — clica aí
+5. Abre uma janela com terminal preto
+6. Aguarda 2-3s até aparecer o prompt (algo tipo `$ ` no canto
+   esquerdo, indicando que tá pronto pra receber comando)
+
+Pronto. Esse é o terminal do Managed.
+
+Quando estiver com a janela aberta e o prompt visível, manda
+'terminal aberto' aqui."
+```
+
+**Esperar aluno responder.** Se tentou e travou, ver "Caminho alternativo: aluno não acha o terminal" abaixo.
+
+### 3. Passar comando
+
+Quando aluno mandar "terminal aberto":
+
+```
+"Beleza. Cola este comando no terminal (Cmd+V no Mac, Ctrl+V no
+Windows/Linux) e dá Enter:
+
+  openclaw exec-policy preset yolo
+
+Ele faz uma coisa: muda meu modo de 'ask' (perguntar antes) pra
+'yolo' (executar direto e narrar).
+
+Vai aparecer alguma saída no terminal — geralmente uma confirmação
+tipo 'exec-policy updated to yolo' ou similar.
+
+Quando rodar, copia a saída do terminal (CTRL+A, CTRL+C) e cola
+aqui. Assim eu confirmo que pegou no terminal certo.
+
+Ou só manda 'feito' se preferir mais rápido."
+```
+
+### 4. Validar comando
+
+Quando aluno mandar "feito" ou colar output:
+
+```bash
+openclaw exec-policy show
+```
+
+| Resultado | Ação |
+|---|---|
+| Retorna `yolo` | "✓ Confirmei. exec-policy = yolo. Autonomia liberada." (segue pra confirmação final) |
+| Ainda `ask` ou default | "Hm, não pegou. Pode ter rodado em terminal errado. Confere se a janela do terminal aberta tem o nome do seu OpenClaw no topo (ex: 'paleturquoise-flamingo-449562'). Tenta de novo: cola `openclaw exec-policy preset yolo` e Enter." |
+| Erro `command not found` | "Parece que o `openclaw` CLI não tá no path desse terminal. Confere o caminho: o terminal que você abriu é mesmo o **'Abrir linha de comando (CLI)'** dentro do menu OpenClaw da Hostinger? (não é terminal local do seu computador)" |
+
+### 5. Confirmação final ao aluno
+
+```
+"✓ Pronto. exec-policy = yolo.
+
+A partir de agora, comportamento novo:
+
+ANTES (modo ask):
+  Você: 'cria um post sobre X'
+  Eu: 'posso criar /workspace/content/drafts/post-X.md?'
+  Você: 'pode'
+  Eu: 'criado. Posso buscar referências no Brave?'
+  Você: 'pode'
+  ...irritante.
+
+AGORA (modo yolo):
+  Você: 'cria um post sobre X'
+  Eu: '[criei post + busquei 3 fontes + salvei research]
+       Post no caminho /workspace/content/drafts/post-X.md.'
+  Sem fricção.
+
+Pra desfazer a qualquer momento:
+  openclaw exec-policy reset
+
+(no mesmo terminal do Managed)
+
+E se quiser revisar tudo que fiz no automático, manda 'mostra log'."
+```
+
+### 6. Pergunta-âncora
+
+Pergunta literal (mapa-aulas.md passo 3):
+
+```
+"Rapidão antes de fechar este passo: se você desfizer a exec-policy
+yolo daqui a pouco (rodar `openclaw exec-policy reset`), o que volta
+a acontecer?"
+```
+
+| Resposta esperada | Validação |
+|---|---|
+| "vai pedir aprovação" / "volta o ask" / similar | "Exato. Eu volto a perguntar 'posso?' a cada coisa que faço — criar arquivo, salvar, executar comando. É reversível." |
+| Errou | "Vou voltar a pedir aprovação a CADA ação. É reversível — você pode desligar e religar a hora que quiser. Útil pra quando você quer fazer algo sensível e não confia em mim sozinho." |
+
+Fechar com:
+
+```
+"Se quer aprofundar segurança no Managed (níveis de exec-policy,
+isolamento de containers, audit log), a aula que detalha isso é a
+*D1* (Segurança Managed) — manda 'aula D1' 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 3 como feito. Bora pro passo 4 (organizar o workspace)?"
+```
+
+### 7. Atualizar MEMORY.md
+
+```markdown
+## Flags
+autonomia_liberada: true
+exec_policy: yolo
+
+## Decisões da jornada
+- {data}: Liberou autonomia. exec-policy=yolo. Aluno autorizou explicitamente via terminal Hostinger.
+```
+
+Atualizar `onboarding_current_step: 4`.
+
+### 8. Devolver controle pra onboarding-checklist
+
+## Caminho alternativo: aluno não acha o terminal
+
+Se aluno disser "não tô achando OpenClaw no menu" / "não vejo 'Abrir linha de comando'":
+
+**Tentativa 1** — sugerir 3 causas comuns:
+
+```
+"Alguns motivos comuns:
+
+1) Você tá num painel diferente do hpanel.hostinger.com
+   — Confirma que tá em https://hpanel.hostinger.com/ (não em
+     hosting.com.br ou similar).
+
+2) Seu OpenClaw ainda não foi provisionado
+   — No menu OpenClaw, se aparecer 'Configuração pendente' em
+     vez de 'Abrir linha de comando', você precisa clicar em
+     'Configurar' primeiro e completar o provisionamento.
+
+3) Idioma do painel diferente
+   — Em inglês: 'Open command line (CLI)'. Em espanhol:
+     'Abrir línea de comandos'. Procura o link equivalente.
+
+Qual desses bate com o que você tá vendo?"
+```
+
+**Tentativa 2** — se aluno ainda travado:
+
+```
+"Manda uma foto da tela do menu OpenClaw que você tá vendo.
+Eu olho e te digo onde clicar.
+
+OU vai direto no grupo @cursoopenclaw — galera responde em
+<5min e quem já passou por isso ajuda visualmente."
+```
+
+Se travado por 10+ min, pausar:
+
+```
+"Vou pausar esse passo. Manda 'reativa jornada' quando o
+terminal estiver aberto. Os passos 4-6 esperam você."
+```
+
+Marca `paused_at_step=3`. Aluno volta depois.
+
+## Caminho alternativo: aluno se assusta com 'yolo'
+
+Algumas pessoas leem 'yolo' e ficam preocupadas. Se aluno expressar dúvida:
+
+```
+"Entendo a preocupação. 'yolo' soa agressivo, mas o nome é só convenção
+do OpenClaw — vem de 'You Only Live Once' (gíria que ficou). Na prática:
+
+- Eu continuo dentro do seu workspace (não saio dele)
+- Eu narro tudo que faço (você vê o log em tempo real)
+- Você pode desligar com 1 comando: `openclaw exec-policy reset`
+- Backups automáticos cobrem se algo der errado (passo 5 ativa
+  backup-workspace-github)
+- Não é 'sudo', não é root — é só 'menos perguntas dentro do escopo
+  permitido'
+
+A alternativa é manter 'ask' (default) — mas aí cada ação minha vira
+3 mensagens entre nós. Vira chato em 5 minutos.
+
+Quer prosseguir? Ou prefere ler a aula D1 antes (5min) pra entender
+melhor a fundo?"
+```
+
+## Critérios de sucesso
+
+- [ ] `openclaw exec-policy show` retorna `yolo`
+- [ ] `autonomia_liberada=true` em `MEMORY.md`
+- [ ] `exec_policy=yolo` salvo em `MEMORY.md`
+- [ ] `onboarding_current_step=4`
+- [ ] Pergunta-âncora respondida
+- [ ] Aula D1 mencionada
+
+## Erros comuns
+
+- **Aluno cola comando no Telegram em vez do terminal:** detectar quando aluno manda `openclaw exec-policy preset yolo` como mensagem. Resposta: "Esse comando vai NO TERMINAL (terminal web do Managed Hostinger), não aqui no chat. Cola lá e me avisa quando rodou."
+- **Aluno cola no terminal local do laptop em vez do terminal Hostinger:** validação `openclaw exec-policy show` falha. Reforçar instrução: "É no terminal **dentro do painel Hostinger** (Menu OpenClaw → Abrir linha de comando)".
+- **Aluno tem `openclaw` desatualizado no terminal:** se comando retorna erro de flag não reconhecida, sugerir `openclaw --version` e atualizar via Hostinger.
+- **Aluno fica desconfortável com permissões:** sempre oferecer alternativa (manter `ask` + chamar agente caso a caso). Não forçar.
+- **Aluno achou que ia ser automático:** explicar Princípio 3. "Esse é o único passo manual. Foi de propósito — segurança."
+
+## 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 2 (confirmação humana):** EXAUSTIVA aqui. Aluno tem que abrir terminal + colar comando + confirmar.
+- **Princípio 3 (NUNCA elevação via agente):** este passo É a aplicação canônica do Princípio 3. Agente JAMAIS roda `exec-policy preset yolo` por conta própria. Sempre passa o comando pro aluno colar no terminal.
+- **Princípio 4 (narrar antes de fazer):** explica O QUE o comando faz e POR QUE manual antes de pedir.
+- **Princípio 5 (atualizar MEMORY ao concluir):** marca `autonomia_liberada=true` + `exec_policy=yolo`.
+- **Princípio 9 (parar se algo der errado):** se aluno trava 2x em comando, pausa o passo (não fica em loop). Sugere foto da tela ou grupo.
+- **Princípio 11 (detectar antes de pedir):** roda `openclaw exec-policy show` ANTES de pedir aluno fazer nada. Se já liberado, pula direto pra pergunta-âncora.
+
+## Modo A vs Modo B
+
+**Modo A:**
+```
+"Bora pro Módulo 3 — Liberar autonomia.
+Aula correspondente: D1 (Segurança Managed).
+Recomendo MUITO assistir antes — esse passo mexe em segurança e
+você precisa entender o tradeoff entre conveniência e controle."
+[fluxo numerado: tutorial Hostinger + 1 comando + validação]
+```
+
+**Modo B:**
+```
+"Próxima coisa: liberar pra mim trabalhar sem te incomodar a cada
+ação. Um comando só. Vou te guiar passo-a-passo."
+[fluxo conversacional, mesma sequência sem numeração]
+```
+
+## Comando "exemplo" neste contexto
+
+Aluno pode pedir "exemplo" pra ver o que muda na prática:
+
+```
+"Exemplo prático do que muda:
+
+ANTES (com 'ask' default):
+  Você: 'cria um post sobre X'
+  Eu: 'posso criar /workspace/content/drafts/post-X.md?'
+  Você: 'pode'
+  Eu: 'criado. Posso buscar referências no Brave?'
+  Você: 'pode'
+  Eu: 'busquei 3 fontes. Posso salvar em research/?'
+  Você: 'pode'
+  ...3 minutos depois pra um post simples
+
+DEPOIS (com 'yolo'):
+  Você: 'cria um post sobre X'
+  Eu: '[criei post + busquei 3 fontes + salvei research]
+       Post no caminho /workspace/content/drafts/post-X.md.
+       Quer que eu mostre?'
+
+Mesma operação. Sem fricção.
+
+Quer prosseguir liberando, ou tá com dúvida ainda?"
+```
+
+## Referências
+
+### Internas
+- Princípios universais (especialmente Princípio 3): [`../onboarding-checklist/references/principios-defensivos.md`](../onboarding-checklist/references/principios-defensivos.md)
+- Decisão D18 (autonomia antes de workspace): [`../../../../DECISOES-ARQUITETURA.md`](../../../../DECISOES-ARQUITETURA.md)
+- Pergunta-âncora oficial: [`../onboarding-checklist/references/mapa-aulas.md`](../onboarding-checklist/references/mapa-aulas.md) (passo 3)
+
+### Externas
+- OpenClaw exec-policy docs oficial: https://docs.openclaw.ai/cli (e `openclaw exec-policy --help` no terminal)
+- Painel Hostinger: https://hpanel.hostinger.com/ (menu OpenClaw)
+
+## Status
+
+✅ ATIVO desde v1.1 do Starter Kit (02/05/2026 — versão revisada com tutorial Hostinger CLI passo-a-passo após teste E2E identificar como ponto crítico de abandono).
+
+## Roadmap
+
+- v1.2: Detectar versão do `openclaw` CLI e adaptar comandos se sintaxe mudar
+- v1.3: Suporte a Hostinger em outros idiomas (espanhol, inglês) com nomes de menu localizados
+- v2: Captura de screenshot do terminal automaticamente (se Hostinger expor API) pra confirmar que aluno tá no terminal certo sem aluno colar output