@pixeleducacao/curso-openclaw 2026.5.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/README.md +60 -0
  2. package/assets/cases/case-amora.md +97 -0
  3. package/assets/cases/case-aurora-brunner.md +85 -0
  4. package/assets/cases/case-chris-everest.md +114 -0
  5. package/assets/cases/case-filippe-cesar.md +117 -0
  6. package/assets/cases/case-igor-gouveia.md +106 -0
  7. package/assets/cases//360/237/223/215 LEIA PRIMEIRO" +57 -0
  8. package/assets/cheatsheets/crons-do-seu-agente.md +170 -0
  9. package/assets/cheatsheets/identidade-do-seu-agente.md +133 -0
  10. package/assets/cheatsheets/integracoes-de-produtividade.md +171 -0
  11. package/assets/cheatsheets/memoria-do-seu-agente.md +166 -0
  12. package/assets/cheatsheets/mission-control.md +220 -0
  13. package/assets/cheatsheets/multi-agente.md +193 -0
  14. package/assets/cheatsheets/onboarding-do-seu-agente.md +145 -0
  15. package/assets/cheatsheets/outros-canais.md +129 -0
  16. package/assets/cheatsheets/skills-do-seu-agente.md +165 -0
  17. package/assets/cheatsheets/workspace-do-seu-agente.md +155 -0
  18. package/assets/cheatsheets//360/237/223/215 LEIA PRIMEIRO" +61 -0
  19. package/assets/prompts/business/analise-features.md +47 -0
  20. package/assets/prompts/business/metricas-saas.md +53 -0
  21. package/assets/prompts/business/reports-pdf.md +37 -0
  22. package/assets/prompts/business//360/237/223/215 LEIA PRIMEIRO.docx +0 -0
  23. package/assets/prompts/community/analise-comunidade.md +43 -0
  24. package/assets/prompts/community//360/237/223/215 LEIA PRIMEIRO" +11 -0
  25. package/assets/prompts/content/content-waterfall.md +57 -0
  26. package/assets/prompts/content/ideias-de-conteudo.md +36 -0
  27. package/assets/prompts/content/tom-de-voz.md +41 -0
  28. package/assets/prompts/content//360/237/223/215 LEIA PRIMEIRO" +13 -0
  29. package/assets/prompts/productivity/daily-briefing.md +57 -0
  30. package/assets/prompts/productivity/social-metrics.md +53 -0
  31. package/assets/prompts/productivity/viagens-pesquisas.md +38 -0
  32. package/assets/prompts/productivity//360/237/223/215 LEIA PRIMEIRO" +13 -0
  33. package/assets/prompts/research/deep-research.md +52 -0
  34. package/assets/prompts/research//360/237/223/215 LEIA PRIMEIRO" +11 -0
  35. package/assets/prompts/support/analise-suporte.md +41 -0
  36. package/assets/prompts/support//360/237/223/215 LEIA PRIMEIRO" +11 -0
  37. package/assets/prompts//360/237/223/215 LEIA PRIMEIRO.docx +0 -0
  38. package/assets/skills/_registry.md +184 -0
  39. package/assets/skills/canais/_registry.md +36 -0
  40. package/assets/skills/canais/wizard-whatsapp/SKILL.md +334 -0
  41. package/assets/skills/operacional/_registry.md +20 -0
  42. package/assets/skills/operacional/backup-workspace-github/SKILL.md +246 -0
  43. package/assets/skills/planejamento/_registry.md +70 -0
  44. package/assets/skills/planejamento/brainstorming/SKILL.md +133 -0
  45. package/assets/skills/planejamento/executing-plans/SKILL.md +182 -0
  46. package/assets/skills/planejamento/verification-before-completion/SKILL.md +157 -0
  47. package/assets/skills/planejamento/writing-plans/SKILL.md +170 -0
  48. package/assets/skills/starter/_registry.md +93 -0
  49. package/assets/skills/starter/onboarding-checklist/SKILL.md +434 -0
  50. package/assets/skills/starter/onboarding-checklist/evals/evals.json +245 -0
  51. package/assets/skills/starter/onboarding-checklist/references/arquivamento-pos-jornada.md +167 -0
  52. package/assets/skills/starter/onboarding-checklist/references/arquivos-raiz.md +281 -0
  53. package/assets/skills/starter/onboarding-checklist/references/checklist-template.md +215 -0
  54. package/assets/skills/starter/onboarding-checklist/references/comandos-canonicos.md +272 -0
  55. package/assets/skills/starter/onboarding-checklist/references/dependencias.md +139 -0
  56. package/assets/skills/starter/onboarding-checklist/references/manifesto-abertura.md +54 -0
  57. package/assets/skills/starter/onboarding-checklist/references/mapa-aulas.md +216 -0
  58. package/assets/skills/starter/onboarding-checklist/references/padrao-exemplos-opt-in.md +159 -0
  59. package/assets/skills/starter/onboarding-checklist/references/principios-defensivos.md +408 -0
  60. package/assets/skills/starter/onboarding-checklist/references/prompt-upgrade-para-aluno-antigo.md +289 -0
  61. package/assets/skills/starter/onboarding-checklist/references/sistema-de-mapas.md +273 -0
  62. package/assets/skills/starter/onboarding-checklist/references/sobre-o-kit.md +105 -0
  63. package/assets/skills/starter/primeira-vitoria/SKILL.md +515 -0
  64. package/assets/skills/starter/primeira-vitoria/evals/evals.json +201 -0
  65. package/assets/skills/starter/wizard-agente/SKILL.md +420 -0
  66. package/assets/skills/starter/wizard-agente/evals/evals.json +204 -0
  67. package/assets/skills/starter/wizard-aluno/SKILL.md +353 -0
  68. package/assets/skills/starter/wizard-aluno/evals/evals.json +192 -0
  69. package/assets/skills/starter/wizard-autonomia/SKILL.md +391 -0
  70. package/assets/skills/starter/wizard-autonomia/evals/evals.json +192 -0
  71. package/assets/skills/starter/wizard-conectar/SKILL.md +450 -0
  72. package/assets/skills/starter/wizard-conectar/evals/evals.json +196 -0
  73. package/assets/skills/starter/wizard-whisper-quick/SKILL.md +349 -0
  74. package/assets/skills/starter/wizard-whisper-quick/evals/evals.json +195 -0
  75. package/assets/skills/starter/wizard-workspace/SKILL.md +483 -0
  76. package/assets/skills/starter/wizard-workspace/evals/evals.json +174 -0
  77. package/assets/templates/AGENTS.template.md +58 -0
  78. package/assets/templates/IDENTITY.template.md +21 -0
  79. package/assets/templates/MAPA.template.md +71 -0
  80. package/assets/templates/README.md +62 -0
  81. package/assets/templates/SOUL-stub.template.md +26 -0
  82. package/assets/templates/USER.template.md +41 -0
  83. package/dist/index.d.ts +9 -0
  84. package/dist/index.d.ts.map +1 -0
  85. package/dist/index.js +11 -0
  86. package/dist/index.js.map +1 -0
  87. package/openclaw.plugin.json +15 -0
  88. package/package.json +44 -0
