@pixeleducacao/curso-openclaw 2026.5.8

package/assets/skills/starter/wizard-workspace/evals/evals.json

@@ -0,0 +1,174 @@
+{
+  "skill": "wizard-workspace",
+  "version": "1.0",
+  "description": "4 cenários cobrindo: criação completa, parcial, sem yolo (avisa fricção), MAPA monolítico tentado",
+  "scenarios": [
+    {
+      "id": "criacao-completa",
+      "name": "Caminho feliz",
+      "description": "Aluno chega no passo 4 com workspace vazio + autonomia liberada. Cria estrutura inteira.",
+      "setup": {
+        "workspace_state": "vazio",
+        "memory_flags": {
+          "autonomia_liberada": true,
+          "exec_policy": "yolo",
+          "onboarding_current_step": 4
+        }
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado]",
+          "expected_agent_behavior": [
+            "checa autonomia_liberada=true (ok, sem aviso)",
+            "executa Princípio 11 — detecta workspace vazio",
+            "narra promessa (4 pastas + MAPA + 4 mapas locais)",
+            "explica Princípio 12 brevemente",
+            "espera confirmação"
+          ]
+        },
+        {
+          "user": "vai",
+          "expected_agent_behavior": [
+            "Princípio 10 — workspace vazio, pula backup global",
+            "cria 4 pastas + subpastas com mkdir -p",
+            "cria MAPA.md raiz (substitui placeholders {NOME_AGENTE}, {NOME_USER}, {DATA})",
+            "cria 4 mapas locais inline",
+            "cria skills/_registry.md e skills/operacional/_registry.md",
+            "confirma criação",
+            "roda pergunta-âncora"
+          ],
+          "must_not": [
+            "criar TOOLS.md monolítico (Princípio 12 proíbe)",
+            "criar arquivos sem aluno confirmar",
+            "esquecer skills/_registry.md"
+          ]
+        },
+        {
+          "user": "post em content/drafts, decisão em memory/decisoes",
+          "expected_agent_behavior": [
+            "valida resposta correta",
+            "menciona aula B2",
+            "marca workspace_organizado=true",
+            "atualiza onboarding_current_step=5"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "MAPA.md raiz criado",
+        "4 pastas + 4 mapas locais criados",
+        "skills/_registry.md e operacional/_registry.md criados",
+        "workspace_organizado=true",
+        "onboarding_current_step=5",
+        "JAMAIS criou TOOLS.md monolítico"
+      ]
+    },
+    {
+      "id": "parcial-content-existe",
+      "name": "Aluno já tem content/ com drafts",
+      "description": "Aluno criou content/ manual antes. Wizard cria só o que falta.",
+      "setup": {
+        "workspace_state": "content/drafts existe com 2 arquivos",
+        "memory_flags": {
+          "autonomia_liberada": true
+        }
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado]",
+          "expected_agent_behavior": [
+            "detecta content/ ✓, memory/ ⏳, skills/ ⏳, archive/ ⏳",
+            "narra estado parcial",
+            "Princípio 10 — workspace tem conteúdo, faz backup global",
+            "cria SÓ memory/, skills/, archive/ + mapas",
+            "cria MAPA.md raiz (referenciando todas as 4 pastas)",
+            "verifica se content/MAPA.md existe; se não, cria"
+          ],
+          "must_not": [
+            "tocar nos arquivos existentes em content/drafts/",
+            "sobrescrever conteúdo de pastas existentes"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "content/drafts originais intactos",
+        "memory + skills + archive criados",
+        "backup global em ~/backups/",
+        "MAPA.md raiz coerente com a estrutura final"
+      ]
+    },
+    {
+      "id": "sem-autonomia-avisa",
+      "name": "Aluno tentou pular passo 3 e veio pro 4",
+      "description": "Sem yolo, fricção é certa. Wizard avisa e oferece volta pro 3.",
+      "setup": {
+        "workspace_state": "vazio",
+        "memory_flags": {
+          "autonomia_liberada": false,
+          "exec_policy": "ask"
+        }
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado]",
+          "expected_agent_behavior": [
+            "detecta autonomia_liberada=false",
+            "avisa sobre fricção (~10 confirmações)",
+            "oferece a) voltar pro 3, b) seguir com fricção",
+            "espera escolha do aluno"
+          ],
+          "must_not": [
+            "começar wizard ignorando dependência"
+          ]
+        },
+        {
+          "user": "a",
+          "expected_agent_behavior": [
+            "redespacha wizard-autonomia (passo 3)",
+            "marca passo 4 como pendente"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "aluno foi avisado da dependência",
+        "se escolheu (a), wizard-autonomia foi disparado novamente"
+      ]
+    },
+    {
+      "id": "aluno-quer-tools-monolitico",
+      "name": "Aluno pede TOOLS.md monolítico",
+      "description": "Aluno pediu 'cria um TOOLS.md com tudo'. Wizard recusa elegante e explica Princípio 12.",
+      "setup": {
+        "workspace_state": "vazio",
+        "memory_flags": {
+          "autonomia_liberada": true
+        }
+      },
+      "interaction_flow": [
+        {
+          "user": "[despachado]",
+          "expected_agent_behavior": ["narra promessa, explica Princípio 12"]
+        },
+        {
+          "user": "prefiro um TOOLS.md monolítico com tudo, vai ser mais fácil de ler",
+          "expected_agent_behavior": [
+            "explica problema com agregadores (cresce sem controle, duplica info, fica desatualizado)",
+            "oferece alternativa: comando 'status' que faz query agregada on-demand lendo os mapas locais",
+            "NÃO cria TOOLS.md monolítico mesmo aluno pedindo"
+          ],
+          "must_not": [
+            "criar TOOLS.md (Princípio 12 é lei)"
+          ]
+        },
+        {
+          "user": "ok, segue com mapas distribuídos",
+          "expected_agent_behavior": ["cria estrutura padrão"]
+        }
+      ],
+      "success_criteria": [
+        "TOOLS.md monolítico NÃO foi criado",
+        "Princípio 12 aplicado mesmo sob pressão",
+        "alternativa (comando status) foi oferecida"
+      ]
+    }
+  ]
+}

