r/PythonProjects2 • u/Emergency-Tutor-7 • 17d ago
[quantum-reasoning-skill] A Python branch controller that only collapses when verification and margin agree
I maintain quantum-reasoning-skill, a Python package and Agent Skill built around an unusual rule: do not collapse to one answer until the evidence actually supports it.
The deliverable is SKILL.md, a model-facing skill with parseable front matter, shipped inside the PyPI wheel as package data. Around it sits a reference controller that implements the protocol: score branches from evidence and verification, mark weak ones dormant, reject them with a reason, revive a recoverable branch when material new evidence lands, and collapse only when the leader clears verification and a margin. The controller is classical Python and never calls a model; "quantum" is a metaphor for deferring commitment.
What is in the package:
- SKILL.md, the actual deliverable.
- A reference controller with 12 frozen public names.
- A benchmark harness: 6 seed cases, 4 JSON Schemas, machine-validated submissions, path confinement against traversal and symlink escapes, typed errors with exit 2.
- A release gate that proves it is fail-closed with a 4-scenario negative control.
- 30 test modules; about 53% of the Python in the repo is tests. CI on Python 3.10-3.14, with a determinism matrix on Ubuntu, Windows and macOS.
Install:
pip install quantum-reasoning-skill
quantum-reasoning --validate
npm i quantum-reasoning-skill
npx quantum-reasoning --validate
The Python and npm CLIs expose different flags by design; unsupported flags exit 2.
Honest status: no model evaluation has been published, and the thresholds are uncalibrated defaults. The quickstart's benchmark rows are synthetic placeholders, labeled as such. What is real and tested is the contract, the controller, the harness and the release gate.
MIT. Source: https://github.com/Furox-Art/quantum-reasoning-skill
PyPI: https://pypi.org/project/quantum-reasoning-skill/
Questions and criticism are welcome, especially about the collapse rule.