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, and Windsurf.
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.
Canonical laws compile deterministically into native targets on selection with zero manual drift.
<!-- SAGARITHM:START --> # SAGARITHM ENGINEERING CONSTITUTION (Target: .cursorrules) # Preset: systems-core | Version: 1.0.1 ## 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 -->
Built for autonomy, architecture, and security.
Embedding architectural governance, entropy token defense, and topological graph analysis directly into the agentic development loop.
Autonomous Workflow Orchestration
Deterministic multi-stage workflow runner executing feature development, bug fixes, refactoring, and release prep with strict gate enforcement.
sagarithm run feature-developmentAlgorithmic 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 --strictRobert 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 statsDeterministic Cross-Agent Compiler
Maintains a single canonical source of truth for architectural laws, injecting precision demarcated instruction blocks into Cursor, Antigravity, Claude, and Copilot.
sagarithm sync --target allSix decoupled layers. One source of truth.
Decoupled engineering principles, skills, and policies compiled deterministically into native agent targets without configuration drift.
Engineering Constitution
constitution/Role & Purpose
Codified principles governing engineering philosophies, strict typing, error handling, testing pyramids, OWASP security, documentation standards, atomic git hygiene, and SemVer releases.
Codified Specifications in Layer 01
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 Dimension | Raw LLM Prompting | .agents | Sagarithm Kit v1.0.1 |
|---|---|---|---|
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 |
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.
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!