@pixeleducacao/curso-openclaw 2026.5.8

package/assets/skills/canais/wizard-whatsapp/SKILL.md

@@ -0,0 +1,334 @@
+---
+name: wizard-whatsapp
+status: ATIVO
+category: canais
+owner: aluno
+version: 1.0
+mode: guided
+estimated_time: 15-45min (varia por modo escolhido)
+model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4]
+description: Use when student types "ativa whatsapp" / "configura whatsapp" / "quero usar whatsapp", typically AFTER finishing primeira-vitoria (next-step optional). Configures WhatsApp as additional channel beyond Telegram, with 2 modes (sessão própria / chip dedicado). Default behavior: read-only — agent only responds when EXPLICITLY mentioned/triggered, NOT to every message. Asks use case BEFORE configuring (Princípio 7 — em dúvida, pergunta).
+---
+
+# Wizard WhatsApp — Canal Opcional Pós-Vitória
+
+## Promessa
+
+Aluno ativa WhatsApp como canal extra do agente. NÃO substitui Telegram (que continua o canal principal — UX da checklist depende dele). Adiciona caminho alternativo pra interagir com agente quando WhatsApp é mais conveniente (mobile, mensagens curtas, áudio).
+
+**Default crítico:** modo **read-only** — agente NÃO responde proativamente a todas as mensagens. Responde só quando aluno aciona explicitamente.
+
+## Quando disparar
+
+**Trigger explícito (sempre — não é trigger automático):**
+- "ativa whatsapp"
+- "configura whatsapp"
+- "quero usar whatsapp"
+- "adiciona whatsapp"
+
+**NÃO disparar se:**
+- `whatsapp_active=true` em `MEMORY.md` E sessão WhatsApp ainda válida (token não expirou)
+
+Esse wizard NÃO é parte da jornada principal — é opcional pós-primeira-vitória.
+
+## Pergunta zero — caso de uso ANTES de configurar (Princípio 7)
+
+Antes de qualquer config técnica, perguntar caso de uso:
+
+```
+"Antes de mexer em WhatsApp, me conta: pra que você quer usar?
+
+Casos comuns:
+
+a) Eu quero mandar mensagem pro agente do meu WhatsApp pessoal
+   (em vez de abrir Telegram). Mais cômodo no mobile.
+
+b) Eu tenho um chip dedicado (ex: número de empresa) e quero o
+   agente atendendo lá com regras claras.
+
+c) Quero o agente respondendo grupos/contatos automaticamente
+   (suporte, atendimento, vendas).
+
+d) Outro — me conta.
+
+Manda 'a', 'b', 'c' ou descreve."
+```
+
+**Por que perguntar antes:** os 3 casos precisam de SETUP DIFERENTE. Caso 'c' (resposta automática) tem riscos sérios (agente respondendo contato pessoal sem querer). Caso 'a' é mais simples. Caso 'b' é o intermediário.
+
+### Resposta por caso
+
+#### Caso 'a' — sessão própria (WhatsApp pessoal do aluno)
+
+```
+"Entendi. Caso A: sua sessão WhatsApp pessoal vinculada ao agente.
+
+Implicações importantes:
+
+✓ Você manda áudio/texto pro agente como se fosse contato seu
+✓ Agente responde só PRA VOCÊ (o número que você usar pra mandar)
+✗ Agente NUNCA responde outros contatos seus por padrão (read-only)
+✗ Conexão depende de Linked Devices (mesma sessão do app — agente
+    'lê suas mensagens', mas só responde quando você manda em chat
+   1:1 contigo mesmo)
+
+Modo correto: você cria um chat com você mesmo no WhatsApp
+('Mensagem para si próprio') e usa esse chat como canal.
+
+Tradeoff vs Telegram: WhatsApp não suporta UI visual da checklist
+(botões inline, atualização in-place). Tudo vira texto plano.
+A jornada principal ficou no Telegram por isso.
+
+Quer prosseguir com setup A? Manda 'sim' ou 'mudei de ideia'."
+```
+
+#### Caso 'b' — chip dedicado
+
+```
+"Entendi. Caso B: chip dedicado (número de empresa ou separado).
+
+Implicações:
+
+✓ Agente atende esse número com regras claras
+✓ Não mistura com seu WhatsApp pessoal (separação limpa)
+✗ Custo: chip + plano (~R$ 15-30/mês) + setup ~30min
+
+Setup envolve:
+1. Você configura WhatsApp Business API ou Linked Devices nesse chip
+2. Agente conecta a esse chip
+3. Definimos regras: atende ou só lê? Quais contatos?
+
+Esse caso é mais robusto pra casos PROFISSIONAIS (atendimento,
+suporte). Pra uso pessoal o Caso A já basta.
+
+Quer prosseguir com B? Manda 'sim' ou 'volto pro A'."
+```
+
+#### Caso 'c' — atendimento automático
+
+```
+"Entendi. Caso C tem RISCO sério que você precisa pesar antes
+de seguir.
+
+⚠️  RISCO: se eu respondo automático em grupos/contatos do seu
+WhatsApp pessoal, posso responder por você em conversa que não
+era pra mim. Casos reais já aconteceram:
+ - Agente respondendo grupo de família com contexto profissional
+ - Agente respondendo cliente quando aluno não queria
+ - Agente vazando contexto de outras conversas
+
+Pra fazer C com segurança:
+
+1. Use chip DEDICADO (Caso B), não WhatsApp pessoal
+2. Whitelist de contatos que agente PODE responder (lista explícita)
+3. Modo de aprovação: agente sugere resposta, você aprova antes de enviar
+
+Posso configurar C com chip dedicado + whitelist + aprovação manual.
+
+Quer:
+a) Seguir com chip dedicado + segurança extra (Caso B+ na real)
+b) Voltar pro Caso A (uso pessoal seguro)
+c) Pular WhatsApp por enquanto"
+```
+
+#### Caso 'd' — outro
+
+```
+"Manda detalhe do que você quer fazer. Vou avaliar se cabe num
+dos modos existentes ou se precisa abordagem custom."
+```
+
+## Princípio 11 — Detecção (sempre, antes do setup técnico)
+
+Após aluno escolher caso, antes de configurar, detectar:
+
+```
+1. WhatsApp Web/Linked Device já configurado no Managed?
+2. Chip dedicado já registrado?
+3. Tokens válidos no .env (WHATSAPP_SESSION_TOKEN, etc)?
+```
+
+Se já tudo pronto: marca `whatsapp_active=true` e vai pra teste.
+
+## Fluxo Caso A (sessão própria — mais comum)
+
+### 1. Aluno escaneia QR code
+
+```
+"Vou gerar QR code do WhatsApp Web pra você escanear.
+
+Isso vincula a sessão do agente ao seu WhatsApp pessoal — mesma
+mecânica de quando você usa WhatsApp Web no navegador.
+
+[gera QR via openclaw whatsapp link-qr]
+
+Abre o WhatsApp no celular →
+Configurações →
+Aparelhos conectados →
+'Conectar um aparelho' →
+Escaneia o QR.
+
+Quando vincular, manda 'conectado' aqui."
+```
+
+### 2. Validar conexão
+
+```bash
+openclaw whatsapp status
+```
+
+Se conectado: prossegue. Se não: investigar (provavelmente QR expirou ou não foi escaneado).
+
+### 3. Configurar regras default — read-only
+
+```
+"Configuração padrão (recomendada): MODO READ-ONLY.
+
+O que significa:
+✓ Eu LEIO todas as suas mensagens (pra você poder me invocar)
+✗ Eu NUNCA respondo automaticamente
+✓ Eu respondo SÓ quando você manda mensagem pra mim explicitamente
+   (no chat 'Você mesmo')
+
+Como invocar quando precisar:
+- No chat 'Você mesmo' (Mensagem para si próprio): qualquer mensagem
+  é uma instrução pra mim
+- Em outros chats: começa mensagem com '@agente' (ou nome configurado)
+   pra acionar — fora isso, fico quieta
+
+Confirma esse modo? Ou prefere customizar?"
+```
+
+Salvar config:
+
+```bash
+openclaw whatsapp config --mode=read-only \
+                          --self-chat-trigger=any \
+                          --other-chat-trigger="@agente"
+```
+
+### 4. Smoke test
+
+```
+"Manda mensagem pra mim no chat 'Você mesmo' agora.
+
+Pode ser 'oi' ou áudio curto — qualquer coisa.
+Eu respondo aqui ou no WhatsApp?
+"
+```
+
+Pergunta extra: "qual canal prefere pra resposta?" (default: mesmo canal — WhatsApp).
+
+Quando aluno mandar, validar end-to-end.
+
+### 5. Atualizar MEMORY.md
+
+```markdown
+## Flags
+whatsapp_active: true
+whatsapp_mode: read-only
+whatsapp_caso: A (sessão própria)
+
+## Decisões da jornada
+- {data}: Ativou WhatsApp. Modo: read-only. Caso: A. Trigger em outros chats: @agente.
+```
+
+### 6. Aviso final
+
+```
+"✓ WhatsApp ativo (modo read-only).
+
+Importantes:
+
+🔒 Privacidade: eu vejo TODAS suas mensagens (limitação do WhatsApp Web).
+   Mas só processo as que são pra mim (chat 'Você mesmo' ou @agente).
+   Mensagens privadas suas com outros contatos não viram contexto meu.
+
+⏱️  Sessão expira em ~14 dias se WhatsApp Web ficar offline. Pra renovar,
+   manda 'renova whatsapp' que eu gero novo QR.
+
+🛑 Pra desativar a qualquer momento:
+   'desativa whatsapp' — agente para de processar WhatsApp imediatamente.
+   Sessão Linked Device permanece (pra reativar fácil) até você desconectar
+   manualmente no app."
+```
+
+## Fluxo Caso B (chip dedicado)
+
+Mais complexo. Setup principal:
+
+1. Aluno informa número do chip
+2. Configura WhatsApp Business API ou Linked Device no chip
+3. Agente conecta via API key (formato `WHATSAPP_BUSINESS_TOKEN` no `.env`)
+4. Define lista de contatos que agente atende (whitelist) — opcional
+5. Smoke test
+
+Detalhes específicos do Business API ficam em `references/whatsapp-business-setup.md` (criar quando necessário).
+
+## Fluxo Caso C (atendimento automático)
+
+Sempre redireciona pra Caso B+ (chip dedicado + whitelist + aprovação):
+
+```
+"Pra atendimento automático seguro: chip dedicado + whitelist explícita
+de contatos + modo aprovação (agente sugere resposta, você aprova antes
+de enviar).
+
+Modo aprovação evita 90% dos riscos. Você dorme tranquilo sabendo que
+nada sai sem sua palavra.
+
+Vou configurar como Caso B+ — manda 'segue B+' pra prosseguir."
+```
+
+## Critérios de sucesso
+
+- [ ] Caso de uso identificado e confirmado pelo aluno
+- [ ] Sessão WhatsApp conectada (QR escaneado OU API token válido)
+- [ ] Modo correto configurado (read-only por default)
+- [ ] Smoke test passou
+- [ ] `whatsapp_active=true` em `MEMORY.md`
+- [ ] `whatsapp_mode` e `whatsapp_caso` registrados
+- [ ] Aluno informado de privacidade + expiração + comando de desativação
+
+## Erros comuns
+
+- **QR expirou antes de aluno escanear:** padrão WhatsApp Web (45s). Gerar novo.
+- **Aluno escolheu Caso C sem entender risco:** sempre redirecionar pra B+ (Princípio 7 — em dúvida, perguntar). Não configurar atendimento automático em WhatsApp pessoal.
+- **Aluno tem 2+ números:** WhatsApp Web aceita 1 sessão por dispositivo. Esclarecer qual número será o canal.
+- **Sessão derrubada por outra conexão:** se aluno conectar WhatsApp Web em outro lugar, pode invalidar a sessão do agente. Avisar antes.
+
+## Aplicação dos princípios defensivos
+
+- **Princípio 2 (confirmação):** confirma cada escolha (caso, modo, trigger).
+- **Princípio 3 (NUNCA elevação):** NÃO escala automaticamente do read-only pra atendimento sem confirmação explícita do aluno.
+- **Princípio 4 (narrar antes):** explica o que cada modo FAZ antes de configurar.
+- **Princípio 5 (atualizar MEMORY):** múltiplas flags (mode, caso, expiração).
+- **Princípio 7 (em dúvida, pergunta):** caso C sempre cai em B+ — não assume que aluno sabe risco.
+- **Princípio 11 (detectar antes):** lê estado WhatsApp antes de pedir QR.
+
+## Decisões arquiteturais
+
+- **D14 (Telegram-only no kit core):** WhatsApp é OPCIONAL pós-vitória. Não substitui Telegram da jornada.
+- **D15 (read-only default):** modo conservador inicial. Aluno escolhe expandir se quiser.
+
+Ver: [`../../../DECISOES-ARQUITETURA.md`](../../../DECISOES-ARQUITETURA.md)
+
+## Referências
+
+### Internas
+- Princípios: [`../../starter/onboarding-checklist/references/principios-defensivos.md`](../../starter/onboarding-checklist/references/principios-defensivos.md)
+
+### Externas
+- WhatsApp Web FAQ: https://faq.whatsapp.com/general/download-and-installation/about-whatsapp-web
+- WhatsApp Business API: https://business.whatsapp.com/products/business-platform
+
+## Status
+
+✅ ATIVO desde v1 do Starter Kit (02/05/2026).
+
+## Roadmap
+
+- v1.1: Suporte a múltiplos canais simultâneos (Telegram + WhatsApp + Slack)
+- v1.2: Whitelist visual no Telegram (aluno gerencia "quem agente pode responder no WhatsApp")
+- v1.3: Modo aprovação manual (agente sugere → aluno aprova → envia) pra atendimento
+- v2: Routing inteligente — agente decide qual canal usar baseado no tipo de mensagem

