QuantumNovelty is a catalog of AI agent skills — running on the Claude Code CLI by default, with Codex and Kimi/Moonshot available for cross-vendor checks — for researchers, patent examiners, and patent attorneys. They build run-local evidence KBs with exact quote substantiation, write and review quantum papers, examine quantum patents through a USPTO‑style Office Action workflow, and draft filing packages. The agents refuse to declare a result novel until the comparator and evidence trail have been made explicit.
Tested on real arXiv papers. Every agent call ships its token + USD cost ledger in the PDF report. The framework refuses to silently fall back to a different LLM backend.
All five share the same skill catalog and audit-and-falsify framework. Pick by what you need today: broad idea scouting, paper writing, paper review, patent examination, patent drafting, or prosecution prep.
Start from a topic, seed PDF, or notes file and get a grounded novelty report with references, quote evidence, and a ranked idea ledger.
scout_report.md, scout_references.bib, claim_ledger.md, arxiv_corpus/, source_kb/, and substantiation/.$ chain/run.sh --pipeline scout \
--topic "Using AI for designing superconducting quantum chips" \
--source-file seed_paper.pdf \
--scout-arxiv-max-downloads 10 \
--llm codex
From a research question to a submission-ready manuscript with audit script attached.
Failure Modes section.$ chain/run.sh --pipeline full-pipeline \
--topic "LLM-driven UCCSD pruning on H2O" \
--hamiltonian H2O_4e_4o_8q \
--journal npj-quantum-information \
--quantum-lib mlxq
Point QuantumNovelty at any published or preprint paper. Get a real reviewer report.
$ chain/run.sh --pipeline chat \
--prompt "Review this paper" \
--paper draft.pdf \
--journal npj-quantum-information
Point QuantumNovelty at a Google Patents URL, publication number, or saved file. Patent examiners get claim‑by‑claim statutory triage; patent attorneys get prior-art, validity, amendment, and Office Action response prep. The output is a simulated USPTO Office Action with structured evidence, claim-compliance review, full-application review, and a legal-review disclaimer.
--filing-standard._office_action.json: disposition (allowance / non-final / final), rejected_claims, and rejections_by_statute {101 / 102 / 103 / 112}, parsed from the reconciled rejection block.PATENT_REPORT.pdf, markdown stage outputs, and structured JSON support examiner search notes, attorney response drafts, claim-amendment strategy, and invalidity-risk memos.$ chain/run.sh --pipeline patent-audit \
--patent "https://patents.google.com/patent/US…A1/en" \
--art-unit "AU 2128 (CPC G06N10/00)" \
--filing-standard multi \
--llm claude
Start from an invention disclosure or short topic. QuantumNovelty drafts a filing package for USPTO, EPO, PCT, or multi-standard review: claims, specification, abstract, drawings plan, compliance notes, and filing handoff checklist.
filing_package.md plus a deterministic manifest for attorney review.$ chain/run.sh --pipeline patent-draft \
--disclosure invention_disclosure.md \
--filing-standard uspto \
--llm claude
QuantumNovelty exposes a portable local KB for exact-quote evidence, and it interoperates with the broader ScienceSkills RAG stack where BGE-M3/Regiment indexing is the normal deep-research path.
skills/quantum_kb creates file-backed KBs under quantum-kb/. It ingests PDF, Markdown, TeX, BibTeX, JSON, text, and optional DOCX, then writes plain inspectable index files.
search_results.json, quotes_for_prompt.txt, claim_evidence.md, citations.md, quote_fidelity.json, and emma_parity_report.json.The ScienceSkills deep-research scout provides the heavier RAG path: run-local PDF KBs and per-idea substantiation KBs indexed through Regiment with BGE-M3 by default.
--scout-pdf-kb-only --scout-pdf-kb-index-backend bge-m3 downloads/fetches documents, extracts text, indexes them, and runs quote search.--scout-idea-kb --scout-idea-kb-index-backend bge-m3 builds a separate evidence pack for each final ranked idea.bin/science_env.sh prefers the DSS-root venv and local HuggingFace cache; SCIENCESKILLS_HF_ONLINE=1 opts into refreshing models.# QN native portable KB/RAG
$ skills/quantum_kb/run.sh create --kb quantum_papers --name "Quantum Papers" --default
$ skills/quantum_kb/run.sh ingest --kb quantum_papers --source papers/
$ skills/quantum_kb/run.sh index --kb quantum_papers --purge
$ skills/quantum_kb/run.sh substantiate --kb quantum_papers --claim "The scout idea is novel against current QEC decoder baselines."
# ScienceSkills BGE-M3 PDF KB
$ cd artifacts/code/ScienceSkills/agents/workflows/ai_scientific_paper_workflow_chain
$ ./run.sh --pipeline scout --topic "AI-assisted superconducting chip design" \
--scout-pdf-kb-only --scout-pdf-kb-index-backend bge-m3
# ScienceSkills per-idea BGE-M3 substantiation KBs
$ ./run.sh --pipeline scout --topic "AI-assisted superconducting chip design" \
--scout-idea-kb --scout-idea-kb-index-backend bge-m3
Every skill is a directory with a SKILL.md, a run.sh, and a Python driver. Drop a new one in — the chain discovers it on the filesystem walk.
The audit-and-falsify framework. Augmented-baseline merge → strict-domination at ε_abs=10⁻¹², ε_rel=10⁻⁹ → recompute-from-raw → Wilson 95 % CIs → honest-negatives enforcement → re-runnable audit_claims.py.
SS-like topic scout: live literature, bounded arXiv PDF acquisition, run-local source KB, exact quote substantiation, claim ledger, references, and ranked novel avenues.
Offline-first local KB: create, ingest, index, search, substantiate claims, run grounded reviews, and generate Emma-style perspectives with verified quotes and citations.
full · quick · systematic-review · socratic · fact-check · lit-review · review
full · plan · outline-only · revision · revision-coach · abstract-only · lit-review · format-convert · citation-check · disclosure
full (EIC + R1 + R2 + R3 + Devil's Advocate) · quick · guided · methodology-focus · re-review · calibration
6-voice examining unit → an Office Action for examiner and attorney workflows. Primary (§ 101 Alice/Mayo) · § 102 anticipation · § 103 obviousness (KSR) · § 112 enablement/definiteness · Quantum Technical Specialist · SPE. Also runs claim-compliance and full-application review under USPTO/EPO/PCT standards.
Generates patent-search queries, runs keyless Google Patents/DDGS searches, and writes prior_art_refs.json for grounding §102/§103 analysis in named prior art.
Invention disclosure → quantum-patent filing package: claims, specification, abstract, drawing plan, USPTO § 112(b) / EPO Art. 84 / PCT compliance review, formalities checklist, and attorney handoff.
cherry-picked-baseline · ad-hoc-precision-floor · conflated-regimes · active-space-handwave · hardware-irrelevant-comparison · asymptotic-only-claim · unit-inflation · simulator-laundering · mapping-by-convenience · pareto-cherry-picked-axes · cross-llm-theatre
Falsifiability rubric. Refuses single-vendor "consensus". Predictions persisted before truth.
Deprecated narrow ansatz/Pareto path for fixed-Hamiltonian reproductions. Use quantum_scout or --pipeline scout for broad novelty discovery.
4 standard axes: LLM-mutator on/off · commutation-hint · Pareto seeding · cross-vendor.
CrossRef + arXiv + Semantic Scholar live HTTP. Emits the Pareto-shaped baseline catalog.
Anna's Archive client for citations not on arXiv or CrossRef.
Stage-6 CQE. Geometric-mean composite of Novelty Rigour · Reproducibility · Methodological Rigour · Falsifiability · Domain Depth · Communication.
Zero-LLM permitted-facts ledger plus post-review audit for unanchored citations, quotes, paper claims, and numeric attributions.
Claim-vs-evidence judge that emits allowed and forbidden claims, with conservative downgrade/reject behavior when the manifest is inconsistent or unparsable.
Natural-language frontend. Pattern-first dispatch; LLM fallback. "Review this paper" → the right skill + mode + flags.
Strict-domination primitives surfaced so you can compose custom audit pipelines.
Registries: 11 venues (npj-QI, PRX-Quantum, Quantum, PRL, PRA, Nature Comms…) + 7 libraries (Qiskit, PennyLane, QuTiP, mlxq, Cirq, OpenFermion, no-code).
Multi-source live search, bounded arXiv PDF acquisition, and optional source-file ingestion.
Run-local lexical/hashed-vector KB writes exact quote packets, citations, and claim evidence.
Augmented-baseline merge. Ratio recompute. Wilson CIs. Honest-negatives gate.
Venue-aware draft. Falsifiable amplitude rubric across two vendors.
5 voices. Quantum-CS fallacy taxonomy applied. Verdict + must-fix list.
6-dim Collaboration Quality Evaluation. Geometric mean. Honest about gaps.
Re-run with the same --outdir: stages whose output exists are skipped. --force re-runs everything.
Every LLM call records input_tokens + output_tokens + cost_usd + model_id via claude --output-format json. Estimated counts (codex) are flagged honestly.
If a backend fails the call surfaces as an error. No silent fallback. backend_actually_used is written for Claude, Codex, Kimi/Moonshot, and explicit Anthropic API runs.
The scout writes global_literature/, arxiv_corpus/, source_kb/, substantiation/, scout_manifest.json, and scout_quality.json so users can see where it looked.
Known-answer probes run before every novelty verdict. Recall < 0.67 downgrades verdicts to "(indicative)" and records the original in verdict_ungated. Skip with --skip-retrieval-preflight.
All 282 tests run without LLM calls. New modules cover novelty-audit gates, patent-reviewer defect detection, cross-LLM vendor guard, and call_llm resilience/fallback paths.
The patent path is built for patent examiners and patent attorneys who need a structured workbench for quantum inventions: prior-art search, statutory issue spotting, Office Action-style reasoning, and a report that preserves every stage output.
URL, publication number, or saved file becomes a reproducible extracted markdown record with claims and metadata.
Deep-research review over the claim set: anticipating references, obviousness combinations, and search notes.
§§101/102/103/112 voices plus quantum specialist and SPE disposition, reconciled into an Office Action block.
Claim clarity and structure under USPTO §112(b), EPO Art. 84, PCT clarity/support, plus full-application formalities.
Quantum-CS overclaiming, operability leaps, simulator-laundering, and claim/spec reasoning gaps.
_office_action.json, stage markdown, CQE summary, and PATENT_REPORT.pdf for examiner or attorney review.
Every example here lives at examples/end_to_end/ and contains the input paper, every stage's LLM output, the backend markers (token counts + USD), and the compiled PDF.
⚠ Disclaimer. All reviews below are generated end-to-end by AI, for academic and demonstration purposes only. We make no claims about the papers under review — four passed real peer review at their journals and one is a public arXiv preprint; nothing here is criticism of the authors or a substitute for human peer review. The combined five-paper report is REVIEWS.pdf.
Zeng, Sun, Jiang, Zhao · arXiv:2212.04566 · PRX Quantum 6, 010359
Panel 6.67/10, minor-revisions; 5 fallacy findings. The physics voice traced boundary-condition gaps in the lattice analysis; the Devil's Advocate pressed the observable-estimation-vs-coherent-simulation framing. Full claude run, $1.94 real USD.
Read the report (PDF)Zou, Rahm, Kockum, Olsson · arXiv:2507.01726
Panel 6.0/10, major-revisions; 7 fallacy findings from the quantum-CS taxonomy (cherry-picked-baseline, pareto-cherry-picked-axes, …). Full claude run, $0.97 real USD.
Read the report (PDF)Monbroussou, Mamon, Landman, Grilo, Kukla, Kashefi · arXiv:2309.15547 · Quantum 9, 1745
The quantum-machine-learning entry: trainability, expressivity, barren-plateau analysis of subspace-preserving ansätze. Panel 5.5/10, major-revisions; 6 fallacy findings. Full claude run, $1.63 real USD.
Read the report (PDF)Bermejo, Braccia, Rudolph, Holmes, Cincio, Cerezo · arXiv:2408.12739 · PRX Quantum 7, 020304
The QML dequantization landmark: Pauli-path simulation of QCNNs. Panel 6.0/10, major-revisions; 7 fallacy findings. Full claude run, $1.36 real USD.
Read the report (PDF)Microsoft Quantum · arXiv:2606.03884 · preprint
The hardware entry — first non-gate-model paper through the pipeline, and the showcase for the full verification layer: argument-structure audit, deterministic claims registry, 16-point disclosure audit, and a paragraph-anchored revision plan. Panel 6.33/10, major-revisions; the Devil's Advocate flagged the single-wire scope vs the multi-tetron-array claims. Full claude run, $1.78 real USD across 8 stages.
Read the report (PDF)Surface code · QML kernels · QAOA on MaxCut
Three different topics, three target journals (PRX Quantum / npj-QI / Quantum), three quantum libraries (Qiskit / PennyLane / QuTiP). One drafted with codex when claude hit a nested-CLI collision (since root-caused — nested calls now disable tool use). All three got reject / major-revisions — because they were scaffolded with no real experiments. The reviewer panel is brutal about that, by design.
Open the runQN is a peer of AutoResearchClaw and academic-research-skills. We cherry-picked the good parts and added a quantum-specific spine. The bottom line first — all three frameworks were run head-to-head on the same PRX Quantum paper (LCU-Trotter, arXiv:2212.04566) with the same backend; the measured rows come from that run (full 40-page comparison PDF):
| QN (QuantumNovelty) | ARS (academic-research-skills) | ARC (AutoResearchClaw) | |
|---|---|---|---|
| Review steps | 4 default stages (+3 opt-in: novelty-audit, cross-llm, synthesizer → up to 7) | 7 agents in 3 phases | 2 review stages (of a 23-stage generative pipeline) |
| Reviewer "agents" | 5 voices in one LLM call (EIC + Physics + Novelty + Evidence + Devil's Advocate) | 7 independent LLM calls (field-analyst, EIC, methodology, domain, perspective, Devil's Advocate, synthesizer) | 1 call simulating Reviewer A + B |
| Logical fallacies | ✓ dedicated stage — the only one with a domain taxonomy: 11 quantum-CS fallacies (simulator-laundering, cherry-picked-baseline, cross-llm-theatre, …) + standard | partial — folded into Devil's Advocate + methodology reviewer | ✗ (fabrication / evidence-consistency check instead) |
| Devil's Advocate | ✓ Voice 4 of the panel | ✓ dedicated agent | ✗ |
| Numeric quality gate | ✓ deterministic _quality_gate.json (ARC's shape, zero LLM cost) |
✗ | ✓ the original (score_1_to_10 + threshold) |
| Editorial decision package | ✓ opt-in --with-synthesizer (+ CONSENSUS-0 tags for fallacy-only findings) |
✓ Phase-2 synthesizer (consensus tags, roadmap, response template) | partial (required_actions list) |
| Measured cost (same paper) | 4 calls, $2.15 real USD | 7 calls, $3.10 real USD | 2 calls, $0.66 real USD |
| Quantum-specific? | ✓ the only one | ✗ general academic | ✗ general (ML-leaning) |
All numbers are from a single all-claude run (Claude Code CLI, exact per-call USD). On LCU-Trotter the three architectures landed in the same revisions band — QN gate 6.0/10 (major revisions), ARC gate 7/10 (accept with minor revisions), ARS editorial decision (Minor Revision); QN's quantum-CS-specific checks make it the strictest. The concrete differences in detail:
The audit-and-falsify framework targets the failure modes that appear in quantum-computing papers: simulator precision artefacts, complex64 vs float64 swaps, Pareto cherry-picking on convenient axes, JW/BK/parity mapping chosen for cosmetic gate counts. ARC's gate stack is venue-agnostic; QN's is quantum-shaped.
Run end-to-end on Flow-VQE (arXiv:2507.01726, npj-QI) and LCU-Trotter (arXiv:2212.04566, PRX Quantum) with the PDF report shipped in examples/ — plus HW-QML, QCNN, and the Majorana-tetron preprint, and three scaffolded avenues across different libraries and venues.
Not just review. The quantum_paper skill with 10 modes (full / plan / outline-only / revision / revision-coach / abstract-only / lit-review / format-convert / citation-check / disclosure) takes a topic to a venue-formatted draft. cross_llm_prediction lets you bake falsifiability into the paper.
11 fallacies that appear in quantum-CS work specifically — not in the general taxonomy. Cherry-picked-baseline. Ad-hoc-precision-floor. Simulator-laundering. Mapping-by-convenience. Pareto-cherry-picked-axes. Cross-llm-theatre. The taxonomy was extracted from real reviewer concerns raised against the framework's motivating study (paper in development).
11-journal registry (npj-QI · PRX Quantum · Quantum · PRL · PRA · PR Applied · Nature Comms · Comms Physics · QST · Physics Letters A · IEEE TQE) with abstract limits, section orderings, required statements. 7-library registry (Qiskit · PennyLane · QuTiP · mlxq · Cirq · OpenFermion · no-code) emitting library-specific code skeletons.
Every LLM call's input/output tokens, model snapshot ID, USD cost, and elapsed time get aggregated into the comparison PDF. Two-paper analysis cost $<X> on claude; the PDF shows you the receipt. Codex / estimated rows flagged honestly.
QN scrubs CLAUDE_CODE_* and ANTHROPIC_* env from every subprocess, runs from a neutral cwd, passes --no-session-persistence. Hardened against the "tool_use ids must be unique" 400 that bites nested claude calls. When isolation isn't enough, QN refuses to silently swap backends.
Six dimensions composed by geometric (not arithmetic) mean. A run that scored 95 on five dimensions and 30 on Falsifiability composites at 67, not 84. The publication-blocking weakness cannot be averaged away.
All paths get you to the same place: local QuantumNovelty skills running through Claude Code CLI by default, Codex CLI for OpenAI-side checks, or Kimi/Moonshot when you want a direct Anthropic-compatible HTTP backend.
$ git clone <repo> QuantumNovelty
$ cd QuantumNovelty
$ python -m venv .venv && source .venv/bin/activate
$ pip install -e .
$ which claude # default: Claude Code CLI (subscription)
$ claude --version
$ which codex # optional: OpenAI/Codex run
$ export KIMI_ENV_FILE=/path/to/kikm.sh # optional Moonshot/Kimi
$ # QN works with Google Patents URLs out of the box.
$ # Add external patent-data MCPs separately when you need
$ # broader USPTO, PTAB, MPEP, EPO, or worldwide data.
$ chain/run.sh --list-skills
$ chain/run.sh --list-stages
$ python -m pytest tests/test_smoke.py
| Goal | Run this | Output |
|---|---|---|
| Scout a new research avenue | chain/run.sh --pipeline scout --topic "Using AI for designing superconducting quantum chips" --scout-arxiv-max-downloads 10 |
Live literature cards, bounded arXiv PDF corpus, optional source KB, exact quote substantiation, claim ledger, references, and scout report. |
| Find patentability issues | chain/run.sh --pipeline patent-audit --patent US10614371B2 --filing-standard multi |
Prior-art surface, six-voice Office Action, JSON/PDF report, fallacy scan, CQE summary. |
| Ground §102/§103 in named prior art | skills/patent_prior_art/run.sh --topic "quantum error correction decoder" --output runs/prior_art |
prior_art_refs.json for patent_reviewer --prior-art, plus markdown search notes. |
| Check claims for compliance | skills/patent_reviewer/run.sh --mode full --patent patent.html --filing-standard multi |
USPTO §112(b) definiteness / antecedent-basis / structure issues and EPO Art. 84 clarity / two-part-form issues. |
| Review a full application | --filing-standard uspto, epo, pct, or multi |
Specification adequacy, enablement, written-description support, formalities, required sections, abstract/title/drawings. |
| Draft from scratch | chain/run.sh --pipeline patent-draft --disclosure invention.md --filing-standard uspto |
Guided quantum-patent filing package with claims, spec, abstract, drawings plan, compliance review, and handoff checklist. |
| Review a quantum paper | chain/run.sh --pipeline paper-audit --paper paper.pdf --journal npj-quantum-information |
Research review, 5-voice reviewer panel, claims registry, fallacy scan, and CQE summary. |
claude CLI (default) or codex CLIpdftotext (poppler) and pdflatex (any TeX distribution)KIMI_ENV_FILE for Kimi/Moonshot; ANNAS_ARCHIVE_KEY for book downloads; SERPER_KEY for Google Scholar; external patent-data MCPs for broader USPTO/PTAB/MPEP/EPO/worldwide sources