package/assets/templates/AGENTS.template.md

@@ -0,0 +1,58 @@
+# AGENTS — Workspace do {NOME_AGENTE}
+
+Esse é o workspace do {NOME_AGENTE}, agente do {NOME_USER}.
+
+## Boot da sessão
+
+Antes de qualquer coisa em cada sessão:
+
+1. Lê `SOUL.md` (quem sou)
+2. Lê `USER.md` (quem é o {NOME_USER})
+3. Lê `MAPA.md` (onde tá tudo no workspace)
+
+Não pede permissão. Apenas faz.
+
+## Memória
+
+Você acorda fresca a cada sessão. Estes arquivos são sua continuidade:
+
+- `memory/decisoes/{YYYY-MM}.md` — decisões importantes (append-only por mês)
+- `memory/projects/{nome}.md` — projetos ativos
+- (Se você adicionar `MEMORY.md` no futuro, ele vira memória de longo prazo curada)
+
+## Red Lines
+
+- Não exfiltra dados privados. Nunca.
+- `trash` > `rm` (recuperável > perdido pra sempre)
+- Em dúvida, pergunta antes de agir
+- Nunca executa comando que muda permissão (sudo, exec-policy, security) — pede pro {NOME_USER} colar manual
+
+## Sem perguntar (faço direto)
+
+| Situação | Ação |
+|---|---|
+| URL sozinha mandada | Salvo em `memory/inbox/` (cria pasta se não existir) |
+| Pesquisa simples | Pesquiso (Brave Search) e respondo |
+| Salvar decisão | Adiciono em `memory/decisoes/{YYYY-MM}.md` |
+| Criar draft | Salvo em `content/drafts/` |
+
+## Pede antes de agir
+
+| Situação | Por quê |
+|---|---|
+| Modificar IDENTITY/SOUL/USER/AGENTS/MAPA | Arquivos raiz são sensíveis (Princípio 1) |
+| Conectar nova integração | Custo $$ + pode mexer em config |
+| Criar cron novo | Infra compartilhada |
+| Enviar mensagem em nome do {NOME_USER} | Representação |
+| Comando shell que altera sistema | Pode quebrar coisa |
+
+## Tom em grupo
+
+(Por padrão, só respondo no chat 1:1. Se {NOME_USER} me adicionar em grupo,
+sigo regra padrão: respondo só quando mencionado, evito "triple-tap",
+não interrompo conversa fluida.)
+
+---
+
+*Criado em {DATA} pelo wizard-agente do Starter Kit OpenClaw v2.*
+*Veja `starter-kit/exemplos/AGENTS-amora.md` pra exemplo maduro.*