package/assets/skills/operacional/_registry.md

@@ -0,0 +1,20 @@
+# Registry — operacional/ (skills utilities)
+
+> Skills utilities pra operação contínua do agente.
+> Não fazem parte da jornada obrigatória do starter-kit, mas são instaladas/ativadas durante ela.
+
+## Skills
+
+| Skill | Status | Versão | Owner | Mode | Quando ativar |
+|---|---|---|---|---|---|
+| [`backup-workspace-github`](backup-workspace-github/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | Item "Integrações" da checklist (módulo 7) ou comando "ativa backup" |
+
+## Princípios universais
+
+Todas as skills aqui herdam os princípios defensivos da `onboarding-checklist`. Ver: [`../starter/onboarding-checklist/references/principios-defensivos.md`](../starter/onboarding-checklist/references/principios-defensivos.md).
+
+## Roadmap (skills futuras)
+
+- `health-check` — diagnóstico do estado do agente (skills, crons, integrações)
+- `restore-from-backup` — reverte workspace pra estado anterior do GitHub
+- `clean-orphans` — remove arquivos órfãos detectados em pastas

package/assets/skills/operacional/backup-workspace-github/SKILL.md

@@ -0,0 +1,246 @@
+---
+name: backup-workspace-github
+status: ATIVO
+category: operacional
+owner: aluno
+version: 1.0
+mode: guided
+estimated_time: 5min (ativação) + automatic (cron)
+model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4]
+description: Use when student wants automatic daily backup of workspace to private GitHub repo. Activates during item "Integrações" of the wizard checklist OR standalone when student types "ativa backup github" / "configura backup". Combines openclaw backup create + git push to student's private repo. Cron daily at 03:00 BRT. Maintains 30-day history. Notifies via Telegram on failure.
+---
+
+# Backup Workspace GitHub
+
+## Promessa
+
+O workspace inteiro do aluno (skills, memory, configs, arquivos raiz — exceto `.env`) é versionado automaticamente todo dia em um repo privado do GitHub. Se algo der errado (deleção acidental, bug do Managed, hardware fail), aluno restaura pelo histórico de commits.
+
+## Quando disparar
+
+**Trigger automático (durante jornada):**
+- Aluno chega no item "Integrações" da checklist (módulo 7) e fornece o GitHub Service Token
+
+**Trigger explícito (standalone):**
+- "ativa backup github"
+- "configura backup"
+- "quero backup do workspace"
+
+**NÃO disparar se:**
+- Cron `backup-workspace-github` já tá rodando (verificar via `openclaw cron list`)
+- Aluno explicitamente desativou backup (`backup_disabled=true` em `MEMORY.md`)
+
+## Princípio 11 — Detectar antes de pedir
+
+Antes de qualquer coisa, **detectar** estado atual:
+
+```
+1. Lê .env: existe GITHUB_TOKEN?
+2. Roda `openclaw cron list`: existe cron backup-workspace-github?
+3. Verifica se repo privado existe no GitHub do aluno
+```
+
+**Casos:**
+
+| Estado | Ação |
+|---|---|
+| Tudo configurado e rodando | "✓ Backup já tá ativo. Último push: {timestamp}. Próximo: hoje 03:00." |
+| Token existe mas cron não | Ativa cron com token existente (skip pedir token) |
+| Token não existe | Pede token (segue fluxo "credencial não encontrada" do Princípio 11/.env first) |
+| Repo não existe | Cria repo privado no GitHub do aluno via API |
+
+## Princípio ".env first"
+
+Token GitHub segue padrão universal de credenciais:
+
+1. Tenta ler `GITHUB_TOKEN` do `.env`
+2. Se achou e funciona (call de teste à API GitHub): usa direto
+3. Se achou mas inválido: explica erro e pede novo token
+4. Se não achou: pede ao aluno (uma vez)
+5. Salva no `.env` com nome canônico `GITHUB_TOKEN`
+
+**Como aluno gera o token:**
+
+```
+"Pra criar GitHub Service Token:
+
+1. Acessa https://github.com/settings/tokens (logado)
+2. Clica 'Generate new token (classic)'
+3. Nome sugerido: 'openclaw-backup-{seu-agente}'
+4. Expiration: 'No expiration' (ou 1 ano se preferir rotacionar)
+5. Marca scopes: 'repo' (acesso completo a repos privados)
+6. Clica 'Generate token' no fim
+7. Copia o token (começa com ghp_...) e cola aqui
+
+Atenção: o token só é mostrado UMA vez. Copia agora."
+```
+
+## Fluxo de configuração
+
+### 1. Validar token GitHub
+
+Após receber token, agente roda:
+
+```bash
+curl -s -H "Authorization: token GITHUB_TOKEN" https://api.github.com/user
+```
+
+Se retorna 200 com info do usuário: ✓ token válido
+Se retorna 401: token inválido — pede novo
+Se outro erro: investiga e reporta
+
+### 2. Criar repo privado (se não existir)
+
+Nome padrão: `{username-github}-workspace-backup`
+
+```bash
+curl -X POST -H "Authorization: token GITHUB_TOKEN" \
+     https://api.github.com/user/repos \
+     -d '{"name": "{nome}", "private": true, "auto_init": true}'
+```
+
+Confirmação ao aluno: "✓ Repo criado: github.com/{username}/{nome}-workspace-backup (privado)"
+
+### 3. Configurar git local no workspace
+
+```bash
+cd $WORKSPACE
+git init  # se não estiver inicializado
+git remote add backup https://{TOKEN}@github.com/{username}/{nome}-workspace-backup.git
+```
+
+**Importante:** o token vai inline no remote URL. Cuidado com vazamento — não commitar `.git/config` em outro repo.
+
+### 4. Criar `.gitignore` defensivo
+
+Adicionar/verificar entradas no `.gitignore` do workspace:
+
+```
+.env
+.env.local
+.env.*.local
+*.key
+*.pem
+*-credentials.json
+.tmp-*
+```
+
+**Crítico:** `.env` NUNCA vai pro backup. Chaves API ficam só no Managed do aluno.
+
+### 5. Criar cron diário
+
+```bash
+openclaw cron create \
+  --name "backup-workspace-github" \
+  --schedule "0 3 * * *" \
+  --tz "America/Sao_Paulo" \
+  --command "cd $WORKSPACE && \
+             openclaw backup create && \
+             git add -A && \
+             git commit -m \"backup: $(date +%Y-%m-%d-%H%M)\" && \
+             git push backup main"
+```
+
+Confirma ao aluno: "✓ Cron configurado: diário às 03:00 BRT"
+
+### 6. Primeiro push manual (smoke test)
+
+Roda imediatamente uma vez pra confirmar que funciona end-to-end:
+
+```bash
+cd $WORKSPACE
+git add -A
+git commit -m "backup: initial setup $(date +%Y-%m-%d-%H%M)"
+git push backup main
+```
+
+Se sucesso: "✓ Primeiro backup feito. Você pode ver em https://github.com/{username}/{nome}-workspace-backup"
+
+Se erro: investiga (provavelmente .gitignore mal configurado ou token sem scope correto) e reporta.
+
+### 7. Atualizar MEMORY.md
+
+```markdown
+- {data}: backup-workspace-github ativado. Repo: {url}. Cron: 03:00 BRT.
+```
+
+E flag: `backup_active: true`
+
+## Critérios de sucesso
+
+- [ ] `GITHUB_TOKEN` no `.env` e validado
+- [ ] Repo privado criado no GitHub do aluno
+- [ ] `.gitignore` exclui `.env` e secrets
+- [ ] Cron `backup-workspace-github` rodando
+- [ ] Primeiro push manual completou com sucesso
+- [ ] `backup_active: true` em `MEMORY.md`
+
+## Erros comuns
+
+- **Token sem scope `repo`:** GitHub retorna 404 ao tentar criar repo. Pedir aluno regenerar token marcando `repo`.
+- **`.env` indo pro backup:** falha catastrófica. SEMPRE validar `.gitignore` antes do primeiro push.
+- **Repo nome conflita:** se já existir repo com mesmo nome, sufixar com `-2`, `-3`, etc.
+- **Workspace tem outro remote configurado:** usar `backup` como nome do remote (não `origin`) pra não conflitar.
+- **Cron silenciosamente falha:** configurar notificação via Telegram quando cron falha (próxima versão).
+
+## Histórico de commits
+
+Cada backup vira commit separado. Aluno consegue:
+
+- Ver histórico: `git log backup/main`
+- Restaurar versão antiga: `git checkout backup/main~7` (volta 7 dias)
+- Ver diff: `git diff backup/main~1 backup/main` (mudanças do último dia)
+
+Histórico de 30 dias garantido por convenção. Mais que isso, GitHub não cobra extra (repo privado free tier).
+
+## Limpeza/desativação
+
+Se aluno quiser parar:
+
+```
+"desativa backup"
+```
+
+Comportamento:
+1. Remove cron: `openclaw cron remove backup-workspace-github`
+2. Marca `backup_disabled: true` em `MEMORY.md`
+3. **NÃO deleta repo** — fica no GitHub do aluno como histórico
+4. **NÃO remove `GITHUB_TOKEN` do .env** — pode ser útil pra outras integrações
+5. Confirma: "✓ Backup desativado. Repo histórico continua em {url}. Reativar a qualquer momento com 'ativa backup'."
+
+## Atualização do TOOLS (se existir)
+
+Esta skill aplica Princípio 12 (mapas distribuídos). Se aluno tiver `skills/operacional/MAPA.md`, atualizar com:
+
+```markdown
+| backup-workspace-github | Backup diário do workspace pro GitHub privado | ativo |
+```
+
+Não criar TOOLS.md monolítico (Princípio 12 proíbe).
+
+## Princípios Defensivos
+
+Esta skill herda os princípios universais da `onboarding-checklist`. Ver: `skills/starter/onboarding-checklist/references/principios-defensivos.md`.
+
+### Aplicação específica
+
+- **Princípio 1 (backup antes):** N/A — esta skill É backup. Mas valida `.gitignore` antes do primeiro push (proteção equivalente)
+- **Princípio 2 (confirmação):** pede confirmação antes de criar cron (afeta infra)
+- **Princípio 11 (detectar antes de pedir):** lê estado atual antes de configurar — se já tá rodando, não duplica
+- **Princípio ".env first":** GitHub Token segue padrão universal de credenciais
+
+## Referências
+
+- Padrão `.env first`: `skills/starter/onboarding-checklist/references/principios-defensivos.md` (Princípio 11)
+- Como GitHub gera tokens: https://github.com/settings/tokens
+- Documentação `openclaw cron`: rodar `openclaw cron --help`
+
+## Status
+
+✅ ATIVO desde v1 do Starter Kit (02/05/2026).
+
+## Roadmap
+
+- v1.1: Notificação automática via Telegram quando cron falha
+- v1.2: Comando "restaura do backup {data}" pra reverter workspace
+- v2: Suporte a múltiplos remotes (backup pra mais de 1 repo simultâneo)

