@pixeleducacao/curso-openclaw 2026.5.8 → 2026.5.9

package/assets/skills/starter/wizard-whisper-quick/SKILL.md

@@ -3,20 +3,43 @@ name: wizard-whisper-quick
 status: ATIVO
 category: starter
 owner: aluno
-version: 1.2
+version: 1.12
 mode: guided
-estimated_time: 5min (ou 30s se já configurado)
+estimated_time: 5min (ou 15s se chave já existe e válida — qualquer ambiente)
 model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4, gemini-pro]
-description: Use when student types "configura whisper" / "ativa áudio" / "quero mandar áudio", OR when dispatched by onboarding-checklist as passo 0 (pré-passo opcional). Configures OpenAI API key in .env so student can send voice messages on Telegram instead of typing. Detects existing key first (Princípio 11/.env first), validates with API call, asks only if missing. Ends with smoke test (student sends audio, agent transcribes).
+description: Use when student types "configura whisper" / "ativa áudio" / "quero mandar áudio", OR when dispatched by onboarding-checklist as passo 0 (pré-passo opcional). Configures OpenAI API key in .env so student can send voice messages on Telegram (Whisper) AND have semantic memory (embeddings). Detects existing key first (Princípio 11/.env first OBRIGATÓRIO), validates with API call, asks only if missing. **v1.12 (kit v2.4 — stress test multi-persona): fast-path AGORA INDEPENDENTE DE AMBIENTE. Antes (v1.10/v1.11) só ativava se `ambiente: managed`. Stress test Rodrigo (VPS root com chave válida em .env) revelou: aluno era re-entrevistado por causa de condicional desnecessária. Fix: se chave existe (env var OR .env) E smoke test retorna HTTP 200 → pula entrevista, independente de ambiente. Princípio: condição "chave válida" não é exclusiva de Managed. Em VPS root + local-dev, mesma economia.** v1.11: env var fast-path (chave Managed em env var, não .env). v1.10: fast-path Managed inicial. v1.9: header P13/14/15. v1.8: pulo agendar 24h vs definitivo. v1.7: P11 reforçado.
 ---
 
 # Wizard Whisper Quick — Passo 0 (Pré-passo opcional)
 
+> 🔴 **PRINCÍPIOS NÃO-NEGOCIÁVEIS PRO AGENTE (kit v2.2):**
+>
+> **NÃO IMPROVISE.** Read este arquivo INTEIRO antes de falar com aluno. Não invente fluxo simplificado.
+>
+> **P13 — Guard Rail (wizard é passo bloqueante).** Toda mensagem do aluno é classificada:
+> - (a) resposta direta → processa, avança
+> - (b) comando canônico (`cancela`, `pula`, `voltar N`, `sobre`, `faq`, `corrige`, `muda modo`) → honra
+> - (c1) pergunta tangencial → responde 1 linha, traz de volta ao passo
+> - (c2) desvio total → anota em `## Perguntas pendentes` (MEMORY.md), traz de volta
+> - 3 desvios consecutivos no mesmo passo → oferecer pause com `wizard_resume_at` agendado
+>
+> **P14 — Smoke tests visíveis.** Validação da chave OpenAI + smoke test de áudio SEMPRE mostram (1) comando `curl` exato, (2) output literal (HTTP code + transcrição), (3) só DEPOIS interpreta. Sem evidência = ABORTA e pede ajuda. NUNCA finge que validou ou que transcreveu áudio que não rodou — falha real Dr. Thiago v1.9.1.
+>
+> **P15 — Mensagens `<canonical>` literais.** "Você quer ajuda pra pegar essa chave, ou já tem ela fácil aí?" + 3 opções pós-pulo (agendar 24h / definitivo / volta quando quiser) são CANONICAL — usar LITERAL.
+>
+> **P17 — Formatação Telegram-friendly.** Mensagens canonical pro aluno usam parágrafos contínuos (1 linha por parágrafo). NÃO quebrar manualmente a cada ~70 chars — Telegram faz word-wrap natural.
+>
+> Detalhes: `../onboarding-checklist/references/principios-defensivos.md` (P1–P17).
+
+> ⚠️ **Agente:** se você é a `onboarding-checklist` despachando este wizard, **NÃO IMPROVISE uma versão simplificada na conversa**. Read este arquivo INTEIRO e siga à risca. Em particular: SEMPRE rode a Detecção (Princípio 11 abaixo) ANTES de mandar qualquer pergunta ao aluno. Falha real (sessão Lia 02/05): agente perguntou "quer ativar Whisper?" sem checar `.env`, gerando pergunta desnecessária pra aluno que já tinha chave.
+
 ## Promessa
 
 Aluno termina esse passo conseguindo **mandar áudio em vez de digitar** no Telegram. Eu transcrevo na hora e respondo. Quem tá no celular dirigindo, andando, fazendo café — fala em vez de teclar.
 
