RO research-os
v0.1.0 — dogfood-proven

research-os No synthesis before source truth.

A local-first CLI that turns an open-ended topic into a gated research-pack — a structured repo where Claude, Cowork, or a swarm can work for hours without hallucinating or flattening the investigation.

Init

research-os init "How should X be structured?"

Chain

research-os gather 01-landscape --url https://... research-os claim extract 01-landscape research-os gate 01-landscape

Freeze

research-os audit research-os freeze # audits/freeze-receipt.json written

16 load-bearing laws

Every step in the chain is enforced, not trusted.

Source truth first

No synthesis before source truth. Fetch is evidence; extraction is interpretation. Models interpret source spans — they never author evidence text.

Claim integrity

Extraction may overproduce; synthesis may not inherit abundance. A formal triage pass deduplicates and parks low-leverage candidates before review.

Freeze-locked output

Freeze writes a sha256-fingerprinted receipt of every canonical and synthesis artifact. Unfinished research cannot masquerade as done.

The workflow chain

Create a pack

research-os init "How should X be structured?"
research-os section add 01-landscape --purpose "Map the landscape"

Gather and gate

research-os gather 01-landscape --url https://example.com/paper
research-os claim extract 01-landscape
research-os claim triage 01-landscape
research-os contradict map 01-landscape
research-os gate 01-landscape

Review and freeze

research-os review 01-landscape --two-pass-llm
research-os review-promote 01-landscape
research-os cowork handoff
research-os audit
research-os freeze