@pixeleducacao/curso-openclaw 2026.5.8 → 2026.5.10

package/assets/skills/starter/onboarding-checklist/references/arquivos-raiz.md

@@ -15,7 +15,7 @@ workspace/
 ├── AGENTS.md       ← regras de interação aluno↔agente
 ├── MAPA.md         ← mapa raiz: lista pastas, aponta pros mapas locais
 ├── MEMORY.md       ← decisões + flags + memória contínua
-├── HEARTBEAT.md    ← estado atual + última atividade
+├── HEARTBEAT.md    ← configuração do mecanismo de proatividade
 └── .env            ← chaves API + segredos
 ```
 
@@ -195,31 +195,46 @@ Nunca uso linguagem motivacional/coach. Falo direto.
 
 ---
 
-### `HEARTBEAT.md` — Estado atual
+### `HEARTBEAT.md` — Configuração do mecanismo de proatividade
 
-**Função:** última atividade, contexto quente, o que tava sendo feito quando aluno saiu.
+**Função:** define COMO o agente vigia o dia do aluno. Frequência de poll, checks rotacionáveis (inbox, calendário, menções, pendências paradas), regras de silêncio, regras de reach out, quiet hours.
+
+> **Importante:** `HEARTBEAT.md` é configuração, não log de estado. O que o agente vigia (prioridades, prazos, negociações ativas, decisões recentes) mora em `memory/hot.md` — auto-mantido pela skill `/salve` e pela pipeline de captura. Não confundir os dois: `HEARTBEAT.md` = COMO ele vigia. `hot.md` = O QUE ele vigia.
 
 **Criado em:** Passo 4 (`wizard-workspace`)
 
-**Quem atualiza:** **Agente — automático.** A cada sessão relevante.
+**Quem atualiza:** **Aluno (manual).** Raro — só quando quer mudar comportamento (ativar/desativar check, mudar frequência, ajustar quiet hours).
 
-**Frequência:** Atualizado a cada sessão de uso.
+**Frequência:** Edita raro. Agente recarrega no próximo poll após qualquer mudança.
 
-**Estrutura:**
+**Estrutura mínima:**
 ```markdown
 # HEARTBEAT.md
 