-Sem ele, aluno passa a jornada inteira digitando. Com ele, passa falando. Mudança grande na primeira impressão.
+**Bonus:** a mesma chave OpenAI configurada aqui também serve pra **memória semântica** (embeddings) — quando aluno tem essa memória ativa, agente "lembra" coisas pelo SIGNIFICADO, não só pelo texto exato. Útil pra recall de decisões antigas, padrões em conteúdo, etc. Sem chave OpenAI: só busca textual literal.
+
+Sem ele, aluno passa a jornada inteira digitando + perde memória semântica. Com ele, passa falando + tem agente que entende contexto. Mudança grande na primeira impressão.
 
 ## Quando disparar
 
@@ -33,20 +56,82 @@ Sem ele, aluno passa a jornada inteira digitando. Com ele, passa falando. Mudan
 - `whisper_configured=true` em `MEMORY.md` E última validação foi há menos de 7 dias
 - Aluno explicitamente pulou no passo 0 (`whisper_skipped=true` em `MEMORY.md`)
 
-## Princípio 11 — Detecção antes de pedir
+## Princípio 11 — Detecção antes de pedir (OBRIGATÓRIO, não pular)
+
+⚠️ **CRÍTICO:** sua PRIMEIRA ação ao ser invocada é a checagem abaixo. Não escreva NADA pro aluno antes de checar. Se pular essa detecção, vai perguntar coisa que aluno já configurou — irrita, parece amador.
+
+**Sequência obrigatória de detecção:**
+
+```bash
+# 1. Lê .env (caminho varia por workspace, geralmente ~/workspace/.env ou ~/.env)
+cat $WORKSPACE/.env | grep -E "^OPENAI_API_KEY="
+
+# 2. Se existe, valida com call de teste à API:
+curl -s https://api.openai.com/v1/models \
+     -H "Authorization: Bearer $OPENAI_API_KEY" \
+     -o /dev/null -w "%{http_code}"
+
+# 3. Interpreta:
+#    200 → chave válida
+#    401 → chave inválida/revogada
+#    429 → chave OK mas sem saldo
+#    outro → investiga
+```
+
+**Falha real observada (Lia 02/05):** agente recebeu "wizard direto" e foi PERGUNTAR "quer ativar Whisper?" sem rodar a detecção. Aluno tinha chave, virou pergunta desnecessária. Princípio 11 existe pra isso — **não pule**.
+
+### Fast-path por chave detectada (kit v2.4 — INDEPENDENTE de ambiente)
 
-**Antes de qualquer pergunta**, executar checagem em 3 camadas:
+⚠️ **Mudança v1.12 (kit v2.4):** antes (v1.10/v1.11) o fast-path só rodava se `ambiente: managed`. Agora a condição passa a ser **"chave válida em env var OR .env"** — independente de ambiente. Razão: stress test Rodrigo (VPS root com chave existente no `.env`) revelou que aluno era re-entrevistado mesmo já tendo chave válida. A condicional `if ambiente == managed` era desnecessária — o que importa é se a chave existe e funciona, não de onde veio.
 
+**Detecção em 2 fontes (mantida da v1.11):**
+
+```bash
+# 1. PRIMEIRO: env var do processo (fonte primária em Managed)
+if [ -n "$OPENAI_API_KEY" ]; then
+    echo "found_in_envvar"
+    KEY="$OPENAI_API_KEY"
+fi
+
+# 2. FALLBACK: .env do workspace (fonte primária em VPS root / local-dev / Managed que tirou da env var)
+if [ -z "$KEY" ] && [ -f "$WORKSPACE/.env" ] && grep -q "^OPENAI_API_KEY=" "$WORKSPACE/.env"; then
+    echo "found_in_dotenv"
+    KEY="$(grep "^OPENAI_API_KEY=" "$WORKSPACE/.env" | cut -d= -f2- | tr -d '"' | tr -d "'")"
+fi
 ```
