/research-design

Rôle : Investigateur principal (conception de l'étude) Position dans le pipeline : intermédiaire

Opérationnalise les hypothèses en prédictions testables et conçoit l'étude ou l'expérience — variables, conditions de contrôle, unité expérimentale, allocation et masquage, échantillon, instruments, analyse de puissance, menaces à la validité — puis produit un préenregistrement qui gèle le plan d'analyse avant la collecte des données.

Invocation canoniqueCopy Anchor Link

/research-design

Avec arguments :

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

EntréesCopy Anchor Link

_inputs/proposal.md (le plan de référence issu de /research-proposal, l'étape précédente), _inputs/synthesis.md (la carte SOTA + l'énoncé de la lacune) et _spec/research-spec.md (les hypothèses).

SortiesCopy Anchor Link

_inputs/study-design.md (prédictions opérationnalisées, spécification des variables, conditions de contrôle, unité expérimentale, plan d'allocation et de masquage, échantillon, instruments, analyse de puissance, menaces à la validité) + _inputs/preregistration.md (le plan d'analyse gelé, y compris les conditions de contrôle avec leurs critères de réussite, le plan d'allocation et de masquage, le traitement des résultats manquants et toute analyse intermédiaire).

En avalCopy Anchor Link

/research-experiment (consommateur en aval)

Phases du flux de travailCopy Anchor Link

La commande suit le flux de travail standard du pipeline /research :

1. Charger le contexte — Lire la synthèse et les hypothèses de la spécification.
2. Vérifier le Portail de Séquence — Confirmer que _inputs/proposal.md (et les _inputs/synthesis.md et _spec/research-spec.md en amont) existe ; sinon, s'arrêter avec Blocked: run /research-proposal first.
3. Concevoir l'étude — Opérationnaliser les prédictions ; spécifier variables, conditions de contrôle et instruments ; fixer l'unité expérimentale, l'allocation à graine fixée, le plan de masquage et l'ordre d'exécution ; dimensionner l'échantillon pour l'analyse prévue ; énumérer les menaces à la validité.
4. Préenregistrer — Geler le plan d'analyse, les conditions de contrôle, l'allocation et le masquage avant toute collecte de données.
5. Mettre à jour le manifeste de transfert — Enregistrer les chemins de la conception de l'étude et du préenregistrement.
6. Émettre la conception — _inputs/study-design.md + _inputs/preregistration.md.

Structure et dimensionnementCopy Anchor Link

• La structure est fixée dans la conception, non dans l'analyse. La conception nomme l'unité expérimentale et l'unité d'analyse, la procédure d'allocation avec son calendrier à graine fixée et, lorsque les unités sont incluses l'une après l'autre, sa dissimulation, qui est masqué (ou pourquoi le masquage est infaisable), les facteurs de nuisance et la manière dont chacun est bloqué, randomisé ou maintenu constant, ainsi que l'ordre d'exécution. Elle planifie le comparateur et les contrôles positifs et négatifs que l'expérience exécutera. Un contrôle ajouté après le gel est un écart divulgué.
• Les balayages à un seul facteur ne peuvent pas montrer une interaction. Lorsque des composants ou des paramètres sont soupçonnés d'interagir, la conception ajoute un plan conjoint sur l'ensemble suspect et préenregistre l'interaction qu'elle revendique.
• Le plus petit effet d'intérêt provient de la spécification. Il se rattache aux métriques de réussite de la spécification ou à un seuil de signification pratique que la synthèse fonde. L'effet rapporté par une étude antérieure borne la plage plausible et ne tient jamais lieu de plus petit effet d'intérêt.
• Dimensionner pour l'analyse qui sera exécutée. L'objectif de chaque affirmation principale (supériorité, non-infériorité ou équivalence) et sa latéralité sont fixés dans la conception, et chacune est dotée d'une puissance calculée à son propre plus petit effet d'intérêt, au seuil par test que laisse la correction déclarée. Le N requis est rapporté comme une plage couvrant l'effet plausible ; lorsque la faisabilité plafonne N, le plus petit effet détectable à ce N est rapporté et le plus petit effet d'intérêt est déclaré non couvert par la puissance.
• Marges et simulation. N compte des unités indépendantes et est majoré pour la corrélation intra-grappe ; la cible de collecte découle du N analysé au moyen d'un taux de perte consigné. Lorsqu'aucune forme close ne correspond à l'analyse prévue, la puissance est estimée par simulation, avec l'outil, la version, la graine et l'erreur de Monte-Carlo consignés, et une règle séquentielle fixe son nombre d'analyses intermédiaires et sa frontière dans le préenregistrement.

Seuil de rigueurCopy Anchor Link

Pour une étude porteuse de comparaison, la conception fixe, et préenregistre, le seuil empirique : un budget unifié unique pour toutes les méthodes comparées (temps d'exécution égal et, là où c'est pertinent, nombre d'évaluations égal), au moins trente répétitions par instance pour les méthodes stochastiques, un facteur d'ablation qui désactive un composant à la fois, des balayages de sensibilité sur chaque paramètre, et une configuration automatisée sur une partition d'entraînement évaluée sur une partition de test disjointe. La profondeur du seuil évolue avec l'ambition du lieu de publication visé.

Modes de défaillanceCopy Anchor Link

ExemplesCopy Anchor Link

# Design the study and preregister the analysis plan
/research-design --suite-name <name>

Références croiséesCopy Anchor Link

• Aperçu du pipeline
• Référence des commandes