/research-experiment
/research-experiment — Executa o estudo projetado e captura dados brutos com proveniência completa, além de um manifesto de reprodutibilidade (ambiente, semente, protocolo, fixação de versões).
Papel: Pesquisador Principal (execução) Posição no pipeline: intermediária
Executa o estudo ou experimento projetado e captura dados brutos com proveniência completa. Garante a reprodutibilidade: registra o ambiente, a semente, o registro do protocolo e a fixação de versões para que uma parte independente possa reexecutar.
Invocação canônica
/research-experimentCom argumentos:
/research-experiment [path/to/research-suite/]Entradas
_inputs/study-design.md (o projeto) e _inputs/preregistration.md (o plano de análise congelado).
Saídas
_outputs/experiment-log.md (o rastro do protocolo com carimbo de data/hora), os dados brutos em um local natural do host e _outputs/reproducibility-manifest.md (ambiente, semente, protocolo, fixação de versões).
Downstream
/research-analysis (consumidor downstream)
Fases do fluxo de trabalho
O comando segue o fluxo de trabalho padrão do pipeline /research:
- Carregar o contexto — Lê o projeto do estudo e o pré-registro.
- Verificar o Portão de Sequência — Confirma que
_inputs/study-design.mdexiste; caso contrário, interrompe comBlocked: run /research-design first. - Executar e registrar — Executa o protocolo; captura dados brutos com proveniência; registra o rastro do protocolo com carimbo de data/hora.
- Capturar a reprodutibilidade — Registra o ambiente, a semente, o protocolo e a fixação de versões.
- Atualizar o manifesto de transferência — Registra a localização dos dados e o manifesto de reprodutibilidade.
- Emitir o registro —
_outputs/experiment-log.md+ dados brutos +_outputs/reproducibility-manifest.md.
Piso de rigor
A execução faz uma passagem-piloto para calibrar orçamentos e faixas, e em seguida a comparação completa sob um plano declarado de utilização de computação (alocação de núcleos, tetos de memória, paralelização segura de repetições independentes). Cada método estocástico executa seu regime de repetições pré-registrado com sementes registradas e hardware anotado. Um laço autônomo de experimento, opcional e desligado por padrão, está disponível: contra um arcabouço congelado, ele propõe uma mudança em um único alvo mutável, executa-a com o orçamento fixo, retém-na somente se superar o titular e registra em diário cada tentativa.
Modos de falha
| Sintoma | Causa | Recuperação |
|---|---|---|
| Blocked: run /research-design first | Sem projeto do estudo | Execute /research-design para produzir _inputs/study-design.md |
| Execução não reproduzível | Falta o registro da semente / ambiente | Registre o manifesto de reprodutibilidade completo antes de prosseguir |
| Desvio de protocolo não documentado | Mudança em meio à execução não registrada | Registre o desvio no registro do experimento; divulgue na análise |
Exemplos
# Execute o estudo projetado e capture dados brutos reproduzíveis
/research-experiment path/to/research-suite/Referências cruzadas
/research-design
/research-design — Operacionaliza as hipóteses em previsões testáveis e projeta o estudo (variáveis, controles, amostra, poder), depois congela o plano de análise como um pré-registro.
/research-analysis
/research-analysis — Analisa os dados brutos conforme o plano pré-registrado: testes planejados, tamanhos de efeito com intervalos de confiança, verificações de robustez e desvios divulgados.