package/assets/templates/IDENTITY.template.md

@@ -0,0 +1,21 @@
+# IDENTITY — {NOME_AGENTE}
+
+**Nome:** {NOME_AGENTE}
+**Versão:** 1.0
+**Gênero:** {GENERO}
+**Modelo:** {MODELO}
+**Agent ID:** {AGENT_ID}
+**Reporta para:** {NOME_USER}
+
+**Onde atuo:**
+- Telegram do {NOME_USER}
+
+*Personalidade → SOUL.md*
+*Sobre o {NOME_USER} → USER.md*
+*Comportamento de sessão → AGENTS.md*
+*Mapa do workspace → MAPA.md*
+
+---
+
+*Criado em {DATA} pelo wizard-agente do Starter Kit OpenClaw v2.*
+*Edite direto. Mudanças refletem na próxima resposta.*

package/assets/templates/MAPA.template.md

@@ -0,0 +1,71 @@
+# MAPA — Workspace do {NOME_AGENTE}
+
+> Mapa central. Leia este arquivo pra saber onde encontrar qualquer coisa.
+
+## Arquivos Raiz
+
+| Arquivo | Função | Quando ler |
+|---|---|---|
+| `IDENTITY.md` | Bilhete de identidade do {NOME_AGENTE} (nome, modelo, etc) | Boot |
+| `SOUL.md` | Personalidade — como o {NOME_AGENTE} pensa e fala | Boot (passo 1) |
+| `USER.md` | Sobre o {NOME_USER} — quem é, o que faz, tom preferido | Boot (passo 2) |
+| `AGENTS.md` | Boot sequence + red lines + regras de comportamento | Boot |
+| `MAPA.md` | Este arquivo — navegação geral | Boot (passo 3) |
+
+## Pastas Principais
+
+```
+workspace/
+├── content/         → Tudo que o agente CRIA pro {NOME_USER} (posts, drafts)
+│   ├── MAPA.md
+│   ├── drafts/      → rascunhos em produção
+│   └── archive/     → publicados/versionados
+│
+├── memory/          → Tudo que o agente PRECISA LEMBRAR entre sessões
+│   ├── MAPA.md
+│   ├── decisoes/    → 1 arquivo por mês (YYYY-MM.md)
+│   └── projects/    → 1 arquivo por projeto ativo
+│
+├── skills/          → Habilidades modulares (1 pasta por skill)
+│   ├── MAPA.md
+│   ├── _registry.md → índice global das skills instaladas
+│   └── operacional/ → categoria inicial (backup, sync, etc)
+│
+└── archive/         → Versionamento manual quando algo é substituído
+    └── MAPA.md
+```
+
+## Navegação Rápida
+
+| Estou buscando... | Onde ir |
+|---|---|
+| Onde salvar um draft novo | `content/drafts/` |
+| Decisões registradas | `memory/decisoes/{YYYY-MM}.md` |
+| Status de um projeto | `memory/projects/{nome}.md` |
+| Skills instaladas | `skills/_registry.md` |
+| Histórico de algo arquivado | `archive/` |
+
+## Sub-MAPAs
+
+Cada pasta principal documenta a si mesma (Princípio 12 — mapas distribuídos):
+
+- `content/MAPA.md`
+- `memory/MAPA.md`
+- `skills/MAPA.md`
+- `archive/MAPA.md`
+
+Não tem `TOOLS.md` agregador. Razão: cresce sem controle, duplica info, fica desatualizado.
+
+## Quando atualizar este arquivo
+
+| Mudança | Atualizar este MAPA? |
+|---|---|
+| Skill nova instalada | NÃO (atualizar `skills/{categoria}/_registry.md`) |
+| Pasta principal nova criada | SIM |
+| Decisão importante registrada | NÃO (vai pra `memory/decisoes/`) |
+| Estrutura de subpasta mudou | NÃO (atualizar MAPA local da pasta) |
+
+---
+
+*Criado em {DATA} pelo wizard-workspace do Starter Kit OpenClaw v2.*
+*Veja `starter-kit/exemplos/MAPA-amora.md` pra exemplo maduro de workspace.*

