/research-experiment
/research-experiment — Ejecuta el estudio diseñado y captura datos en bruto con procedencia completa, junto con un manifiesto de reproducibilidad (entorno, semilla, protocolo, fijación de versiones).
Rol: Investigador Principal (ejecución) Posición en la canalización: intermedia
Ejecuta el estudio o experimento diseñado y captura datos en bruto con procedencia completa. Garantiza la reproducibilidad: registra el entorno, la semilla, el registro del protocolo y la fijación de versiones para que una parte independiente pueda volver a ejecutarlo.
Invocación canónica
/research-experimentCon argumentos:
/research-experiment [--suite-name NAME]Entradas
_inputs/study-design.md (el diseño) y _inputs/preregistration.md (el plan de análisis congelado).
Salidas
_outputs/experiment-log.md (la traza del protocolo con marca de tiempo, más el registro de cierre de una campaña autónoma), los datos en bruto en una ubicación natural del host y _outputs/reproducibility-manifest.md (entorno, semilla, protocolo, fijación de versiones).
Aguas abajo
/research-analysis (consumidor aguas abajo)
Fases del flujo de trabajo
El comando sigue el flujo de trabajo estándar de la canalización /research:
- Cargar el contexto — Lee el diseño del estudio y el preregistro.
- Verificar la Puerta de Secuencia — Confirma que
_inputs/study-design.mdexiste; de lo contrario, detente conBlocked: run /research-design first. - Ejecutar y registrar — Ejecuta el protocolo; captura datos en bruto con procedencia; registra la traza del protocolo con marca de tiempo.
- Capturar la reproducibilidad — Registra el entorno, la semilla, el protocolo y la fijación de versiones.
- Actualizar el manifiesto de transferencia — Registra la ubicación de los datos y el manifiesto de reproducibilidad.
- Emitir el registro —
_outputs/experiment-log.md+ datos en bruto +_outputs/reproducibility-manifest.md.
Umbral de rigor
La ejecución realiza una pasada piloto para calibrar presupuestos y rangos, y luego la comparación completa bajo un plan declarado de utilización de cómputo (asignación de núcleos, techos de memoria, paralelización segura de repeticiones independientes). Cada método estocástico ejecuta su régimen de repeticiones preregistrado con semillas registradas y hardware anotado. Está disponible un bucle de experimentación autónomo opcional y desactivado por defecto. Contra un arnés congelado, propone un cambio a un único objetivo mutable, enuncia una predicción falsable antes de cada ejecución y lo ejecuta con el presupuesto fijo. La métrica principal se lee del registro de ejecución como dos señales: una señal de búsqueda que guía el bucle y una señal de admisión de un conjunto disjunto, que confirma o rechaza un cambio antes de conservarlo: el cambio debe superar la fase de búsqueda y, después, superar al titular en la admisión por más del margen de ruido declarado (o empatar con él reduciendo la complejidad). Se deja constancia de cada ensayo y cada consulta de admisión se cuenta y se divulga.
Un conjunto final intacto se evalúa una sola vez, en el cierre. Una campaña sin él etiqueta su resultado como contaminado por la selección y exploratorio, y cualquier cifra que informe la campaña se vuelve a medir bajo el régimen de repeticiones anterior. El operador confirma una vez el objetivo, el arnés, la métrica, los conjuntos de evaluación, la regla de aceptación, el presupuesto y el espacio de trabajo, y puede fijar criterios de parada; al detenerse, el registro de cierre (recuentos de ensayos, conservados, descartados, fallos y consultas de admisión, la ganancia sobre la línea base y el resultado del conjunto intacto) va al registro del experimento para que la etapa de análisis pueda clasificar el resultado seleccionado por el bucle.
Modos de fallo
| Síntoma | Causa | Recuperación |
|---|---|---|
| Blocked: run /research-design first | Sin diseño del estudio | Ejecuta /research-design para producir _inputs/study-design.md |
| Ejecución no reproducible | Falta el registro de la semilla / el entorno | Registra el manifiesto de reproducibilidad completo antes de continuar |
| Desviación del protocolo sin documentar | Cambio a mitad de ejecución no registrado | Registra la desviación en el registro del experimento; divúlgala en el análisis |
| Resultado del bucle presentado como confirmatorio | El bucle se guio por su conjunto de admisión, o no se leyó ningún conjunto intacto en el cierre | Etiqueta el resultado como contaminado por la selección y exploratorio; la señal de búsqueda guía, la señal de admisión decide y el conjunto intacto se lee una sola vez |
Ejemplos
# Ejecuta el estudio diseñado y captura datos en bruto reproducibles
/research-experiment --suite-name <name>Referencias cruzadas
/research-design
/research-design — Operacionaliza las hipótesis en predicciones comprobables y diseña el estudio (variables, controles, muestra, potencia), luego congela el plan de análisis como un preregistro.
/research-analysis
/research-analysis — Analiza los datos brutos según el plan preregistrado: pruebas planificadas, tamaños del efecto con intervalos de confianza, comprobaciones de robustez y desviaciones divulgadas.