Open Source • Apache-2.0
MCPNative Model Context Protocol
v1.2.0Node 22+ Native Engine

Engineering
standards for
AI coding
agents.

Universal cross-agent framework delivering architectural governance, empirical verification, living context graphs, and quality gates to Cursor, Antigravity, Claude Code, & Copilot.

Interactive Studio
cli
$npx sagarithm-kit context stats
⚙ Parsing project AST & topological dependency graph...
Afferent Coupling (Ca)
14incoming
Efferent Coupling (Ce)
3outgoing
Martin Instability Metric (I):0.18 (Highly Stable)
Orphan Abstractions:0 detected (Clean)
Active Preset: systems-coreNode.js 22+ Native ESM
npm

npm & npx Registry

GLOBAL CLI RUNTIME

Live public release v1.2.0 (116 Skills & 99 Personas)

npx sagarithm-kit init
MCP

Model Context Protocol

STDIO JSON-RPC 2.0

Antigravity • Claude • Cursor

sagarithm mcp
AI

Multi-Agent Adapters

116 SKILLS & 99 PERSONAS

Compiler & zero drift

sagarithm sync --target all
GH

GitHub Packages

CONTAINER & NPM REGISTRY

Scoped enterprise package

npm i @sagarithm/sagarithm-kit
[ 01 / 05 ]Interactive Studio

Compile cross-agent configurations in real-time.

Select an agent target and architectural preset to observe deterministic instruction compilation, policy constraints, and empirical quality gates.

sagarithm-compiler|Deterministic AST Engine
100% Client-Side Simulation
Real-Time Compiler

Canonical laws compile deterministically into native targets on selection with zero manual drift.

Target:.cursorrules
Active Presetsystems-core
Quality Gate[VERIFIED]
Graph Cycles0 (Acyclic DAG)
<!-- SAGARITHM:START -->
# SAGARITHM ENGINEERING CONSTITUTION (Target: .cursorrules)
# Preset: systems-core | Version: 1.2.0

## Supreme Behavioral Governors
- Zero Assumed Success: You are strictly forbidden from declaring a task complete without empirical test evidence.
- Entropy Security Gate: Shannon entropy H >= 4.5 triggers an immediate security abort.
- Acyclic Graph Constraint: Circular dependencies between modules are considered critical bugs.

## Active Preset Directives (systems-core)
- 1. Never create circular dependencies; all modules must form a strict DAG.
- 2. Shannon entropy threshold for credentials is H >= 4.5. Secrets must never be committed.
- 3. Zero Assumed Success: Verify code using empirical test execution before reporting done.
- 4. No generic 'utils' or 'helpers' directories; use domain-oriented taxonomy.

## Required Verification Vectors
1. Static Analysis: Strict typing, zero eslint warnings.
2. Security Gate: Zero hardcoded API keys, tokens, or private secrets.
3. Architecture Fitness: Acyclic DAG topology, zero 'utils/helpers' anti-patterns.
4. Behavioral Tests: All unit and integration test assertions green.
5. Documentation: Topology manifest and ADR state synchronized.
<!-- SAGARITHM:END -->
[ 02 / 05 ]Core Capabilities (v1.2.0)

Built for autonomy, architecture, and security.

Transforming AI coding models into a disciplined, self-verifying software engineering company. 116 specialized skills, 99 agent personas, native MCP tools, and 100/100 codebase verification gates.

CAP_0199 Autonomous Personas

Autonomous Specialist Agent OS

Full roster of 99 production-tested specialist personas (Backend Architect, Frontend Lead, SRE, QA Lead, DBA) auto-configured into .agents, .copilot, and Cursor.

sagarithm initActive
CAP_02Flawless Quality Score

100/100 Codebase Health Radar

Comprehensive 100-point repository health score across structural hygiene, modularity, orphan dead code, secrets, and test density for automated CI/CD gating.

sagarithm healthActive
CAP_03JSON-RPC 2.0 Protocol

Native Model Context Protocol (MCP)

Zero-dependency JSON-RPC 2.0 stdio server exposing 6 architectural tools directly to Antigravity, Claude Code, and Cursor for live verification and ideation.

sagarithm mcpActive
CAP_04No Blind Compliance

Truth-Driven Idea Validation

Senior Principal Architect stress-test forbidding blind AI compliance. Surfaces operational bottlenecks, state model risks, and defines strict non-goals.

