O que spike faz?
Use quando o usuário quiser testar uma ideia antes de se comprometer com uma implementação real: "faz um spike disso", "protótipo rápido", "isso é possível?", "compara A/B", "antes de construir".
Não use quando a leitura de documentação/código pode responder à pergunta, ou quando o usuário claramente pediu uma implementação para produção.
Loop
- Pergunta: formule a pergunta concreta de viabilidade.
- Pesquisa: leia documentação/fonte suficiente para escolher uma abordagem crível.
- Construção: crie o menor artefato executável que valide ou invalide a ideia.
- Estresse: teste um caso de borda ou modo de falha.
- Veredito:
VALIDADO,PARCIALouINVALIDADO.
Formato de saída
- Espaço de trabalho padrão:
.tmp/openclaw-spikes/<slug>a menos que o usuário peça um caminho rastreável dentro do repositório. - Opção dentro do repositório:
spikes/<NNN-slug>/comREADME.mde código mínimo. - Prefira CLI executável, HTML pequeno, um endpoint ou teste focado.
- Evite proliferação de pacotes, Docker, arquivos de ambiente, frameworks de aplicação e limpeza de produção.
Ideias com múltiplos spikes
- Divida em 2 a 5 perguntas independentes.
- Execute primeiro a pergunta mais arriscada.
- Para comparações A/B, mantenha as entradas iguais e meça as mesmas dimensões.
- Pergunte antes de construir todas as variantes se o trabalho for maior que um pequeno protótipo.
Formato do veredito
## Veredito: VALIDADO | PARCIAL | INVALIDADO
Pergunta: ...
Evidência: comando/saída/medição exatos.
O que funcionou: ...
O que falhou ou nos surpreendeu: ...
Recomendação: publique / ajuste / evite, com o próximo passo de produção.
Regras
- Um spike invalidado é útil quando descarta um caminho com evidências.
- Não mescle código de spike na produção sem reescrevê-lo normalmente.
- Se dependências externas forem avaliadas, verifique a saúde: release/commit recente, documentação, licença, dificuldade de instalação.