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.4

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 increasing 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ᵢ = (xᵢ, φᵢ, Δᵢ, oᵢ)

State aggregation:

Sₙ = {o₁, …, oₙ}

Cumulative drift:

C(Sₙ) = Σ Δᵢ

Continuation:

C(Sₙ) < τ

Stop:

C(Sₙ) ≥ τ

Topology:

Rᵢ₊₁ = 𝒯(Rᵢ, Sᵢ, C(Sᵢ))

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:
Email: sabouhi.research@gmail.com
LinkedIn: https://www.linkedin.com/in/ryan-sabouhi/

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.4.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.4-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

File details

Details for the file mrs_scaffold-1.1.4.tar.gz.

File metadata

  • Download URL: mrs_scaffold-1.1.4.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.4.tar.gz
Algorithm Hash digest
SHA256 cf83b0c50395134ab94cb60263f878a8ca7d731121b436057e7867bef88da997
MD5 72c080367b889abdef33bd2eec7d992d
BLAKE2b-256 c9956203b0816dcd8f9e4117dff4333f208454cd5f68594eeb72a527484a6191

See more details on using hashes here.

File details

Details for the file mrs_scaffold-1.1.4-py3-none-any.whl.

File metadata

  • Download URL: mrs_scaffold-1.1.4-py3-none-any.whl
  • Upload date:
  • Size: 19.6 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 28bcd624f307562450976e61da4726904f2a4ef6e7e40c09da9775a03fe8e29d
MD5 87b4fd87c55dfc46c0ada100fd4750af
BLAKE2b-256 7dddc8367d16e82c460ad4c4da6526ec840bb946d56792894af0935feaf19df8

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