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