@pixeleducacao/curso-openclaw 2026.5.8

package/assets/skills/starter/onboarding-checklist/references/mapa-aulas.md

@@ -0,0 +1,216 @@
+# Mapa de Perguntas-Âncora ↔ Aulas
+
+> Cada wizard, ao terminar, dispara 1 pergunta-âncora padronizada.
+> Esse mapa amarra: passo → pergunta → aula correspondente do mini-curso → grupo de apoio.
+
+---
+
+## Reforço pedagógico no modo A (aula-por-aula)
+
+No modo A, agente sempre reforça que aluno deve **assistir TODAS as aulas, não pular**. Mesmo aulas de tema que aluno acha que não vai usar.
+
+Mensagem padrão ao apresentar menu modular no modo A:
+
+> "Importante: pra você entender a lógica completa do curso, recomendo MUITO que assista todas as aulas (não pula nenhuma), mesmo as de tema que você não vai usar agora. Cada aula constrói camada na cabeça que ajuda nas próximas.
+>
+> Quando assistir uma aula, volta aqui e manda o número do módulo correspondente. A gente configura juntos."
+
+E quando aluno tenta pular módulo direto sem ter assistido aula correspondente (modo A):
+
+> "Você quer configurar {módulo X} sem ter assistido a aula {Y}?
+>
+> Lembre-se: no modo aula-por-aula, a recomendação é sempre assistir aula primeiro. Aula traz contexto/conceito que ajuda você decidir o que configurar.
+>
+> Quer:
+> a) Assistir aula {Y} primeiro (link: ...)
+> b) Configurar mesmo assim (sem o conceito)
+> c) Mudar pra modo wizard direto (manda 'muda modo')"
+
+No modo B, esse reforço NÃO se aplica — aluno escolheu pular aulas explicitamente.
+
+---
+
+## Estrutura padrão da pergunta-âncora
+
+Cada wizard usa este template ao final:
+
+```
+"Rapidão antes de fechar este passo: {pergunta_âncora}"
+
+[espera resposta do aluno]
+
+"{validação curta — 2 frases}.
+
+Se quer aprofundar {tema do passo}, a aula que detalha isso é a *{AULA-X}*
+— manda 'aula {X}' 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 {N} como feito. Bora pro {N+1}?"
+```
+
+---
+
+## Mapa por passo
+
+### Passo 0 — Whisper (pré-passo opcional)
+
+**Pergunta-âncora:** "Pra confirmar que tá tudo certo: manda agora um áudio curto dizendo qualquer coisa. Eu transcrevo e te mostro."
+
+**Tipo:** Validação prática (não conceitual). Smoke test embutido.
+
+**Aula correspondente:** A0 (Visão — modelos, créditos, OpenAI API key)
+
+**Resposta do agente após áudio:**
+```
+✓ Transcrevi: "{texto_transcrito}"
+
+Funcionando perfeito. A partir de agora você pode mandar áudio em
+qualquer momento — eu entendo.
+
+Se quer aprofundar como configurar OpenAI API e gerenciar custos,
+a aula é a *A0* — manda 'aula A0'.
+
+Bora pro passo 1?
+```
+
+---
+
+### Passo 1 — Personalidade do agente
+
+**Pergunta-âncora:** "Rapidão: se daqui a 1 mês você editar o `IDENTITY.md` direto e mudar meu nome ou tom — eu pego automático ou preciso ser avisado?"
+
+**Resposta esperada:** "automático" ou similar.
+
+**Validação correta:** "Boa. IDENTITY.md fica vivo no seu workspace. Toda vez que eu vou responder, leio ele. Se mudar lá, mudo aqui na hora seguinte."
+
+**Validação se errou:** "Quase. IDENTITY.md fica vivo no workspace — toda mensagem minha consulta ele. Edit direto = mudança imediata. Não precisa me avisar."
+
+**Aula correspondente:** B1 (Identidade completa — SOUL, anti-patterns, jeitos de falar)
+
+---
+
+### Passo 2 — Personalidade do aluno
+
+**Pergunta-âncora:** "Você acabou de me passar várias coisas sobre você. Onde isso ficou salvo? E se você editar lá direto, eu pego?"
+
+**Resposta esperada:** "USER.md" ou "no workspace" + "sim, automático".
+
+**Validação correta:** "Isso. USER.md no seu workspace. Mesma regra do IDENTITY: edit lá = mudança imediata aqui."
+
+**Validação se errou:** "USER.md no seu workspace. Mesma regra do IDENTITY: edit direto, mudança imediata. Você sempre tem controle do que eu sei sobre você."
+
+**Aula correspondente:** B1 (Identidade completa)
+
+---
+
+### Passo 3 — Autonomia (exec-policy + security)
+
+**Pergunta-âncora:** "Se você desfizer a exec-policy yolo daqui a pouco (rodar `openclaw exec-policy reset`), o que volta a acontecer?"
+
+**Resposta esperada:** "vai pedir aprovação" ou similar.
+
+**Validação correta:** "Exato. Eu volto a perguntar 'posso?' a cada coisa que faço — criar arquivo, salvar, executar comando. É reversível."
+
+**Validação se 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."
+
+**Aula correspondente:** D1 (Segurança Managed)
+
+---
+
+### Passo 4 — Workspace
+
+**Pergunta-âncora:** "Pra onde eu vou salvar um post novo que você me pedir? E pra onde eu vou buscar uma decisão antiga que você me contou?"
+
+**Resposta esperada:** "post em content/, decisão em memory/" ou similar — qualquer indicação que aluno entendeu a estrutura.
+
+**Validação correta:** "Boa. `content/drafts/` pra criação, `memory/decisoes/` pra registro. Eu uso o MAPA.md como gabarito sempre que vou salvar algo."
+
+**Validação se errou:** "Quase. `content/` pra coisas que você cria (posts, drafts, imagens). `memory/` pra coisas que você lembra (decisões, pendências, pessoas). MAPA.md no workspace tem o gabarito completo."
+
+**Aula correspondente:** B2 (Workspace + mapa externo)
+
+---
+
+### Passo 5 — Conectar superpoderes
+
+**Pergunta-âncora:** "Imagina que sua chave OpenAI vazou no Twitter por engano. O que você precisa fazer agora?"
+
+**Resposta esperada:** "revogar a chave" ou "criar nova" ou similar.
+
+**Validação correta:** "Exato. Vai em platform.openai.com/api-keys, revoga a chave vazada (botão 'Revoke'), gera nova, atualiza no .env. Toda chave de API funciona assim — revogar é instantâneo."
+
+**Validação se errou:** "Você vai em platform.openai.com/api-keys, clica 'Revoke' na chave vazada (instantâneo, ela morre), gera nova, atualiza no seu .env. Mesma lógica pra Brave, GitHub, qualquer chave. Por isso 1Password ajuda — quando você troca chave, atualiza num lugar só."
+
+**Aula correspondente:** D2 (1Password e secrets)
+
+---
+
+### Passo 6 — Primeira vitória
+
+**Pergunta-âncora:** "Esse arquivo que eu acabei de criar — onde ele tá salvo? Você consegue editar ele depois pra ajustar antes de publicar?"
+
+**Resposta esperada:** "em content/drafts/" + "sim, posso editar".
+
+**Validação correta:** "Isso. `content/drafts/primeira-vitoria-{data}.md`. Você pode abrir no editor que preferir, ajustar o que quiser, e usar. Tudo que eu crio fica visível e editável — você sempre tem palavra final."
+
+**Validação se errou:** "`content/drafts/primeira-vitoria-{data}.md`. Markdown puro, abre em qualquer editor (VS Code, Obsidian, até bloco de notas). Pode editar tudo, eu não trava nada."
+
+**Aula correspondente:** C2 (Skills — SOP executável)
+
+---
+
+## Comando "aula {X}" — comportamento
+
+Quando aluno responde "aula B1" (ou similar), agente entrega:
+
+```
+A aula *B1 — Identidade completa* aprofunda o que a gente fez no passo {N}.
+
+Cobre:
+- {tópicos da aula}
+
+Link pra área de membros: {URL_aula}
+
+Volta aqui quando assistir, ou bora seguir pro próximo passo da
+checklist?
+```
+
+URL e tópicos detalhados ficam em `references/links-aulas.md` (criar quando o curso terminar de ser gravado).
+
+---
+
+## Comando "grupo" — comportamento
+
+Quando aluno menciona "grupo" ou "comunidade":
+
+```
+Grupo do mini-curso no Telegram:
+https://t.me/cursoopenclaw
+
+Lá dentro tem 2 caminhos pra você:
+
+→ Tópico Suporte: @Openclawzinho (bot IA) responde 24/7. Bom pra dúvida
+  técnica rápida, erro de comando, configuração travada.
+
+→ Outros tópicos: galera que comprou o mesmo curso, fazendo isso junto.
+  Bom pra ver o que outros tão construindo, trocar ideia, pedir feedback.
+  O Bruno também aparece direto por lá.
+
+Bora seguir pro próximo passo?
+```
+
+---
+
+## Por que essa estrutura funciona
+
+A pergunta-âncora resolve 3 problemas de uma vez:
+
+1. **Validação leve de aprendizado** — aluno teve que pensar pra responder. Mesmo se errou, a correção fica.
+2. **Venda da aula em vídeo** — cria hook concreto: "se quer aprofundar X, aula é a Y". Não é venda genérica, é venda contextual.
+3. **Ativação da comunidade** — em vez de "tem grupo se quiser", aparece no momento natural (logo após pequeno marco).
+
+Resultado: aluno termina kit com agente funcionando + sentimento de "fiz parte de algo, tem outras pessoas, e tem mais conteúdo se quiser".

