CI: Multi-Platform Passing v1.1.0 Research Protocol Scaffold FAIR-Aligned Scaffolding 5 Methodological Pillars

Transform Any Agentic IDE into a High-Rigor, Polyglot Scientific Workbench.

Mitigates procedural p-hacking, flags silent data leakage, and provides cryptographic auditability. Equips Google Antigravity, Claude Code, Cursor, and Copilot with structured methodological guardrails, preregistered hypothesis ledgers, and tamper-evident SHA-256 manifests.

Global Skill Install
curl -fsSL https://raw.githubusercontent.com/krsdntr/OmniResearch/main/install.sh | bash
Raw Data Quarantine (Locked SHA-256)
Mandatory 95% Confidence Intervals
Polyglot: Python, R, Julia & C++
Zero Dependencies (Pure stdlib tools)
antigravity@omniresearch: ~/study
100%
Raw Data Immutability Guarantee
5
Methodological Research Paradigms
6
Scientific Modality Data Handlers
SHA-256
Cryptographic Lineage Manifest
Epistemological Discipline

Enforcing Scientific Guardrails on Autonomous LLMs

When AI coding assistants are left ungoverned, they silently modify datasets, fish for p-values, and hallucinate uncalibrated trendlines. OmniResearch establishes hard deterministic boundaries.

01 / TAMPER DETECTION

Raw Data Tamper-Evidence

01_data/raw/ is monitored under continuous cryptographic integrity checks. The agent is restricted from modifying raw files in place, with every execution validated against SHA-256 baselines.

02 / PREREGISTRATION

Hypothesis Ledger

Before executing regressions or neural sweeps, null (H₀) and alternative (H₁) hypotheses, significance α thresholds, and power plans are committed to a local preregistration ledger in 00_meta/.

03 / MANDATORY UNCERTAINTY

Error Bounds & Sensitivity

Point estimates without standard errors or 95% confidence intervals are rejected. Every reported metric must undergo ablation and sensitivity testing.

04 / CRYPTOGRAPHIC LINEAGE

Manifest Receipts

Every plot and table is cryptographically bonded to the raw inputs, transformation script, seed, and OS specs in 05_artifacts/provenance/manifest.json.

Methodological Rigor (v1.1)

The 5 Pillars of Computational Research Integrity

Bridging autonomous LLM execution with the reproducible science protocols and auditability standards required by peer-reviewed research.

PILLAR 01 // HUMAN-IN-THE-LOOP gate_check.py

Approval Gates & Digital Signatures

Replaces unmonitored exploratory runs with structured human oversight. Requires explicit researcher digital approval before unlocking data execution pipelines and statistical inferences in 00_meta/.

$ python gate_check.py lock --gate hypothesis-lock
PILLAR 02 // PUBLICATION READY generate_appendix.py

Auto-Appendix for Journals

Streamlines technical documentation for peer-review. Automatically compiles standardized LaTeX (booktabs) and Markdown methodology appendices directly from cryptographic lineage manifests.

$ python generate_appendix.py --project . --format all
PILLAR 03 // PRE-EXECUTION AUDIT scan_leakage.py

Real-time Data Leakage Scanner

Static code analysis powered by Python Abstract Syntax Trees (AST). Automatically intercepts pre-split transformations (e.g. StandardScaler.fit() prior to split) and temporal shuffle leaks before execution.

$ python scan_leakage.py 03_src/python --strict
PILLAR 04 // BIG DATA SCALE record_provenance.py

Streaming Buffers & Merkle Trees

Engineered for high-throughput genomic, physical, and observational datasets. Uses 8MB streaming buffers and 64MB chunked Merkle Tree roots for scalable, memory-efficient data integrity checks.

$ python record_provenance.py --verify --manifest ...
PILLAR 05 // ANTI-SYCOPHANCY Reviewer 2 Protocol

Adversarial Anti-Bias Auditing

Mitigates confirmation bias and LLM sycophancy. Deploys an automated adversarial audit protocol to challenge claims via marginal p-value bounds (0.01 ≤ p < 0.05), 5% outlier sensitivity trims, and 1,000-permutation placebo tests.

> 00_meta/adversarial_audit.md [5 Attack Vectors Checked]
Deterministic Dataflow

The OmniResearch Execution Pipeline

How information moves through strict quarantine boundaries without leakage or retroactive tampering.

01_data/raw/ Immutable Source [READ-ONLY] SHA-256 Checksummed 00_meta/ & 02_plan Preregistration H₀/H₁ Matrix & α=0.05 Statistical Plan Locked 03_src/ Polyglot Deterministic Engine Python • R • Julia • C++ seed=42 • CI=0.95 Normality & VIF Checked 05_artifacts/ Publication Outputs 300 DPI / Vector PDF Colorblind-Friendly RECEIPT manifest .json SHA-256
Interactive Verification

Cryptographic Lineage Simulator

Test the tamper-detection principle live in your browser. Alter a single character in the raw patient cohort below to see how SHA-256 immediately detects tampering and invalidates the artifact receipt.

