@pixeleducacao/curso-openclaw 2026.5.8

package/assets/skills/starter/onboarding-checklist/references/sistema-de-mapas.md

@@ -0,0 +1,273 @@
+# Sistema de Mapas — Padrão Distribuído
+
+> Como o workspace do aluno se documenta sozinho sem nenhum arquivo virar gigante.
+
+---
+
+## A regra em uma frase
+
+**Cada pasta importante tem seu próprio `MAPA.md` local. O `MAPA.md` raiz só lista pastas e aponta pros mapas locais. Nada é duplicado.**
+
+---
+
+## Por que distribuído (e não centralizado)
+
+Tentamos primeiro propor `TOOLS.md` monolítico (tudo num arquivo). Tem 3 problemas:
+
+1. **Cresce sem controle** — power user com 50 skills + 20 integrações = arquivo de 500+ linhas
+2. **Viola single source of truth** — duplica info que já vive em outros arquivos (registries, .env, OpenClaw cron list)
+3. **Princípio 12 fica frágil** — atualizar em 2 lugares = fora de sincronia em semanas
+
+Distribuído resolve os 3:
+- Cada mapa cresce no seu escopo (limitado naturalmente)
+- Cada mapa só fala da sua pasta — sem duplicar
+- Princípio 12 só atualiza UM mapa (o local da pasta afetada)
+
+---
+
+## Estrutura completa
+
+```
+workspace/
+├── MAPA.md                    ← MAPA RAIZ (lista pastas, aponta pros locais)
+│
+├── skills/
+│   ├── MAPA.md                ← mapa local de skills/
+│   ├── starter/
+│   │   └── MAPA.md            ← mapa local de skills/starter/
+│   ├── planejamento/
+│   │   └── MAPA.md
+│   └── canais/
+│       └── MAPA.md
+│
+├── content/
+│   ├── MAPA.md                ← mapa local de content/
+│   ├── drafts/
+│   └── images/
+│
+├── memory/
+│   ├── MAPA.md                ← mapa local de memory/
+│   ├── decisoes/
+│   ├── pendencias/
+│   └── pessoas/
+│
+└── archive/
+    └── MAPA.md                ← mapa local de archive/
+```
+
+---
+
+## Padrão visual de cada `MAPA.md`
+
+Independente do nível, todo `MAPA.md` segue mesmo padrão:
+
+```markdown
+# MAPA.md — {pasta atual}
+
+> Última atualização: {data}
+
+## O que tem aqui
+
+{Conteúdo específico da pasta — tabela, lista, ou descrição.}
+
+## Como navegar
+
+{Como ir mais fundo ou subir um nível.}
+
+## Quando atualizar
+
+{Trigger que dispara atualização deste mapa.}
+```
+
+---
+
+## Exemplos por nível
+
+### MAPA raiz (`workspace/MAPA.md`)
+
+```markdown
+# MAPA.md — workspace raiz
+
+## Pastas principais
+
+| Pasta | Função | Mapa local |
+|---|---|---|
+| `skills/` | Skills instaladas | [skills/MAPA.md](skills/MAPA.md) |
+| `content/` | Coisas que eu crio | [content/MAPA.md](content/MAPA.md) |
+| `memory/` | Coisas que eu lembro | [memory/MAPA.md](memory/MAPA.md) |
+| `archive/` | Material arquivado | [archive/MAPA.md](archive/MAPA.md) |
+
+## Arquivos raiz
+
+Ver [`AGENTS.md`](AGENTS.md) pra regras de interação.
+Ver detalhe de cada arquivo raiz em `references/arquivos-raiz.md` (no kit).
+
+| Arquivo | Função |
+|---|---|
+| `USER.md` | Quem você é |
+| `IDENTITY.md` | Quem eu sou |
+| `SOUL.md` | Minha personalidade |
+| `AGENTS.md` | Regras entre nós |
+| `MEMORY.md` | Decisões + memória |
+| `HEARTBEAT.md` | Estado atual |
+| `.env` | Chaves API |
+
+## Quando atualizar este mapa
+
+Só quando estrutura macro mudar:
+- Pasta nova criada
+- Pasta importante removida ou renomeada
+- Novo arquivo raiz adicionado
+
+NÃO atualizar quando algo dentro de uma pasta muda — isso é responsabilidade do mapa local da pasta.
+```
+
+---
+
+### MAPA local de pasta com sub-pastas (`workspace/skills/MAPA.md`)
+
+```markdown
+# MAPA.md — skills/
+
+## Categorias
+
+| Categoria | Skills | Status | Mapa |
+|---|---:|---|---|
+| starter | 1 ativa, 6 arquivadas | jornada de onboarding completa | [starter/MAPA.md](starter/MAPA.md) |
+| planejamento | 4 | Superpowers curado | [planejamento/MAPA.md](planejamento/MAPA.md) |
+| canais | 1 | wizard-whatsapp (não ativado) | [canais/MAPA.md](canais/MAPA.md) |
+
+## Como navegar
+
+- Detalhe de categoria: `{categoria}/MAPA.md`
+- Detalhe de skill específica: `{categoria}/{nome}/SKILL.md`
+
+## Quando atualizar
+
+- Skill nova instalada → atualiza este mapa (contagem) + mapa da categoria
+- Skill removida → idem
+- Categoria nova criada → atualiza este mapa + cria MAPA.md da categoria
+```
+
+---
+
+### MAPA local de pasta com arquivos diretos (`workspace/content/MAPA.md`)
+
+```markdown
+# MAPA.md — content/
+
+## O que tem aqui
+
+| Sub-pasta | Função | Conteúdo recente |
+|---|---|---|
+| `drafts/` | Posts, briefings, planos que crio pra você | 1 arquivo: primeira-vitoria-2026-05-02.md |
+| `images/` | Imagens geradas (futuro) | vazio |
+
+## Convenção de naming
+
+- Drafts: `{nome-da-skill}-{YYYY-MM-DD}.md` (ex: `primeira-vitoria-2026-05-02.md`)
+- Imagens: `{tema}-{YYYY-MM-DD}.png`
+
+## Quando atualizar
+
+- Novo arquivo criado em qualquer sub-pasta → atualiza contagem aqui
+- Sub-pasta nova criada → adiciona linha
+```
+
+---
+
+### MAPA local de pasta com items individuais (`workspace/skills/starter/MAPA.md`)
+
+```markdown
+# MAPA.md — skills/starter/
+
+## Skills da jornada de onboarding (concluída)
+
+| Skill | Status pós-jornada |
+|---|---|
+| onboarding-checklist | arquivada (mestre — função cumprida) |
+| wizard-whisper-quick | arquivada (Whisper já configurado) |
+| wizard-agente | arquivada (identidade já criada) |
+| wizard-aluno | arquivada (USER já criado) |
+| wizard-autonomia | arquivada (já liberada) |
+| wizard-workspace | arquivada (já organizado) |
+| wizard-conectar | arquivada (já conectado) |
+| primeira-vitoria | **ativa** — usa de novo pra criar mais artefatos |
+
+## Quando atualizar
+
+Esse mapa estabiliza após jornada de onboarding.
+Atualizar só se:
+- Aluno desarquivar alguma wizard pra refazer
+- primeira-vitoria for desativada/atualizada
+```
+
+---
+
+## Como o agente usa os mapas
+
+Princípio: **leia só o que precisa.**
+
+| Aluno pergunta | Agente lê |
+|---|---|
+| "que skills eu tenho?" | `skills/MAPA.md` |
+| "que skills de planejamento?" | `skills/planejamento/MAPA.md` |
+| "como funciona a primeira-vitoria?" | `skills/starter/primeira-vitoria/SKILL.md` |
+| "o que tem em content/drafts/?" | `content/MAPA.md` (vê contagem), depois `ls content/drafts/` se precisar lista |
+| "que decisões tomei mês passado?" | `memory/MAPA.md` (vê estrutura), depois `memory/decisoes/2026-04.md` |
+
+Não precisa de varredura completa do workspace. Mapas direcionam navegação.
+
+---
+
+## Comando "status" — visão consolidada sob demanda
+
+Quando aluno quer ver tudo de uma vez, agente roda queries on-demand:
+
+> Status do seu agente:
+>
+> **Skills ativas:** 12 (lê `skills/MAPA.md`)
+> - 4 starter (1 ativa, 3 arquivadas)
+> - 4 planejamento
+> - 2 canais
+> - 2 que você criou
+>
+> **Integrações conectadas:** 5 (lê `.env`, sem expor valores)
+> - OpenAI API, OpenAI OAuth, Brave Search, GitHub, Chromium
+>
+> **Crons rodando:** 1 (`openclaw cron list`)
+> - backup-github (diário 03h)
+>
+> **Última atividade:** hoje 14h30 (lê `HEARTBEAT.md`)
+>
+> Quer detalhe? Manda "skills detalhado", "crons detalhado", etc.
+
+Resposta sempre fresca, custo trivial, sem arquivo agregador pra inchar.
+
+---
+
+## Quando criar um MAPA novo
+
+**SIM, criar `MAPA.md`:**
+- Pasta tem 3+ items que precisam ser indexados
+- Pasta vai crescer ao longo do tempo (skills, content, memory)
+- Pasta tem sub-pastas que precisam ser navegadas
+
+**NÃO criar `MAPA.md`:**
+- Pasta com 1-2 arquivos triviais (ex: `images/` com 2 PNGs)
+- Pasta gerada/temporária (ex: `tmp/`, `.cache/`)
+- Sub-pasta de arquivos versionados pelo agente (ex: `decisoes/2026-04.md` — não precisa MAPA dentro de decisoes/)
+
+Default: criar mapa só quando faz diferença pro agente OU pro aluno explorando.
+
+---
+
+## Princípio 12 conectado
+
+Este sistema implementa o **Princípio 12 — Mapas distribuídos** descrito em `principios-defensivos.md`:
+
+> Cada pasta importante tem mapa local; MAPA raiz só lista pastas. Quando algo muda, atualizar SÓ o mapa local da pasta afetada. Mapas desatualizados são pior que mapa nenhum — Princípio 12 mantém vivos.
+
+---
+
+*Última revisão: 02/05/2026*

