sentrux

Scan codebases for architectural rule violations using .sentrux/rules.toml.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Pyl-Tech/stream-coding --skill sentrux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sentrux
Source: https://github.com/Pyl-Tech/stream-coding/tree/main/.agents/skills/sentrux
Command: npx skills add https://github.com/Pyl-Tech/stream-coding --skill sentrux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sentrux solves the problem of architectural drift by quantifying and enforcing structural quality rules so that code remains layered, bounded, and maintainable over time.

Core Features & Use Cases

  • Structural rule enforcement: Applies constraints from .sentrux/rules.toml to detect violations as a pass/fail gate.
  • Quality signal scoring: Produces a 0–10000 architectural health score derived from modularity, acyclicity, depth, equality, and redundancy.
  • Baseline regression checking: Uses gate to compare current structural health against a saved baseline to prevent gradual degradation.
  • Layer & boundary governance: Ensures dependency direction respects foundational vs presentation layering and prevents DIP violations.
  • Use case: After implementing a new service/module, run structural checks to confirm the domain layer does not start depending on handlers and that the dependency graph remains acyclic and shallow.

Quick Start

Activate the skill by adding a project-specific .sentrux/rules.toml, then run sentrux gate . to enforce the constraints and detect architectural regressions against the baseline.

Frequently Asked Questions about sentrux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce architectural boundaries and prevent dependency drift in my codebase?▼

You can enforce architectural boundaries by defining layer and dependency direction constraints in a `.sentrux/rules.toml` file, then running structural checks to catch foundational vs presentation layering violations and dependency drift.

What is architectural regression detection and how does a baseline comparison work?▼

Architectural regression detection compares current codebase health metrics against a saved baseline to prevent gradual degradation. It checks if structural quality scores have dropped due to cyclical structures or excessive complexity introduced by new changes.

How do I check code quality gates for cyclical dependencies and excessive complexity?▼

You can check code quality gates by running structural analysis commands that scan your codebase against defined thresholds. This pass/fail gate detects cyclical structures, excessive complexity, and dependency direction violations to ensure maintainability.

Can I use structural analysis to quantify codebase modularity and acyclicity?▼

Yes, structural analysis quantifies codebase modularity and acyclicity by generating a 0–10000 architectural health score. This score is derived from metrics including modularity, acyclicity, depth, equality, and redundancy.

Do I need a rules configuration file to run structural governance checks?▼

Yes, you need to add a project-specific `.sentrux/rules.toml` file to define your structural constraints. Once configured, you run the gate command to enforce the rules and detect architectural regressions against a baseline.

When should I run architectural structural checks during the development workflow?▼

You should run architectural structural checks during the STRATEGY, BUILD, and VERIFY stages. This ensures that new services or modules do not introduce layered-dependency drift or violate dependency boundaries before integration.