@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.
- package/README.md +60 -0
- package/assets/cases/case-amora.md +97 -0
- package/assets/cases/case-aurora-brunner.md +85 -0
- package/assets/cases/case-chris-everest.md +114 -0
- package/assets/cases/case-filippe-cesar.md +117 -0
- package/assets/cases/case-igor-gouveia.md +106 -0
- package/assets/cases//360/237/223/215 LEIA PRIMEIRO" +57 -0
- package/assets/cheatsheets/crons-do-seu-agente.md +170 -0
- package/assets/cheatsheets/identidade-do-seu-agente.md +133 -0
- package/assets/cheatsheets/integracoes-de-produtividade.md +171 -0
- package/assets/cheatsheets/memoria-do-seu-agente.md +166 -0
- package/assets/cheatsheets/mission-control.md +220 -0
- package/assets/cheatsheets/multi-agente.md +193 -0
- package/assets/cheatsheets/onboarding-do-seu-agente.md +145 -0
- package/assets/cheatsheets/outros-canais.md +129 -0
- package/assets/cheatsheets/skills-do-seu-agente.md +165 -0
- package/assets/cheatsheets/workspace-do-seu-agente.md +155 -0
- package/assets/cheatsheets//360/237/223/215 LEIA PRIMEIRO" +61 -0
- package/assets/prompts/business/analise-features.md +47 -0
- package/assets/prompts/business/metricas-saas.md +53 -0
- package/assets/prompts/business/reports-pdf.md +37 -0
- package/assets/prompts/business//360/237/223/215 LEIA PRIMEIRO.docx +0 -0
- package/assets/prompts/community/analise-comunidade.md +43 -0
- package/assets/prompts/community//360/237/223/215 LEIA PRIMEIRO" +11 -0
- package/assets/prompts/content/content-waterfall.md +57 -0
- package/assets/prompts/content/ideias-de-conteudo.md +36 -0
- package/assets/prompts/content/tom-de-voz.md +41 -0
- package/assets/prompts/content//360/237/223/215 LEIA PRIMEIRO" +13 -0
- package/assets/prompts/productivity/daily-briefing.md +57 -0
- package/assets/prompts/productivity/social-metrics.md +53 -0
- package/assets/prompts/productivity/viagens-pesquisas.md +38 -0
- package/assets/prompts/productivity//360/237/223/215 LEIA PRIMEIRO" +13 -0
- package/assets/prompts/research/deep-research.md +52 -0
- package/assets/prompts/research//360/237/223/215 LEIA PRIMEIRO" +11 -0
- package/assets/prompts/support/analise-suporte.md +41 -0
- package/assets/prompts/support//360/237/223/215 LEIA PRIMEIRO" +11 -0
- package/assets/prompts//360/237/223/215 LEIA PRIMEIRO.docx +0 -0
- package/assets/skills/_registry.md +184 -0
- package/assets/skills/canais/_registry.md +36 -0
- package/assets/skills/canais/wizard-whatsapp/SKILL.md +334 -0
- package/assets/skills/operacional/_registry.md +20 -0
- package/assets/skills/operacional/backup-workspace-github/SKILL.md +246 -0
- package/assets/skills/planejamento/_registry.md +70 -0
- package/assets/skills/planejamento/brainstorming/SKILL.md +133 -0
- package/assets/skills/planejamento/executing-plans/SKILL.md +182 -0
- package/assets/skills/planejamento/verification-before-completion/SKILL.md +157 -0
- package/assets/skills/planejamento/writing-plans/SKILL.md +170 -0
- package/assets/skills/starter/_registry.md +93 -0
- package/assets/skills/starter/onboarding-checklist/SKILL.md +434 -0
- package/assets/skills/starter/onboarding-checklist/evals/evals.json +245 -0
- package/assets/skills/starter/onboarding-checklist/references/arquivamento-pos-jornada.md +167 -0
- package/assets/skills/starter/onboarding-checklist/references/arquivos-raiz.md +281 -0
- package/assets/skills/starter/onboarding-checklist/references/checklist-template.md +215 -0
- package/assets/skills/starter/onboarding-checklist/references/comandos-canonicos.md +272 -0
- package/assets/skills/starter/onboarding-checklist/references/dependencias.md +139 -0
- package/assets/skills/starter/onboarding-checklist/references/manifesto-abertura.md +54 -0
- package/assets/skills/starter/onboarding-checklist/references/mapa-aulas.md +216 -0
- package/assets/skills/starter/onboarding-checklist/references/padrao-exemplos-opt-in.md +159 -0
- package/assets/skills/starter/onboarding-checklist/references/principios-defensivos.md +408 -0
- package/assets/skills/starter/onboarding-checklist/references/prompt-upgrade-para-aluno-antigo.md +289 -0
- package/assets/skills/starter/onboarding-checklist/references/sistema-de-mapas.md +273 -0
- package/assets/skills/starter/onboarding-checklist/references/sobre-o-kit.md +105 -0
- package/assets/skills/starter/primeira-vitoria/SKILL.md +515 -0
- package/assets/skills/starter/primeira-vitoria/evals/evals.json +201 -0
- package/assets/skills/starter/wizard-agente/SKILL.md +420 -0
- package/assets/skills/starter/wizard-agente/evals/evals.json +204 -0
- package/assets/skills/starter/wizard-aluno/SKILL.md +353 -0
- package/assets/skills/starter/wizard-aluno/evals/evals.json +192 -0
- package/assets/skills/starter/wizard-autonomia/SKILL.md +391 -0
- package/assets/skills/starter/wizard-autonomia/evals/evals.json +192 -0
- package/assets/skills/starter/wizard-conectar/SKILL.md +450 -0
- package/assets/skills/starter/wizard-conectar/evals/evals.json +196 -0
- package/assets/skills/starter/wizard-whisper-quick/SKILL.md +349 -0
- package/assets/skills/starter/wizard-whisper-quick/evals/evals.json +195 -0
- package/assets/skills/starter/wizard-workspace/SKILL.md +483 -0
- package/assets/skills/starter/wizard-workspace/evals/evals.json +174 -0
- package/assets/templates/AGENTS.template.md +58 -0
- package/assets/templates/IDENTITY.template.md +21 -0
- package/assets/templates/MAPA.template.md +71 -0
- package/assets/templates/README.md +62 -0
- package/assets/templates/SOUL-stub.template.md +26 -0
- package/assets/templates/USER.template.md +41 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- package/openclaw.plugin.json +15 -0
- 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)
|