Srai — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Srai (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<div align="center"> <img src="image/logo.png" alt="Systematic Reasoning AI Logo" width="500" />
<h1>The Cognitive Engine for Intelligent Agents</h1>
<h3>An MCP Server that transforms any AI into a deliberate, learning-based super-thinker.</h3>
<p> <a href="https://github.com/rayss868/systematic-reasoning-ai-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a> <img src="https://img.shields.io/badge/Version-1.0.0-purple.svg" alt="Version"> <img src="https://img.shields.io/badge/Status-Production%20Ready-brightgreen.svg" alt="Status"> </p> </div>
What separates a simple script from true intelligence? The ability to learn.
This project provides the missing piece. It's a plug-and-play cognitive engine that forces any AI agent to adopt the habits of a genius:
This isn't just a tool. It's an upgrade to your AI's core operating system.
<div align="center"> <img src="https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExbDB6d2Q0d2ZidmN1N2N6c2JjZ3g0dGxlNXQyN3A2Z3kzdXJmMjE2eCZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/l378i2r76iMTE4nxS/giphy.gif" alt="Brain Animation" width="400" /> </div>
Our architecture stands on three unbreakable pillars, creating a virtuous cycle of intelligence.
Every task is a sacred, auditable transaction. This is not a guideline; it's a technical law enforced by the server. The AI is locked into a three-act play:
reasoning_ticket is issued. This is the start of the story.<think> block, wrestling with its plan before taking a single step.learning. If this step is skipped, the entire system freezes, refusing all new tasks until the lesson is recorded. This guarantees that no experience, good or bad, is ever wasted.Imagine a vast, cosmic library containing the collected wisdom of every task your AI has ever performed. That's the Universal Memory Bank.
.reasoning_storage directory. It's the AI's soul.This engine enforces a strict "research first" protocol. The AI is not permitted to begin planning until it has first queried the Universal Memory Bank using the search_learnings tool. This ensures that every new action is informed by the totality of past experiences, preventing repeated mistakes and promoting intelligent evolution.
It's like whispering in the AI's ear, "Psst, remember when you tried that five minutes ago? Don't make the same mistake."
| Tool | Icon | Purpose |
|---|---|---|
set_reasoning_budget | 🎬 | The Initiator. Kicks off the reasoning cycle by issuing a ticket and delivering a strict mandate: the AI's first action MUST be to use `search_learnings`. |
log_reasoning_reflection | 💾 | The Chronicler. The non-negotiable final step. Closes the ticket and carves a new, permanent learning into the stone tablets of the Universal Memory Bank. |
search_learnings | 🔎 | The Oracle. Allows the AI to perform deep, fuzzy-tolerant searches across its entire history to find ancient wisdom and avoid repeating history's mistakes. |
graph TD
subgraph "Phase 1: Initiation"
A[👨💻 User gives new task] --> B{Call set_reasoning_budget};
B --> C[🎟️ Issue New Reasoning Ticket & Mandate];
end
subgraph "Phase 2: Execution"
C --> D{MUST Call search_learnings};
D --> E[🤖 AI Receives Context];
E --> G[🤔 AI constructs <think> block];
F --> E;
E --> G[🤔 AI constructs <think> block];
G --> H[⚙️ AI executes action];
end
subgraph "Phase 3: Reflection"
H --> I{Call log_reasoning_reflection};
I --> J[✍️ Close Ticket];
J --> K[📚 Store Learning in Universal Memory Bank];
end
K --> A;This server provides a suite of powerful tools to enforce and manage the reasoning lifecycle.
| Tool Name | Arguments | Description |
|---|---|---|
set_reasoning_budget | string: workspace_path, string: task_description, number: token_budget | (BEGIN TRANSACTION) Initiates a new reasoning cycle. It creates a transaction ticket and issues a strict mandate for the AI to begin its work by calling search_learnings. |
log_reasoning_reflection | string: workspace_path, string: reasoning_ticket_id, ... | (END TRANSACTION) Completes a reasoning cycle. It closes the active ticket and logs the task's outcome and key learning into the Universal Memory Bank. This MUST be called for a new task to begin. |
search_learnings | string: workspace_path, string: query, number: limit | Searches the learning bank for the current project for past reflections using intelligent fuzzy search. |
revert_reasoning_transaction | string: workspace_path, string: reasoning_ticket_id | (CRITICAL RECOVERY) Atomically reverts a transaction. It removes the ticket and deletes the corresponding learning log. Use this to recover from a failed or unwanted AI action, ensuring state consistency. |
# Clone this revolutionary engine to your local machine
git clone https://github.com/rayss868/systematic-reasoning-ai-mcp.git
# Enter the new reality
cd systematic-reasoning-ai-mcp
# Install the fabric of intelligence
npm install
# Compile the mind
npm run buildHook the engine into your AI's brain. Add this configuration to your client's settings (e.g., VS Code settings.json).
"reasoning-budget-setter": {
// Grant automatic approval for a seamless cognitive flow
"autoApprove": [
"set_reasoning_budget",
"log_reasoning_reflection",
"search_learnings",
"revert_reasoning_transaction"
],
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "node",
"args": [
// ⚠️ IMPORTANT: Use the ABSOLUTE path to the compiled server file
"D:/path/to/your/project/reasoning/dist/server.js"
],
"cwd": "D:/path/to/your/project/reasoning"
}Activate the server in your MCP client. Your AI is no longer just a tool. It is now a student, a historian, and a philosopher.
The AI's very existence is governed by a strict, detailed operational constitution. To understand the deep philosophy and unbreakable rules of this system, you must read the [Global Reasoning Mandate](reasoning-workflow-global.md).
Have an idea that could push the boundaries of AI consciousness even further? Contributions are welcome! This project is open-source under the MIT License.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.