-1. Lê .env: existe OPENAI_API_KEY?
-2. Se existe, valida com call de teste à API:
-   curl -s https://api.openai.com/v1/models \
-        -H "Authorization: Bearer $OPENAI_API_KEY" | head -c 200
-3. Se retorna lista de models (200 OK): chave válida
-   Se retorna 401: chave inválida/revogada
-   Se outro erro: investiga
+
+Se achou em qualquer um dos 2 lugares → smoke test visível (P14):
+
+```bash
+# Validar chave (não importa de qual fonte veio)
+curl -s https://api.openai.com/v1/models \
+     -H "Authorization: Bearer $KEY" \
+     -o /dev/null -w "%{http_code}"
 ```
 
+**Se HTTP 200 → narra (mensagem ajusta-se ao ambiente detectado):**
+
+| `ambiente:` | Mensagem |
+|---|---|
+| `managed` | "✓ Detectei sua chave OpenAI vinda do setup Managed (você forneceu quando instalou o OpenClaw no painel Hostinger). Validei, tá funcionando. Whisper + memória semântica já prontos." |
+| `vps-root` | "✓ Detectei sua chave OpenAI no `.env` do workspace. Validei, tá funcionando. Whisper + memória semântica já prontos — sem pergunta extra." |
+| `local-dev` ou `unknown` | "✓ Detectei sua chave OpenAI configurada (env var ou `.env`). Validei, tá funcionando. Whisper + memória semântica já prontos." |
+
+→ pula direto pro smoke test (seção 5 abaixo). Marca `whisper_configured=true` em MEMORY.md.
+
+**Se HTTP ≠ 200:**
+- 401 (chave inválida/revogada) → "Achei uma chave OpenAI configurada, mas a validação retornou 401 (chave inválida ou revogada). Fluxo: você gera nova chave OU me manda outra que eu sobrescrevo. Continuar?" → cai no fluxo normal abaixo (passo 2 — instruir geração)
+- 429 (sem saldo) → "A chave funciona, mas a conta tá sem crédito. Adiciona $5 em platform.openai.com/billing e me chama de volta com 'continua' que eu valido de novo."
+- Outro → mostrar output literal + investigar com aluno (P14)
+
+**Se NEM env var NEM .env tem chave:**
+
+Comportamento normal — entrevistar conforme fluxo tradicional abaixo (passo 1).
+
+**Por que Fast-path independente de ambiente:** caso Rodrigo (VPS root com chave) era idêntico ao caso Managed em termos de UX — aluno já tinha chave, agente devia detectar. Condicional `ambiente == managed` excluía 15k VPS legados sem motivo. Agora cobertura é universal.
+
+**Princípio 11 estendido (kit v2.1):** detectar ANTES de instruir. Aqui aplica direto — chave existe e funciona = pula entrevista, mesmo padrão pra qualquer ambiente.
+
 ### 4 estados detectáveis
 
 | Estado | Ação |
@@ -58,31 +143,83 @@ Sem ele, aluno passa a jornada inteira digitando. Com ele, passa falando. Mudan
 
 ## Fluxo principal (quando precisa pedir chave)
 