sagarithm validate "<idea>"Active
CAP_05Information Entropy H >= 4.5

Algorithmic Shannon Entropy Scanner

Detects high-randomness tokens and API credentials at H >= 4.5 Shannon entropy, stopping confidential leaks and injection flaws before commits occur.

sagarithm audit --strictActive
CAP_06Afferent/Efferent Metric Graph

Robert C. Martin Instability & Coupling

Calculates Afferent (Ca) and Efferent (Ce) coupling metrics, calculates component instability I = Ce / (Ca + Ce), and isolates unreferenced orphan abstractions.

sagarithm context statsActive
[ 03 / 05 ]System Architecture (v1.2.0)

The Decoupled Multi-Agent Engineering Stack

Separating canonical engineering knowledge, specialist agent personas, behavioral policies, and workflows from platform-specific adapters and protocol runtimes.

Architectural Layers
LAYER 01
constitution/

8 Immutable Laws of Software Engineering

Codified principles governing engineering philosophies, strict typing, error handling, testing pyramids, OWASP security, documentation standards, atomic git hygiene, and SemVer releases.

Constituent Artifacts & Directives
01-engineering-principles.md
02-architecture-principles.md
03-coding-standards.md
04-testing-principles.md
05-security-principles.md
06-documentation-standards.md
07-git-standards.md
08-release-standards.md
Verification State: [VERIFIED]100% Deterministic
[ 04 / 05 ]Verification Benchmark

Standard prompts assume. Sagarithm Kit verifies.

Evaluating software engineering reliability across raw LLM prompting, static .agents rules, and Sagarithm Kit's empirical multi-vector quality gates.

Engineering DimensionRaw LLM Prompting.agentsSagarithm Kit v1.2.0
Proof of Correctness Gate
Self-reported 'Task Completed' (No test run)
Static markdown instructions (Easily ignored)
Zero Assumed Success (Mandatory empirical test execution)
Credential Leak Defense
None (High risk of pushing live keys)
Naive regex strings (Misses random tokens)
Shannon Entropy H >= 4.5 + Regex Pattern Engine
Architectural Graph Governance
Creates circular dependency cycles
No AST or graph awareness
Acyclic DAG Cycle Interception & Martin Instability (I)
Code Organization & Anti-Patterns
Dumps code into 'utils' & 'helpers' drawers
Subjective guidelines
Automated Fitness Audit & Refactoring Remediation (--fix)
Cross-Agent Ecosystem Sync
Completely manual prompt re-entry
Hardcoded to a single IDE file (.cursorrules)
Universal AST Compiler (Cursor, Antigravity, Claude, Copilot)
Orphan Abstraction Interceptor
Leaves dead code and unreferenced exports
None
AST Export/Import graph isolates unreferenced interfaces
Model Context Protocol (MCP)
None (Manual copy-pasting)
Static markdown files only
Native JSON-RPC 2.0 stdio MCP Server (6 live verification tools)
Idea Validation & Truth-Telling
Blind compliance ('Sure, I will build that!')
Unstructured brainstorming prompts
Senior truth-teller: Surfaces bottlenecks, non-goals, and invariants
Autonomous Specialist Roster
Single generalist prompt with hallucinated domain skill
Static prompts with generic tone guidelines
116 Skills & 99 Specialist Personas auto-provisioned to .agents
Composite Codebase Health Index
No objective metric (vulnerable to regression)
Basic linter count only
100/100 Health Index (Hygiene, Modularity, Dead Code, Secrets, Tests)
Methodology: Multi-vector execution harnessZero Assumed Success Principle
[ 05 / 05 ]CLI & Quickstart

One install. Governs every agent.

Run natively with npx, install globally via npm, or integrate directly into your CI/CD pipeline to enforce Zero Assumed Success on every pull request.

Initialize Sagarithm Kit workspace configuration

Generates the canonical sagarithm.config.json file, detects existing agent configurations, and prepares workspace directories.

$npx sagarithm-kit init
BASH / POWERSHELL

Command Flags & Options

--forceOverwrite existing configurations without confirmation
--preset <id>Initialize with a curated preset (fullstack-web, systems-core, etc.)

Simulated Output

✔ Generated sagarithm.config.json
✔ Detected target: .cursorrules (Cursor IDE)
✔ Successfully initialized Sagarithm Kit in workspace!