package/assets/skills/starter/onboarding-checklist/references/padrao-exemplos-opt-in.md

@@ -0,0 +1,159 @@
+# Padrão de Design — Exemplos Opt-In
+
+> Como wizards do starter-kit oferecem templates de referência sem forçar.
+
+---
+
+## A regra em uma frase
+
+**Toda pergunta que pede input criativo (não factual) inclui linha "manda 'exemplo' se quiser ver template".**
+
+Aluno escolhe. Aluno que sabe responde direto. Aluno que trava pede exemplo.
+
+---
+
+## Por quê
+
+3 razões:
+
+1. **Opt-in não força** — aluno que sabe responde direto, sem fricção. Aluno que trava pede exemplo. Carga cognitiva zero pra quem não precisa.
+
+2. **Destrava aluno leigo** — "que tom quer no agente?" pode paralisar PME que nunca pensou nisso. Mostrar Amora pronta = "ah, então é assim". Aluno parte de algo concreto, não do branco.
+
+3. **Carrega autoridade** — "exemplo do Bruno" reforça que existe coisa funcionando, não é exercício hipotético. Confiança.
+
+---
+
+## Quando aplicar
+
+**SIM, oferecer exemplo:**
+
+- Pergunta pede input **criativo**: "que tom?", "que regras?", "que estrutura?"
+- Aluno sem referência clara provavelmente trava
+- Existe template no `starter-kit/exemplos/`
+
+**NÃO oferecer exemplo:**
+
+- Pergunta pede input **factual**: "qual seu nome?", "qual seu negócio?"
+- Pergunta tem resposta única: "deseja seguir? (sim/não)"
+- Não existe exemplo relevante
+
+---
+
+## Padrão de pergunta
+
+```
+"{Pergunta}.
+
+Manda direto se já tem ideia.
+Se quiser ver um exemplo (template do Bruno/Amora), manda 'exemplo'."
+```
+
+**Exemplos de aplicação:**
+
+### `wizard-agente`
+
+```
+"Que nome você quer me dar?
+
+Manda direto se já tem ideia.
+Se quiser ver um exemplo (template da Amora), manda 'exemplo'."
+```
+
+### `wizard-aluno`
+
+```
+"Conta um pouco sobre você — quem é, o que faz, área, dor principal.
+
+Manda como falaria pra um amigo novo.
+Se quiser ver um exemplo (USER do Bruno), manda 'exemplo'."
+```
+
+### `wizard-workspace`
+
+```
+"Vou organizar seu workspace. Tá tudo bem assim ou tem alguma estrutura
+particular que você quer (ex: pasta 'clientes' separada, 'receitas' separada)?
+
+Manda direto se sim.
+Se quiser ver um exemplo (workspace da Amora), manda 'exemplo'."
+```
+
+---
+
+## Comportamento ao receber "exemplo"
+
+1. **Identificar contexto** — qual wizard ativo, qual pergunta ativa
+2. **Carregar exemplo correspondente** de `starter-kit/exemplos/`
+3. **Apresentar com header de contexto:**
+
+   > "Esse é o {arquivo} da Amora — {breve descrição do contexto}.
+   > Não copia, adapta pro teu jeito.
+   >
+   > [conteúdo do template inline ou em mensagem separada se for grande]"
+
+4. **Voltar pra pergunta original:**
+
+   > "Agora que viu o exemplo, me conta o seu jeito."
+
+---
+
+## Mapa de contextos → exemplos
+
+| Wizard / Pergunta | Carrega arquivo |
+|---|---|
+| `wizard-aluno` perguntando sobre identidade pessoal | `exemplos/USER-amora.md` |
+| `wizard-agente` perguntando nome/tom/iniciativa | `exemplos/IDENTITY-amora.md` |
+| `wizard-agente` perguntando personalidade/anti-patterns | `exemplos/SOUL-amora.md` |
+| `wizard-agente` perguntando regras/limites | `exemplos/AGENTS-amora.md` |
+| `wizard-workspace` perguntando estrutura | `exemplos/MAPA-amora.md` |
+| Outros wizards (futuro) | conforme novos exemplos forem adicionados |
+
+---
+
+## Quando aluno NÃO pediu exemplo
+
+Não mostrar. Não insistir. Não perguntar "quer ver exemplo?". A linha "manda 'exemplo' se quiser" basta.
+
+Aluno que ignora o opt-in tá dizendo "não preciso". Respeita.
+
+---
+
+## Quando aluno pediu exemplo MAS quer outro
+
+Aluno: "exemplo"
+Agente: [mostra IDENTITY-amora.md]
+Aluno: "quero outro"
+
+Comportamento: agente lista todos os exemplos disponíveis e pede pra aluno escolher:
+
+> "Tem esses templates disponíveis:
+> - USER-amora.md (sobre o Bruno)
+> - IDENTITY-amora.md (que você acabou de ver)
+> - SOUL-amora.md (personalidade da Amora)
+> - AGENTS-amora.md (regras entre Bruno e Amora)
+> - MAPA-amora.md (workspace da Amora)
+>
+> Qual quer ver?"
+
+---
+
+## Princípios relacionados
+
+- **Princípio 7 (em dúvida, perguntar):** se aluno mandou "exemplo" sem contexto claro, perguntar qual quer
+- **Princípio 11 (detectar antes de pedir):** se aluno já viu o exemplo na sessão atual, não mostrar de novo automaticamente — perguntar se quer rever
+- **UX premium:** exemplos não interrompem fluxo, retornam pra pergunta original
+
+---
+
+## Por que é padrão de design, não princípio
+
+Princípios defensivos (1-12) protegem **integridade técnica** (backup, confirmação, single source of truth, etc).
+
+Padrão "exemplos opt-in" é sobre **UX de aprendizagem** — destrava aluno leigo sem forçar quem não precisa. É decisão de produto, não regra de segurança.
+
+Por isso vive em `padrao-exemplos-opt-in.md` separado, não como Princípio 13 em `principios-defensivos.md`.
+
+---
+
+*Última revisão: 02/05/2026*