Source: 01_data/raw/patient_cohort.csv READ-ONLY
Live Raw Input SHA-256: Computing...
Audit Log & Verification Manifest manifest.json
Expected Certified Hash in manifest.json: c88f4bd42736f26d7492c95f0eaf1b052b746c443e03300c43fc422d9bcf4936
DATASET INTACT: SHA-256 matches registered study receipt.
Methodologist Guardrail: If the hash diverges, Antigravity halts execution immediately and raises an unverified lineage alarm before any figures can be published.
Workspace Scaffolding

Standard FAIR Directory Architecture

Click through each directory layer to inspect its operational role, file permissions, and scientific guardrails.

00_meta/
Prereg
01_data/raw/
Locked
02_methodology/
Protocol
03_src/
Polyglot
04_experiments/
Sweeps
05_artifacts/
Receipts
06_reports/
Papers
00_meta/

Research Objectives & Preregistered Hypotheses

Stores formal hypothesis matrices, study objectives, and decision logs. Establishes the study protocol prior to computing statistics.

Directory Protocol & Mandated Files
  • hypothesis_matrix.md: Explicit null vs. alternative hypotheses, α-thresholds, and minimum detectable effect sizes.
  • decision_log.md: Chronological methodological trade-offs and modeling decisions.
Quantitative Specialization

Five Methodological Research Paradigms

OmniResearch adapts its statistical rules depending on your study design. Click a paradigm to inspect its required checks and copy a production prompt.

Experimental Trials & Randomized Controlled Trials (RCT)

Clinical dose-response, split-plot designs, laboratory biology, randomized A/B trials.

