@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,133 @@
1
+ ---
2
+ name: brainstorming
3
+ status: ATIVO
4
+ category: planejamento
5
+ owner: aluno
6
+ version: 1.0
7
+ mode: guided
8
+ estimated_time: 5-15min (varia por escopo da decisão)
9
+ model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4]
10
+ description: Use BEFORE any creative or design work — features novas, mudanças de comportamento do agente, decisões de arquitetura. Explores user intent, requirements, and design BEFORE implementation. Adapted from obra/superpowers (originally for software engineering, applied here to general agent workflows). Forces explicit thinking instead of jumping to action.
11
+ source: https://github.com/obra/superpowers (skill: brainstorming)
12
+ ---
13
+
14
+ # Brainstorming — Pensar Antes de Construir
15
+
16
+ ## Promessa
17
+
18
+ Antes de pedir pro agente CONSTRUIR algo (feature nova, fluxo, automação, conteúdo), gastar 5-15min explorando o problema. Resultado: você sabe O QUE quer e POR QUÊ antes de começar. Constrói a coisa certa em vez de iterar versões erradas.
19
+
20
+ Adaptado da skill `brainstorming` do projeto [obra/superpowers](https://github.com/obra/superpowers) — originalmente pra eng de software, aplicado aqui pra workflows gerais de agente.
21
+
22
+ ## Quando usar
23
+
24
+ **Use ANTES de:**
25
+ - Pedir agente criar skill nova
26
+ - Definir comportamento novo (ex: "agente vai responder X de jeito Y")
27
+ - Adicionar integração nova
28
+ - Mudar fluxo existente que tá te incomodando
29
+ - Qualquer "vamos construir" que envolve >1 hora de trabalho
30
+
31
+ **NÃO use pra:**
32
+ - Tarefa simples ("escreve um post sobre X")
33
+ - Bug fix óbvio
34
+ - Pedidos one-shot sem peso futuro
35
+
36
+ ## Como funciona
37
+
38
+ ### Etapa 1 — Por que (5min)
39
+
40
+ Antes de QUALQUER decisão técnica, responde:
41
+
42
+ ```
43
+ 1. O que tá te incomodando hoje?
44
+ 2. Como você sabe que isso é problema (sintomas concretos)?
45
+ 3. Se você não fizer NADA, qual o impacto em 30 dias?
46
+ 4. Quem mais tem esse problema? (você só? equipe? clientes?)
47
+ ```
48
+
49
+ Se você não consegue responder os 4 com clareza, você não tem PROBLEMA — você tem URGE de fazer coisa nova. Pausa.
50
+
51
+ ### Etapa 2 — O quê (5min)
52
+
53
+ ```
54
+ 1. Em 1 frase, qual o resultado ideal? (não "usar X tecnologia" — RESULTADO)
55
+ 2. Como você vai saber que deu certo? (métrica concreta)
56
+ 3. Mínima coisa que resolve o problema? (não a versão completa, a versão MÍNIMA)
57
+ ```
58
+
59
+ Maior parte dos projetos morrem porque pulam essa etapa. Aluno define escopo em "tudo que parece interessante" em vez de "o mínimo que resolve".
60
+
61
+ ### Etapa 3 — Como (5min)
62
+
63
+ Só agora, pensa em implementação:
64
+
65
+ ```
66
+ 1. 2-3 abordagens diferentes pra resolver
67
+ 2. Tradeoff principal de cada uma (tempo vs qualidade vs flexibilidade)
68
+ 3. Qual você escolhe e POR QUÊ?
69
+ ```
70
+
71
+ Se aluno só consegue pensar em 1 abordagem, geralmente não pensou direito. Forçar 2-3 expõe alternativas.
72
+
73
+ ### Etapa 4 — Riscos (3min)
74
+
75
+ ```
76
+ 1. O que pode dar errado?
77
+ 2. Se isso acontecer, qual o plano B?
78
+ 3. Custo de errar (tempo perdido, dinheiro, relacionamento)?
79
+ ```
80
+
81
+ ## Como invocar com seu agente
82
+
83
+ Manda no chat:
84
+
85
+ ```
86
+ "Vamos brainstormar [coisa que você quer]. Roda a skill brainstorming.
87
+
88
+ Contexto:
89
+ - [contexto relevante]
90
+
91
+ Me guia pelas 4 etapas."
92
+ ```
93
+
94
+ Agente vai te conduzir pelas 4 etapas com perguntas específicas pro seu caso.
95
+
96
+ ## Output esperado
97
+
98
+ Ao final, agente entrega:
99
+
100
+ - **Problema** (1 parágrafo)
101
+ - **Solução proposta** (mínima viável)
102
+ - **Métricas de sucesso** (como saberá que funcionou)
103
+ - **Riscos principais + mitigação**
104
+ - **Próximos passos concretos** (não "explorar mais" — ações específicas)
105
+
106
+ Salvar em `memory/decisoes/{YYYY-MM}.md` (Princípio: tudo que importa vai pra arquivo).
107
+
108
+ ## Adaptação pro Starter Kit
109
+
110
+ A versão original da `obra/superpowers` é mais densa (15+ tópicos cobertos). Esta versão simplifica pras 4 etapas críticas. Conforme aluno usa, pode expandir pra cobertura completa do superpower original.
111
+
112
+ Se quer versão completa, ler: https://github.com/obra/superpowers/blob/main/skills/brainstorming/SKILL.md
113
+
114
+ ## Princípios herdados
115
+
116
+ - **Princípio 7 (em dúvida, perguntar):** brainstorming É a aplicação canônica desse princípio.
117
+ - **Princípio 9 (parar se algo der errado):** se etapa 1 não consegue responder com clareza, parar e pensar mais antes de seguir.
118
+
119
+ ## Critérios de sucesso
120
+
121
+ - [ ] As 4 etapas foram percorridas explicitamente (não pulou nenhuma)
122
+ - [ ] Solução proposta é MÍNIMA (não "tudo de uma vez")
123
+ - [ ] Output salvo em `memory/decisoes/`
124
+ - [ ] Próximos passos são concretos (verbos no infinitivo + prazos)
125
+
126
+ ## Referências
127
+
128
+ - Skill original: https://github.com/obra/superpowers
129
+ - Princípios universais: [`../../starter/onboarding-checklist/references/principios-defensivos.md`](../../starter/onboarding-checklist/references/principios-defensivos.md)
130
+
131
+ ## Status
132
+
133
+ ✅ ATIVO desde v1 do Starter Kit (02/05/2026) — versão curada/simplificada do superpower original.
@@ -0,0 +1,182 @@
1
+ ---
2
+ name: executing-plans
3
+ status: ATIVO
4
+ category: planejamento
5
+ owner: aluno
6
+ version: 1.0
7
+ mode: guided
8
+ estimated_time: varia (executa o plano todo)
9
+ model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4]
10
+ description: Use to execute a plan written by writing-plans skill. Walks through tasks one by one, marks progress in real-time, surfaces blockers, asks for review at checkpoints. Adapted from obra/superpowers (executing-plans skill). Loops independently until plan is done or blocker hit.
11
+ source: https://github.com/obra/superpowers (skill: executing-plans)
12
+ ---
13
+
14
+ # Executing Plans — Tirar Plano do Papel
15
+
16
+ ## Promessa
17
+
18
+ Pega o `PLAN.md` (gerado pela skill `writing-plans`) e executa tarefa por tarefa. Atualiza estado em tempo real, narra progresso, para em checkpoints definidos pra você revisar.
19
+
20
+ Sem essa skill, agente é "responsivo" — só faz quando você pergunta. Com ela, agente é "executivo" — você dá o plano, ele toca.
21
+
22
+ Adaptado de [obra/superpowers](https://github.com/obra/superpowers).
23
+
24
+ ## Quando usar
25
+
26
+ **Use quando:**
27
+ - Tem `PLAN.md` em `memory/projects/{nome}/`
28
+ - Plano tem tarefas atômicas com verificação
29
+ - Você tem ~30min+ pra deixar agente executar e revisar pontos de checkpoint
30
+
31
+ **NÃO use pra:**
32
+ - Plano vago ("vou começar a fazer X")
33
+ - Tarefas sem critério de verificação (agente não saberá quando termina)
34
+ - Decisões pendentes ainda
35
+
36
+ ## Como invocar
37
+
38
+ ```
39
+ "Roda executing-plans pro projeto {nome}.
40
+
41
+ PLAN.md em memory/projects/{nome}/PLAN.md.
42
+
43
+ Quero que execute até o checkpoint da fase 1."
44
+ ```
45
+
46
+ Ou mais aberto:
47
+
48
+ ```
49
+ "Executa PLAN.md de memory/projects/{nome}/. Para no primeiro
50
+ checkpoint pra eu revisar."
51
+ ```
52
+
53
+ ## Comportamento esperado do agente
54
+
55
+ ### 1. Lê plano + estado
56
+
57
+ Antes de começar, lê `PLAN.md` inteiro pra entender:
58
+
59
+ - O que tá feito (`[x]`)
60
+ - O que tá em progresso (`[~]`)
61
+ - O que tá bloqueado (`[!]`)
62
+ - O que falta (`[ ]`)
63
+
64
+ Identifica próxima tarefa não-bloqueada.
65
+
66
+ ### 2. Anuncia próxima tarefa
67
+
68
+ ```
69
+ "Próxima: T1.2 — {descrição}.
70
+ Estimativa: {Xmin}.
71
+ Verificação: {critério}.
72
+
73
+ Vou começar?"
74
+ ```
75
+
76
+ Espera OK do aluno (ou pula confirmação se aluno mandou "executa tudo").
77
+
78
+ ### 3. Executa
79
+
80
+ Faz a tarefa. Narra etapas significativas (não cada operação granular).
81
+
82
+ Se encontrar problema:
83
+ - **Ambíguo (precisa decisão):** PARA, pergunta ao aluno (Princípio 7)
84
+ - **Bloqueado externo (depende de algo fora):** marca `[!]`, segue pra próxima tarefa não-bloqueada
85
+ - **Erro técnico:** investiga 1-2x, se não resolve PARA e reporta (Princípio 9)
86
+
87
+ ### 4. Verifica resultado
88
+
89
+ Antes de marcar `[x]`, valida o critério explicitamente:
90
+
91
+ ```
92
+ "Verificação T1.2: {critério}
93
+ Resultado: {evidência concreta}
94
+ Status: ✓ passou"
95
+ ```
96
+
97
+ Sem evidência concreta, NÃO marca como feito (Princípio: provar que funciona antes de declarar pronto).
98
+
99
+ ### 5. Atualiza PLAN.md
100
+
101
+ Edita `PLAN.md` em tempo real:
102
+
103
+ - `[ ]` → `[~]` (começou)
104
+ - `[~]` → `[x]` (terminou e verificou)
105
+ - `[ ]` → `[!]` (bloqueado, com nota)
106
+
107
+ Atualiza seção "Estado atual" com última atividade.
108
+
109
+ ### 6. Checkpoints
110
+
111
+ Em checkpoints definidos no plano (ex: fim de cada fase), PARA e mostra ao aluno:
112
+
113
+ ```
114
+ "Checkpoint Fase 1 ✓
115
+
116
+ Resumo do que rolou:
117
+ - T1.1 [x]: {descrição curta + resultado}
118
+ - T1.2 [x]: {idem}
119
+ - T1.3 [x]: {idem}
120
+
121
+ Tempo gasto: ~Xmin (estimativa: Ymin)
122
+ Aprendizados: {nota se aprendeu algo importante}
123
+
124
+ Pronto pra Fase 2 ou quer revisar algo?"
125
+ ```
126
+
127
+ Espera OK pra seguir.
128
+
129
+ ## Casos especiais
130
+
131
+ ### Aluno pediu "executa só T1.2"
132
+
133
+ Executa SÓ aquela tarefa. Não avança automaticamente.
134
+
135
+ ### Aluno pediu "executa tudo até o final"
136
+
137
+ Executa todas as fases. Para SÓ em blockers ou quando precisa de decisão. Reporta ao final.
138
+
139
+ ### Aluno pediu "para por aqui"
140
+
141
+ Pausa execução. Salva estado em `PLAN.md`. Não modifica nada mais.
142
+
143
+ ### Plano tem tarefa com perigo (deletar dados, push pra prod, etc)
144
+
145
+ SEMPRE confirma antes — independente de aluno ter pedido "executa tudo". Princípio 2 (confirmação) sobrepõe modo automático.
146
+
147
+ ## Princípios herdados
148
+
149
+ - **Princípio 4 (narrar antes):** sempre anuncia próxima tarefa antes de executar.
150
+ - **Princípio 5 (atualizar estado):** PLAN.md atualizado em tempo real.
151
+ - **Princípio 7 (em dúvida, perguntar):** ambiguidade material → para e pergunta.
152
+ - **Princípio 9 (parar se algo der errado):** erros técnicos não resolvidos em 1-2 tentativas viram pausa.
153
+
154
+ ## Critérios de sucesso
155
+
156
+ - [ ] Próxima tarefa identificada e anunciada
157
+ - [ ] Tarefa executada
158
+ - [ ] Verificação explícita rodada (com evidência)
159
+ - [ ] PLAN.md atualizado
160
+ - [ ] Checkpoint reportado ao aluno (se aplicável)
161
+
162
+ ## Erros comuns
163
+
164
+ - **Marcar tarefa como `[x]` sem verificação concreta:** falha clássica. Mostra evidência (output do comando, screenshot, link) ou não marca.
165
+ - **Pular tarefa "porque parecia trivial":** todas as tarefas viram `[x]` ou `[!]` ou `[~]`. Nenhuma é silenciosamente pulada.
166
+ - **Continuar mesmo com bloqueador:** Princípio 9 manda parar e replanejar, não empurrar.
167
+
168
+ ## Adaptação pro Starter Kit
169
+
170
+ Versão original do superpower é mais elaborada (gerencia branches git, testes automáticos, etc). Esta versão simplifica pra projetos típicos de aluno: workflows, integrações, conteúdo.
171
+
172
+ Versão completa: https://github.com/obra/superpowers/blob/main/skills/executing-plans/SKILL.md
173
+
174
+ ## Referências
175
+
176
+ - Skill original: https://github.com/obra/superpowers
177
+ - Skill complementar: `writing-plans` (cria o plano)
178
+ - Skill complementar: `verification-before-completion` (valida ao final)
179
+
180
+ ## Status
181
+
182
+ ✅ ATIVO desde v1 do Starter Kit (02/05/2026) — versão curada/simplificada do superpower original.
@@ -0,0 +1,157 @@
1
+ ---
2
+ name: verification-before-completion
3
+ status: ATIVO
4
+ category: planejamento
5
+ owner: aluno
6
+ version: 1.0
7
+ mode: guided
8
+ estimated_time: 5-15min (depende do escopo)
9
+ model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4]
10
+ description: Use BEFORE declaring task/project complete. Forces evidence-based verification — runs tests, checks output, confirms each success criterion before marking done. Adapted from obra/superpowers (verification-before-completion skill). Eliminates "I think it works" claims.
11
+ source: https://github.com/obra/superpowers (skill: verification-before-completion)
12
+ ---
13
+
14
+ # Verification Before Completion — Provar Antes de Declarar
15
+
16
+ ## Promessa
17
+
18
+ Antes de declarar "tá pronto" / "merge" / "publica" / "tá ok", roda verificação concreta de cada critério de sucesso. Sem evidência, não marca como feito.
19
+
20
+ Mata o "achei que funcionava" e força "comprovei que funciona".
21
+
22
+ Adaptado de [obra/superpowers](https://github.com/obra/superpowers).
23
+
24
+ ## Quando usar
25
+
26
+ **Use ANTES de:**
27
+ - Marcar projeto/plano como completo
28
+ - Fechar issue
29
+ - Publicar conteúdo
30
+ - Lançar feature
31
+ - Mandar entregável pro cliente
32
+ - Encerrar wave/sprint
33
+
34
+ **Use SEMPRE em:**
35
+ - Última tarefa do `executing-plans`
36
+ - Final do `wizard-{qualquer}` que afirma sucesso
37
+ - Antes de declarar bug "resolvido"
38
+
39
+ ## Como funciona
40
+
41
+ ### 1. Lê critérios de sucesso
42
+
43
+ Onde estão:
44
+ - `PLAN.md` → seção "Sucesso = (critérios)"
45
+ - Issue/ticket → critérios definidos
46
+ - Brief de conteúdo → critérios de qualidade
47
+ - (Se não tem critério, **PARA** — sem critério não há verificação)
48
+
49
+ ### 2. Pra cada critério, confirma com evidência
50
+
51
+ | Critério | Como verificar |
52
+ |---|---|
53
+ | "Funciona em produção" | Roda comando real, mostra output |
54
+ | "Aparece corretamente em mobile" | Screenshot do mobile, não desktop |
55
+ | "API retorna 200" | curl real, não "deve retornar" |
56
+ | "Conteúdo segue brand voice" | Lê tom de voz + compara com draft |
57
+ | "Aluno consegue completar fluxo X" | Testa o fluxo end-to-end |
58
+ | "Aluno autorizou Y" | Mensagem do aluno mandada |
59
+
60
+ **Evidência ≠ pergunta retórica.** "Acho que tá ok?" não é evidência. "Rodei `curl` e vi 200" é evidência.
61
+
62
+ ### 3. Reporta resultado
63
+
64
+ ```
65
+ Verificação de {projeto/tarefa}:
66
+
67
+ ✓ Critério 1: {evidência concreta}
68
+ ✓ Critério 2: {evidência concreta}
69
+ ✗ Critério 3: {falhou — detalhe do problema}
70
+ ✓ Critério 4: {evidência}
71
+
72
+ Status: 3/4 passaram. Critério 3 precisa ser resolvido antes de marcar como completo.
73
+
74
+ Próxima ação: {ação concreta pra resolver critério 3}
75
+ ```
76
+
77
+ ### 4. SE algum critério falhou — NÃO MARCA COMO COMPLETO
78
+
79
+ ```
80
+ Não vou marcar isso como completo até critério 3 passar.
81
+
82
+ Opções:
83
+ a) Resolvo critério 3 agora ({Xmin estimado})
84
+ b) Reescala o critério (era ambicioso demais? muda?)
85
+ c) Marca como "completo com ressalva" e abre issue pra T-X resolver isso
86
+
87
+ Qual prefere?
88
+ ```
89
+
90
+ NÃO permite "ah deixa, depois eu vejo" — é por isso que essa skill existe.
91
+
92
+ ## Erro principal que essa skill resolve
93
+
94
+ ```
95
+ ❌ ANTES:
96
+ "Implementei o fluxo X."
97
+ [marca como done]
98
+ [3 dias depois descobre que crashou na produção em caso edge]
99
+
100
+ ✓ COM ESSA SKILL:
101
+ "Implementei o fluxo X. Verificação:
102
+ ✓ Caminho feliz: rodei manualmente, funcionou
103
+ ✓ Caso edge 1 (input vazio): tratei, validei
104
+ ✗ Caso edge 2 (input gigante >1MB): não testei
105
+
106
+ Não vou marcar como completo até validar caso 2.
107
+ Vou rodar com input de 5MB agora."
108
+ ```
109
+
110
+ ## Princípios herdados
111
+
112
+ - **Princípio 5 (atualizar estado):** verificação atualiza PLAN.md/MEMORY com resultado.
113
+ - **Princípio 7 (em dúvida, perguntar):** se critério é ambíguo, pergunta antes de declarar OK.
114
+ - **Princípio 8 (logging):** verificação completa vira entrada em `memory/decisoes/`.
115
+ - **Princípio 9 (parar se algo der errado):** critério que falha = pausa, não empurra.
116
+
117
+ ## Como invocar
118
+
119
+ No final de qualquer projeto/feature/conteúdo:
120
+
121
+ ```
122
+ "Roda verification-before-completion pra: {projeto/tarefa}.
123
+ Critérios em: {PLAN.md / brief / issue}.
124
+ Não marca como done até passar tudo."
125
+ ```
126
+
127
+ Agente vai rodar checks, mostrar evidência, reportar.
128
+
129
+ ## Adaptação pro Starter Kit
130
+
131
+ Versão original do superpower é mais agressiva (assume contexto de software/CI). Esta versão adapta pro mix de projetos típicos de aluno: conteúdo, integrações, automações, decisões.
132
+
133
+ Princípio central preservado: **evidência antes de declaração**.
134
+
135
+ Versão completa: https://github.com/obra/superpowers/blob/main/skills/verification-before-completion/SKILL.md
136
+
137
+ ## Critérios de sucesso (meta — pra própria skill)
138
+
139
+ - [ ] Lista de critérios foi extraída antes de começar (não inventada na hora)
140
+ - [ ] Cada critério tem evidência concreta documentada
141
+ - [ ] Critérios falhos foram reportados, não escondidos
142
+ - [ ] Decisão final (completo / parcial / pendente) foi explícita
143
+
144
+ ## Erros comuns
145
+
146
+ - **Confiar em "vibe check":** "parece bom" não é verificação. Roda o teste, não confia no olhómetro.
147
+ - **Pular critérios que parecem triviais:** "verificar permissão" não é trivial até testar.
148
+ - **Aceitar "vou validar depois":** depois é nunca. Valida agora ou marca como pendente.
149
+
150
+ ## Referências
151
+
152
+ - Skill original: https://github.com/obra/superpowers
153
+ - Skills complementares: `writing-plans`, `executing-plans` (cria os critérios que essa skill verifica)
154
+
155
+ ## Status
156
+
157
+ ✅ ATIVO desde v1 do Starter Kit (02/05/2026) — versão curada/simplificada do superpower original.
@@ -0,0 +1,170 @@
1
+ ---
2
+ name: writing-plans
3
+ status: ATIVO
4
+ category: planejamento
5
+ owner: aluno
6
+ version: 1.0
7
+ mode: guided
8
+ estimated_time: 10-30min (varia por complexidade)
9
+ model_compatible: [gpt-5, gpt-5.5, claude-sonnet-4, claude-opus-4]
10
+ description: Use AFTER brainstorming, BEFORE coding/building. Transforms a brainstorm output into an executable plan with concrete tasks, dependencies, and verification criteria. Adapted from obra/superpowers (writing-plans skill). Plans are documents, not chat — they survive sessions and let agent loop independently.
11
+ source: https://github.com/obra/superpowers (skill: writing-plans)
12
+ ---
13
+
14
+ # Writing Plans — Plano Executável Antes de Começar
15
+
16
+ ## Promessa
17
+
18
+ Pega a saída do brainstorming (problema + solução proposta) e transforma em PLANO EXECUTÁVEL: tarefas concretas, dependências mapeadas, critérios de sucesso por etapa.
19
+
20
+ Plano vira ARQUIVO no workspace (`memory/projects/{nome}/PLAN.md`). Sobrevive sessões. Agente lê e executa sem precisar de hand-holding.
21
+
22
+ Adaptado de [obra/superpowers](https://github.com/obra/superpowers) — originalmente pra software, aplicável a qualquer projeto multi-etapa.
23
+
24
+ ## Quando usar
25
+
26
+ **Use APÓS brainstorming, ANTES de:**
27
+ - Construir feature nova de skill
28
+ - Implementar workflow complexo (3+ etapas)
29
+ - Migração de algo existente
30
+ - Lançamento (produto, conteúdo, evento)
31
+
32
+ **NÃO use pra:**
33
+ - Tarefa one-shot sem etapas
34
+ - Decisão pontual (vai pra `memory/decisoes/`, não plan)
35
+
36
+ ## Estrutura do plano
37
+
38
+ ```markdown
39
+ # Plano: {Nome do projeto}
40
+
41
+ > Criado em {data}. Status: {planejamento|execução|completo|pausado}.
42
+
43
+ ## Objetivo
44
+
45
+ (1 parágrafo. Resultado concreto que você quer alcançar.
46
+ Não "usar tecnologia X" — RESULTADO.)
47
+
48
+ ## Sucesso = (critérios verificáveis)
49
+
50
+ - [ ] {critério 1 — concreto, mensurável}
51
+ - [ ] {critério 2}
52
+ - [ ] {critério 3}
53
+
54
+ ## Tarefas
55
+
56
+ ### Fase 1: {nome}
57
+
58
+ - [ ] **T1.1** — {descrição}
59
+ - Verificação: {como vai saber que terminou}
60
+ - Estimativa: {Xmin/h}
61
+ - Depende de: nenhuma
62
+
63
+ - [ ] **T1.2** — {descrição}
64
+ - Verificação: ...
65
+ - Estimativa: ...
66
+ - Depende de: T1.1
67
+
68
+ ### Fase 2: {nome}
69
+
70
+ - [ ] **T2.1** — ...
71
+
72
+ ## Dependências externas
73
+
74
+ - {API, serviço, pessoa que precisa fazer algo antes}
75
+
76
+ ## Riscos
77
+
78
+ - {risco 1} — mitigação: {como evitar/reagir}
79
+
80
+ ## Estado atual
81
+
82
+ (Atualizado conforme execução. Lista o que tá feito, em progresso, bloqueado.)
83
+
84
+ ---
85
+
86
+ *Atualizar este arquivo conforme execução. Não criar arquivo novo — versionar este.*
87
+ ```
88
+
89
+ ## Como invocar
90
+
91
+ Manda no chat:
92
+
93
+ ```
94
+ "Roda writing-plans pra: {projeto}.
95
+
96
+ Brainstorming já feito (em memory/decisoes/{data}.md).
97
+
98
+ Quero plano executável."
99
+ ```
100
+
101
+ Agente vai:
102
+
103
+ 1. Ler o brainstorming
104
+ 2. Te perguntar 3-5 coisas pra refinar (escopo, prazo, recursos)
105
+ 3. Gerar plano seguindo template acima
106
+ 4. Salvar em `memory/projects/{nome}/PLAN.md`
107
+
108
+ ## Princípios do plano
109
+
110
+ ### 1. Tarefas atômicas
111
+
112
+ Cada T deve ser executável em <2h. Se não cabe em 2h, quebra em sub-tarefas.
113
+
114
+ ❌ "Configurar integração Notion completa" (muito amplo)
115
+ ✅ "Configurar Notion API token + validar com call de teste"
116
+ ✅ "Criar mapeamento de campos USER.md → propriedades do database Notion"
117
+ ✅ "Implementar sync bidirecional (Notion → workspace + workspace → Notion)"
118
+
119
+ ### 2. Verificação por tarefa
120
+
121
+ Cada T tem critério de "como sei que terminou". Sem isso, agente não sabe quando parar/seguir.
122
+
123
+ ❌ "Implementar X" (quando termina?)
124
+ ✅ "Implementar X até que `curl /api/x` retorne 200 com JSON esperado"
125
+
126
+ ### 3. Dependências mapeadas
127
+
128
+ Mostrar T1.2 depende de T1.1 evita execução paralela quebrada.
129
+
130
+ ### 4. Estimativa honesta
131
+
132
+ Se você acha que vai dar 2h, escreve 4h. Sempre escala 2x. Se errar pouco, melhor que estourar.
133
+
134
+ ### 5. Estado vivo
135
+
136
+ Plano não é doc estático. É arquivo VIVO. Conforme executa, atualiza:
137
+
138
+ - `[ ]` → `[x]` quando termina
139
+ - `[ ]` → `[~]` quando começou mas não terminou
140
+ - `[ ]` → `[!]` quando bloqueado (com nota explicando)
141
+ - Adicionar T descobertas mid-execução (não esconder escopo)
142
+
143
+ ## Adaptação pro Starter Kit
144
+
145
+ A versão original do superpower é mais detalhada (especificação de testes, refactors, etc). Esta versão simplifica pra projetos que aluno típico de starter-kit faz: launches, integrações, configs complexas.
146
+
147
+ Se quer versão completa: https://github.com/obra/superpowers/blob/main/skills/writing-plans/SKILL.md
148
+
149
+ ## Princípios herdados
150
+
151
+ - **Princípio 5 (atualizar estado):** PLAN.md é arquivo vivo, atualiza durante execução.
152
+ - **Princípio 8 (logging):** decisões importantes do plano vão em `memory/decisoes/`.
153
+
154
+ ## Critérios de sucesso
155
+
156
+ - [ ] Plano salvo em `memory/projects/{nome}/PLAN.md`
157
+ - [ ] Tarefas são atômicas (cada uma <2h)
158
+ - [ ] Cada tarefa tem critério de verificação
159
+ - [ ] Dependências entre tarefas estão mapeadas
160
+ - [ ] Aluno sabe a próxima ação concreta
161
+
162
+ ## Referências
163
+
164
+ - Skill original: https://github.com/obra/superpowers
165
+ - Skill complementar: `executing-plans` (executa o plano)
166
+ - Skill complementar: `verification-before-completion` (valida que terminou)
167
+
168
+ ## Status
169
+
170
+ ✅ ATIVO desde v1 do Starter Kit (02/05/2026) — versão curada/simplificada do superpower original.