package/assets/skills/starter/onboarding-checklist/references/sobre-o-kit.md

@@ -0,0 +1,105 @@
+# Sobre o Kit — Versão Expandida
+
+> Carregado pela `onboarding-checklist` quando aluno manda comando `"sobre"` (ou variantes: "filosofia", "quem fez isso?", "me explica o kit").
+> Após exibir, retomar pra última posição da jornada com pergunta: "Bora voltar pro passo {N}?"
+
+---
+
+## Texto
+
+```
+*Sobre o Starter Kit "Minha Cabeça"*
+
+*Quem fez*
+Bruno Okamoto — fundador da Pixel Educação, autor do mini-curso OpenClaw.
+12+ anos construindo Micro-SaaS no Brasil.
+
+*A tese*
+A maioria dos cursos de IA ensina você a USAR a ferramenta. Esse aqui é
+diferente: ele ensina o seu agente a se ensinar — e você assiste de
+camarote enquanto isso acontece.
+
+Por isso o nome "Minha Cabeça". Você não vai aprender a usar uma
+ferramenta nova. Você vai construir uma extensão da sua cabeça que
+trabalha por você.
+
+*Por que "curso pra humanos E agentes"*
+Esse é o primeiro experimento da Pixel onde o conteúdo do curso roda
+DENTRO do agente do aluno. Cada skill aqui foi escrita pra ser lida e
+executada por outro agente (LLM) E compreensível pra um humano que
+olha por cima.
+
+Isso é novo. Tá funcionando? A gente descobre junto.
+
+*Filosofia operacional*
+
+1. Managed-first — você nunca vai precisar abrir terminal SSH ou
+   configurar Docker. Tudo roda no Managed Hostinger.
+
+2. Primeira vitória antes de setup pesado — em ~37min você tem
+   agente trabalhando de verdade.
+
+3. Um agente forte com skills fortes > muitos agentes genéricos.
+
+4. Agente como funcionário digital — pense nele como funcionário novo
+   no primeiro dia. Você apresenta a empresa, dá acessos, define
+   limites, ensina o jeito da casa.
+
+*O que esse kit NÃO é*
+- Tutorial pra você seguir lendo
+- Configuração que você faz na mão
+- Curso só pra desenvolvedor
+- Setup VPS/SSH/Docker
+- "Usar OpenAI" (você vai construir um agente, não chatbot)
+
+*O que esse kit É*
+- Tutoria agêntica: o agente te conduz, você só responde
+- Setup que conclui em ~37min com agente trabalhando
+- Identidade própria do agente (nome, tom, limites)
+- Memória persistente
+- Pesquisa real (Brave Search + Whisper pra áudio)
+- Backup automático no GitHub
+- Caminho claro pras próximas aulas
+
+*Fase de testes*
+Esse kit tá em v1. Nada quebrado, mas tem rugosidade. Se você travar:
+
+— Rápido (24/7, IA): chama @Openclawzinho no tópico Suporte do grupo
+  https://t.me/cursoopenclaw
+
+— Médio (galera): pergunta nos outros tópicos do mesmo grupo
+  https://t.me/cursoopenclaw
+
+— Estruturado: bruno@microsaas.com.br
+  (Bruno lê pessoalmente — feedback bom vira melhoria na v2)
+
+*O que vem na v2 do kit*
+- gera-imagem (após validar suporte do Managed pra gpt-image-1)
+- wizard-whatsapp aprimorado (atendimento clientes)
+- wizard-google-workspace (Calendar + Gmail + Drive)
+- Skills de pesquisa avançada (Apify, Perplexity)
+- Skill de design rápido
+
+---
+
+Bora voltar pro passo {N}?
+```
+
+---
+
+## Notas
+
+- **Substituição obrigatória**: `{N}` = último passo onde o aluno estava antes de pedir "sobre". Pega de `MEMORY.md` (`onboarding_current_step`).
+- **Se aluno mandou "sobre" antes de começar a jornada** (logo após manifesto): trocar última linha por "Bora começar pelo passo 0 (opcional Whisper) ou ir direto pro passo 1?"
+- **Se aluno mandou "sobre" durante a jornada**: voltar exatamente pro ponto onde parou — não restartar passo.
+
+## Variações aceitáveis
+
+- Aluno pode mandar variantes: "filosofia", "quem fez", "me explica isso", "manifesto"
+- Todas disparam este texto
+
+## Variações NÃO aceitáveis
+
+- ❌ Adicionar/remover seções (mantém ordem fixa: tese → humanos+agentes → filosofia → não/é → testes → roadmap)
+- ❌ Encurtar a parte "fase de testes" (vende vulnerabilidade que cria conexão)
+- ❌ Mover email Bruno pra rodapé pequeno