@pixeleducacao/curso-openclaw 2026.5.8

package/assets/skills/starter/primeira-vitoria/SKILL.md

@@ -0,0 +1,515 @@
+---
+name: primeira-vitoria
+status: ATIVO
+category: starter
+owner: aluno
+version: 1.0
+mode: guided
+estimated_time: 5min
+model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4, gemini-pro]
+description: Use when student types "primeira vitória" / "vamo gerar algo", OR when dispatched by onboarding-checklist as passo 6 (último). Generates first real artifact (post, email, decisão registrada) using IDENTITY + USER + Brave Search. Saves to content/drafts/ and shows the path. Demonstrates the full integration stack working together. NPS prompt at the end (high promoter moment).
+---
+
+# Primeira Vitória — Passo 6 (último, vitória visível)
+
+## Promessa
+
+Em ~5min, aluno tem o primeiro artefato CONCRETO entregue pelo agente: um post salvo, um email rascunhado, uma decisão registrada. Arquivo no caminho previsto (`content/drafts/`), editável, em formato markdown.
+
+Esse é o momento de vitória — onde aluno PERCEBE que não comprou só "mais um chatbot": comprou uma extensão da própria cabeça que entrega trabalho.
+
+NPS aparece aqui (decisão D9): após primeira vitória, aluno tá no topo da curva de promoter score.
+
+## Quando disparar
+
+**Trigger automático:**
+- `onboarding-checklist` despacha como passo 6 (último)
+
+**Trigger explícito (standalone):**
+- "primeira vitória"
+- "vamo gerar algo"
+- "primeiro post"
+- "vamo testar"
+
+**NÃO disparar se:**
+- `first_win_completed=true` em `MEMORY.md` E `content/drafts/` tem ao menos 1 arquivo
+
+Se aluno mandar trigger explícito mesmo já tendo primeira vitória:
+
+```
+"Você já fez sua primeira vitória em {data}. Quer:
+a) Gerar OUTRO artefato (mesmo fluxo)
+b) Reabrir a primeira (em content/drafts/{arquivo})
+c) Cancelar"
+```
+
+## Dependência: passos 3, 4, 5
+
+Sem autonomia (3): vou pedir aprovação a cada call do Brave + cada salvamento.
+Sem workspace (4): não tenho onde salvar.
+Sem chave Brave (5): não consigo buscar referências.
+
+Aviso quando dependência não cumprida (mesmo padrão dos wizards anteriores).
+
+## Princípio 11 — Detecção antes de pedir
+
+Antes de gerar, checa:
+
+```
+1. Existe content/drafts/primeira-vitoria-*.md?
+   - Sim: aluno já fez. Pergunta se quer gerar outra ou só re-abrir.
+   - Não: fluxo normal.
+
+2. Existe drafts em content/drafts/ (mesmo que não seja primeira-vitoria)?
+   - Sim: aluno já usou agente em outra sessão. OK, não bloqueia.
+   - Não: caso típico.
+```
+
+## Fluxo principal
+
+### 1. Narrar promessa
+
+```
+"Chegou a hora boa. Em 5min você sai daqui com um artefato REAL
+no seu workspace.
+
+Vou:
+1. Te perguntar QUE tipo de coisa você quer entregar
+2. Pesquisar referências no Brave Search (se for sobre tema externo)
+3. Escrever um draft seguindo seu USER.md (tom + contexto)
+4. Salvar em content/drafts/primeira-vitoria-{tipo}-{data}.md
+5. Te mostrar onde tá pra você editar
+
+A diferença pra ChatGPT: o arquivo fica no SEU workspace, em
+markdown, editável. Você abre no editor que preferir, ajusta o que
+quiser, e usa.
+
+Bora?"
+```
+
+### 2. Perguntar tipo
+
+```
+"O que você quer entregar?
+
+Opções comuns:
+
+a) Post de 200-400 palavras sobre {tema relevante pro que você faz}
+b) Email pra alguém específico (cliente, colega, fornecedor)
+c) Decisão registrada (algo que você decidiu recentemente e quer salvar)
+d) Lista/checklist sobre {tema}
+e) Outro — me conta o que precisa
+
+Manda 'a', 'b', 'c', 'd' ou descreve. Pode ser bem específico:
+'post pra LinkedIn sobre 3 erros que cometo na padaria'."
+```
+
+Salvar `tipo_artefato`.
+
+### 3. Refinar (perguntas curtas conforme o tipo)
+
+#### Se "a) Post":
+
+```
+"Sobre o que? Quanto mais específico, melhor.
+
+Exemplos:
+- 'Post sobre como organizo o dia na padaria'
+- 'Post sobre o erro mais caro que cometi nos últimos 6 meses'
+- 'Post sobre por que troquei [ferramenta] por [outra]'
+
+Manda em 1 linha."
+```
+
+Pra plataforma:
+
+```
+"Pra qual rede social ou canal?
+- LinkedIn (texto técnico, parágrafos curtos)
+- Instagram (foto + caption longa)
+- Newsletter (mais profundo, ~800 palavras)
+- Outro
+"
+```
+
+#### Se "b) Email":
+
+```
+"Pra quem? E qual o assunto principal em 1 frase?
+
+Ex: 'Email pro Pedro, fornecedor de farinha, pedindo desconto
+porque tô comprando mais volume'."
+```
+
+#### Se "c) Decisão":
+
+```
+"Que decisão? Em 1-2 linhas.
+
+Ex: 'Decidi parar de fazer entrega aos domingos. Volume baixo
+não compensa o custo do entregador.'"
+```
+
+#### Se "d) Checklist":
+
+```
+"Sobre que processo? E pra quem usar?
+
+Ex: 'Checklist de fechamento da padaria à noite, pra usar quando
+funcionário novo treina'."
+```
+
+#### Se "e) Outro":
+
+```
+"Manda detalhe. Quanto mais contexto, melhor."
+```
+
+Salvar `tema_artefato` + `contexto_adicional`.
+
+### 4. Buscar referências (opcional, dependendo do tipo)
+
+Se artefato é POST sobre tema que tem benefício de pesquisa externa:
+
+```
+"Vou buscar 2-3 referências no Brave pra contextualizar."
+```
+
+Roda 1 query no Brave Search:
+
+```bash
+curl -s -H "X-Subscription-Token: $BRAVE_SEARCH_API_KEY" \
+     "https://api.search.brave.com/res/v1/web/search?q={query_url_encoded}" \
+     | jq '.web.results[0:3]'
+```
+
+Mostra ao aluno:
+
+```
+"Achei essas 3 referências:
+
+1. {título_1}
+   {snippet_1}
+   {url_1}
+
+2. {título_2}
+   {snippet_2}
+   {url_2}
+
+3. {título_3}
+   {snippet_3}
+   {url_3}
+
+Vou usar como inspiração + dar atribuição se citar dados específicos."
+```
+
+Se artefato é EMAIL ou DECISÃO ou CHECKLIST: **pular Brave** (não precisa de pesquisa). Direto pra geração.
+
+### 5. Gerar artefato
+
+Antes de gerar, ler:
+- `IDENTITY.md` (pra usar nome do agente quando se referir a si)
+- `SOUL.md` (tom)
+- `USER.md` (contexto do aluno + tom preferido)
+
+Gerar conteúdo seguindo:
+- Tom: do `tom_preferido` em USER.md + diretrizes de SOUL.md
+- Estrutura: padrão da plataforma escolhida (LinkedIn = parágrafos curtos, etc)
+- Comprimento: respeita o que aluno pediu (200-400 palavras pra post LinkedIn, etc)
+- Referências: se buscou no Brave, citar de forma natural (não "fonte 1, fonte 2")
+
+### 6. Salvar arquivo
+
+Path: `content/drafts/primeira-vitoria-{tipo_curto}-{YYYY-MM-DD}.md`
+
+Exemplo: `content/drafts/primeira-vitoria-post-2026-05-02.md`
+
+Estrutura do arquivo:
+
+```markdown
+# {título_artefato}
+
+> Gerado em: {data} pela primeira-vitoria do {nome_agente}
+> Tipo: {tipo_artefato}
+> Plataforma destino: {plataforma_se_aplicavel}
+
+---
+
+{conteúdo gerado}
+
+---
+
+## Referências (se aplicável)
+
+- {url_1} — {título_1}
+- {url_2} — {título_2}
+
+---
+
+## Como usar
+
+- **No celular (Telegram):** o conteúdo inteiro tá no chat acima. Você pode COPIAR daqui direto pra colar no LinkedIn / WhatsApp / Instagram / email. Se quiser refazer em outro tom, manda 'refaz com {ajuste}' que eu salvo nova versão e te mostro.
+- **No computador (web/painel Hostinger):** abre o painel do Managed → File Manager → navega até `content/drafts/{arquivo}.md`. Edita lá direto.
+- **Avançado:** se você usa VS Code/Obsidian com sync do workspace, abre por lá.
+- Quando publicar/enviar, mover de `content/drafts/` pra `content/archive/`.
+```
+
+### 7. Mostrar caminho ao aluno + entregar conteúdo USÁVEL
+
+```
+"✓ Pronto. Salvei em:
+
+  content/drafts/primeira-vitoria-{tipo}-{data}.md
+  ({tamanho} bytes, ~{N} palavras)
+
+Aqui tá o conteúdo INTEIRO pra você copiar:
+
+---
+
+{conteúdo gerado COMPLETO — pra Telegram dar pra copiar direto. Se for
+muito grande (>2000 chars), divide em 2-3 mensagens pra não cortar.}
+
+---
+
+3 jeitos de usar:
+
+📱 **No celular agora:** copia o texto acima direto do Telegram
+   (pressiona, 'Copiar') e cola no LinkedIn / WhatsApp / etc.
+
+💻 **No computador:** abre o painel da Hostinger Managed → File Manager →
+   navega até `content/drafts/primeira-vitoria-{tipo}-{data}.md`. Edita lá.
+
+🔄 **Refazer:** manda 'refaz com {ajuste}' (ex: 'mais curto', 'mais técnico',
+   'tira a parte sobre X'). Eu versiono a antiga em archive/ e gero v2.
+
+A versão salva é a v1. Você sempre tem palavra final."
+```
+
+### 8. Pergunta-âncora
+
+Pergunta literal (mapa-aulas.md passo 6):
+
+```
+"Rapidão antes de fechar este passo: esse arquivo que eu acabei de
+criar — onde ele tá salvo? Você consegue editar ele depois pra
+ajustar antes de publicar?"
+```
+
+| Resposta esperada | Validação |
+|---|---|
+| "em content/drafts/" + "sim posso editar" | "Isso. `content/drafts/primeira-vitoria-{data}.md`. Você pode abrir no editor que preferir, ajustar o que quiser, e usar. Tudo que eu crio fica visível e editável — você sempre tem palavra final." |
+| Quase / parcial | "`content/drafts/primeira-vitoria-{data}.md`. Markdown puro, abre em qualquer editor (VS Code, Obsidian, até bloco de notas). Pode editar tudo, eu não trava nada." |
+
+Fechar com:
+
+```
+"Se quer aprofundar como skills funcionam (e como criar skill própria
+pra repetir esse fluxo automatizado), a aula é a *C2* (Skills como SOP)
+— manda 'aula C2'.
+
+E se ficou alguma dúvida que eu não cobri, dois caminhos no grupo:
+- resposta rápida 24/7: chama @Openclawzinho (bot IA) no tópico Suporte
+- ajuda humana: pergunta nos outros tópicos
+https://t.me/cursoopenclaw
+
+Marquei o passo 6 como feito — você completou a jornada. 🎉
+
+[próximo bloco: NPS]"
+```
+
+### 9. NPS (decisão D9 — high promoter moment)
+
+```
+"Antes de você sair: rapidíssimo, em 1 número de 0 a 10:
+
+Quanto você recomendaria esse Starter Kit pra alguém que tá começando
+a usar agente IA?
+
+Pode mandar só o número."
+```
+
+Após resposta:
+
+| Score | Resposta |
+|---|---|
+| 9-10 (Promoter) | "Brigado! Se quiser ajudar a galera nova, manda na sua rede contando o que mais te surpreendeu. O grupo tá em https://t.me/cursoopenclaw — tem casos de pessoas começando como você." |
+| 7-8 (Neutro) | "Brigado pelo feedback. Manda no grupo @cursoopenclaw o que poderia melhorar — leio tudo. Se quiser feedback estruturado pro Bruno, bruno@microsaas.com.br responde direto." |
+| 0-6 (Detractor) | "Valeu pela honestidade. Me ajuda muito saber o que não funcionou. Manda no grupo @cursoopenclaw ou direto pro Bruno (bruno@microsaas.com.br) o que travou ou frustrou. Vou levar pro time." |
+
+Salvar `nps_score: {N}` em `MEMORY.md` (decisões).
+
+### 10. Renderizar checklist final completa
+
+Devolver controle pra `onboarding-checklist`, que renderiza:
+
+```
+=== Sua jornada — COMPLETA 🎉 ===
+
+[x] 0. Whisper configurado
+[x] 1. Personalidade do agente
+[x] 2. Sua personalidade
+[x] 3. Autonomia liberada
+[x] 4. Workspace organizado
+[x] 5. Superpoderes conectados
+[x] 6. Primeira vitória (content/drafts/primeira-vitoria-{data}.md)
+
+NPS: {score}
+
+Próximos passos opcionais:
+
+→ Quer arquivar o material de onboarding e deixar workspace limpo?
+  Manda 'arquiva onboarding'
+
+→ Quer ativar WhatsApp como canal extra (read-only)?
+  Manda 'ativa whatsapp'
+
+→ Quer instalar skills de planejamento (brainstorming, plans, debugging)?
+  Manda 'instala superpowers'
+
+→ Quer só seguir usando o agente?
+  Manda 'fechar' e a checklist some.
+
+A aula próxima é a B1 (Identidade completa) — mergulha fundo no SOUL
+do seu agente. Manda 'aula B1' pra link.
+
+Grupo: https://t.me/cursoopenclaw
+Bruno: bruno@microsaas.com.br
+```
+
+### 11. Atualizar MEMORY.md
+
+```markdown
+## Flags
+first_win_completed: true
+onboarding_complete: true
+
+## Decisões da jornada
+- {data}: Primeira vitória completa. Tipo: {tipo}. Plataforma: {plataforma}. NPS: {score}.
+
+## Artefatos gerados
+- content/drafts/primeira-vitoria-{tipo}-{data}.md
+```
+
+Atualizar `onboarding_current_step: done` (jornada principal completa).
+
+### 12. Devolver controle pra onboarding-checklist
+
+## Comando "refaz" durante este wizard
+
+Se aluno disser "refaz com tom mais X" ou "refaz mais curto":
+
+1. Backup do artefato atual em `archive/{nome_arquivo}-v1.md`
+2. Regenerar com ajuste pedido
+3. Salvar como v2 no mesmo path original (não cria arquivo novo)
+4. Mostrar diff resumido (o que mudou)
+
+Aluno pode refazer N vezes — cada versão antiga vai pra archive/.
+
+## Caminho alternativo: aluno sem inspiração
+
+Se aluno não souber o que pedir:
+
+```
+"Tranquilo. Olhando o que você me contou no USER.md ({o_que_faz}),
+3 sugestões pra essa primeira vitória:
+
+a) Post: '3 coisas que aprendi no último mês {fazendo X}'
+b) Decisão: registrar a decisão mais importante da semana
+c) Checklist: rotina diária do {seu trabalho}
+
+Manda 'a', 'b' ou 'c' (ou outra ideia)."
+```
+
+Personaliza sugestões pelo `o_que_faz` do USER.md.
+
+## Critérios de sucesso
+
+- [ ] Artefato gerado e salvo em `content/drafts/primeira-vitoria-*.md`
+- [ ] Path mostrado ao aluno
+- [ ] Aluno tem opção clara pra editar/refazer/usar
+- [ ] Pergunta-âncora respondida + validada
+- [ ] NPS coletado (0-10)
+- [ ] `first_win_completed=true` E `onboarding_complete=true` em `MEMORY.md`
+- [ ] Aula C2 mencionada
+- [ ] Próximos passos opcionais oferecidos (arquivar, WhatsApp, Superpowers)
+
+## Erros comuns
+
+- **Brave Search retorna 0 resultados:** raro, mas acontece pra termos muito nichados. Gerar mesmo assim, sem referências externas.
+- **Aluno pediu artefato que não conhece (ex: "post LinkedIn" mas nunca usou):** explicar diferença de plataformas brevemente. Não infantilizar.
+- **Aluno detesta o draft gerado:** convidar pra "refaz com {ajuste}". Iterar 2-3x se preciso. Não defender a versão atual.
+- **Aluno trata como 'só mais um teste':** ok, mas reforçar que arquivo é REAL no workspace dele. Não vai sumir. É dele.
+- **NPS baixo (0-6) sem feedback acionável:** insistir 1x na razão. Se mesmo assim não vier, ok. Salvar como "detractor sem feedback explícito".
+
+## Aplicação dos princípios defensivos
+
+Esta skill herda os princípios universais da `onboarding-checklist`. Ver: [`../onboarding-checklist/references/principios-defensivos.md`](../onboarding-checklist/references/principios-defensivos.md).
+
+### Aplicação específica
+
+- **Princípio 1 (backup antes):** se aluno pedir 'refaz', backup da versão atual em archive/ antes.
+- **Princípio 2 (confirmação humana):** menos relevante aqui (geração de artefato é mais conversacional). Mas sempre confirma estrutura/tom antes se aluno tem opções múltiplas.
+- **Princípio 4 (narrar antes de fazer):** narra cada etapa (pesquisa, geração, salvamento).
+- **Princípio 5 (atualizar MEMORY ao concluir):** marca first_win_completed + onboarding_complete + NPS.
+- **Princípio 8 (logging de decisões):** salva tipo, plataforma, NPS, artefato em MEMORY.
+- **Princípio 11 (detectar antes de pedir):** checa se já existe primeira-vitoria. Não duplica silenciosamente.
+
+## Modo A vs Modo B
+
+**Modo A:**
+```
+"Bora pro Módulo 6 — Primeira vitória (último).
+Aula correspondente: C2 (Skills como SOP).
+Sua primeira vitória é o gancho pra C2 — depois dela você aprende
+a transformar esse fluxo em skill reutilizável."
+[fluxo numerado]
+```
+
+**Modo B:**
+```
+"Última coisa: vamos gerar algo real. 5min. Você sai com arquivo
+salvo no workspace que você pode usar."
+[fluxo conversacional, mais animado — momento de vitória]
+```
+
+## Comando "exemplo" durante este wizard
+
+Se aluno pedir "exemplo" antes de escolher tipo:
+
+```
+"Pra calibrar, alguns artefatos que outros alunos geraram na
+primeira vitória:
+
+- 'Post LinkedIn sobre 5 erros que cometo na minha agência'
+- 'Email pro time sobre mudança de sistema de gestão'
+- 'Decisão de parar de pegar cliente abaixo de R$ X mil'
+- 'Checklist diário pro estagiário começar segunda'
+
+Cada pessoa escolhe coisa diferente. Manda o que faz sentido pra você."
+```
+
+(Esses são genéricos sanitizados — não tem template Amora específico aqui porque é geração ad-hoc.)
+
+## Referências
+
+### Internas
+- Princípios universais: [`../onboarding-checklist/references/principios-defensivos.md`](../onboarding-checklist/references/principios-defensivos.md)
+- Decisão D09 (NPS após primeira vitória): [`../../../../DECISOES-ARQUITETURA.md`](../../../../DECISOES-ARQUITETURA.md)
+- Decisão D10 (arquivamento opcional pós-jornada): mesma referência
+- Pergunta-âncora oficial: [`../onboarding-checklist/references/mapa-aulas.md`](../onboarding-checklist/references/mapa-aulas.md) (passo 6)
+- Skill backup-workspace-github (já ativada no passo 5): [`../../operacional/backup-workspace-github/SKILL.md`](../../operacional/backup-workspace-github/SKILL.md)
+
+### Externas
+- Brave Search API docs: https://api.search.brave.com/app/documentation
+- Markdown spec: https://daringfireball.net/projects/markdown/
+
+## Status
+
+✅ ATIVO desde v1 do Starter Kit (02/05/2026).
+
+## Roadmap
+
+- v1.1: Templates de artefato por plataforma (LinkedIn, Newsletter, Instagram) embutidos
+- v1.2: Comando "exporta primeira-vitoria" que faz formato apropriado pra publicação direta (HTML pro LinkedIn, etc)
+- v1.3: Detecção de artefatos similares já gerados (sugere "você já fez algo parecido em {data}, quer reutilizar?")
+- v2: Loop de iteração premium — agente sugere 3 versões em paralelo (mais conservador, mais arrojado, mais técnico) pra aluno escolher