@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,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.
|