-### 1. Narrar o que vai acontecer
+### 1. Narrar o que vai acontecer (SÓ se detecção do P11 mostrou que precisa pedir)
+
+⚠️ Se Princípio 11 acima mostrou **chave válida**: PULE este passo, vá direto pro smoke test (passo 5). Mensagem: "✓ Achei sua chave OpenAI no .env, validei, funcionando. Whisper + memória semântica já estão prontos. Vou rodar smoke test pra confirmar."
+
+⚠️ Se chave NÃO existe ou tá inválida, USA esse texto:
 
 ```
 "Antes da gente começar a jornada principal, vou configurar uma coisa
-que destrava você no celular: transcrição de áudio.
+que destrava muito: transcrição de áudio + memória semântica.
 
-Sem isso, você responde tudo digitando. Com isso, manda áudio e eu
-entendo. No celular ou no carro, vira diferença grande.
+Pra que serve a chave OpenAI:
+1. **Whisper** — transcrever áudio que você manda (no celular, no carro,
+   fala em vez de digitar)
+2. **Memória semântica** — embeddings que me deixam "lembrar" coisas
+   pelo SIGNIFICADO, não só pelo texto exato (recall de decisões
+   antigas, padrões em conteúdo, etc)
 
-Pra ativar, preciso de uma chave da OpenAI (a empresa do ChatGPT).
 Custa centavos por mês de uso (~R$2-5 pra uso pessoal médio).
 
-**Você quer ajuda pra pegar essa chave, ou já tem ela fácil aí?**
+**Você já tem chave OpenAI configurada, ou precisa de ajuda pra pegar?**
 
-→ Se já tem: só me manda aqui que eu salvo no lugar certo.
-→ Se quer ajuda: te guio passo-a-passo (cadastro OpenAI → cartão → gera chave). Pega 5min.
-→ Se não quiser agora: manda 'pulo' que a gente vai direto pro passo 1 (você ativa depois com 'configura whisper')."
+→ Se já tem (mas não tá no meu .env ainda): só me manda aqui que eu salvo
+→ Se quer ajuda pra pegar: te guio passo-a-passo (cadastro → cartão → gera chave). 5min.
+→ Se prefere avançar pro próximo passo: manda 'pula' que eu te dou 2 opções de retomada."
 ```
 
 Esperar resposta:
 - Se aluno mandar a chave direto (começa com `sk-proj-` ou `sk-`): pular pro passo 3 (validar) — não precisa instruir geração.
 - Se aluno mandar "ajuda" / "preciso ajuda" / "como pegar": ir pro passo 2 (instruir geração passo-a-passo).
-- Se aluno mandar "pulo" / "depois" / "deixa pra depois": marcar `whisper_skipped=true` e devolver controle pra `onboarding-checklist`.
+- Se aluno mandar "pulo" / "depois" / "deixa pra depois": ir pro passo 1.5 (tratar pulo com agenda vs definitivo) — **NÃO** marcar `whisper_skipped=true` direto.
 - Outras respostas ambíguas ("já tenho" sem mandar a chave): pedir pra mandar a chave.
 
