/research-design
/research-design — Mengoperasionalkan hipotesis menjadi prediksi yang dapat diuji dan merancang studi (variabel, kontrol, sampel, daya), lalu membekukan rencana analisis sebagai praregistrasi.
Peran: Peneliti Utama (rancangan studi) Posisi pipeline: tengah rantai
Mengoperasionalkan hipotesis menjadi prediksi yang dapat diuji dan merancang studi atau eksperimen — variabel, kondisi kontrol, unit eksperimental, alokasi dan penyamaran, sampel, instrumen, analisis daya, ancaman terhadap validitas — lalu menghasilkan praregistrasi yang membekukan rencana analisis sebelum pengumpulan data.
Pemanggilan kanonis
/research-designDengan argumen:
/research-design [--suite-name NAME]Masukan
_inputs/proposal.md (rencana-acuan dari /research-proposal, tahap pendahulu), _inputs/synthesis.md (peta SOTA + pernyataan kesenjangan), dan _spec/research-spec.md (hipotesis).
Keluaran
_inputs/study-design.md (prediksi yang dioperasionalkan, spesifikasi variabel, kondisi kontrol, unit eksperimental, rencana alokasi dan penyamaran, sampel, instrumen, analisis daya, ancaman terhadap validitas) + _inputs/preregistration.md (rencana analisis yang dibekukan, termasuk kondisi kontrol beserta kriteria lolosnya, rencana alokasi dan penyamaran, penanganan hasil yang hilang, dan setiap peninjauan interim).
Hilir
/research-experiment (konsumen hilir)
Fase alur kerja
Perintah ini mengikuti alur kerja pipeline /research standar:
- Muat konteks — Baca sintesis dan hipotesis spesifikasi.
- Verifikasi Gerbang Urutan — Konfirmasi
_inputs/proposal.md(dan_inputs/synthesis.mdserta_spec/research-spec.mddi hulu) ada; jika tidak, hentikan denganBlocked: run /research-proposal first. - Rancang studi — Operasionalkan prediksi; spesifikasikan variabel, kondisi kontrol, dan instrumen; tetapkan unit eksperimental, alokasi ber-seed, rencana penyamaran, dan urutan pelaksanaan; tentukan ukuran sampel untuk analisis yang direncanakan; cantumkan ancaman terhadap validitas.
- Praregistrasi — Bekukan rencana analisis, kondisi kontrol, alokasi, dan penyamaran sebelum pengumpulan data apa pun.
- Perbarui manifes serah-terima — Catat jalur rancangan studi dan praregistrasi.
- Keluarkan rancangan —
_inputs/study-design.md+_inputs/preregistration.md.
Struktur dan penentuan ukuran
- Struktur ditetapkan dalam rancangan, bukan dalam analisis. Rancangan menyebutkan unit eksperimental dan unit analisis, prosedur alokasi beserta jadwalnya yang ber-seed dan, ketika unit terdaftar satu demi satu, penyembunyiannya, siapa yang disamarkan (atau mengapa penyamaran tidak layak dilakukan), faktor pengganggu dan bagaimana masing-masing diblok, diacak, atau dipertahankan, serta urutan pelaksanaan. Rancangan merencanakan pembanding serta kontrol positif dan negatif yang akan dijalankan eksperimen. Kontrol yang ditambahkan setelah pembekuan adalah penyimpangan yang diungkapkan.
- Sapuan satu faktor tidak dapat menunjukkan interaksi. Ketika komponen atau parameter diduga berinteraksi, rancangan menambahkan tata letak gabungan atas himpunan yang diduga dan mempraregistrasikan interaksi yang diklaimnya.
- Efek terkecil yang diminati berasal dari spesifikasi. Efek ini dapat ditelusuri ke metrik keberhasilan spesifikasi atau ke ambang signifikansi praktis yang dilandasi sintesis. Efek yang dilaporkan studi terdahulu membatasi rentang yang masuk akal dan tidak pernah menggantikan efek terkecil yang diminati.
- Tentukan ukuran untuk analisis yang akan dijalankan. Tujuan setiap klaim primer (superioritas, non-inferioritas, atau ekuivalensi) dan arah ujinya ditetapkan dalam rancangan, dan masing-masing diberi daya pada efek terkecil yang diminatinya sendiri pada ambang per-uji yang tersisa setelah koreksi yang dinyatakan. N yang dibutuhkan dilaporkan sebagai rentang di seluruh efek yang masuk akal; ketika kelayakan membatasi N, efek terkecil yang dapat dideteksi pada N tersebut dilaporkan dan efek terkecil yang diminati dinyatakan tidak memiliki daya.
- Kelonggaran dan simulasi. N menghitung unit independen dan dinaikkan untuk korelasi dalam klaster; target pengumpulan berasal dari N yang dianalisis melalui tingkat kehilangan yang dicatat. Ketika tidak ada bentuk tertutup yang cocok dengan analisis yang direncanakan, daya diestimasi melalui simulasi dengan alat, versi, seed, dan galat Monte Carlo yang dicatat, dan aturan sekuensial menetapkan jumlah peninjauan dan batasnya dalam praregistrasi.
Landasan ketelitian
Untuk studi yang mengandung perbandingan, rancangan menetapkan, dan mempraregistrasikan, landasan empiris: satu anggaran terpadu di seluruh metode yang dibandingkan (waktu-dinding setara dan, bila bermakna, jumlah evaluasi setara), setidaknya tiga puluh pengulangan per instans untuk metode stokastik, faktor ablasi yang menonaktifkan satu komponen setiap kali, sapuan sensitivitas atas setiap parameter, dan konfigurasi otomatis pada pembagian pelatihan yang dievaluasi pada pembagian uji yang terpisah. Kedalaman landasan berskala sesuai ambisi tempat-terbit sasaran.
Mode kegagalan
| Gejala | Penyebab | Pemulihan |
|---|---|---|
| Blocked: run /research-proposal first | Tidak ada rencana-acuan | Jalankan /research-proposal untuk menghasilkan _inputs/proposal.md |
| Rancangan kurang daya | Sampel terlalu kecil untuk efeknya | Jalankan ulang analisis daya untuk analisis yang direncanakan; ubah ukuran sampel, atau laporkan efek terkecil yang dapat dideteksi dan nyatakan bahwa efek terkecil yang diminati tidak memiliki daya |
| Struktur diserahkan kepada analisis | Unit, alokasi, penyamaran, atau urutan pelaksanaan tidak ditetapkan dalam rancangan | Tetapkan dalam rancangan dan praregistrasi; tidak ada uji yang diterapkan setelahnya yang dapat memisahkan perancu yang dibangun oleh tata letak |
| Estimasi terdahulu dipakai sebagai efek sasaran | Efek yang dilaporkan satu studi menggantikan efek terkecil yang diminati | Landasi sasaran pada metrik keberhasilan spesifikasi; gunakan studi terdahulu hanya untuk membatasi rentang |
| Rencana analisis tidak dibekukan | Praregistrasi dilewati | Tulis _inputs/preregistration.md sebelum pengumpulan data |
Contoh
# Rancang studi dan praregistrasikan rencana analisis
/research-design --suite-name <name>Referensi silang
/research-proposal
/research-proposal — Mengubah celah hasil sintesis dan kerangka teoretis menjadi rencana acuan yang layak didanai dan dapat ditinjau: sasaran SMART, register kelayakan dan risiko beserta kontingensinya, jalur dampak, rencana praregistrasi, rencana pengelolaan dan berbagi data, serta pemilihan pedoman pelaporan EQUATOR, ditambah matriks persyaratan untuk panggilan pendanaan yang diberikan dan tanggapan pengajuan ulang yang berdiri sendiri — tahap proposal dari alur /research, antara /research-synthesis dan /research-design.
/research-experiment
/research-experiment — Menjalankan studi yang dirancang dan menangkap data mentah dengan provenans lengkap plus manifes reproduksibilitas (lingkungan, seed, protokol, penyematan versi).