/research-design
/research-design — Operationalizes the hypotheses into testable predictions and designs the study (variables, controls, sample, power), then freezes the analysis plan as a preregistration.
Role: Principal Investigator (study design) Pipeline position: mid-chain
Operationalizes the hypotheses into testable predictions and designs the study or experiment — variables, controls, sample, instruments, power analysis, threats-to-validity — then produces a preregistration that freezes the analysis plan before data collection.
Canonical invocation
/research-designWith arguments:
/research-design [path/to/research-suite/]Inputs
_inputs/proposal.md (the plan-of-record from /research-proposal, the predecessor stage), _inputs/synthesis.md (the SOTA map + gap statement), and _spec/research-spec.md (the hypotheses).
Outputs
_inputs/study-design.md (operationalized predictions, variable specification, controls, sample, instruments, power analysis, threats-to-validity) + _inputs/preregistration.md (the frozen analysis plan).
Downstream
/research-experiment (downstream consumer)
Workflow phases
The command follows the standard /research pipeline workflow:
- Load context — Read the synthesis and the spec's hypotheses.
- Verify the Sequence Gate — Confirm
_inputs/proposal.md(and the upstream_inputs/synthesis.mdand_spec/research-spec.md) exists; otherwise halt withBlocked: run /research-proposal first. - Design the study — Operationalize predictions; specify variables, controls, sample, instruments, power; enumerate threats-to-validity.
- Preregister — Freeze the analysis plan before any data collection.
- Update the handoff manifest — Record the study-design and preregistration paths.
- Emit the design —
_inputs/study-design.md+_inputs/preregistration.md.
Rigor floor
For a comparison-bearing study the design fixes, and preregisters, the empirical floor: one unified budget across all compared methods (equal wall-clock and, where meaningful, equal evaluation count), at least thirty repetitions per instance for stochastic methods, an ablation factor that disables one component at a time, sensitivity sweeps over each parameter, and automated configuration on a training split evaluated on a disjoint test split. The floor depth scales to the target-venue ambition.
Failure modes
| Symptom | Cause | Recovery |
|---|---|---|
| Blocked: run /research-proposal first | No plan-of-record | Run /research-proposal to produce _inputs/proposal.md |
| Underpowered design | Sample too small for the effect | Re-run the power analysis; resize the sample |
| Analysis plan not frozen | Preregistration skipped | Author _inputs/preregistration.md before data collection |
Examples
# Design the study and preregister the analysis plan
/research-design path/to/research-suite/Cross-references
/research-proposal
/research-proposal — Transforms the synthesized gap and theoretical framework into a fundable, reviewable plan-of-record: SMART aims, feasibility and risk register, impact pathway, preregistration plan, and EQUATOR reporting-guideline selection — the proposal stage of the /research pipeline, between /research-synthesis and /research-design.
/research-experiment
/research-experiment — Executes the designed study and captures raw data with full provenance plus a reproducibility manifest (environment, seed, protocol, version pins).