MRS (Modular Reasoning Scaffold): a mesoscale architecture for symbolic meta-reasoning and recursive cognitive pipelines.
This project has been archived.
The maintainers of this project have marked this project as archived. No new releases are expected.
Project description
Modular Reasoning Scaffold (MRS) — v1.1
Author: Sabouhi (2025)
Lightweight Meta-Reasoning Architecture for Small & Medium LLMs
Overview
MRS is a model-agnostic meta-reasoning architecture that overlays an explicit recursive structure on top of any language model (LLM) without modifying its weights. It gives tiny models the ability to:
- maintain intermediate variables
- perform structured multi-step reasoning
- detect drift and stabilize outputs
- ground reasoning through rules and patterns
- execute self-correction and verification steps
MRS behaves like a symbolic cognitive skeleton wrapped around an LLM, providing:
- State slots (persistent memory)
- Update rules (monotonic + stable transformations)
- Constraint layers (drift, contradiction, instability)
- Topology engine (flow, recursion, branching, halting)
This creates the effect of a “larger mind” without needing parameter scale.
Why MRS Matters
Small LLMs normally fail at reasoning because they cannot:
- Store intermediate results
- Maintain coherence across steps
- Prevent drift or contradictions
- Stabilize their own trajectories
MRS externally supplies these abilities through structure rather than scale.
It is:
- Model-agnostic
- Parameter-free
- Computationally cheap
- Robust against drift
- Transparent and interpretable
Ideal for:
- On-device / low-resource reasoning
- Safety layers
- Interpretability research
- Emergent behavior study
- Multi-agent coordination
- Deterministic / reproducible inference
Core Components
1. Recursion Nodes (Rᵢ)
Rᵢ = (input xᵢ, rule φᵢ, drift Δᵢ, output oᵢ)
2. State Trackers (S)
Persistent memory for slots and signatures.
3. Constraint Monitors (C)
Guardrails preventing collapse.
4. Topology Engine (𝒯)
Determines recursion depth, continuation, halting, branching.
Architecture Diagram (v1.2)
[Diagram omitted in markdown rendering]
Mathematical Core
Recursion node:
R_i = (x_i, φ_i, Δ_i, o_i)
State aggregation:
S_n = {o_1, ..., o_n}
Cumulative drift:
C(S_n) = Σ Δ_i
Continuation:
C(S_n) < τ
Stop:
C(S_n) ≥ τ
Topology:
R_{i+1} = T(R_i, S_i, C(S_i))
Minimal Reference Implementation
class MRS:
def __init__(self, model, num_slots=4, max_depth=8):
self.model = model
self.slots = [None] * num_slots
self.max_depth = max_depth
self.depth = 0
def update_slot(self, i, value):
self.slots[i % len(self.slots)] = value
def drift(self, text):
return abs(hash(text)) % 1000 / 1000.0
def run(self, prompt):
x = prompt
history = []
while self.depth < self.max_depth:
self.depth += 1
o = self.model(x)
Δ = self.drift(o)
history.append((x, o, Δ))
if Δ > 0.65:
break
self.update_slot(self.depth, o)
x = o
return {
"history": history,
"slots": self.slots,
"final": history[-1][1]
}
Example Usage
python scaffold.py --prompt "Explain gravity at two levels of detail."
Outputs:
- slot history
- drift scores
- stability markers
- topology transitions
- verified final answer
Roadmap
v1.2
- upgraded diagrams
- improved drift monitors
- clearer slot signatures
v1.3
- probabilistic drift model
- dynamic slot allocation
- multi-branch topology
v1.4
- differentiable topology engine
- multi-agent shared MRS states
- hardware/runtime integration
Citation
Sabouhi (2025). Modular Reasoning Scaffold (MRS).
Contact
For research and collaboration inquiries:
Sabouhi (2025)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mrs_scaffold-1.1.3.tar.gz.
File metadata
- Download URL: mrs_scaffold-1.1.3.tar.gz
- Upload date:
- Size: 9.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ae6e3609e01307389d3be0987f1fe37470a979feb321d150abde3d622ef3a917
|
|
| MD5 |
b6325998bc71f91f7bc12d3a5bf47578
|
|
| BLAKE2b-256 |
0c4a66bcd77e4b9649fe1c94b462f88361ad96d92355e62b5f709116ce4c03b3
|
File details
Details for the file mrs_scaffold-1.1.3-py3-none-any.whl.
File metadata
- Download URL: mrs_scaffold-1.1.3-py3-none-any.whl
- Upload date:
- Size: 19.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
936647aa6bf68b9a55789bd405c0ba3ae8e084daf10f973f39954c610e7ae0f4
|
|
| MD5 |
02593fbbe57f9d47992be2afbcf3f4a6
|
|
| BLAKE2b-256 |
986d562316044718dafc6deddf710e51580576f8b360ca331b110ff1d4aefa8f
|