@@ -0,0 +1,215 @@
1
+ # Template Visual da Checklist
2
+
3
+ > Texto literal que a `onboarding-checklist` renderiza no Telegram.
4
+ > Variáveis com `{nome}` são substituídas dinamicamente.
5
+
6
+ ---
7
+
8
+ ## Template inicial (primeira vez que aluno vê)
9
+
10
+ ```
11
+ === Sua jornada — total estimado: ~37min ===
12
+
13
+ *Antes da gente começar (5min, opcional)*
14
+
15
+ [ ] 0. Chave OpenAI API (pra Whisper transcrever áudios) 👤 5min
16
+ — manda "pulo" pra deixar pra depois
17
+
18
+ *Comece sua jornada por aqui*
19
+
20
+ 🎭 [ ] 1. Vamos configurar a personalidade do seu agente 🤖 4min
21
+ 🎭 [ ] 2. Vamos configurar a sua personalidade 🤖 3min
22
+ ⚙️ [ ] 3. Vamos liberar autonomia pra ele trabalhar 👤 6min
23
+ ⚙️ [ ] 4. Vamos mostrar onde tudo vive 🤖 4min
24
+ ⚙️ [ ] 5. Vamos conectar mais superpoderes 👤 12min
25
+ 🚀 [ ] 6. Vamos rodar sua primeira vitória 🤖 5min
26
+
27
+ 📞 Travou?
28
+ → Resposta rápida 24/7: chama @Openclawzinho (bot IA) no tópico Suporte
29
+ → Ajuda humana: galera do mini-curso tá nos outros tópicos
30
+ Grupo: https://t.me/cursoopenclaw
31
+ ✉️ Feedback estruturado pro Bruno: bruno@microsaas.com.br
32
+ 🧭 Quer entender mais? Manda "sobre"
33
+
34
+ Bora começar pelo passo 0? (Manda "começar" pra ir, ou "pulo" pra
35
+ ir direto pro passo 1.)
36
+ ```
37
+
38
+ ---
39
+
40
+ ## Template em progresso (após cada passo concluído)
41
+
42
+ ```
43
+ === Sua jornada ===
44
+
45
+ [x] 0. Chave OpenAI API (pra Whisper) ✓ feito
46
+ 🎭 [x] 1. Vamos configurar a personalidade do seu agente ✓ feito
47
+ 🎭 [x] 2. Vamos configurar a sua personalidade ✓ feito
48
+ ⚙️ [→] 3. Vamos liberar autonomia pulado — "volta no 3" pra fazer
49
+ ⚙️ [ ] 4. Vamos mostrar onde tudo vive ← agora 🤖 4min
50
+ ⚙️ [ ] 5. Vamos conectar mais superpoderes 👤 12min
51
+ 🚀 [ ] 6. Vamos rodar sua primeira vitória 🤖 5min
52
+
53
+ Bora pro passo 4?
54
+ ```
55
+
56
+ ---
57
+
58
+ ## Template ao reativar (aluno volta após pausa)
59
+
60
+ ```
61
+ Bem-vindo de volta, {nome_aluno}. Você parou no passo {N}.
62
+
63
+ === Status atual ===
64
+
65
+ [x] 0. Chave OpenAI API (pra Whisper) ✓
66
+ 🎭 [x] 1. Vamos configurar a personalidade do seu agente ✓
67
+ 🎭 [x] 2. Vamos configurar a sua personalidade ✓
68
+ ⚙️ [⏸️] 3. Vamos liberar autonomia ← parou aqui
69
+ ⚙️ [ ] 4. Vamos mostrar onde tudo vive
70
+ ⚙️ [ ] 5. Vamos conectar mais superpoderes
71
+ 🚀 [ ] 6. Vamos rodar sua primeira vitória
72
+
73
+ Continuar do passo {N} ou prefere recapitular o que já fizemos?
74
+ ```
75
+
76
+ ---
77
+
78
+ ## Template ao concluir jornada
79
+
80
+ ```
81
+ === Sua jornada — COMPLETA ===
82
+
83
+ [x] 0. Chave OpenAI API ✓
84
+ 🎭 [x] 1. Personalidade do seu agente ✓
85
+ 🎭 [x] 2. Sua personalidade ✓
86
+ ⚙️ [x] 3. Autonomia liberada ✓
87
+ ⚙️ [x] 4. Workspace organizado ✓
88
+ ⚙️ [x] 5. Superpoderes conectados ✓
89
+ 🚀 [x] 6. Primeira vitória entregue ✓
90
+
91
+ 🎉 Você terminou a jornada de configuração.
92
+
93
+ Seu agente tá pronto pra trabalhar. Manda áudio, manda texto, peça
94
+ pesquisa, peça resumo, peça plano. Tô aqui.
95
+
96
+ *Próximos passos opcionais (qualquer hora):*
97
+ - "ativa whatsapp" → adicionar canal extra
98
+ - "instala perplexity" → deep research
99
+ - "instala apify" → puxar dados de redes sociais
100
+ - "1password" → migrar .env pro cofre
101
+
102
+ Manda "ajuda" se quiser ver tudo que sei fazer.
103
+ ```
104
+
105
+ ---
106
+
107
+ ## Símbolos da checklist
108
+
109
+ | Símbolo | Significado |
110
+ |---|---|
111
+ | `[ ]` | Pendente |
112
+ | `[x]` | Concluído com sucesso |
113
+ | `[→]` | Pulado pelo aluno (com "pulo") |
114
+ | `[⏸️]` | Pausado no meio (aluno cancelou aqui) |
115
+ | `[!]` | Erro durante execução (raro) |
116
+ | `🤖` | Eu (agente) executo a maior parte |
117
+ | `👤` | Você executa parte (cola comando, autoriza, etc) |
118
+ | `🎭` | Bloco identidade |
119
+ | `⚙️` | Bloco configuração técnica |
120
+ | `🚀` | Bloco vitória |
121
+
122
+ ---
123
+
124
+ ## Regras de renderização
125
+
126
+ - **Sempre mostrar checklist completa**, não só o passo atual. Aluno precisa ver progresso global.
127
+ - **Manter ETA total visível** na primeira renderização (depois pode omitir se ficar repetitivo)
128
+ - **Rodapé fixo** com 3 linhas (grupo + feedback + sobre) só na primeira vez. Depois aparece a cada 2-3 mensagens (não em todas — polui).
129
+ - **Emoji do passo atual com seta** (`← agora`) ajuda foco visual
130
+ - **Nunca usar tabela formatada** — Telegram não renderiza bem em mobile. Lista vertical é mais legível.
131
+
132
+ ---
133
+
134
+ ## Variáveis substituíveis
135
+
136
+ | Variável | Valor | Fonte |
137
+ |---|---|---|
138
+ | `{nome_aluno}` | Nome do aluno | `USER.md` (depois do passo 2) |
139
+ | `{N}` | Número do passo atual | `MEMORY.md` (`onboarding_current_step`) |
140
+ | `{eta_total}` | "~37min" | Calculado dos passos restantes |
141
+ | `{passo_atual_nome}` | Ex: "Vamos configurar a personalidade do seu agente" | Config interna |
142
+
143
+ Se variável não tem valor (ex: `{nome_aluno}` antes do passo 2), omitir graciosamente — não escrever "Bem-vindo de volta, {nome_aluno}" literal.
144
+
145
+ ---
146
+
147
+ ## Modo B — Wizard direto (checklist OCULTA)
148
+
149
+ Quando aluno escolheu modo B (wizard direto), os templates acima NÃO são renderizados durante a jornada.
150
+
151
+ ### O que aluno vê no modo B
152
+
153
+ Em vez de checklist visual, aluno vê **conversa fluida** conduzida pelo agente. Sem números de passo, sem "[ ] X", sem ETA na cara. O agente conduz como tutor:
154
+
155
+ ```
156
+ "Beleza, modo wizard direto.
157
+
158
+ Bora começar.
159
+
160
+ Primeiro, me conta um pouco sobre você: quem é, com o que trabalha,
161
+ um pouco da família, hobbies que importam, o que rouba teu tempo hoje.
162
+ Não precisa escrever tese — me fala como falaria pra um amigo novo
163
+ que quer te conhecer.
164
+
165
+ Pode mandar áudio, se preferir."
166
+ ```
167
+
168
+ [aluno responde]
169
+
170
+ ```
171
+ "Beleza, anotei: [resume o que captou].
172
+
173
+ Agora, quem você quer que eu seja?
174
+
175
+ Vou te mostrar um exemplo concreto: a Amora, Chief of Staff do Bruno...
176
+
177
+ Você não precisa copiar a Amora. Mas serve de referência. Me conta:
178
+ - Que nome você quer me dar?
179
+ - Que tom você quer que eu fale com você?
180
+ ..."
181
+ ```
182
+
183
+ E assim por diante. **Internamente**, o agente passa pelos mesmos wizards (wizard-aluno, wizard-agente, etc), mas **sem mostrar a estrutura modular** ao aluno.
184
+
185
+ ### Quando aparece checklist no modo B
186
+
187
+ **Só no resumo final**, depois da primeira vitória:
188
+
189
+ ```
190
+ Pronto, terminamos de configurar tudo. Olha o que a gente construiu juntos:
191
+
192
+ [x] Sua identidade salva em USER.md
193
+ [x] Minha identidade configurada (sou {nome_agente})
194
+ [x] Autonomia liberada — posso trabalhar sem te interromper a cada passo
195
+ [x] Workspace organizado com mapas distribuídos
196
+ [x] {N} integrações conectadas (Brave Search, OpenAI, GitHub)
197
+ [x] Primeira vitória entregue: arquivo salvo em {path}
198
+
199
+ 🎉 Você terminou a jornada de configuração.
200
+
201
+ [continua com NPS + arquivamento + próximos passos opcionais]
202
+ ```
203
+
204
+ Aluno vê pela primeira vez que estava passando por uma jornada estruturada — só agora, no fim. Cria efeito de "uau, eu fiz tudo isso?".
205
+
206
+ ### Trocando entre modos no meio
207
+
208
+ Se aluno mandou "muda modo" durante a jornada, o agente:
209
+
210
+ - Salva nova preferência em `MEMORY.md`
211
+ - Re-renderiza próxima mensagem no novo modo:
212
+ - **A → B:** esconde checklist, vira tutor conversacional
213
+ - **B → A:** mostra checklist completa atualizada com o que já foi feito
214
+
215
+ Aluno mantém progresso ao trocar de modo. Não perde nada.
@@ -0,0 +1,272 @@
1
+ # Comandos Canônicos da Checklist
2
+
3
+ > 5 comandos que o aluno pode mandar em qualquer momento da jornada.
4
+ > A `onboarding-checklist` deve reconhecer estes patterns mesmo com variações de fraseado.
5
+
6
+ ---
7
+
8
+ ## 1. Voltar / Refazer
9
+
10
+ **Função:** re-disparar wizard de um passo já completado.
11
+
12
+ ### Patterns reconhecidos
13
+
14
+ - "volta no [N]"
15
+ - "voltar pro passo [N]"
16
+ - "refazer [tema]" (ex: "refazer identidade")
17
+ - "muda [campo]" (ex: "muda meu nome", "muda o tom")
18
+ - "quero ajustar [coisa]"
19
+
20
+ ### Comportamento
21
+
22
+ 1. Identificar qual passo o aluno quer voltar (pelo número OU pelo tema)
23
+ 2. Antes de re-executar, perguntar:
24
+
25
+ > "Quer editar trecho específico ou refazer do passo do zero?
26
+ >
27
+ > **a) Editar** — eu mostro o que tem hoje, você diz o que mudar, mexo só nisso
28
+ > **b) Refazer** — apago o que tinha, faço backup, e a gente conversa de novo desde o começo"
29
+
30
+ 3. Conforme resposta:
31
+ - **(a)**: passa contexto pro wizard em modo "edição parcial" — preserva tudo que aluno não pediu pra mudar
32
+ - **(b)**: backup timestamped do estado atual em `~/backups/pre-redo-{passo}-{timestamp}/` + re-executa wizard inteiro
33
+
34
+ ### Casos de borda
35
+
36
+ - Aluno pediu pra voltar num passo que NUNCA foi feito → "Esse passo ainda não rolou. Quer fazer ele agora?"
37
+ - Aluno pediu "volta" sem especificar → "Voltar pro qual? Você fez até o passo {N}. Manda 'volta no 2', 'volta no 4', etc."
38
+
39
+ ---
40
+
41
+ ## 2. Pular
42
+
43
+ **Função:** marcar passo como pulado e avançar pro próximo.
44
+
45
+ ### Patterns reconhecidos
46
+
47
+ - "pulo"
48
+ - "pula esse"
49
+ - "deixa pra depois"
50
+ - "próximo"
51
+ - "skip"
52
+ - "não vou fazer agora"
53
+
54
+ ### Comportamento
55
+
56
+ 1. Marcar passo atual como `skipped` em `MEMORY.md` (não `done`)
57
+ 2. Renderizar checklist com `[→]` no lugar de `[x]`
58
+ 3. **Antes de avançar**, checar dependências (`references/dependencias.md`)
59
+ 4. Se próximo passo TEM dependência do que foi pulado:
60
+
61
+ > "Antes de seguir, aviso: o passo {próximo} depende do passo {pulado}.
62
+ >
63
+ > Sem ele, o {próximo} vai funcionar com fricção (ex: vou pedir aprovação a cada coisa que faço).
64
+ >
65
+ > Quer:
66
+ > **a)** Voltar e fazer o {pulado} agora (~{tempo}min)
67
+ > **b)** Seguir mesmo assim e aceitar a fricção"
68
+
69
+ 5. Se próximo passo NÃO tem dependência: avançar direto sem aviso
70
+
71
+ ### Casos de borda
72
+
73
+ - Aluno pediu "pulo" no passo 0 (Whisper opcional) → seguir sem aviso (passo 0 é opcional por design)
74
+ - Aluno pediu "pulo" e já tá no último passo → "Esse é o último. Quer cancelar a jornada inteira?"
75
+
76
+ ---
77
+
78
+ ## 3. Cancelar
79
+
80
+ **Função:** pausar a checklist (não encerrar permanente).
81
+
82
+ ### Patterns reconhecidos
83
+
84
+ - "cancelar"
85
+ - "cancela"
86
+ - "deixa quieto"
87
+ - "fecha o tour"
88
+ - "para por aqui"
89
+ - "depois eu volto"
90
+ - "sai disso"
91
+
92
+ ### Comportamento
93
+
94
+ 1. Salvar `onboarding_paused_at_step={N}` em `MEMORY.md`
95
+ 2. Mensagem de despedida:
96
+
97
+ > "Beleza, parei aqui. Você fez até o passo {N}.
98
+ >
99
+ > Se quiser voltar, manda 'reativa jornada' que eu retomo do ponto.
100
+ >
101
+ > Se quiser apagar de vez, manda 'nunca mais'."
102
+
103
+ 3. NÃO marcar `onboarding_dismissed=true` (a não ser que aluno mande "nunca mais")
104
+
105
+ ### Casos de borda
106
+
107
+ - Aluno mandou "nunca mais" depois → marcar `onboarding_dismissed=true`. Próxima interação não dispara checklist.
108
+ - Aluno cancelou no passo 0 ou 1 → vale anotar `onboarding_cancelled_early=true` (sinal de friction, pra Bruno olhar)
109
+
110
+ ---
111
+
112
+ ## 4. Reativar
113
+
114
+ **Função:** retomar checklist do ponto onde parou.
115
+
116
+ ### Patterns reconhecidos
117
+
118
+ - "reativa jornada"
119
+ - "volta o tour"
120
+ - "guia de novo"
121
+ - "continua de onde parou"
122
+ - "retoma"
123
+
124
+ ### Comportamento
125
+
126
+ 1. Ler `onboarding_paused_at_step={N}` em `MEMORY.md`
127
+ 2. Se `onboarding_dismissed=true`:
128
+ > "Você tinha cancelado de vez essa jornada. Manda 'reativar mesmo' pra confirmar que quer voltar."
129
+ 3. Se pausa normal:
130
+
131
+ > "Bem-vindo de volta. Você parou no passo {N}.
132
+ >
133
+ > [renderizar checklist atualizada com [x] feitos e [→] pulados]
134
+ >
135
+ > Continuar daí ou prefere recapitular o que já fizemos?"
136
+
137
+ 4. Esperar resposta antes de despachar wizard
138
+
139
+ ### Casos de borda
140
+
141
+ - Aluno reativou mas não tem `onboarding_paused_at_step` (nunca cancelou) → tratar como primeira interação (re-disparar checklist do começo)
142
+ - Aluno reativou e MEMORY corrupted/perdido → mostrar checklist com tudo desmarcado e perguntar "Não consegui recuperar onde você parou. Bora começar de novo?"
143
+
144
+ ---
145
+
146
+ ## 5. Sobre
147
+
148
+ **Função:** mostrar versão expandida do manifesto.
149
+
150
+ ### Patterns reconhecidos
151
+
152
+ - "sobre"
153
+ - "filosofia"
154
+ - "quem fez isso?"
155
+ - "me explica o kit"
156
+ - "manifesto"
157
+
158
+ ### Comportamento
159
+
160
+ 1. Carregar `references/sobre-o-kit.md`
161
+ 2. Apresentar texto inteiro
162
+ 3. Substituir `{N}` na última linha pelo passo atual
163
+ 4. Esperar aluno responder pra retomar (não despachar wizard automaticamente)
164
+
165
+ ### Casos de borda
166
+
167
+ - Aluno mandou "sobre" antes de começar a jornada (logo após manifesto curto): trocar última linha por "Bora começar pelo passo 0 ou ir direto pro 1?"
168
+ - Aluno mandou "sobre" no meio de um wizard ativo: pausar wizard, mostrar texto, perguntar se quer retomar
169
+
170
+ ---
171
+
172
+ ## 6. Exemplo
173
+
174
+ **Função:** mostrar template do Bruno/Amora pra aluno se inspirar quando trava em pergunta de design.
175
+
176
+ ### Patterns reconhecidos
177
+
178
+ - "exemplo"
179
+ - "mostra exemplo"
180
+ - "como o Bruno fez"
181
+ - "template Amora"
182
+ - "me mostra como ficou"
183
+
184
+ ### Comportamento
185
+
186
+ 1. Identificar contexto atual (qual wizard ativo, qual pergunta foi feita)
187
+ 2. Carregar arquivo correspondente em `starter-kit/exemplos/` (ex: `IDENTITY-amora.md` se aluno tá em pergunta sobre identidade do agente)
188
+ 3. Apresentar template com header de contexto: "esse é o IDENTITY.md da Amora — Chief of Staff do Bruno. Não copia, adapta"
189
+ 4. Após mostrar, voltar pra pergunta original: "agora que viu, me manda o seu jeito"
190
+
191
+ ### Mapa de contextos → exemplos
192
+
193
+ | Contexto / Wizard | Carrega arquivo |
194
+ |---|---|
195
+ | `wizard-aluno` perguntando sobre você | `exemplos/USER-amora.md` |
196
+ | `wizard-agente` perguntando nome/tom | `exemplos/IDENTITY-amora.md` + `SOUL-amora.md` |
197
+ | `wizard-agente` perguntando regras | `exemplos/AGENTS-amora.md` |
198
+ | `wizard-workspace` mostrando estrutura | `exemplos/MAPA-amora.md` |
199
+ | Outros (futuro) | conforme novos exemplos forem adicionados |
200
+
201
+ ### Casos de borda
202
+
203
+ - Aluno pediu "exemplo" sem contexto claro (ex: chat livre fora de wizard): listar todos os exemplos disponíveis e perguntar qual quer ver
204
+ - Exemplo não existe pro contexto: explicar e oferecer alternativa próxima
205
+
206
+ Detalhes do padrão completo: `references/padrao-exemplos-opt-in.md`
207
+
208
+ ---
209
+
210
+ ## 7. FAQ
211
+
212
+ **Função:** carregar FAQ do starter-kit pra responder dúvidas comuns sem agente improvisar.
213
+
214
+ ### Patterns reconhecidos
215
+
216
+ - "faq"
217
+ - "perguntas frequentes"
218
+ - "ajuda"
219
+ - "tô com dúvida"
220
+ - "isso é normal?"
221
+
222
+ ### Comportamento
223
+
224
+ 1. Carregar `starter-kit/FAQ.md`
225
+ 2. Se aluno mandou só "faq": mostrar índice das seções (1-9)
226
+ 3. Se aluno mandou pergunta específica: identificar seção relevante e mostrar só essa parte
227
+ 4. Sempre oferecer no final: "manda 'faq' + número da seção pra ver outra parte. Se não respondeu sua dúvida, manda no grupo: https://t.me/cursoopenclaw"
228
+
229
+ ### Casos de borda
230
+
231
+ - Aluno arquivou kit (incluindo FAQ): agente lê FAQ direto de `~/archive/starter-kit-onboarding-{data}/FAQ.md` sem precisar mover arquivo
232
+ - FAQ não cobre dúvida: agente é honesto ("isso não tá no FAQ, manda no grupo que a galera ou o @Openclawzinho responde")
233
+
234
+ ---
235
+
236
+ ## 8. Muda modo
237
+
238
+ **Função:** trocar entre modo aula-por-aula (A) e modo wizard direto (B).
239
+
240
+ ### Patterns reconhecidos
241
+
242
+ - "muda pra aulas" / "vou assistir as aulas em paralelo" / "ativa modo aula"
243
+ - "muda pra wizard" / "esquece aulas, vai direto" / "ativa modo wizard"
244
+ - "troca modo"
245
+
246
+ ### Comportamento
247
+
248
+ 1. Ler `modo_jornada` atual em `MEMORY.md`
249
+ 2. Confirmar troca: "Vou trocar de {modo_atual} pra {modo_novo}. Tem certeza?"
250
+ 3. Se confirmado, salvar `modo_jornada: aula | wizard` em `MEMORY.md`
251
+ 4. Re-renderizar UI conforme novo modo (modo A mostra menu modular completo, modo B esconde menu e conduz)
252
+
253
+ ### Casos de borda
254
+
255
+ - Aluno tenta mudar mas não tá em jornada ativa: avisar "você não tá numa jornada agora. Use 'reativa jornada' pra começar"
256
+ - Aluno quer mudar repetidas vezes: aceitar (sem fricção), mas registrar na MEMORY como sinal de indecisão
257
+
258
+ ---
259
+
260
+ ## Resumo da matriz
261
+
262
+ | Comando | Modifica MEMORY? | Despacha wizard? | Backup? |
263
+ |---|:-:|:-:|:-:|
264
+ | Voltar (modo edição) | Sim (atualiza) | Sim (modo parcial) | Não |
265
+ | Voltar (modo refazer) | Sim (reset do passo) | Sim (do zero) | ✅ Sim |
266
+ | Pular | Sim (`skipped`) | Sim (próximo passo) | Não |
267
+ | Cancelar | Sim (`paused_at_step`) | Não | Não |
268
+ | Reativar | Sim (limpa `paused`) | Sim (do ponto pausado) | Não |
269
+ | Sobre | Não | Não | Não |
270
+ | Exemplo | Não | Não | Não |
271
+ | FAQ | Não | Não | Não |
272
+ | Muda modo | Sim (`modo_jornada`) | Não | Não |
@@ -0,0 +1,139 @@
1
+ # Dependências entre Passos
2
+
3
+ > Mapa de quais passos dependem tecnicamente de quais.
4
+ > A `onboarding-checklist` consulta isso ao processar comando "pulo" pra avisar antes de avançar.
5
+
6
+ ---
7
+
8
+ ## Tabela de dependências diretas
9
+
10
+ | Passo | Depende de | Dependência é... | O que acontece se pular |
11
+ |---|---|---|---|
12
+ | 0 (Whisper) | — | Nenhuma | Aluno digita tudo, sem áudio |
13
+ | 1 (Personalidade agente) | — | Nenhuma | Agente fica genérico, sem nome |
14
+ | 2 (Personalidade aluno) | — | Nenhuma | Agente não te conhece, fala genérico |
15
+ | 3 (Autonomia) | — | Nenhuma | Agente pede aprovação a CADA ação nos passos seguintes |
16
+ | 4 (Workspace) | **3** | Hard (técnica) | Agente vai pedir aprovação pra criar pasta/arquivo a cada passo |
17
+ | 5 (Conectar) | **3** | Hard (técnica) | Agente vai pedir aprovação a cada chave inserida |
18
+ | 6 (Vitória) | **3 + 4 + 5** | Hard (técnica) | Vitória vira monólogo pq agente fica perguntando aprovação a cada passo + sem chaves não tem pesquisa real |
19
+
20
+ ---
21
+
22
+ ## Tabela de dependências de qualidade (não técnicas)
23
+
24
+ Passos que **funcionam** sem o anterior, mas a experiência fica degradada:
25
+
26
+ | Passo | Pulou | Qualidade da experiência |
27
+ |---|---|---|
28
+ | 2 | Pulou 1 | Agente sem nome próprio. Aluno responde entrevista sobre si pra um agente "genérico". UX fria. |
29
+ | 5 | Pulou 0 | Aluno tem que digitar todas as 3-5 chaves manualmente sem poder mandar foto/áudio do dashboard. |
30
+ | 6 | Pulou 0 | Vitória sem áudio. Aluno não vive a "magia" de mandar áudio + agente entender. |
31
+
32
+ ---
33
+
34
+ ## Mensagens padrão por dependência
35
+
36
+ ### Quando aluno pula passo 3 (Autonomia)
37
+
38
+ ```
39
+ Antes de seguir, aviso: o passo {próximo} depende do passo 3 (Autonomia).
40
+
41
+ Sem ele, eu vou pedir sua aprovação a CADA coisa que faço — criar pasta,
42
+ salvar arquivo, executar comando. Quebra o fluxo "🤖 eu monto pra você"
43
+ dos passos automatizados.
44
+
45
+ Quer:
46
+ *a)* Voltar e fazer o passo 3 agora (~6min)
47
+ *b)* Seguir mesmo assim e aprovar tudo manualmente
48
+ ```
49
+
50
+ ### Quando aluno pula passo 4 (Workspace)
51
+
52
+ ```
53
+ Antes de seguir, aviso: o passo {próximo} pode dar problema sem o passo 4.
54
+
55
+ O passo 5 (Conectar) e 6 (Vitória) precisam saber ONDE salvar arquivos
56
+ — sem o workspace organizado, vou ter que assumir defaults que talvez
57
+ não combinem com o que você prefere depois.
58
+
59
+ Quer:
60
+ *a)* Voltar e fazer o passo 4 agora (~4min)
61
+ *b)* Seguir mesmo assim com defaults que você pode ajustar depois
62
+ ```
63
+
64
+ ### Quando aluno pula passo 5 (Conectar)
65
+
66
+ ```
67
+ Antes de seguir pra primeira vitória, aviso: sem o passo 5, eu não tenho:
68
+
69
+ - Chave Brave Search → não consigo pesquisar na internet
70
+ - OpenAI API → não consigo transcrever áudio
71
+ - Backup GitHub → seu trabalho não fica salvo automaticamente
72
+
73
+ A primeira vitória vai funcionar, mas sem pesquisa real e sem backup.
74
+ Vai ser tipo "demonstração", não trabalho de verdade.
75
+
76
+ Quer:
77
+ *a)* Voltar e fazer o passo 5 agora (~12min)
78
+ *b)* Seguir e fazer vitória "demo" (sem pesquisa real)
79
+ ```
80
+
81
+ ---
82
+
83
+ ## Tipo de dependência
84
+
85
+ **Hard (técnica)** = sem o passo anterior, próximo passo NÃO funciona ou funciona MUITO mal.
86
+
87
+ **Soft (qualidade)** = próximo passo funciona, mas experiência degrada.
88
+
89
+ Ao pular, sempre mostrar o tipo de dependência pra aluno entender o trade-off real.
90
+
91
+ ---
92
+
93
+ ## Casos especiais
94
+
95
+ ### Pulou 0 (Whisper opcional)
96
+
97
+ Sem aviso. Passo 0 é opcional por design — pular é caminho normal.
98
+
99
+ ### Pulou 1 (Personalidade agente) E não vai voltar
100
+
101
+ Passo 2 (Personalidade aluno) pergunta "Como você quer ser chamado?" — mas agente não tem nome. Dilema:
102
+
103
+ - Opção A: Passo 2 pergunta nome do agente também (engole responsabilidade do passo 1)
104
+ - Opção B: Aluno termina jornada com agente sem nome — pode pedir depois com "muda meu agente"
105
+
106
+ Decidi por **B**: respeitar pulo do aluno. Agente sem nome é legítimo.
107
+
108
+ ### Pulou TODOS exceto 6
109
+
110
+ Aluno chegou no passo 6 sem fazer 1, 2, 3, 4 nem 5. Cenário extremo. Tratamento:
111
+
112
+ ```
113
+ Você quer fazer a vitória sem nenhum dos outros passos?
114
+
115
+ Pra ser honesto, vai ser frustrante:
116
+ - Eu não tenho identidade nem te conheço (não vou personalizar nada)
117
+ - Não tenho autonomia (vou pedir aprovação a cada ação)
118
+ - Não tenho workspace organizado (não vou saber onde salvar)
119
+ - Não tenho pesquisa nem APIs (vou usar só meu conhecimento interno)
120
+
121
+ Recomendação forte: faz pelo menos 1 e 3 antes. Isso destrava a vitória
122
+ de verdade. Manda "volta no 1" pra começar do começo.
123
+
124
+ Se quiser MESMO assim seguir só pro 6, manda "vai mesmo".
125
+ ```
126
+
127
+ ---
128
+
129
+ ## Inverso: o que cada passo HABILITA
130
+
131
+ | Passo concluído | Habilita |
132
+ |---|---|
133
+ | 0 | Áudio em todos os passos seguintes |
134
+ | 1 | Agente personalizado em todas as próximas mensagens |
135
+ | 2 | Agente te conhece e adapta tom/sugestões |
136
+ | 3 | Passos 4-6 fluem sem pedir aprovação a cada ação |
137
+ | 4 | Agente sabe onde salvar tudo que cria |
138
+ | 5 | Pesquisa real, transcrição áudio, backup automático |
139
+ | 6 | Aluno tem prova viva de que agente trabalha |
@@ -0,0 +1,54 @@
1
+ # Manifesto de Abertura — Versão Curta
2
+
3
+ > Texto literal que a `onboarding-checklist` carrega e apresenta como primeira mensagem do agente, antes da checklist visual.
4
+ > Substituições obrigatórias: `{nome_aluno}` (do USER.md se existir, senão omitir).
5
+
6
+ ---
7
+
8
+ ## Texto
9
+
10
+ ```
11
+ {nome_aluno}, beleza. Acabei de mapear o kit que você instalou.
12
+
13
+ Antes da gente começar, contexto rápido:
14
+
15
+ Esse Starter Kit foi feito pelo Bruno Okamoto, autor do mini-curso. A
16
+ ideia é radical: em vez de você ler manual e configurar tudo na mão,
17
+ *eu sou seu tutor*. Eu te guio passo a passo, executo o que dá pra
18
+ executar, te explico o que tô fazendo e por quê.
19
+
20
+ Esse é um curso construído pra dois tipos de aluno: *humanos e agentes*.
21
+ Você é o humano. Eu sou o agente. A gente faz isso juntos.
22
+
23
+ Heads up: o kit tá em fase de testes. Funciona bem, mas se você
24
+ encontrar algo estranho, manda direto pro Bruno: bruno@microsaas.com.br
25
+ — ele lê todos os feedbacks pessoalmente.
26
+
27
+ Manda "sobre" se quer saber mais da filosofia. Senão, bora começar a
28
+ sua jornada.
29
+ ```
30
+
31
+ ---
32
+
33
+ ## Notas
34
+
35
+ - **Quebras de linha são propositais** — facilitam leitura no Telegram mobile (mensagens longas em parede de texto cansam)
36
+ - **Negrito com `*texto*`** — funciona em Telegram (markdown nativo do bot)
37
+ - **Sem emoji** no manifesto — fica sério, contrasta com a checklist depois (que tem emoji)
38
+ - **Email do Bruno em destaque** — convite real pra contato direto, não decoração
39
+
40
+ ## Variações aceitáveis
41
+
42
+ Se o aluno entrar sem `USER.md` configurado (workspace 100% vazio), trocar primeira linha:
43
+
44
+ > "Beleza. Acabei de mapear o kit que você instalou."
45
+
46
+ (Sem nome — não temos. Vai ter no fim do passo 2.)
47
+
48
+ ## Variações NÃO aceitáveis
49
+
50
+ - ❌ Adicionar "Olá" ou "Oi" no começo (Bruno odeia formalidade)
51
+ - ❌ Trocar "beleza" por "tudo bem" (perde tom direto)
52
+ - ❌ Substituir "tá" por "está" (perde conversação)
53
+ - ❌ Adicionar emoji no manifesto (rompe contraste com checklist)
54
+ - ❌ Mover email do Bruno pro fim ou rodapé (perde destaque)