paradigms/experimental_rct.md
Mandatory Analytical Protocol
  • Pre-experiment power analysis (Cohen's d, minimum detectable effect).
  • Baseline covariate balance checks (Standardized Mean Differences).
  • Intent-to-Treat (ITT) alongside Per-Protocol (PP) estimates.
  • Linear Mixed-Effects Models (LMM) with random subject intercepts.
Ready-to-Use Agent Prompt
"Examine patient cohort in 01_data/raw/oncology_trial.csv. Generate Kaplan-Meier curves comparing Treatment vs Control, test Schoenfeld residuals for Cox PH compliance, and estimate 95% CIs."

Causal Inference & Observational Econometrics

Economics, epidemiology, policy evaluations, and natural experiments.

paradigms/causal_observational.md
Mandatory Analytical Protocol
  • Difference-in-Differences (DiD) with event-study pre-trend validation.
  • Instrumental Variables (IV / 2SLS) with first-stage F-statistic (> 10 rule).
  • Regression Discontinuity Design (RDD) with McCrary sorting density tests.
  • Heteroskedasticity-consistent cluster-robust standard errors.
Ready-to-Use Agent Prompt
"Estimate the causal impact of the regional policy in 01_data/raw/panel.csv using staggered DiD with state-clustered SEs. Perform a parallel trends diagnostic and plot event-study leads and lags."

Computational Simulation & Reaction Kinetics

Differential equations (ODE/PDE), molecular dynamics, stochastic kinetics.

paradigms/computational_simulation.md
Mandatory Analytical Protocol
  • Explicit pseudo-random seed preservation for Monte Carlo sequences.
  • Stability analysis across stiff ODE regimes (implicit Radau / BDF solvers).
  • Global sensitivity analysis (Sobol indices, Morris screening).
  • Mass and energy conservation checks across simulation time steps.
Ready-to-Use Agent Prompt
"Build a numerical solver in 03_src/python/ for Michaelis-Menten kinetics. Test solver stability across stiff ODE regimes, perform a parameter sweep for k_cat, and verify mass conservation."

Empirical Machine Learning & Benchmarks

Predictive models, tabular benchmarks, feature ablation, hyperparameter tuning.

paradigms/machine_learning_empirical.md
Mandatory Analytical Protocol
  • Zero data leakage: Preprocessing strictly nested inside CV folds.
  • 5×2 cross-validated paired t-tests (Dietterich's test) for model comparisons.
  • Systematic ablation studies quantifying the marginal contribution of features.
  • Reporting PR-AUC and calibration curves alongside ROC-AUC.
Ready-to-Use Agent Prompt
"Benchmark tabular classifiers on 01_data/raw/credit.csv. Ensure leak-free scikit-learn Pipelines, run 5x2cv statistical tests against baseline XGBoost, and report feature ablation impact."

Systematic Reviews & Meta-Analyses

Evidence synthesis, effect pooling, Cochrane Risk of Bias, heterogeneity.

paradigms/meta_analysis_systematic.md
Mandatory Analytical Protocol
  • PRISMA 2020 flow reporting (identified, screened, included).
  • Random-effects pooling models (REML / DerSimonian-Laird).
  • Heterogeneity metrics: Cochran's Q, I² statistic, and τ² calculation.
  • Publication bias assessment via Egger's test and funnel plots.
Ready-to-Use Agent Prompt
"Synthesize the 24 effect sizes in 01_data/raw/studies.csv. Compute pooled estimates via random-effects REML, generate a forest plot, compute I^2 heterogeneity, and evaluate bias via Egger's test."
Modality Hygiene

Six Specialized Scientific Data Handlers

Specialized ingestion protocols tailored to domain data structures. Coordinates, sampling frequencies, and missingness are audited before modeling.

Tabular & Survey Data

.csv .parquet .dta

Handles survey weights, multi-stage stratification (PSU/strata), and multivariate imputation (MICE).

Guardrail: Global imputation prior to train/test split is strictly rejected.

Spatial & Geospatial

.geojson .tif .shp

Coordinate Reference System (CRS) hygiene and spatial autocorrelation (Moran's I).

Guardrail: Explicit EPSG projection transformation required before distance calculation.

Biological Sequences

.fasta .pdb .sdf

RNA-Seq normalization (DESeq2), 3D PDB structure analysis, and SMILES cheminformatics.

Guardrail: Library size and dispersion checked prior to differential expression.

Signals & Sensor Streams

.edf .wav .h5

Biomedical and physical time series (EEG/ECG). Nyquist theorem compliance and bandpass filters.

Guardrail: Phase distortion prevented via forward-backward digital filtering (filtfilt).

Text Corpora & Humanities

.txt .xml .tei

Quantitative stylometry (Burrows' Delta), topic modeling (BERTopic), and lemmatized collocations.

Guardrail: Stopword dictionaries and tokenizer choices fully documented in 02_methodology/.

Graphs & Complex Networks

.gexf .graphml

Topological properties: degree distributions, small-worldness, and community modularity.

Guardrail: Multi-edges and self-loops explicitly handled before matrix decomposition.
Cryptographic Auditing

Cryptographic Lineage Manifest: manifest.json

Every figure and table is permanently sealed with an immutable SHA-256 fingerprint. Inspect an actual certified receipt from our clinical dose-response example.

When results are published, anyone can verify the exact computational environment and dataset that generated Figure 1:

Tamper-Proof Raw Input Bond

Guarantees that raw source tables were not modified in-flight.

Exact Script SHA-256 Fingerprint

Proves the specific Python, R, or Julia code that ran.

Locked Hyperparameters & Seeds

Fixed random seeds (seed=42) and explicit confidence levels (95%).

05_artifacts/provenance/manifest.json schema v1.0.0
{
  "schema_version": "1.0.0",
  "records": [
    {
      "artifact_id": "dose_summary.csv",
      "artifact_sha256": "e5309e7567f7efdbc90aa2874efcea654d31ec4e9de031aef7e582b6a21deefd",
      "timestamp_utc": "2026-09-18T09:28:17Z",
      "source_script": "03_src/python/analyze_dose_response.py",
      "script_sha256": "7f6c256cba08b38b6d85f3f4526645c92c0a97b99a5e0b7a883cf260d42e5851",
      "input_datasets": [
        {
          "path": "01_data/raw/dose_response_trial.csv",
          "sha256": "c88f4bd42736f26d7492c95f0eaf1b052b746c443e03300c43fc422d9bcf4936"
        }
      ],
      "parameters": {
        "confidence_level": 0.95,
        "model": "dose_group_summary"
      },
      "environment": {
        "os": "Windows / Linux / macOS",
        "python_version": "3.14.2"
      }
    }
  ]
}
Polyglot & Cross-Platform

Zero-Configuration Agent Support

OmniResearch integrates natively with any modern coding agent via standard discovery instruction files.

Agentic Environment Primary Configuration Activation Mechanism
Google Antigravity GEMINI.md + SKILL.md Discovered automatically; active on all data analysis and scientific inquiries.
Claude Code CLAUDE.md Terminal CLI activation with custom slash commands (/scaffold, /toolchains).
Cursor IDE .cursorrules Active in Cursor Composer / Chat (Ctrl+I / Cmd+I).
Copilot Workspace & Codex AGENTS.md Adheres to the Universal Agent Instructions standard for multi-agent workflows.
Open Interpreter & Aider AGENTS.md + scripts/ Executes directly in local terminal environments using pure standard-library tools.
Getting Started

Elevate Your Research Agent Today

Install globally across all workspaces or initialize directly within your current Git repository.

macOS / Linux Installation

Installs into ~/.gemini/config/skills/research-scientist/.

curl -fsSL https://raw.githubusercontent.com/krsdntr/OmniResearch/main/install.sh | bash

Windows PowerShell Installation

Installs into C:\Users\<User>\.gemini\config\skills\research-scientist\.

irm https://raw.githubusercontent.com/krsdntr/OmniResearch/main/install.ps1 | iex
BibTeX Citation
@software{omniresearch2026,
  author = {krsdntr},
  title = {OmniResearch: Universal Autonomous Scientific Research Workbench for AI Coding Agents},
  year = {2026},
  url = {https://github.com/krsdntr/OmniResearch}
}