package/assets/skills/planejamento/_registry.md

@@ -0,0 +1,70 @@
+# Registry — planejamento/ (Superpowers curado)
+
+> 4 skills de pensamento/processo curadas do projeto open-source [obra/superpowers](https://github.com/obra/superpowers).
+> Adaptadas/simplificadas pro contexto do mini-curso OpenClaw v2.
+
+## Skills
+
+| Skill | Status | Versão | Owner | Mode | Tempo |
+|---|---|---|---|---|---|
+| [`brainstorming`](brainstorming/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 5-15min |
+| [`writing-plans`](writing-plans/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 10-30min |
+| [`executing-plans`](executing-plans/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | varia |
+| [`verification-before-completion`](verification-before-completion/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 5-15min |
+
+## Fluxo recomendado
+
+```
+brainstorming (entender problema)
+↓
+writing-plans (transformar em plano executável)
+↓
+executing-plans (tirar do papel)
+↓
+verification-before-completion (provar que terminou)
+```
+
+Não precisa rodar todas. Pra projetos pequenos, brainstorming + verification já cobre. Pra projetos médios/grandes, todas as 4 valem.
+
+## Por que curado?
+
+O projeto [obra/superpowers](https://github.com/obra/superpowers) tem 23+ skills. Não faz sentido instalar todas no starter-kit (curva de aprendizado massa).
+
+Estas 4 são as que MAIS aplicam pro perfil de aluno do mini-curso (não-engenheiro de software, foco em workflows pessoais/pequenas operações). Conforme aluno avança, pode adicionar mais skills do superpowers manualmente.
+
+## Versões
+
+Cada skill aqui é VERSÃO CURADA — simplificada do original. Trade-off:
+
+✓ Mais fácil de absorver (5-15min de leitura)
+✗ Menos detalhada (não cobre casos edge avançados)
+
+Pra versão completa: link na seção Referências de cada skill.
+
+## Decisão arquitetural
+
+Decisão original (do roadmap): "curar todas as 23 skills do Superpowers" foi rejeitada (ver D em `DECISOES-ARQUITETURA.md`). Curar 4 = começar simples, expandir conforme uso real.
+
+## Como aluno ativa
+
+Após primeira-vitória, próximos passos opcionais incluem:
+
+```
+→ Quer instalar skills de planejamento (brainstorming, plans, debugging)?
+  Manda 'instala superpowers'
+```
+
+Quando aluno manda, agente disponibiliza as 4 skills (já estão no kit, basta marcar como ativas).
+
+## Princípios universais
+
+Mesmo com origem externa, todas seguem os 12 princípios defensivos da `onboarding-checklist`. Especialmente:
+
+- **Princípio 5** (atualizar estado em arquivo)
+- **Princípio 7** (em dúvida, perguntar)
+- **Princípio 9** (parar se algo der errado)
+
+---
+
+*Registry v1 — Onda 3 (02/05/2026).*
+*Source: https://github.com/obra/superpowers (autor: jesse alpha aka @obra)*