package/assets/templates/README.md

@@ -0,0 +1,62 @@
+# Templates — Starter Kit OpenClaw v2
+
+> Templates raiz `.template` que os wizards usam pra criar arquivos no workspace do aluno.
+
+## O que tem aqui
+
+| Template | Usado pelo wizard | Cria no workspace |
+|---|---|---|
+| `IDENTITY.template.md` | wizard-agente | `IDENTITY.md` |
+| `SOUL-stub.template.md` | wizard-agente | `SOUL.md` (versão stub) |
+| `AGENTS.template.md` | wizard-agente | `AGENTS.md` |
+| `USER.template.md` | wizard-aluno | `USER.md` |
+| `MAPA.template.md` | wizard-workspace | `MAPA.md` (raiz) |
+
+## Como funcionam
+
+Cada template tem **placeholders** entre chaves (ex: `{NOME_AGENTE}`, `{DATA}`). O wizard:
+
+1. Coleta dados do aluno via entrevista (ou detecta de arquivos existentes)
+2. Lê o template
+3. Substitui cada `{PLACEHOLDER}` pelo valor coletado
+4. Salva o arquivo final no workspace do aluno
+
+## Placeholders comuns
+
+| Placeholder | Origem |
+|---|---|
+| `{NOME_AGENTE}` | wizard-agente — pergunta 1 |
+| `{GENERO}` | wizard-agente — pergunta 2 |
+| `{TOM}` | wizard-agente — pergunta 3 |
+| `{ANTI_PATTERN}` | wizard-agente — pergunta 4 |
+| `{MODELO}` | detectado via `openclaw config show model` |
+| `{AGENT_ID}` | calculado: `{nome_lowercase}-{user_lowercase}` |
+| `{NOME_COMPLETO}` | wizard-aluno — pergunta 1 |
+| `{COMO_CHAMAR}` | wizard-aluno — pergunta 1 |
+| `{CIDADE}` | wizard-aluno — pergunta 2 |
+| `{TIMEZONE}` | inferido da cidade |
+| `{IDIOMA}` | inferido do timezone |
+| `{O_QUE_FAZ}` | wizard-aluno — pergunta 3 |
+| `{TOM_PREFERIDO}` | wizard-aluno — pergunta 4 |
+| `{NOME_USER}` | extraído de USER.md (campo `Como me chamar`) |
+| `{DATA}` | data atual no formato YYYY-MM-DD |
+
+## Mapas locais (criados pelo wizard-workspace)
+
+Os 4 mapas locais (`content/MAPA.md`, `memory/MAPA.md`, `skills/MAPA.md`, `archive/MAPA.md`) são gerados **inline** pelo `wizard-workspace/SKILL.md` (não tem template `.md` separado pra eles).
+
+Razão: o conteúdo é simples e pouco varia por aluno — não compensa um template separado.
+
+Se no futuro a customização ficar necessária, mover pra cá como `{nome}-MAPA.template.md`.
+
+## Quando atualizar templates
+
+- Quando estrutura padrão dos arquivos raiz mudar (ex: adicionar campo novo no IDENTITY)
+- Quando placeholder novo for necessário (ex: `{NICHO}` se algum dia perguntar nicho do aluno)
+- Quando wording melhorar (ex: revisar tom dos comentários no template)
+
+**NÃO atualizar pra ajustes de UX dos wizards** — esses são os scripts (SKILL.md), não os outputs.
+
+---
+
+*Templates v1 — criados junto com a Onda 2 dos wizards filhos (02/05/2026).*

package/assets/templates/SOUL-stub.template.md

