Skip to main content

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:

  1. Store intermediate results
  2. Maintain coherence across steps
  3. Prevent drift or contradictions
  4. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mrs_scaffold-1.1.3.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mrs_scaffold-1.1.3-py3-none-any.whl (19.5 kB view details)

Uploaded Python 3

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

Hashes for mrs_scaffold-1.1.3.tar.gz
Algorithm Hash digest
SHA256 ae6e3609e01307389d3be0987f1fe37470a979feb321d150abde3d622ef3a917
MD5 b6325998bc71f91f7bc12d3a5bf47578
BLAKE2b-256 0c4a66bcd77e4b9649fe1c94b462f88361ad96d92355e62b5f709116ce4c03b3

See more details on using hashes here.

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

Hashes for mrs_scaffold-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 936647aa6bf68b9a55789bd405c0ba3ae8e084daf10f973f39954c610e7ae0f4
MD5 02593fbbe57f9d47992be2afbcf3f4a6
BLAKE2b-256 986d562316044718dafc6deddf710e51580576f8b360ca331b110ff1d4aefa8f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page