+### 1.5. Tratar pulo (agendar 24h vs definitivo) — v1.9
+
+⚠️ **Nova seção v1.9 (Bruno feedback):** quando aluno escolhe pular uma etapa, NÃO marca `whisper_skipped=true` direto. Pergunta antes se quer agendar lembrete ou pular definitivo. Razão: pulo silencioso vira pendência órfã que aluno nunca lembra de retomar.
+
+```
+"Beleza, pulando o Whisper. Antes de avançar, escolhe uma:
+
+1. **Agendo lembrete pra daqui 24h** — te chamo aqui no Telegram amanhã
+   pra retomar esse passo (volta a perguntar se quer ativar)
+
+2. **Pulo definitivamente** — saio do caminho normal. Você pode voltar
+   quando quiser, é só me pedir 'ativa whisper' (ou 'configura whisper')
+
+Manda 1 ou 2."
+```
+
+**Comportamento por resposta:**
+
+| Resposta | Ação |
+|---|---|
+| `1` ou "agenda" / "lembra" / "amanhã" | Marcar `whisper_reminder_at: {NOW + 24h ISO}` em MEMORY.md. Confirmar: "Anotado. Te chamo amanhã (≈ {DATA_HORA_LOCAL}). Bora pro próximo passo." |
+| `2` ou "definitivo" / "pula tudo" | Marcar `whisper_skipped_permanently: true` em MEMORY.md. Confirmar: "Beleza, pulando definitivo. Lembrete: pode voltar quando quiser, é só me pedir 'ativa whisper'." |
+| Resposta ambígua | Repetir as 2 opções uma vez. Se persistir ambíguo, default seguro: opção 2 (pular definitivo, com aviso de retomada). |
+
+**Mecanismo do agendamento (v1.9 = MVP passivo):**
+
+- Flag `whisper_reminder_at: {timestamp}` é gravada em MEMORY.md
+- Quando aluno **abrir o Telegram naturalmente** depois das 24h, agente detecta a flag vencida e dispara mensagem de retomada — não precisa de cron-DM ativo
+- **Limitação consciente:** se aluno não voltar, lembrete não chega. Aceito como tradeoff até cron-worker por aluno existir (depende da Onda 12 — detecção ambiente Managed/VPS + infra de cron-DM ativo)
+- Mensagem de retomada (quando agente detecta flag vencida na próxima sessão): "Oi, lembra que você pediu pra eu te chamar sobre o Whisper? Quer ativar agora ou empurra mais?" → reabre 1.5
+
+**Independente da escolha (1 ou 2), salvar em MEMORY.md:**
+
+```markdown
+## Flags
+whisper_skip_choice: agendado | definitivo
+whisper_reminder_at: 2026-05-04T22:55:00-03:00  # só se opção 1
+whisper_skipped_permanently: true  # só se opção 2
+
+## Decisões da jornada
+- {data}: Pulou o passo 0 (Whisper) — escolha: {agendado | definitivo}
+```
+
+Após gravar flag e confirmar, **devolve controle pra `onboarding-checklist`** que segue pro passo 1.
+
 ### 2. Instruir como gerar chave
 
 ```

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

@@ -3,15 +3,34 @@ name: wizard-workspace
 status: ATIVO
 category: starter
 owner: aluno
-version: 1.0
+version: 1.1
 mode: guided
 estimated_time: 4min
 model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4, gemini-pro]
-description: Use when student types "organiza workspace" / "cria mapa", OR when dispatched by onboarding-checklist as passo 4. Creates minimal workspace structure (content/, memory/, skills/, archive/) + MAPA.md raiz + 4 local MAPAs (Princípio 12 — mapas distribuídos). Detects existing structure first (Princípio 11). Depends on passo 3 (autonomia) — without yolo, every mkdir asks for approval.
+description: Use when student types "organiza workspace" / "cria mapa", OR when dispatched by onboarding-checklist as passo 4. Creates minimal workspace structure (content/, memory/, skills/, archive/) + MAPA.md raiz + 4 local MAPAs (Princípio 12 — mapas distribuídos). Detects existing structure first (Princípio 11). Depends on passo 3 (autonomia) — without yolo, every mkdir asks for approval. v1.1 (kit v2.2): header com Princípios 13/14/15 explícitos no topo (auditoria pós-v2.1).
 ---
 
 # Wizard Workspace — Passo 4 (Estrutura mínima + mapas distribuídos)
 
+> 🔴 **PRINCÍPIOS NÃO-NEGOCIÁVEIS PRO AGENTE (kit v2.2):**
+>
+> **NÃO IMPROVISE.** Read este arquivo INTEIRO antes de falar com aluno. Não invente fluxo simplificado.
+>
+> **P13 — Guard Rail (wizard é passo bloqueante).** Toda mensagem do aluno é classificada:
+> - (a) resposta direta → processa, avança
+> - (b) comando canônico (`cancela`, `pula`, `voltar N`, `sobre`, `faq`, `corrige`, `muda modo`) → honra
+> - (c1) pergunta tangencial → responde 1 linha, traz de volta ao passo
+> - (c2) desvio total → anota em `## Perguntas pendentes` (MEMORY.md), traz de volta
+> - 3 desvios consecutivos no mesmo passo → oferecer pause com `wizard_resume_at` agendado
+>
+> **P14 — Smoke tests visíveis.** Comando externo SEMPRE mostra (1) comando exato em bloco de código, (2) output literal em bloco de código, (3) só DEPOIS interpreta/narra. Sem evidência = ABORTA e pede ajuda. NUNCA finge que rodou.
+>
+> **P15 — Mensagens `<canonical>` literais.** Trechos marcados `<canonical>...</canonical>` usam LITERAL. Não reformula, não "melhora", não substitui exemplos. Ajustar TOM (formal/casual via SOUL.md) é OK; estrutura/ordem/keywords técnicas preservadas.
+>
+> **P17 — Formatação Telegram-friendly.** Mensagens canonical pro aluno usam parágrafos contínuos (1 linha por parágrafo). NÃO quebrar manualmente a cada ~70 chars — Telegram faz word-wrap natural.
+>
+> Detalhes: `../onboarding-checklist/references/principios-defensivos.md` (P1–P17).
+
 ## Promessa
 
 Em 4min, o workspace do aluno passa de "pasta vazia" pra "estrutura mínima com lugar pra cada coisa". 4 pastas (`content/`, `memory/`, `skills/`, `archive/`) + 1 MAPA raiz + 4 mapas locais (Princípio 12).