@@ -0,0 +1,26 @@
+# SOUL — {NOME_AGENTE} (stub)
+
+Sou {NOME_AGENTE}, agente do {NOME_USER}.
+
+## Tom
+
+{TOM}
+
+## 1 anti-pattern fundamental
+
+{ANTI_PATTERN}
+
+## Como penso (a expandir)
+
+- Antes de responder algo importante, considero o contexto do {NOME_USER} (USER.md)
+- Quando recebo mensagem ambígua, pergunto antes de assumir
+- Respostas curtas são padrão; profundidade quando o contexto pede
+
+---
+
+> **STUB — versão inicial.**
+> Esta SOUL.md vai crescer ao longo do uso. A aula B1 do mini-curso ensina a expandir.
+> Quando você descobrir padrões de como QUER que eu me comporte, adiciona aqui.
+> Veja `starter-kit/exemplos/SOUL-amora.md` pra exemplo de SOUL maduro (~150 linhas).
+
+*Criado em {DATA} pelo wizard-agente do Starter Kit OpenClaw v2.*

package/assets/templates/USER.template.md

@@ -0,0 +1,41 @@
+# USER — Sobre {NOME_COMPLETO}
+
+- **Nome:** {NOME_COMPLETO}
+- **Como me chamar:** {COMO_CHAMAR}
+- **Cidade:** {CIDADE}
+- **Timezone:** {TIMEZONE}
+- **Idioma:** {IDIOMA}
+
+---
+
+## O que faço
+
+{O_QUE_FAZ}
+
+---
+
+## Tom preferido
+
+{TOM_PREFERIDO}
+
+---
+
+## Como crescer este arquivo
+
+USER.md é o que o agente lê pra saber quem você é. Quanto mais contexto, mais útil ele é.
+
+**Você pode adicionar:**
+
+- **Prioridades atuais** — em que você tá focada agora (1-3 itens)
+- **Vocabulário** — termos técnicos da sua área que o agente deve usar sem explicar
+- **Preferências de horário** — quando produz, quando descansa
+- **Pessoas frequentes** — quem aparece muito (parceiros, clientes, familiares)
+- **Ferramentas que usa** — sistemas, apps, processos
+
+**Não precisa adicionar nada disso agora.** Comece simples. Expande conforme descobre o que falta.
+
+---
+
+*Criado em {DATA} pelo wizard-aluno do Starter Kit OpenClaw v2.*
+*Veja `starter-kit/exemplos/USER-amora.md` pra exemplo de USER maduro.*
+*Edite direto. Mudanças refletem na próxima resposta.*

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginConfigSchema;
+    register: NonNullable<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition["register"]>;
+} & Pick<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition, "kind" | "reload" | "nodeHostCommands" | "securityAuditCollectors">;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;AAEA,wBASG"}

package/dist/index.js

@@ -0,0 +1,11 @@
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+export default definePluginEntry({
+    id: "curso-openclaw",
+    name: "Curso OpenClaw v2 - Bruno Okamoto",
+    description: "Conteúdo do mini-curso 'Construindo seus primeiros agentes' — skills, templates, cheatsheets, cases.",
+    register() {
+        // Skills-only plugin: skills are loaded automatically via manifest.skills.
+        // No runtime registration needed.
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,eAAe,iBAAiB,CAAC;IAC/B,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,sGAAsG;IACxG,QAAQ;QACN,2EAA2E;QAC3E,kCAAkC;IACpC,CAAC;CACF,CAAC,CAAC"}

package/openclaw.plugin.json

@@ -0,0 +1,15 @@
+{
+  "id": "curso-openclaw",
+  "name": "Curso OpenClaw v2 - Bruno Okamoto",
+  "description": "Conteúdo do mini-curso 'Construindo seus primeiros agentes' — skills, templates, cheatsheets, cases.",
+  "version": "2026.5.8",
+  "activation": {
+    "onStartup": false
+  },
+  "skills": ["./assets/skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pixeleducacao/curso-openclaw",
+  "version": "2026.5.8",
+  "description": "Plugin OpenClaw do mini-curso \"Construindo seus primeiros agentes\" — Bruno Okamoto / Pixel Educação",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**",
+    "assets/**",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "license": "MIT",
+  "author": "Bruno Okamoto <bruno@microsaas.com.br>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pixel-educacao/curso-openclaw-plugin.git"
+  },
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "openclaw": "^2026.5.7",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "sync": "node scripts/sync-assets.mjs",
+    "sync:web": "cp install.sh web/install.sh",
+    "build": "pnpm sync && pnpm sync:web && tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}