psyclaw 0.27.22 → 0.28.0

package/vendor/ars/deep-research/templates/preregistration_template.md

@@ -0,0 +1,318 @@
+# Preregistration Template — OSF Standard 21-Item Preregistration Template
+
+## Purpose
+A fill-in template based on the OSF Standard Pre-Data Collection Registration format. Researchers complete this template before data collection and upload it to a preregistration platform (e.g., OSF Registries).
+
+---
+
+## Instructions
+
+1. Complete this template **before** data collection
+2. Items marked `[Required]` are mandatory; `[Optional]` are recommended but not required
+3. If an item is not applicable, write "Not applicable" and briefly explain why
+4. After completion, go to [OSF Registries](https://osf.io/registries) to create a preregistration
+5. Once submitted, preregistrations cannot be modified (an embargo period can be set)
+
+---
+
+## A. Study Information
+
+### 1. Title [Required]
+> Study Title
+
+```
+[Enter descriptive study title]
+```
+
+### 2. Authors [Required]
+> Research Team
+
+| Name | Institution | Role | ORCID |
+|------|-------------|------|-------|
+| [Name] | [Institution] | [PI / Co-PI / RA] | [ORCID] |
+| [Name] | [Institution] | [Role] | [ORCID] |
+
+### 3. Research Questions [Required]
+> Main Research Questions
+
+```
+RQ1: [Enter main research question]
+RQ2: [Enter secondary research question, if any]
+```
+
+### 4. Hypotheses [Required]
+> Pre-specified Hypotheses
+> Please state directional predictions clearly
+
+```
+H1: [Enter hypothesis 1, including expected direction]
+    Example: Students receiving treatment X will score significantly higher
+    on test Y than the control group
+
+H2: [Enter hypothesis 2, if any]
+
+H3: [Enter hypothesis 3, if any]
+```
+
+---
+
+## B. Design Plan
+
+### 5. Study Type [Required]
+> Study Design
+
+- [ ] Experiment
+  - [ ] Between-subjects
+  - [ ] Within-subjects
+  - [ ] Mixed design
+  - [ ] Factorial design: ___ x ___
+- [ ] Observational study
+  - [ ] Cross-sectional
+  - [ ] Longitudinal / Cohort
+  - [ ] Case-control
+- [ ] Survey
+- [ ] Other: [Describe]
+
+```
+[Describe study design in detail]
+```
+
+### 6. Randomization [Optional]
+> Randomization Procedure
+
+```
+Randomization method: [Simple random / Stratified random / Cluster random / Block random / Not applicable]
+Randomization unit: [Individual / Class / School / Not applicable]
+Randomization tool: [Random number table / Computer program / Lottery / Not applicable]
+Allocation ratio: [1:1 / 2:1 / Other]
+```
+
+### 7. Blinding [Optional]
+> Blinding / Masking
+
+```
+Blinding level: [No blinding / Single-blind / Double-blind / Triple-blind]
+Blinded parties: [Participants / Researchers / Assessors / Not applicable]
+Blinding maintenance: [Describe how blinding is maintained]
+Unblinding timing: [Describe when unblinding occurs]
+```
+
+### 8. Study Design / Conditions [Required]
+> Specific description of each group/condition
+
+```
+Experimental group/Condition 1: [Describe intervention content, duration, frequency in detail]
+Experimental group/Condition 2: [If any]
+Control group: [Describe control condition in detail]
+```
+
+---
+
+## C. Sampling Plan
+
+### 9. Existing Data [Required]
+> Existing Data Declaration
+
+- [ ] No data have been collected yet (Registration prior to creation of data)
+- [ ] Data exist but have not been examined (Registration prior to any human observation of the data)
+- [ ] Some data have been examined (Registration prior to accessing the data)
+- [ ] Data have been used for preliminary analysis (Registration following analysis of the data)
+
+```
+[Describe data status and your level of familiarity with the data]
+```
+
+### 10. Data Collection Procedures [Required]
+> Data Collection Procedures
+
+```
+Collection method: [Online survey / Paper survey / Interview / Experiment / Archival data / Other]
+Collection instruments: [Questionnaire name / Scale name / Experimental software]
+Collection location: [Online / Classroom / Laboratory / Other]
+Collection timeline: [Start and end dates]
+Data collectors: [Who is responsible for collection]
+```
+
+### 11. Sample Size [Required]
+> Planned sample size
+
+```
+Target sample size: [N = ]
+Sample size per group: [Experimental group n = , Control group n = ]
+```
+
+### 12. Sample Size Rationale [Required]
+> Basis for sample size determination
+
+```
+Method: [Power analysis / Prior research conventions / Feasibility constraints / Other]
+
+Power analysis parameters (if applicable):
+- Effect size: [d = / f = / r = ]
+- Effect size source: [Prior study / Meta-analysis / Pilot study]
+- Significance level (alpha): [.05 / .01]
+- Statistical power: [.80 / .90]
+- Test type: [t-test / ANOVA / Regression / Other]
+- Calculation tool: [G*Power / R / Other]
+- Calculation result: Minimum required N = [  ]
+
+Oversampling rate: [Accounting for ___% attrition, actual target N = ]
+```
+
+### 13. Stopping Rule [Required]
+> When to stop data collection
+
+```
+Stopping rule:
+- [ ] Stop when target sample size is reached
+- [ ] Stop at specified date (Deadline: [Date])
+- [ ] Stop when target power is reached (sequential analysis)
+- [ ] Other: [Describe]
+```
+
+---
+
+## D. Variables
+
+### 14. Manipulated Variables [Required for experiments]
+> Independent Variables
+
+```
+Independent variable 1: [Name]
+Operational definition: [How it is manipulated]
+Levels: [Level 1 / Level 2 / ...]
+
+Independent variable 2: [If any]
+```
+
+### 15. Measured Variables [Required]
+> Dependent Variables
+
+```
+Primary dependent variable: [Name]
+Operational definition: [How it is measured]
+Measurement instrument: [Scale name / Test name]
+Reliability and validity: [Cite reliability/validity literature]
+
+Secondary dependent variable: [If any]
+
+Covariates/Control variables: [If any]
+```
+
+### 16. Indices [Required]
+> Specific scoring method for each variable
+
+```
+Variable 1 scoring:
+- Items: [Which items]
+- Scoring method: [Sum / Mean / Factor score / Other]
+- Reverse-scored items: [Which items need reverse scoring]
+- Missing data handling: [How to handle missing values]
+
+Variable 2 scoring: [Same format as above]
+```
+
+---
+
+## E. Analysis Plan
+
+### 17. Statistical Models [Required]
+> Primary statistical analysis methods
+
+```
+Analysis for Hypothesis 1:
+- Statistical method: [Independent t-test / ANOVA / Regression / HLM / SEM / Other]
+- Detailed description: [Model specification, e.g., DV ~ IV + covariate + (1|cluster)]
+
+Analysis for Hypothesis 2: [Same format as above]
+```
+
+### 18. Transformations [Optional]
+> Data transformation plan
+
+```
+Planned transformations:
+- [ ] No transformations
+- [ ] Log transformation: Applied to [which variables], trigger condition [skewness > ]
+- [ ] Standardization (Z-score)
+- [ ] Other: [Describe]
+```
+
+### 19. Inference Criteria [Required]
+> Statistical inference criteria
+
+```
+Significance level: alpha = [.05 / .01 / .005]
+Multiple comparison correction: [Bonferroni / Holm / FDR / Not applicable]
+Effect size reporting: [Cohen's d / eta-squared / R² / Other]
+Confidence interval: [95% CI / 99% CI]
+One-tailed/Two-tailed test: [Two-tailed / One-tailed, with justification]
+```
+
+### 20. Data Exclusion [Required]
+> Data exclusion criteria
+
+```
+Exclusion criteria:
+- [ ] Failed attention check (Specific criteria: [                ])
+- [ ] Response time too short/long (Criteria: < [  ] minutes or > [  ] minutes)
+- [ ] Outliers (Definition: [> 3 SD / IQR method / Other])
+- [ ] Incomplete rate > [  ]%
+- [ ] Other: [Describe]
+
+Post-exclusion procedures:
+- Report pre- and post-exclusion sample sizes
+- Compare characteristics of excluded vs. retained samples
+```
+
+### 21. Exploratory Analyses [Optional]
+> Planned exploratory analyses
+
+```
+Exploratory analyses (not primary hypotheses, but planned):
+1. [Analysis description]
+2. [Analysis description]
+
+These analyses will be explicitly labeled as "exploratory" in the paper.
+```
+
+---
+
+## F. Other
+
+### Ethics Review [Optional]
+```
+IRB review status: [Approved / Under review / Exempt / Not applicable]
+IRB number: [                ]
+Reviewing institution: [                ]
+```
+
+### Data Availability [Optional]
+```
+Will data be made public: [Yes / No / Partially]
+Data repository: [OSF / Dataverse / Other]
+Timing: [After publication / After study completion / Other]
+```
+
+### Supplementary Materials [Optional]
+```
+- [ ] Full questionnaire/scale
+- [ ] Stimulus materials
+- [ ] Analysis code
+- [ ] Power analysis report
+- [ ] Pilot study results
+```
+
+---
+
+## Pre-Submission Checklist
+
+- [ ] All [Required] items have been completed
+- [ ] Hypotheses are clearly stated and testable
+- [ ] Analysis methods correspond to hypotheses
+- [ ] Exclusion criteria were established before data collection
+- [ ] Confirmatory and exploratory analyses have been distinguished
+- [ ] IRB review status has been confirmed
+- [ ] Preregistration platform has been selected (OSF Registries recommended)
+
+> After completion, go to [OSF Registries](https://osf.io/registries) to submit the preregistration.

package/vendor/ars/deep-research/templates/prisma_protocol_template.md

@@ -0,0 +1,248 @@
+# PRISMA-P 2015 — Systematic Review Protocol Template
+
+## Purpose
+
+Template for writing a systematic review protocol following PRISMA-P 2015 (Preferred Reporting Items for Systematic Review and Meta-Analysis Protocols). Complete this template before starting the literature search and register it on PROSPERO or OSF.
+
+**Reference**: Shamseer et al. (2015). BMJ, 349, g7647. https://doi.org/10.1136/bmj.g7647
+
+---
+
+## ADMINISTRATIVE INFORMATION
+
+### Title
+
+**[Provide a descriptive title that identifies the report as a protocol for a systematic review. Include "systematic review" and "meta-analysis" if applicable.]**
+
+Registration: [PROSPERO / OSF ID, or "To be registered"]
+
+### Authors
+
+| # | Name | Affiliation | Role | Contact |
+|---|------|-------------|------|---------|
+| 1 | [Name] | [Institution] | Guarantor / Lead | [email] |
+| 2 | [Name] | [Institution] | Co-reviewer | [email] |
+
+### Amendments
+
+| Date | Section Changed | Description of Change | Rationale |
+|------|----------------|----------------------|-----------|
+| [date] | [section] | [change] | [why] |
+
+### Support
+
+**Sources**: [Funding source(s) or "No external funding"]
+**Role of funder**: [Describe any role of funders in the review, or "None"]
+
+---
+
+## INTRODUCTION
+
+### Rationale
+
+**[Describe the rationale for the review in the context of what is already known. Explain why this review is needed.]**
+
+Key points to address:
+- What is the health/education/social problem?
+- What is the current state of the evidence?
+- Why is a systematic review needed now? (e.g., existing reviews are outdated, conflicting evidence, no previous review exists)
+
+### Objectives
+
+**[Provide an explicit statement of the question(s) the review will address. Use the PICOS framework.]**
+
+- **P** (Population): [Define the target population]
+- **I** (Intervention/Exposure): [Define the intervention or exposure of interest]
+- **C** (Comparator): [Define the comparison group]
+- **O** (Outcomes): [Define primary and secondary outcomes]
+- **S** (Study design): [Specify eligible study designs]
+
+Research Question: [State the review question in a single sentence]
+
+---
+
+## METHODS
+
+### Eligibility Criteria
+
+#### Study Characteristics
+
+| Criterion | Include | Exclude |
+|-----------|---------|---------|
+| **Study design** | [e.g., RCTs, quasi-experimental, cohort] | [e.g., case reports, editorials, commentaries] |
+| **Publication date** | [e.g., 2010-present] | [Before cutoff, with justification] |
+| **Language** | [e.g., English and Chinese] | [Other languages, with justification] |
+| **Publication status** | [e.g., published and preprints] | [e.g., conference abstracts only] |
+| **Setting** | [e.g., higher education institutions] | [e.g., K-12, non-formal education] |
+
+#### Participants
+
+[Describe the target population in detail. Include age, gender, condition, or other relevant characteristics.]
+
+#### Interventions/Exposures
+
+[Describe the intervention(s) or exposure(s) of interest. Include dosage, frequency, duration if applicable.]
+
+#### Comparators
+
+[Describe the comparator(s). This may include no intervention, usual care, placebo, or alternative interventions.]
+
+#### Outcomes
+
+**Primary outcome(s)**:
+1. [Outcome 1] — measured by [instrument/method], at [time point(s)]
+2. [Outcome 2] — measured by [instrument/method], at [time point(s)]
+
+**Secondary outcome(s)**:
+1. [Outcome 3] — measured by [instrument/method], at [time point(s)]
+2. [Outcome 4] — measured by [instrument/method], at [time point(s)]
+
+#### Timing
+
+[Specify any minimum follow-up duration or time constraints]
+
+### Information Sources
+
+| Database/Source | URL | Coverage | Justification |
+|----------------|-----|----------|---------------|
+| [e.g., PubMed/MEDLINE] | pubmed.ncbi.nlm.nih.gov | Biomedical | Core database for health research |
+| [e.g., Web of Science] | webofscience.com | Multidisciplinary | Citation indexing, broad coverage |
+| [e.g., Scopus] | scopus.com | Multidisciplinary | Large abstract database |
+| [e.g., ERIC] | eric.ed.gov | Education | Core database for education research |
+| [e.g., PsycINFO] | apa.org/pubs/databases/psycinfo | Psychology | Behavioral science coverage |
+| [Grey literature] | [specify sources] | — | Reduce publication bias |
+| [Trial registries] | clinicaltrials.gov, WHO ICTRP | — | Identify unpublished studies |
+
+Additional sources:
+- Reference lists of included studies (backward citation)
+- Citation tracking of key studies (forward citation)
+- Contact with experts in the field (if applicable)
+
+### Search Strategy
+
+**[Present the draft search strategy for at least one database. The strategy should be peer-reviewed using the PRESS checklist.]**
+
+Example structure for [primary database]:
+```
+Search Block 1 (Population):
+  "higher education" OR "university" OR "college" OR "postsecondary"
+
+Search Block 2 (Intervention/Exposure):
+  "quality assurance" OR "accreditation" OR "program review"
+
+Search Block 3 (Outcome):
+  "student outcomes" OR "learning outcomes" OR "graduation rate"
+
+Combined: Block 1 AND Block 2 AND Block 3
+Filters: [date range], [language], [document type]
+```
+
+### Study Records
+
+#### Data Management
+
+[Describe the software/tools to be used for managing records. E.g., Covidence, Rayyan, Excel, Zotero]
+
+#### Selection Process
+
+1. **Deduplication**: [Method for removing duplicates, e.g., automatic in Covidence + manual check]
+2. **Title/Abstract screening**: [Number of reviewers, independence, process for resolving disagreements]
+3. **Full-text screening**: [Number of reviewers, independence, process for resolving disagreements]
+4. **Documentation**: [How excluded studies and reasons will be recorded]
+
+Pilot: [Describe pilot testing of screening criteria, e.g., "Two reviewers will independently screen 50 records to calibrate criteria before full screening"]
+
+#### Data Collection Process
+
+1. **Data extraction form**: [Describe or attach the form. Pilot test with 3-5 studies]
+2. **Extractors**: [Number, independence, process for resolving discrepancies]
+3. **Missing data**: [How missing or unclear data will be handled, e.g., contact authors]
+
+### Data Items
+
+| Category | Variables to Extract |
+|----------|---------------------|
+| **Study metadata** | Authors, year, country, journal, study design |
+| **Participants** | Sample size, demographics, setting, inclusion criteria |
+| **Intervention/Exposure** | Description, duration, frequency, comparison group |
+| **Outcomes** | Primary and secondary outcomes, measurement tools, time points |
+| **Results** | Effect sizes, CIs, p-values, means, SDs, counts |
+| **Quality** | Funding, COI declarations, registration status |
+
+### Risk of Bias Assessment
+
+**Tool**: [Specify the tool]
+- RCTs: RoB 2 (Sterne et al., 2019)
+- Non-randomized studies: ROBINS-I (Sterne et al., 2016)
+- Qualitative studies: [e.g., CASP qualitative checklist]
+
+**Process**: [Number of assessors, independence, consensus process]
+
+**Use in synthesis**: [How risk of bias results will inform the synthesis, e.g., sensitivity analysis excluding high-risk studies]
+
+### Data Synthesis
+
+#### Quantitative Synthesis (Meta-Analysis)
+
+**Conditions for meta-analysis**: [Describe when studies will be pooled, e.g., "When ≥ 3 studies report sufficiently similar outcomes measured in comparable populations"]
+
+**Effect measure**: [Specify, e.g., SMD for continuous outcomes, RR for binary outcomes]
+
+**Model**: [Fixed-effect / Random-effects, with justification]
+
+**Heterogeneity assessment**:
+- Q-test (significance at p < 0.10)
+- I² statistic with 95% CI
+- tau² (between-study variance)
+- Prediction interval
+
+**Subgroup analyses** (pre-specified):
+1. [Subgroup variable 1] — Rationale: [why]
+2. [Subgroup variable 2] — Rationale: [why]
+
+**Sensitivity analyses**:
+1. Leave-one-out analysis
+2. Exclude high risk of bias studies
+3. [Other planned sensitivity analyses]
+
+**Software**: [Specify, e.g., R metafor package, RevMan]
+
+#### Narrative Synthesis
+
+**When meta-analysis is not feasible**: [Describe the narrative synthesis approach, e.g., SWiM reporting guideline, vote counting, effect direction plot]
+
+### Meta-Bias Assessment
+
+**Publication bias**: [Methods to assess, e.g., funnel plot + Egger's test if ≥ 10 studies]
+
+**Selective reporting**: [How to detect, e.g., compare protocol to published report, search trial registries]
+
+### Confidence in Cumulative Evidence
+
+**Framework**: GRADE (Grading of Recommendations, Assessment, Development and Evaluations)
+
+[Describe how GRADE will be applied to assess certainty for each outcome]
+
+---
+
+## APPENDICES
+
+### Appendix A: Draft Search Strategy
+
+[Complete search strategy for the primary database]
+
+### Appendix B: Data Extraction Form
+
+[Include or reference the data extraction form]
+
+### Appendix C: PRISMA-P Checklist
+
+[Mark each PRISMA-P item as addressed with the relevant page/section number]
+
+---
+
+## Revision Log
+
+| Version | Date | Author | Changes |
+|---------|------|--------|---------|
+| 1.0 | [date] | [name] | Initial protocol |