@@ -354,7 +373,7 @@ Fechar com:
 ```
 "Se quer aprofundar workspace + sistema de mapas (e por que cada
 pasta tem MAPA.md local em vez de TOOLS.md gigante), a aula é a
-*B2* (Workspace + mapa externo) — manda 'aula B2'.
+Aula 6 (Organizando Workspace) — manda 'aula 6'.
 
 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
@@ -397,7 +416,7 @@ Atualizar `onboarding_current_step: 5`.
 - **Aluno tem `exec-policy=ask` (passo 3 não foi liberado):** wizard fica perguntando aprovação a cada mkdir. Avisar antes (ver "Dependência: passo 3" no início).
 - **Workspace tem conteúdo legado:** Princípio 10 (backup global) cobre. Tar.gz na pasta backups antes.
 - **Aluno não entende por que tem MAPA por pasta:** explicar Princípio 12. "Pasta gigante com tudo (TOOLS.md) cresce sem controle. Pasta documentada localmente cresce no escopo dela. Mais sustentável."
-- **Aluno quer adicionar `pendencias.md` já no setup:** ok, mas avisar que isso é da aula B3 (memória prática). Pode criar agora vazio.
+- **Aluno quer adicionar `pendencias.md` já no setup:** ok, mas avisar que isso é da Aula 7 (Boas Práticas para melhorar a Memória). Pode criar agora vazio.
 - **Aluno quer pular essa pasta (skills/, archive/):** explicar que estrutura mínima é mínima por design. Pular skills/ ou archive/ quebra wizards futuros (passo 5 instala skills, passo 6 pode arquivar drafts).
 
 ## Aplicação dos princípios defensivos

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

@@ -47,7 +47,7 @@
           "user": "post em content/drafts, decisão em memory/decisoes",
           "expected_agent_behavior": [
             "valida resposta correta",
-            "menciona aula B2",
+            "menciona Aula 6",
             "marca workspace_organizado=true",
             "atualiza onboarding_current_step=5"
           ]

package/assets/templates/HEARTBEAT.template.md

@@ -0,0 +1,58 @@
+# HEARTBEAT.md
+
+> Configuração do mecanismo de proatividade do agente. Define COMO ele vigia
+> seu dia. O que ele vigia mora em `memory/hot.md` (auto-mantido).
+>
+> Edite este arquivo quando quiser mudar comportamento (frequência, checks,
+> regras de silêncio). O agente recarrega no próximo poll.
+
+## Frequência
+
+- **Poll a cada:** [30 minutos]
+- **Janela ativa:** [08:00 às 22:00]
+- **Quiet hours:** [22:00 às 08:00] — só interrompe em urgência real
+
+## Checks rotacionáveis
+
+> O agente sorteia 2-4 destas por heartbeat (não checa todas juntas — vira ruído).
+> Comente com `#` as que não quer ativar agora.
+
+- [ ] **Inbox triage** — emails das últimas 4h, classifica em [urgente/pode esperar/lixo], avisa só urgentes
+- [ ] **Calendário próximo** — próximas 24-48h, lembra de evento amanhã 1 dia antes às 18h
+- [ ] **Mention sweep** — LinkedIn/Twitter/menções, só relevantes pro negócio
+- [ ] **Pendências paradas** — itens em `pendencias.md` com nome de terceiro parado 3+ dias
+- [ ] **Memory maintenance** — a cada 3 dias, extrai aprendizados de `memory/YYYY-MM-DD.md` pra `MEMORY.md`
+- [ ] **Weather guard** — se evento externo hoje, checa previsão e avisa só se chuva real
+- [ ] **News watch** — 2-3 fontes que importam (newsletters, RSS), só se algo realmente novo
+
+## Regras de silêncio (anti-spam)
+
+- Já checou nos últimos 30min? → `HEARTBEAT_OK` (silencioso)
+- Nada novo desde a última checagem? → silêncio (não mandar "tudo certo!" gratuito)
+- Você em modo focado (call, trabalho profundo)? → segura mensagem não-urgente pro próximo break
+- Quiet hours ativas? → só interrompe se for urgência real (deadline em 2h, alerta crítico)
+
+## Regras de reach out (quando vale interromper)
+
+- Email importante chegou (cliente ativo, prazo, financeiro)
+- Evento começa em <2h e você ainda não confirmou
+- Achou algo genuinamente interessante (oportunidade, ameaça, sinal forte)
+- Faz mais de 8h sem dizer nada e tem coisa relevante acumulada
+
+## Como o heartbeat consulta contexto
+
+O heartbeat NÃO duplica memória. Ele lê `memory/hot.md` (auto-mantido pela
+pipeline + skill /salve) pra saber:
+
+- Top prioridades da semana
+- Negociações ativas e próximos passos pendentes
+- Decisões recentes
+- Métricas-chave
+- Prazos críticos por data
+
+Se algum prazo de `hot.md` chega perto e ainda tá pendente, heartbeat te avisa.
+
+---
+
+> **Histórico de ajustes:**
+> - YYYY-MM-DD: criado pelo onboarding do Starter Kit

