/research-design

Rol: Investigador principal (diseño del estudio) Posición en la canalización: intermedia

Operacionaliza las hipótesis en predicciones comprobables y diseña el estudio o experimento —variables, condiciones de control, unidad experimental, asignación y enmascaramiento, muestra, instrumentos, análisis de potencia, amenazas a la validez— y luego produce un preregistro que congela el plan de análisis antes de la recolección de datos.

Invocación canónicaCopy Anchor Link

/research-design

Con argumentos:

/research-design [--suite-name NAME]

EntradasCopy Anchor Link

_inputs/proposal.md (el plan de referencia de /research-proposal, la etapa predecesora), _inputs/synthesis.md (el mapa SOTA + el enunciado de la brecha) y _spec/research-spec.md (las hipótesis).

SalidasCopy Anchor Link

_inputs/study-design.md (predicciones operacionalizadas, especificación de variables, condiciones de control, unidad experimental, plan de asignación y enmascaramiento, muestra, instrumentos, análisis de potencia, amenazas a la validez) + _inputs/preregistration.md (el plan de análisis congelado, que incluye las condiciones de control con sus criterios de superación, el plan de asignación y enmascaramiento, el tratamiento de los resultados faltantes y cualquier análisis intermedio).

Aguas abajoCopy Anchor Link

/research-experiment (consumidor aguas abajo)

Fases del flujo de trabajoCopy Anchor Link

El comando sigue el flujo de trabajo estándar de la canalización /research:

1. Cargar contexto — Leer la síntesis y las hipótesis de la especificación.
2. Verificar la Puerta de Secuencia — Confirmar que _inputs/proposal.md (y los _inputs/synthesis.md y _spec/research-spec.md previos) existe; de lo contrario, detenerse con Blocked: run /research-proposal first.
3. Diseñar el estudio — Operacionalizar predicciones; especificar variables, condiciones de control e instrumentos; fijar la unidad experimental, la asignación con semilla, el plan de enmascaramiento y el orden de ejecución; dimensionar la muestra para el análisis planificado; enumerar amenazas a la validez.
4. Preregistrar — Congelar el plan de análisis, las condiciones de control, la asignación y el enmascaramiento antes de cualquier recolección de datos.
5. Actualizar el manifiesto de traspaso — Registrar las rutas del diseño del estudio y del preregistro.
6. Emitir el diseño — _inputs/study-design.md + _inputs/preregistration.md.

Estructura y dimensionamientoCopy Anchor Link

• La estructura se fija en el diseño, no en el análisis. El diseño nombra la unidad experimental y la unidad de análisis, el procedimiento de asignación con su calendario con semilla y, cuando las unidades se incorporan una tras otra, su ocultación, quién está enmascarado (o por qué el enmascaramiento es inviable), los factores de molestia y cómo se bloquea, aleatoriza o mantiene fijo cada uno, y el orden de ejecución. Planifica el comparador y los controles positivos y negativos que ejecutará el experimento. Un control añadido después de la congelación es una desviación divulgada.
• Los barridos de un solo factor no pueden mostrar una interacción. Cuando se sospecha que componentes o parámetros interactúan, el diseño añade una disposición conjunta sobre el conjunto sospechoso y preregistra la interacción que afirma.
• El efecto mínimo de interés procede de la especificación. Remite a las métricas de éxito de la especificación o a un umbral de significancia práctica que fundamenta la síntesis. El efecto informado por un estudio previo acota el rango plausible y nunca sustituye al efecto mínimo de interés.
• Dimensionar para el análisis que se ejecutará. El objetivo de cada afirmación primaria (superioridad, no inferioridad o equivalencia) y su lateralidad se fijan en el diseño, y cada una se dota de potencia en su propio efecto mínimo de interés al umbral por prueba que deja la corrección declarada. El N requerido se informa como un rango a lo largo del efecto plausible; cuando la viabilidad limita N, se informa el efecto mínimo detectable con ese N y se declara que el efecto mínimo de interés no tiene potencia suficiente.
• Márgenes y simulación. N cuenta unidades independientes y se infla por la correlación intraconglomerado; el objetivo de recolección se obtiene del N analizado mediante una tasa de pérdida registrada. Cuando ninguna forma cerrada corresponde al análisis planificado, la potencia se estima por simulación registrando la herramienta, la versión, la semilla y el error de Monte Carlo, y una regla secuencial fija su número de análisis intermedios y su límite en el preregistro.

Umbral de rigorCopy Anchor Link

Para un estudio que conlleva comparación, el diseño fija —y preregistra— el umbral empírico: un único presupuesto unificado para todos los métodos comparados (igual tiempo de reloj y, donde sea significativo, igual recuento de evaluaciones), al menos treinta repeticiones por instancia para los métodos estocásticos, un factor de ablación que desactiva un componente a la vez, barridos de sensibilidad sobre cada parámetro y configuración automatizada en una partición de entrenamiento evaluada en una partición de prueba disjunta. La profundidad del umbral se escala a la ambición del lugar de publicación objetivo.

Modos de falloCopy Anchor Link

EjemplosCopy Anchor Link

# Diseña el estudio y preregistra el plan de análisis
/research-design --suite-name <name>

Referencias cruzadasCopy Anchor Link

• Resumen de la canalización
• Referencia de comandos