@pixeleducacao/curso-openclaw 2026.5.8

package/assets/skills/starter/_registry.md

@@ -0,0 +1,93 @@
+# Registry — starter/ (jornada obrigatória)
+
+> Skills da jornada principal do Starter Kit.
+> Aluno novo passa por todas em ordem (com possibilidade de pular).
+
+## Skills
+
+| Skill | Status | Versão | Owner | Mode | Tempo |
+|---|---|---|---|---|---|
+| [`onboarding-checklist`](onboarding-checklist/SKILL.md) | ✅ ATIVO | 1.2 | aluno | guided | 1min apresentação / 37min jornada total |
+| [`wizard-whisper-quick`](wizard-whisper-quick/SKILL.md) | ✅ ATIVO | 1.2 | aluno | guided | 5min (ou 30s se já configurado) |
+| [`wizard-agente`](wizard-agente/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 4min (ou 1min se já configurado) |
+| [`wizard-aluno`](wizard-aluno/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 3min (ou 30s se já configurado) |
+| [`wizard-autonomia`](wizard-autonomia/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 6min (manual no terminal) |
+| [`wizard-workspace`](wizard-workspace/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 4min |
+| [`wizard-conectar`](wizard-conectar/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 12min (varia por chaves existentes) |
+| [`primeira-vitoria`](primeira-vitoria/SKILL.md) | ✅ ATIVO | 1.0 | aluno | guided | 5min |
+
+## Ordem oficial da jornada
+
+```
+0. wizard-whisper-quick (opcional, antes da jornada)
+↓
+1. wizard-agente
+↓
+2. wizard-aluno
+↓
+3. wizard-autonomia
+↓
+4. wizard-workspace
+↓
+5. wizard-conectar (ativa backup-workspace-github de operacional/)
+↓
+6. primeira-vitoria (NPS no fim, jornada completa)
+```
+
+## Dependências entre skills
+
+Ver detalhe completo em [`onboarding-checklist/references/dependencias.md`](onboarding-checklist/references/dependencias.md).
+
+Resumo:
+- 0, 1, 2, 3 → independentes (sem dependência)
+- 4 → depende de 3 (sem yolo, agente pede aprovação a cada criação)
+- 5 → depende de 3 (sem yolo, agente pede aprovação a cada chave)
+- 6 → depende de 3 + 4 + 5 (sem qualquer um, vitória degrada)
+
+## Padrão comum entre os 7 wizards filhos
+
+Todos seguem este esqueleto:
+
+```
+1. Detecção (Princípio 11) — lê estado atual antes de pedir nada
+2. Decide caminho (pulo / parcial / completo)
+3. Executa caminho escolhido (entrevista, criação de arquivo, validação de chave, etc)
+4. Pergunta-âncora (texto literal em onboarding-checklist/references/mapa-aulas.md)
+5. Marca flag em MEMORY.md (whisper_configured, agente_configured, etc)
+6. Devolve controle pra onboarding-checklist (que renderiza checklist atualizada)
+```
+
+## Princípios universais
+
+Todas as skills aqui herdam os princípios defensivos da `onboarding-checklist`. Ver: [`onboarding-checklist/references/principios-defensivos.md`](onboarding-checklist/references/principios-defensivos.md).
+
+Especialmente relevantes:
+- **Princípio 1** (backup antes de sobrescrever)
+- **Princípio 3** (agente NUNCA elevação de privilégio — wizard-autonomia é a aplicação canônica)
+- **Princípio 11** (detectar antes de pedir + .env first pra credenciais)
+- **Princípio 12** (mapas distribuídos — wizard-workspace implementa)
+
+## Templates usados pelos wizards
+
+Em [`../../templates/`](../../templates/):
+
+- `IDENTITY.template.md` (wizard-agente)
+- `SOUL-stub.template.md` (wizard-agente)
+- `AGENTS.template.md` (wizard-agente)
+- `USER.template.md` (wizard-aluno)
+- `MAPA.template.md` (wizard-workspace)
+
+Mapas locais (`content/MAPA.md`, `memory/MAPA.md`, etc.) são gerados inline pelo wizard-workspace.
+
+## Modo A vs Modo B (apresentação)
+
+Toda skill aqui suporta os 2 modos:
+
+- **Modo A** (aula-por-aula) — passos numerados, cada wizard menciona aula correspondente do mini-curso
+- **Modo B** (wizard direto) — conversacional, sem números, fluído
+
+Lógica é a mesma. Só muda apresentação. Aluno troca a qualquer momento com "muda modo" (comando 8).
+
+---
+
+*Registry v1 — Onda 2 completa (02/05/2026).*

package/assets/skills/starter/onboarding-checklist/SKILL.md

@@ -0,0 +1,434 @@
+---
+name: onboarding-checklist
+status: ATIVO
+category: starter
+owner: aluno
+version: 1.2
+mode: guided
+estimated_time: 37min (jornada completa) ou 1min (apresentação)
+model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4, gemini-pro]
+description: Use when student opens Telegram for the first time after installing the Starter Kit, OR when student types "reativa jornada" / "começar de novo" / "checklist". Master skill that orchestrates the full onboarding journey by dispatching to wizard-* skills. Renders persistent visual checklist, handles 8 canonical commands (voltar/pular/cancelar/reativar/sobre/exemplo/faq/muda modo), detects environment state, and protects existing installations. v1.2 fixes Caminho B do Cenário B — agente EXECUTA o upgrade diretamente em vez de entregar prompt como texto pro aluno copiar (não tem outro agente pra colar — o agente que recebeu o kit É o agente do aluno).
+---
+
+# Onboarding Checklist — Skill Mestre da Jornada
+
+## Promessa
+
+O aluno passa de "instalei um kit" pra "meu agente trabalhou pra mim de verdade" em ~37min, conduzido por uma checklist visual que aparece no Telegram, gameifica progresso e respeita o tempo dele (pode pausar, voltar, pular, cancelar).
+
+A skill mestre não executa nenhum dos passos — ela apresenta a jornada e despacha cada passo pra um wizard específico (`wizard-agente`, `wizard-aluno`, etc).
+
+## Quando disparar
+
+**Trigger automático:**
+- Primeira mensagem do aluno no Telegram + nenhuma marca `kit_intro_done=true` em `MEMORY.md`
+- Workspace tem `skills/starter/` populado (kit acabou de ser instalado)
+
+**Trigger explícito:**
+- "checklist"
+- "reativa jornada"
+- "começar de novo"
+- "onde eu parei?"
+
+**NÃO disparar se:**
+- `MEMORY.md` tem `onboarding_dismissed=true` (aluno escolheu não usar checklist)
+- Já tem outra wizard ativa em execução
+
+## Fase zero — detecção de ambiente (sempre primeiro)
+
+Antes de qualquer coisa, detectar estado da instalação. 3 cenários:
+
+### Cenário A — Workspace vazio (aluno novo)
+
+Detecção: nenhum arquivo raiz preenchido (`USER.md`, `IDENTITY.md`, `AGENTS.md` ausentes ou vazios) + `MEMORY.md` sem flags.
+
+Ação: seguir fluxo normal (apresentar manifesto + checklist).
+
+### Cenário B — Workspace populado (aluno antigo)
+
+Detecção: arquivos raiz preenchidos OU `MEMORY.md` com flags de versão anterior OU skills customizadas pré-existentes.
+
+**⚠️ IMPORTANTE pro agente que vai executar isso:**
+- **NÃO improvise outras opções fora dos 3 caminhos abaixo.** Apresente os 3 textualmente como descrito.
+- **NÃO ofereça "instalar tudo mesmo assim sobrescrevendo"** — quebra workspace do aluno (Princípio 1).
+- **NÃO recomende um caminho sobre outro** — aluno escolhe baseado no perfil dele.
+- **NÃO siga fluxo normal da jornada (Cenário A)** — sobrescreve o que o aluno já tem.
+- **Apresente os 3 caminhos e ESPERA resposta** ('A', 'B' ou 'C') antes de executar qualquer ação.
+
+Ação: apresentar 3 caminhos canônicos e perguntar.
+
+```
+"[Nome], detectei que você já tem um OpenClaw configurado:
+ - {USER.md preenchido (último edit: DD/MM/AAAA)}
+ - {N skills instaladas}
+ - {N entradas em MEMORY.md}
+
+Esse Starter Kit foi feito pra instalações do zero. Se eu rodar a
+jornada completa, vou criar arquivos por cima do seu trabalho. Não
+vai rolar.
+
+MAS você tem 3 caminhos seguros, sem destruir o que você construiu:
+
+(A) Só skills agnósticas — 5min, zero risco
+   Eu instalo as 4 skills de planejamento (brainstorming, writing-plans,
+   executing-plans, verification-before-completion) na sua skills/planejamento/.
+   Não toco em arquivo raiz (USER, IDENTITY, SOUL, AGENTS, MAPA, MEMORY).
+   Útil se você já tem agente operando bem e só quer mais ferramentas.
+
+(B) Upgrade completo via prompt agentic — 30-60min, caminho premium
+   Eu te passo um prompt que você cola no SEU agente atual. Ele vai:
+   1. Fazer raio-X do meu kit (ler tudo)
+   2. Fazer raio-X do seu workspace (entender o que você já tem)
+   3. Comparar e propor PRD personalizado de adaptação
+   4. Executar item a item COM SUA APROVAÇÃO em cada passo
+   Respeita tudo que você customizou. Coerente com a tese 'agente é tutor'.
+
+(C) Só deixar arquivos disponíveis — zero ação
+   O zip já foi extraído pra starter-kit/. Você consulta os exemplos
+   Amora, templates raiz, FAQ e skills quando quiser. Eu não rodo nada.
+   Útil se você só quer ler como o kit foi feito pra inspirar adaptações
+   manuais.
+
+Manda 'A', 'B' ou 'C'. Sem certo nem errado — depende do seu perfil."
+```
+
+Se aluno responder **A** (skills agnósticas):
+1. Princípio 10: backup global do workspace antes (`tar -czf ~/backups/...`)
+2. Copiar `starter-kit/skills/planejamento/` pra `~/skills/planejamento/` (ou path equivalente do workspace dele)
+3. Atualizar `~/skills/_registry.md` adicionando as 4 skills (sem remover as existentes — append)
+4. Atualizar `~/skills/planejamento/_registry.md` (criar se não existe)
+5. Confirmar: "✓ 4 skills instaladas em skills/planejamento/. Manda 'brainstormar X', 'cria plano pra Y', 'verifica se Z tá pronto' pra invocar quando precisar."
+6. Marcar `onboarding_partial=true` em `MEMORY.md` + log da decisão
+7. Sair (não roda checklist da jornada principal)
+
+Se aluno responder **B** (upgrade completo):
+
+⚠️ **CRÍTICO pro agente:** você (que recebeu o kit) é quem EXECUTA o upgrade. **NÃO entregue o prompt como texto pro aluno copiar** — ele tá no MESMO agente que você. Não tem outro agente pra colar. Você É o agente dele. Falha real observada: agentes anteriores entregavam o texto e o aluno ficava perdido sem saber o que fazer com ele.
+
+1. Carregar `references/prompt-upgrade-para-aluno-antigo.md` como **instrução interna sua** (não como texto pra entregar).
+2. Adotar a postura descrita: você É o tutor da própria migração. Mantém seu nome, seu tom, seu workspace — só adiciona a missão "conduzir o upgrade".
+3. **Anunciar ao aluno que VOCÊ vai conduzir pessoalmente** (não passar texto pra ele):
+   ```
+   "Beleza, eu mesma vou conduzir esse upgrade. Vou:
+    - Fazer raio-X do kit que você baixou
+    - Comparar com o que a gente já construiu aqui
+    - Te mostrar um PRD personalizado de adaptação
+    - Executar item a item — você aprova cada coisa antes de eu mexer
+    Sem destruir nada do que já tá funcionando. Bora?"
+   ```
+4. Esperar OK do aluno. Quando vier, executar as 6 fases do prompt-upgrade na ordem:
+   - **Fase 0:** validar acesso (`openclaw exec-policy show` retorna `yolo`?). Se não, pedir aluno rodar — mesma instrução do passo 3 da jornada normal.
+   - **Fase 0.5:** backup global do workspace (Princípio 10) — `tar -czf ~/backups/pre-upgrade-{timestamp}.tar.gz $WORKSPACE` ANTES de qualquer alteração.
+   - **Fase 1:** raio-X do kit (ler manifesto, exemplos/, templates/, todas as 14 skills/).
+   - **Fase 2:** raio-X do workspace dele (raiz, skills/, memory/, content/).
+   - **Fase 3:** comparar e propor PRD personalizado de adaptação ao aluno.
+   - **Fase 4:** aluno aprova/ajusta o PRD.
+   - **Fase 5:** executar item a item COM APROVAÇÃO em cada passo.
+5. Narrar cada fase ao aluno (Princípio 4 — modo guiado). Não rodar silencioso.
+6. Marcar `upgrade_in_progress=true` em `MEMORY.md` enquanto roda; substituir por `upgrade_completed=true` no fim.
+7. **NÃO marcar `onboarding_dismissed`** — esse aluno NÃO declinou, ele aceitou caminho B e completou.
+
+Se aluno responder **C** (só deixar arquivos):
+1. Confirmar extração já feita: "✓ Os arquivos do kit estão em starter-kit/. Você pode consultar:
+   - `starter-kit/manifesto.md` — filosofia do kit
+   - `starter-kit/exemplos/` — templates Amora (USER, IDENTITY, SOUL, AGENTS, MAPA) sanitizados
+   - `starter-kit/templates/` — templates raiz com placeholders
+   - `starter-kit/skills/` — 14 skills (jornada + canais + planejamento + operacional)
+   - `starter-kit/FAQ.md` — 10 perguntas frequentes
+   Quando quiser usar algo, me chama."
+2. Marcar `onboarding_dismissed=true`
+3. Sair
+
+Se aluno responder qualquer outra coisa ou ignorar A/B/C: pedir pra escolher um dos 3 (não improvisar outro caminho).
+
+### Cenário C — Workspace parcial
+
+Detecção: workspace vazio MAS `.env` já tem chaves OU arquivo raiz isolado existe (ex: só `USER.md`, sem o resto).
+
+Ação: seguir fluxo normal **sem tratamento especial aqui**. Cada wizard filho aplica o **Princípio 11 (Detectar antes de pedir)** automaticamente, então o estado parcial é resolvido caso a caso.
+
+Exemplo: se `.env` já tem chave OpenAI, o `wizard-whisper-quick` (passo 0) detecta isso, valida, marca como pronto sem pedir nada. Se só `USER.md` existe, o `wizard-aluno` (passo 2) detecta e pula. O fluxo é o mesmo do Cenário A — a detecção fica embutida em cada passo.
+
+**Por que não tratar aqui:** centralizar lógica de detecção na fase zero criaria duplicação. Cada wizard sabe melhor que ninguém o que precisa checar. Ver `references/principios-defensivos.md` (Princípio 11) pra mapa completo do que cada wizard detecta.
+
+## Verificação de canal
+
+Confirmar que aluno está usando Telegram (não WhatsApp ou outro).
+
+Se canal != Telegram:
+
+```
+"Detectei que você tá usando {canal}. Esse kit foi otimizado pra Telegram
+— alguns recursos visuais (checklist atualizada in-place, áudio fluido,
+botões inline) só funcionam direito lá.
+
+Recomendo: cria um Telegram (5min, grátis), configura o bot do agente lá
+(aula A3 do mini-curso ensina), e roda o kit por lá.
+
+Se quiser seguir aqui mesmo: vai funcionar, mas a experiência vai ser
+degradada. Manda 'aceito perda' pra continuar, ou 'mudo pra telegram'
+pra pausar e configurar."
+```
+
+Se aluno aceitar perda: marcar `canal_degradado=true` e seguir.
+Se preferir mudar: marcar `onboarding_paused_at_step=0` e sair.
+
+## Manifesto de abertura
+
+Apresentar versão curta do manifesto (carregar de `references/manifesto-abertura.md`).
+
+Após o manifesto, marcar `kit_intro_done=true` em `MEMORY.md`.
+
+## Bifurcação de modo (logo após manifesto)
+
+Antes de apresentar a checklist, perguntar como aluno prefere fazer:
+
+```
+"Antes de começar, me conta como você prefere fazer:
+
+a) Assistindo as aulas em paralelo — você assiste aula sobre X, volta
+   aqui e configura X. Próxima aula, próximo módulo.
+
+b) Direto comigo, sem aulas agora — eu te guio pelo essencial em
+   ~30min. Você assiste aulas depois pra aprofundar.
+
+Manda 'a' ou 'b'. Sem certo nem errado."
+```
+
+Salvar resposta em `MEMORY.md` como `modo_jornada: aula | wizard`.
+
+Aluno pode mudar a qualquer momento mandando "muda modo" (ver `references/comandos-canonicos.md` → comando 8).
+
+### Modo A — Aula por aula
+
+- Mostra menu modular completo (12 módulos numerados estavelmente)
+- Cada módulo aponta pra aula correspondente em destaque
+- **Reforço pedagógico**: agente sempre recomenda assistir TODAS as aulas (não pular)
+- Aluno controla ritmo: assiste aula → manda número → configura → assiste próxima
+
+### Modo B — Wizard direto
+
+- **Sem checklist visível durante** a jornada
+- **Sem números de passos** ("passo 1, 2, 3" desaparecem)
+- **Conversação fluida** — agente conduz como tutor real
+- **Templates da Amora como referência** pra acelerar decisões (`exemplos/` opt-in via comando "exemplo")
+- **Resumo aparece só no final** (mostra o que foi construído)
+
+Por baixo, **mesma estrutura** (mesmas skills filhas, mesmo dependencias.md). Só muda apresentação.
+
+## Apresentação da checklist (modo A apenas)
+
+Renderizar checklist visual (template em `references/checklist-template.md`):
+
+```
+=== Antes da gente começar (5min, opcional) ===
+
+[ ] 0. Chave OpenAI API (pra Whisper transcrever áudios)   👤 5min
+       — manda "pulo" pra deixar pra depois
+
+=== Comece sua jornada por aqui — total estimado: ~37min ===
+
+🎭 [ ] 1. Vamos configurar a personalidade do seu agente   🤖 4min
+🎭 [ ] 2. Vamos configurar a sua personalidade             🤖 3min
+⚙️ [ ] 3. Vamos liberar autonomia pra ele trabalhar        👤 6min
+⚙️ [ ] 4. Vamos mostrar onde tudo vive                     🤖 4min
+⚙️ [ ] 5. Vamos conectar mais superpoderes                 👤 12min
+🚀 [ ] 6. Vamos rodar sua primeira vitória                 🤖 5min
+
+📞 Travou?
+   → Resposta rápida 24/7: chama @Openclawzinho (bot IA) no tópico Suporte
+   → Ajuda humana: galera do mini-curso tá nos outros tópicos
+   Grupo: https://t.me/cursoopenclaw
+✉️  Feedback estruturado pro Bruno: bruno@microsaas.com.br
+🧭 Quer entender mais? Manda "sobre"
+
+Bora começar pelo passo 0? (Manda "começar" pra ir, ou "pulo" pra
+ir direto pro passo 1.)
+```
+
+Esperar resposta do aluno.
+
+## Despacho de wizards
+
+Conforme aluno aceita cada passo, despachar:
+
+| Passo | Wizard | Marca em MEMORY ao concluir |
+|---|---|---|
+| 0 | `wizard-whisper-quick` (pré) | `whisper_configured=true` |
+| 1 | `wizard-agente` | `agente_configured=true` |
+| 2 | `wizard-aluno` | `aluno_configured=true` |
+| 3 | `wizard-autonomia` | `autonomia_liberada=true` |
+| 4 | `wizard-workspace` | `workspace_organizado=true` |
+| 5 | `wizard-conectar` | `conectado=true` |
+| 6 | `primeira-vitoria` | `first_win_completed=true` |
+
+Cada wizard executa seu fluxo independente. Quando termina, retorna controle pra `onboarding-checklist`, que:
+
+1. Marca [x] no item correspondente
+2. Roda pergunta-âncora do passo
+3. Renderiza checklist atualizada
+4. Pergunta se aluno quer seguir pro próximo passo
+
+## Pergunta-âncora ao final de cada passo
+
+Cada wizard, ao terminar, dispara uma pergunta-âncora padronizada (mapa em `references/mapa-aulas.md`).
+
+Estrutura padrão:
+
+```
+"Rapidão antes de fechar este passo: {pergunta}"
+
+[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 completo das perguntas-âncora ↔ aulas: `references/mapa-aulas.md`.
+
+## Comandos canônicos
+
+8 comandos que funcionam em qualquer momento da jornada (detalhe completo em `references/comandos-canonicos.md`):
+
+| # | Comando | Função |
+|---|---|---|
+| 1 | "voltar N" / "refazer N" | Re-disparar wizard do passo N |
+| 2 | "pulo" / "deixa pra depois" | Marcar passo como skipped, avançar |
+| 3 | "cancelar" / "deixa quieto" | Pausar checklist |
+| 4 | "reativa jornada" | Retomar checklist do ponto onde parou |
+| 5 | "sobre" | Mostrar manifesto expandido |
+| 6 | **"exemplo"** | Mostrar template do Bruno/Amora pra inspiração (ver `padrao-exemplos-opt-in.md`) |
+| 7 | **"faq"** | Carregar FAQ do starter-kit (`starter-kit/FAQ.md`) com perguntas comuns |
+| 8 | **"muda modo"** | Trocar entre modo aula-por-aula (A) e wizard direto (B) |
+
+Resumo dos 5 originais (detalhe abaixo):
+
+### "voltar [N]" / "refazer [N]" / "muda [campo]"
+
+Re-disparar wizard do passo N. Antes de re-executar, perguntar:
+- "Quer editar trecho específico ou refazer do zero?"
+
+Se editar: passar contexto pro wizard pra modo edição (preserva o que aluno não pediu pra mudar).
+
+Se refazer: backup timestamped do estado atual + re-executa wizard inteiro.
+
+### "pulo" / "deixa pra depois" / "próximo"
+
+Marcar passo como `skipped` (não `done`). Avançar pro próximo.
+
+Se próximo passo tem dependência do que foi pulado:
+```
+"Antes de seguir, aviso: o passo {atual} depende do passo {pulado}.
+Sem ele, o {atual} vai funcionar com fricção (ex: vou pedir aprovação
+a cada coisa que faço). Quer:
+
+a) Voltar e fazer o {pulado} agora (~Nmin)
+b) Seguir mesmo assim e aceitar a fricção"
+```
+
+Mapa completo de dependências: `references/dependencias.md`.
+
+### "cancelar" / "deixa quieto" / "fecha o tour"
+
+Pausar checklist. Salvar `onboarding_paused_at_step=N` em `MEMORY.md`.
+
+```
+"Beleza, parei aqui. Você fez até o passo {N}.
+
+Se quiser voltar, manda 'reativa jornada' que eu retomo do ponto.
+Se quiser apagar de vez, manda 'nunca mais'."
+```
+
+NÃO marcar `onboarding_dismissed=true` (a não ser que aluno mande "nunca mais").
+
+### "reativa jornada" / "volta o tour" / "guia de novo"
+
+Re-renderizar checklist do ponto onde parou. Mostrar progresso com [x] e [→] (pulados).
+
+```
+"Bem-vindo de volta. Você parou no passo {N}.
+
+[checklist atualizada]
+
+Continuar daí ou prefere recapitular o que já fizemos?"
+```
+
+### "sobre" / "filosofia" / "quem fez isso?"
+
+Carregar `references/sobre-o-kit.md` (versão expandida do manifesto).
+
+Não interrompe jornada — depois de mostrar, perguntar "Bora voltar pro passo {N}?".
+
+## Princípios defensivos (heredados por todos os wizards)
+
+Todos os wizards do starter herdam estes princípios. Detalhes em `references/principios-defensivos.md`:
+
+1. **Antes de qualquer escrita de arquivo raiz**, checar existência. Se existe, backup timestamped + confirmação dupla.
+2. **Confirmação humana** em qualquer ação que modifica `.env`, executa comando de sistema, ou cria arquivo persistente.
+3. **Nunca executar** comando que muda exec-policy ou security-full silenciosamente. Aluno cola no terminal manualmente.
+4. **Sempre narrar** o que tá fazendo antes de fazer (modo guiado).
+5. **Após cada passo concluído**, atualizar `MEMORY.md` com flag correspondente + atualizar checklist visual.
+
+## Critérios de sucesso
+
+A jornada está completa quando:
+
+- [ ] Manifesto apresentado e `kit_intro_done=true`
+- [ ] Pelo menos 1 passo da jornada principal completado
+- [ ] Aluno respondeu pelo menos 1 pergunta-âncora (não monólogo)
+- [ ] `MEMORY.md` reflete estado consistente (todas as flags dos passos completados)
+- [ ] Pelo menos 1 ponte pra aula ou grupo de apoio foi oferecida
+
+A jornada está SEM SUCESSO se:
+
+- Aluno cancelou no passo 0 ou 1 (sinal de friction excessiva — investigar)
+- Algum wizard quebrou e jornada parou no meio sem retomada
+- `MEMORY.md` ficou em estado inconsistente (passo marcado [x] mas flag não setada)
+
+## Erros comuns
+
+- **Pular fase zero de detecção de ambiente:** ignorar workspace populado e sobrescrever arquivos do aluno antigo. Destruidor de produto.
+- **Apresentar checklist sem manifesto:** aluno entra direto na lista, não entende o que é o kit, fica frio. Manifesto cria conexão emocional.
+- **Não respeitar comando "pulo":** insistir que aluno faça o passo é UX abusiva. Pular é direito.
+- **Esquecer pergunta-âncora:** aluno termina passo sem absorver. Suporte explode com perguntas básicas depois.
+- **Renderizar checklist sem ETA total:** aluno não sabe tamanho do compromisso, ansiedade.
+- **Despachar wizard sem confirmar próximo passo:** correr no automático tira agência do aluno.
+
+## Referências
+
+### Internas (references/)
+- `manifesto-abertura.md` — versão curta do manifesto (primeira mensagem)
+- `sobre-o-kit.md` — versão expandida (carregada via "sobre")
+- `comandos-canonicos.md` — patterns dos 8 comandos
+- `checklist-template.md` — template visual da checklist (modo A)
+- `dependencias.md` — quais passos dependem de quais
+- `mapa-aulas.md` — pergunta-âncora ↔ aula correspondente
+- `arquivos-raiz.md` — documentação dos 8 arquivos raiz
+- `sistema-de-mapas.md` — padrão MAPA distribuído
+- `principios-defensivos.md` — 12 princípios universais de segurança
+- `padrao-exemplos-opt-in.md` — UX design do comando "exemplo"
+- `arquivamento-pos-jornada.md` — o que arquivar quando aluno pede
+- `prompt-upgrade-para-aluno-antigo.md` — entregue no Cenário B (workspace populado)
+
+### Externas (no kit, fora da skill)
+- `starter-kit/exemplos/` — 5 templates da Amora pra opt-in via "exemplo"
+- `starter-kit/FAQ.md` — perguntas frequentes (carregado via "faq")
+- `starter-kit/templates/` — templates raiz `.template` que wizards usam pra criar arquivos novos
+
+## Evals
+
+3 cenários testados em `evals/evals.json`:
+
+1. **Aluno linear:** novo, faz tudo na ordem, sem pular
+2. **Aluno que pula passos:** pula passo 3, chega no 5 com fricção, agente avisa
+3. **Aluno que cancela e volta:** cancela no passo 2, volta 2 dias depois, retoma corretamente
+4. **Workspace populado:** aluno antigo, agente recusa elegante e entrega prompt de upgrade