package/assets/templates/README.md

@@ -1,8 +1,10 @@
 # Templates — Starter Kit OpenClaw v2
 
-> Templates raiz `.template` que os wizards usam pra criar arquivos no workspace do aluno.
+> 2 grupos: **estruturais** (preenchidos pelos wizards na configuração inicial) e **de output** (usados pelo aluno pra produzir reports/material).
 
-## O que tem aqui
+## 1. Templates estruturais (.md)
+
+Templates raiz que os wizards usam pra criar arquivos no workspace do aluno durante o setup.
 
 | Template | Usado pelo wizard | Cria no workspace |
 |---|---|---|
@@ -11,8 +13,9 @@
 | `AGENTS.template.md` | wizard-agente | `AGENTS.md` |
 | `USER.template.md` | wizard-aluno | `USER.md` |
 | `MAPA.template.md` | wizard-workspace | `MAPA.md` (raiz) |
+| `HEARTBEAT.template.md` | wizard-autonomia (heartbeats) | `HEARTBEAT.md` |
 
-## Como funcionam
+### Como funcionam
 
 Cada template tem **placeholders** entre chaves (ex: `{NOME_AGENTE}`, `{DATA}`). O wizard:
 
@@ -21,7 +24,7 @@ Cada template tem **placeholders** entre chaves (ex: `{NOME_AGENTE}`, `{DATA}`).
 3. Substitui cada `{PLACEHOLDER}` pelo valor coletado
 4. Salva o arquivo final no workspace do aluno
 
-## Placeholders comuns
+### Placeholders comuns
 
 | Placeholder | Origem |
 |---|---|
@@ -41,22 +44,71 @@ Cada template tem **placeholders** entre chaves (ex: `{NOME_AGENTE}`, `{DATA}`).
 | `{NOME_USER}` | extraído de USER.md (campo `Como me chamar`) |
 | `{DATA}` | data atual no formato YYYY-MM-DD |
 
-## Mapas locais (criados pelo wizard-workspace)
+### Mapas locais (criados pelo wizard-workspace)
+
+Os 4 mapas locais (`content/MAPA.md`, `memory/MAPA.md`, `skills/MAPA.md`, `archive/MAPA.md`) são gerados **inline** pelo `wizard-workspace/SKILL.md` (não tem template `.md` separado pra eles). O conteúdo é simples e pouco varia por aluno — não compensa template separado.
+
+---
+
+## 2. Templates de output (.html)
+
+Templates de **artefato final** que o aluno usa pra gerar reports, diagnósticos e material didático ao longo do uso. Cumpre a promessa da Aula 8 do mini-curso ("vocês têm aqui o Template Report, Template Report Executivo, Material Didático").
+
+| Template | Pra que serve | Paleta |
+|---|---|---|
+| `template-report.html` | Análise semanal · deep dive · post-mortem · review de campanha | teal/jade + dourado · slate dark |
+| `template-report-executivo.html` | Diagnóstico estratégico · leitura pra board · decisão go/no-go · kick-off de cliente | violeta + rosa · deep purple-black |
+| `template-material-didatico.html` | Aula · playbook · tutorial · guia passo-a-passo · material de mentoria | sky cyan + lime · navy ink |
+
+### Como o aluno usa
+
+1. Pede pro agente: "abre o template de report" / "preciso fazer um diagnóstico" / "gera material didático sobre X"
+2. Agente copia o `.html` pro `content/drafts/{tema}.html` do aluno
+3. Aluno preenche os `{{ MARCADORES }}` (ou pede pro agente preencher com base num briefing)
+4. Aluno apaga seções que não usa, salva, exporta como PDF se quiser
+
+### Características comuns aos 3
+
+- **Logo Pixel** discreta no topo + footer com assinatura "Pixel Educação · Template oficial OpenClaw v2"
+- **Não usam a paleta oficial Pixel** (laranja/azul-marinho). Cada template tem paleta própria pra evitar diluir a marca quando aluno publicar
+- **Plus Jakarta Sans** (font universal Pixel — mantida)
+- **Dark premium editorial** (estilo canônico Pixel — manteve direção visual, trocou só cromática)
+- **Self-contained**: SVG do logo embutido em base64, fontes via Google CDN — funciona stand-alone, sem servidor
+- **Comentários `<!-- aluno preenche aqui -->`** guiando preenchimento
+- **Print-friendly** (CSS `@media print` configurado)
 
