evidence-first-claimslisted
Install: claude install-skill Ahmad-Jaradat-Space/scientistos
# Evidence-first claims
Say in one short line that you are using the `evidence-first-claims` skill before you act, so
the user can see which discipline you are working under.
A claim is only as strong as the lineage attached to it. The engine enforces this in code,
so an unsupported claim raises `ValueError` rather than quietly passing.
The CLI has no command for evidence or claims. Use the MCP tools `add_source`, `add_evidence`,
`register_hypothesis`, `add_assumption` and `register_claim`. They validate arguments and return
contract failures as readable errors. The Python API below is the fallback when the tools are
unavailable or you need something they do not expose.
Run the Python API with the interpreter that has `scientistos` installed, which is the project
venv (`.venv/bin/python`). A system `python3` will not have it importable.
`ResearchEngine(Path("research.db"))`
resolves relative to the current directory, so `cd` into the project that owns the graph, or
pass an absolute path. Do not create a new graph in whatever directory you happen to be in.
## The evidence ladder
Enforced in `ResearchEngine._validate_claim_evidence` (`src/scientistos/engine.py:191`):
| Level | What it requires |
|---|---|
| E0 | Nothing. Unsupported statement, speculation. |
| E1 | At least one evidence record or result, and every attached evidence must pass all four verification flags. |
| E2 | Everything above, plus at least one `result_id`. Empirical claims need empirical results. |
|