-## Última atividade
-- Quando: 2026-05-02 15:18
-- O que: Aluno completou jornada de onboarding e respondeu NPS
-- Próximo passo natural: aguardar aluno mandar primeira tarefa real
-
-## Estado atual
-- Modo: aguardando comando
-- Contexto quente: nenhum
-- Pendências do aluno: nenhuma
+## Frequência
+- Poll a cada: 30 minutos
+- Janela ativa: 08:00 às 22:00
+- Quiet hours: 22:00 às 08:00
+
+## Checks rotacionáveis
+- [x] Inbox triage — emails das últimas 4h, avisa só urgentes
+- [ ] Calendário próximo — eventos das próximas 24-48h
+- [ ] Pendências paradas — itens com terceiro parado 3+ dias
+- # [ ] Mention sweep, weather guard, news watch (desativados)
+
+## Regras de silêncio
+- Já checou nos últimos 30min → HEARTBEAT_OK
+- Nada novo desde a última checagem → silêncio
+- Quiet hours → só urgência real
+
+## Regras de reach out
+- Email importante chegou
+- Evento começa em <2h sem confirmação
+- Faz >8h sem dizer nada e tem coisa relevante
 ```
 
+Template completo: [`templates/HEARTBEAT.template.md`](../../../../templates/HEARTBEAT.template.md). Exemplo real: [`exemplos/HEARTBEAT-amora.md`](../../../../exemplos/HEARTBEAT-amora.md).
+
 ---
 
 ### `.env` — Chaves API e segredos
@@ -263,11 +278,24 @@ GITHUB_TOKEN=ghp_xxx                # backup automático
 | `AGENTS.md` | nunca | sim, raro |
 | `MAPA.md` | sim, quando estrutura muda | sim, raro |
 | `MEMORY.md` | sim, constante | raramente edita direto |
-| `HEARTBEAT.md` | sim, cada sessão | nunca edita |
+| `HEARTBEAT.md` | nunca | sim, raro (muda comportamento) |
 | `.env` | só com confirmação dupla | sim, paste de chaves |
 
 ---
 
+## Nota sobre `HEARTBEAT.md` vs `memory/hot.md`
+
+Em versões anteriores do Starter Kit, `HEARTBEAT.md` funcionava como log de estado (última atividade, contexto quente, próximo passo natural). **Não é mais.** Esse papel passou pra `memory/hot.md`, que é auto-mantido pela skill `/salve` e pela pipeline de captura — concentra prioridades da semana, negociações ativas, decisões recentes, métricas-chave e prazos críticos.
+
+A divisão fica assim:
+
+- **`HEARTBEAT.md`** = COMO o agente vigia (config: frequência, checks, regras)
+- **`memory/hot.md`** = O QUE o agente vigia (contexto: prioridades, prazos, pendências)
+
+O heartbeat lê `hot.md` a cada poll pra decidir se age ou fica quieto. Não duplica memória.
+
+---
+
 ## Princípios aplicados
 
 - **Princípio 1 (backup antes):** todos os 8 arquivos têm backup antes de qualquer modificação

package/assets/skills/starter/onboarding-checklist/references/aula-menus.md

@@ -0,0 +1,304 @@
+# Mapa de Aulas → Submenus (Modo A v2 — kit v2.3)
+
+> Referência canonical de cada aula do Bloco A com seu submenu de configuração no agente.
+>
+> Modo A v2 (NOVO em kit v2.3): jornada espelha aulas 1:1, não passos do kit. Aluno seleciona aula via `abre A{X}`, agente abre submenu específico daquela aula.
+>
+> **Princípio guia:** uma aula no vídeo = uma "unidade" mental no agente. Aluno nunca confunde "passo do kit" vs "aula do curso" — é o mesmo número.
+
+---
+
+## Visão geral do Bloco A (entrada)
+
+| Aula | Vídeo (~min) | Configuração no agente (~min) | Tipo |
+|---|---|---|---|
+| A0 — Visão geral | 12min | 3min smoke test | Conceito + aplicação leve |
+| A1 — Primeiro login Managed | 8min | — | **Pré-req** (já feito antes do kit) |
+| A2 — Identidade mínima | 14min | 7min config | Aplicação (2 módulos) |
+| A3 — Telegram bot básico | 6min | — | **Pré-req** (já feito antes do kit) |
+| A4 — Desbloqueio + superpoderes | 11min | 22min config | Aplicação (3 módulos) |
+| A5 — Primeira vitória | 9min | 5min config | Aplicação (1 módulo) |
+| A6 — Debug primeiros socorros | 7min | — | **Referência** permanente (sem config dedicada) |
+
+---
+
+## Submenus de cada aula
+
+### A0 — Visão geral
+
+**Vídeo cobre:** O que é OpenClaw Managed, modelos disponíveis (GPT/Claude/Gemini), créditos OpenAI, como o curso funciona.
+
+**Submenu (`abre A0`):**
+
+```
+=== A0 — Visão geral ===
+
+Você acabou de assistir a aula. Aplicação prática agora:
+
+→ smoke test áudio (Whisper) — 3min
+  Manda um áudio curto pra eu transcrever e confirmar que tá funcionando.
+
+[se ambiente: managed → ✓ Sua chave OpenAI veio do setup Managed (você forneceu na instalação 1-click). Whisper já tá pronto. Só falta o áudio teste.]
+
+[se ambiente: vps-root → entrevistar chave OpenAI normalmente]
+```
+
+**Despacha:** `wizard-whisper-quick` (com fast-path Managed v1.10).
+
+**Marca em MEMORY:** `whisper_configured=true`, `aula_A0_assistida=true`.
+
+---
+
+### A1 — Primeiro login Managed (PRÉ-REQ)
+
+**Vídeo cobre:** Como entrar no painel Hostinger, vincular bot Telegram, primeiro contato com agente.
+
+**Submenu (`vi A1` ou `abre A1`):**
+
+```
+=== A1 — Primeiro login Managed ===
+
+Aula consolidatória — você JÁ FEZ isso antes de baixar o kit (caso contrário não estaria conversando comigo agora). Aula consolida o que já tá rodando.
+
+Sem configuração nova. ✓ Marcado como visto.
+
+Pergunta-âncora pra fixar (opcional):
+"Em qual painel você entra pra ver/parar/reiniciar este agente quando precisar?"
+
+Resposta esperada: "Hostinger, no menu OpenClaw."
+
+Próxima: A2 (Identidade mínima — começamos a configurar de verdade).
+```
+
+**Despacha:** nada (pré-req).
+
+**Marca em MEMORY:** `aula_A1_assistida=true`.
+
+---
+
+### A2 — Identidade mínima
+
+**Vídeo cobre:** Por que agente precisa de personalidade definida, como SOUL/IDENTITY/AGENTS funcionam, como USER.md te representa.
+
+**Submenu (`abre A2`):**
+
+```
+=== A2 — Identidade mínima ===
+
+Aula cobre 2 coisas no kit. Total de configuração: ~7min.
+
+Como prefere?
+
+(a) Os 2 em sequência (~7min total)
+(b) Um por vez. Qual?
+    1. Personalidade do agente (4min) — IDENTITY + SOUL stub + AGENTS
+    2. Sua personalidade (3min) — USER.md
+```
+
+**Despacha:** `wizard-agente` e/ou `wizard-aluno` (conforme escolha).
+
+**Marca em MEMORY:** `agente_configured=true`, `aluno_configured=true`, `aula_A2_assistida=true`.
+
+---
+
+### A3 — Telegram bot básico (PRÉ-REQ)
+
+**Vídeo cobre:** Como criar bot Telegram via @BotFather, vincular ao OpenClaw, primeiro `/start`.
+
+**Submenu (`vi A3` ou `abre A3`):**
+
+```
+=== A3 — Telegram bot básico ===
+
+Aula consolidatória — bot já tá ativo (você tá conversando comigo via Telegram agora).
+
+Sem configuração nova. ✓ Marcado como visto.
+
+Pergunta-âncora opcional: "Se o token do bot vazar, o que você faz?"
+Resposta esperada: "regenero no @BotFather e atualizo no OpenClaw."
+
+Próxima: A4 (Desbloqueio + superpoderes).
+```
+
+**Despacha:** nada (pré-req).
+
+**Marca em MEMORY:** `aula_A3_assistida=true`.
+
+---
+
+### A4 — Desbloqueio + superpoderes
+
+**Vídeo cobre:** Por que agente precisa de autonomia (yolo), o que é workspace + MAPA, integrações externas (Brave + GitHub).
+
+**Submenu (`abre A4`):**
+
+```
+=== A4 — Desbloqueio + superpoderes ===
+
+Aula cobre 3 coisas. Total de configuração: ~22min — bloco mais longo do kit.
+
+Como prefere?
+
+(a) As 3 em sequência (autonomia → workspace → superpoderes externos)
+(b) Uma por vez. Qual?
+    1. Autonomia (yolo) — 6min — você cola 1 comando no terminal Hostinger
+    2. Workspace + MAPA — 4min — eu crio pastas e mapas distribuídos
+    3. Superpoderes externos (Brave + GitHub) — 12min — você cria 2 chaves, eu valido
+(c) Pausar e voltar depois (manda 'cancela')
+```
+
+**Despacha:** `wizard-autonomia`, `wizard-workspace`, `wizard-conectar` (conforme escolha).
+
+**Marca em MEMORY:** `autonomia_liberada`, `workspace_organizado`, `conectado` (conforme), `aula_A4_assistida=true`.
+
+---
+
+### A5 — Primeira vitória pelo Telegram
+
+**Vídeo cobre:** Como agente entrega trabalho, primeiro artefato real, fluxo de "delegar e revisar".
+
+**Submenu (`abre A5`):**
+
+```
+=== A5 — Primeira vitória ===
+
+Aula cobre 1 coisa: gerar primeiro artefato. ~5min de configuração.
+
+Pra começar, me conta o tema. Algo que você precisaria fazer hoje (post, email, ideia, decisão pra registrar).
+```
+
+**Despacha:** `primeira-vitoria` (com auto-arquivamento v1.7 no fim).
+
+**Marca em MEMORY:** `first_win_completed=true`, `onboarding_complete=true`, `aula_A5_assistida=true`.
+
+---
+
+### A6 — Debug primeiros socorros (REFERÊNCIA)
+
+**Vídeo cobre:** Categorias comuns de erro (chave inválida, comando não encontrado, agente não responde), como classificar, onde pedir ajuda.
+
+**Submenu (`vi A6` ou `abre A6`):**
+
+```
+=== A6 — Debug primeiros socorros ===
+
+Aula vira referência permanente — você nunca "configura A6", você consulta quando travar.
+
+Sem configuração. ✓ Marcado como visto.
+
+Próxima vez que travar, manda:
+- 'travei' — eu te oriento na hora
+- 'ajuda' — menu completo de comandos
+- @Openclawzinho no grupo — bot IA 24/7
+
+Onde tem o vídeo: link na área de membros do mini-curso.
+```
+
+**Despacha:** nada (referência).
+
+**Marca em MEMORY:** `aula_A6_assistida=true`.
+
+---
+
+## Comandos canonical novos (Modo A v2)
+
+Adicionados em `comandos-canonicos.md` na v1.9 da onboarding-checklist:
+
+### `abre A{X}` (X ∈ {0,1,2,3,4,5,6})
+
+Abre o submenu da aula X conforme tabela acima. Aluno escolhe:
+
+- Aulas com aplicação (A0, A2, A4, A5): submenu lista módulos. Aluno faz tudo de uma vez OU um por vez OU pausa
+- Aulas pré-req (A1, A3): submenu confirma que é pré-req, oferece pergunta-âncora opcional
+- Aula A6: submenu explica que é referência
+
+Sinônimos: `aula A{X}`, `começar A{X}`, `vamos pela A{X}`.
+
+### `vi A{X}` ou `assisti A{X}`
+
+Marca aula como vista em MEMORY (`aula_A{X}_assistida=true`). Útil pra aulas pré-req ou A6 — aluno marca sem precisar abrir submenu.
+
+Sinônimos: `terminei A{X}`, `A{X} feita`, `A{X} ok`, `concluí A{X}`.
+
+### `vou assistir A{X}` (auto-pause)
+
+Aluno avisa que tá saindo pro Hotmart pra ver vídeo. Agente registra `assistindo_aula: A{X}` em MEMORY e responde:
+
+```
+Tô aqui esperando. Quando voltar, manda 'assisti A{X}' (ou 'A{X} ok')
+pra eu disparar o submenu da aula. Se travar na aula, manda 'travei
+na A{X}' que eu ajudo.
+```
+
+Sensação de "agente espera junto" em vez de "agente sumiu".
+
+### `travei na A{X}`
+
+Aluno tá com dificuldade durante o vídeo (não conseguiu fazer algo, pergunta conceitual). Agente entra em modo "ajuda contextualizada":
+
+```
+Em qual ponto da aula? Manda timestamp aproximado ou descreve o que
+travou. Posso:
+- Explicar o conceito de novo (texto)
+- Apontar pro tópico relevante na FAQ
+- Te jogar pro grupo (@Openclawzinho 24/7)
+```
+
+NÃO despacha submenu — aluno só volta pro fluxo quando terminou aula.
+
+---
+
+## Renderização da checklist Modo A v2 (template novo)
+
+Substitui o template antigo de "passos" por checklist de aulas:
+
+```
+=== Curso OpenClaw — Bloco A (Entrada) ===
+
+Cada aula tem vídeo + menu de configuração próprio dentro do agente.
+Você assiste no Hotmart, volta aqui, abre o menu daquela aula.
+
+[ ] 🎬 A0 — Visão geral (~12min vídeo + 3min config)
+[ ] 🎬 A1 — Primeiro login Managed (~8min vídeo · pré-req, sem config)
+[ ] 🎬 A2 — Identidade mínima (~14min vídeo + 7min config — 2 módulos)
+[ ] 🎬 A3 — Telegram bot (~6min vídeo · pré-req, sem config)
+[ ] 🎬 A4 — Desbloqueio + superpoderes (~11min vídeo + 22min config — 3 módulos)
+[ ] 🎬 A5 — Primeira vitória (~9min vídeo + 5min config)
+[ ] 🎬 A6 — Debug primeiros socorros (~7min vídeo · referência permanente)
+
+Comandos:
+- 'abre A{X}' → submenu da aula X (config no agente)
+- 'vi A{X}' → marcar aula como assistida (rápido pra pré-req)
+- 'vou assistir A{X}' → me avisa que tá saindo pro Hotmart, eu espero
+- 'travei na A{X}' → ajuda durante o vídeo
+
+📞 Travou em geral? Manda 'ajuda' (menu completo) ou @Openclawzinho no grupo.
+
+Bora pela A0?
+```
+
+Substituições por ambiente:
+- Se `ambiente: managed` E A0 já tem chave: linha A0 vira "✓ A0 — chave OpenAI já vem do Managed (smoke test áudio quando você quiser)" — passo INVISÍVEL como módulo separado
+- Se `aula_A1_assistida=true` ANTES da checklist (quando aluno é antigo Managed): linha A1 vira "✓ A1 — pré-req já consolidado"
+
+---
+
+## Modo B continua igual
+
+Modo B (wizard direto) NÃO usa essa estrutura por aulas. Aluno escolheu pular vídeos — kit conduz como tutor conversacional sem mencionar aulas. Igual ao desenho v2.2.
+
+Diferença visível só no Modo A. Por baixo, mesmas skills filhas (mesmos wizards, mesmas references).
+
+---
+
+## Falhas que essa estrutura PREVINE
+
+1. **Confusão "passo X" vs "aula Y"** (Modo A v1) — agora é o mesmo número
+2. **Aulas pré-req sem espaço próprio** — A1 e A3 ganham submenu de "consolidar visto" em vez de "passa direto sem-graça"
+3. **Aulas multi-módulo viram parede de config** — A4 (3 módulos / 22min) agora oferece "um por vez ou tudo de uma vez"
+4. **Aluno fica esperando enquanto vê vídeo sem feedback** — comando `vou assistir A{X}` registra estado, agente "espera junto"
+5. **Aluno trava no vídeo sem saber pedir ajuda contextual** — `travei na A{X}` é canonical
+
+---
+
+*Criado em kit v2.3 (03/05/2026 noite). Substitui parcialmente `mapa-aulas.md` (que continua como referência de pergunta-âncora por passo). Os 2 arquivos coexistem — `mapa-aulas.md` é "pergunta de fixação por passo", `aula-menus.md` é "submenu de configuração por aula".*

package/assets/skills/starter/onboarding-checklist/references/checklist-template.md

@@ -5,7 +5,76 @@
 
 ---
 
-## Template inicial (primeira vez que aluno vê)
+## Modo A v2 — Template de checklist por aulas (NOVO em kit v2.3)
+
+⚠️ **REESCRITO em v2.3:** Modo A agora espelha aulas do mini-curso 1:1 (A0-A6) em vez de "passos do kit". Cada aula tem submenu próprio (ver `references/aula-menus.md`).
+
+### Template renderizado quando aluno escolhe Modo A
+
+```
+=== Curso OpenClaw — Bloco A (Entrada) ===
+
+Cada aula tem vídeo + menu de configuração próprio dentro do agente.
+Você assiste no Hotmart, volta aqui, abre o menu daquela aula.
+
+[ ] 🎬 A0 — Visão geral (~12min vídeo + 3min config)
+[ ] 🎬 A1 — Primeiro login Managed (~8min vídeo · pré-req, sem config)
+[ ] 🎬 A2 — Identidade mínima (~14min vídeo + 7min config — 2 módulos)
+[ ] 🎬 A3 — Telegram bot (~6min vídeo · pré-req, sem config)
+[ ] 🎬 A4 — Desbloqueio + superpoderes (~11min vídeo + 22min config — 3 módulos)
+[ ] 🎬 A5 — Primeira vitória (~9min vídeo + 5min config)
+[ ] 🎬 A6 — Debug primeiros socorros (~7min vídeo · referência permanente)
+
+Comandos:
+- 'abre A{X}' → submenu da aula X (config no agente)
+- 'vi A{X}' → marcar aula como assistida (rápido pra pré-req)
+- 'vou assistir A{X}' → me avisa que tá saindo, eu espero
+- 'travei na A{X}' → ajuda durante o vídeo
+
+📞 Travou em geral? Manda 'ajuda' (menu completo) ou @Openclawzinho no grupo.
+
+Bora pela A0?
+```
+
+### Substituições condicionais por ambiente (kit v2.3)
+
+**Se `ambiente: managed` E `managed_has_openai_envvar: true`** (Fase Pré-Zero detectou):
+
+Linha A0 vira:
+```
+[✓] 🎬 A0 — Visão geral (~12min vídeo) · áudio já tá funcionando (chave OpenAI vem do Managed)
+```
+
+A0 some como "passo de configuração" — Whisper já tá pronto. Aluno assiste o vídeo se quiser, mas sem fricção mental de "o que tem que configurar nesse passo?".
+
+**Se `aula_A1_assistida=true` setada antes** (aluno já tinha visto antes do kit chegar):
+
+Linha A1 vira:
+```
+[✓] 🎬 A1 — Primeiro login Managed · pré-req consolidado
+```
+
+### Renderização durante a jornada (após cada aula)
+
+```
+=== Curso OpenClaw — Bloco A ===
+
+[✓] 🎬 A0 — Visão geral · áudio funcionando
+[✓] 🎬 A1 — Primeiro login Managed · pré-req
+[✓] 🎬 A2 — Identidade mínima · agente + USER configurados
+[ ] 🎬 A3 — Telegram bot ← agora (pré-req, manda 'vi A3' pra marcar)
+[ ] 🎬 A4 — Desbloqueio + superpoderes
+[ ] 🎬 A5 — Primeira vitória
+[ ] 🎬 A6 — Debug primeiros socorros
+
+Bora pela A3?
+```
+
+---
+
+## Template inicial (primeira vez que aluno vê) — DEPRECATED em v2.3 pra Modo A
+
+⚠️ **Histórico:** este era o template original do Modo A em kits v1.x → v2.2. Substituído pela checklist por aulas (acima) em v2.3. Mantido aqui como referência histórica e como fallback se algum agente legado precisar (não usar em fluxos novos).
 
 ```
 === Sua jornada — total estimado: ~37min ===