-Os 4 mapas locais (`content/MAPA.md`, `memory/MAPA.md`, `skills/MAPA.md`, `archive/MAPA.md`) são gerados **inline** pelo `wizard-workspace/SKILL.md` (não tem template `.md` separado pra eles).
+### Sanitização
 
-Razão: o conteúdo é simples e pouco varia por aluno — não compensa um template separado.
+Os 3 templates foram derivados de reports REAIS da Pixel (Roberto Rocha · Naatooh · Pixel AI Track) que vivem em `memory/assets/pixel-educacao/references/templates/`. Esses originais NÃO devem virar templates públicos — têm dados de cliente. As versões em `starter-kit/templates/` são as sanitizadas, com placeholders.
 
-Se no futuro a customização ficar necessária, mover pra cá como `{nome}-MAPA.template.md`.
+### Espelho no Google Drive (planejado)
+
+A intenção é manter espelho público no Drive da Pixel pra alunos que preferem baixar e abrir no Word/Notion sem passar pelo agente. Estrutura sugerida:
+
+```
+📁 OpenClaw v2 — Templates (Drive público)
+├── 📁 estruturais (preenche na Aula 5)
+│   ├── IDENTITY.template.md
+│   ├── SOUL-stub.template.md
+│   ├── AGENTS.template.md
+│   ├── USER.template.md
+│   └── MAPA.template.md
+└── 📁 outputs (mostra na Aula 8)
+    ├── template-report.html
+    ├── template-report-executivo.html
+    └── template-material-didatico.html
+```
+
+---
 
 ## Quando atualizar templates
 
-- Quando estrutura padrão dos arquivos raiz mudar (ex: adicionar campo novo no IDENTITY)
-- Quando placeholder novo for necessário (ex: `{NICHO}` se algum dia perguntar nicho do aluno)
-- Quando wording melhorar (ex: revisar tom dos comentários no template)
+- **Estruturais (.md):** quando estrutura padrão dos arquivos raiz mudar (ex: adicionar campo novo no IDENTITY) ou quando placeholder novo for necessário
+- **Outputs (.html):** quando descobrir que aluno reclama de seção que falta, ou quando paleta/branding Pixel evoluir e fizer sentido refletir
 
-**NÃO atualizar pra ajustes de UX dos wizards** — esses são os scripts (SKILL.md), não os outputs.
+**NÃO atualizar pra ajustes de UX dos wizards** — esses são os scripts (SKILL.md), não os templates.
 
 ---
 
-*Templates v1 — criados junto com a Onda 2 dos wizards filhos (02/05/2026).*
+*Templates estruturais v1 — criados junto com Onda 2 dos wizards filhos (02/05/2026).*
+*Templates de output v1 — criados pra cumprir promessa da Aula 8 da Hotmart (07/05/2026).*

package/assets/templates/SOUL-stub.template.md

@@ -19,7 +19,7 @@ Sou {NOME_AGENTE}, agente do {NOME_USER}.
 ---
 
 > **STUB — versão inicial.**
-> Esta SOUL.md vai crescer ao longo do uso. A aula B1 do mini-curso ensina a expandir.
+> Esta SOUL.md vai crescer ao longo do uso. A Aula 5 do mini-curso ensina a expandir.
 > Quando você descobrir padrões de como QUER que eu me comporte, adiciona aqui.
 > Veja `starter-kit/exemplos/SOUL-amora.md` pra exemplo de SOUL maduro (~150 linhas).