skills.rest
AdelysAlberto
AdelysAlbertoCOMMUNITY
Explore all skills by this author →
Website𝕏@adelysalbertoGitHub

engineering-invariants

Applies universal engineering standards and language-specific rules to source code changes.

1|Updated Jul 18, 2025
Search Tags:#code quality#code review#best practices#coding standards#software architecture#engineering principles#language rules
One-click install
npx skills add https://github.com/AdelysAlberto/md-configs-and-agents --skill engineering-invariants-adelysalberto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: engineering-invariants
Source: https://github.com/AdelysAlberto/md-configs-and-agents/tree/main/agents-hermes/skills/engineering-invariants
Command: npx skills add https://github.com/AdelysAlberto/md-configs-and-agents --skill engineering-invariants-adelysalberto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code written by agents or teams often drifts into inconsistent patterns, hidden coupling, and unverified changes. This Skill enforces a shared set of engineering invariants so every modification to files under src/** follows the same correctness, simplicity, and security standards. ## Core Features & Use Cases - Universal Engineering Principles: Seventeen core invariants covering correctness, single responsibility, DRY, explicit design, error handling, testability, security, and observability. - Language-Specific Rule Loading: Directs the agent to load dedicated rule files for JavaScript/TypeScript, Go, Python, and other languages before writing code. - Verification Discipline: Requires running the project's formatter, linter, type checker, tests, or build before declaring a task complete. - Use Case: When an agent modifies a TypeScript service in src/, it first loads the JavaScript/TypeScript rules, applies the invariants (e.g., explicit error handling, minimal change surface), and verifies the change with the project's checks. ## Quick Start Apply the engineering invariants and load the matching language rules before modifying any file under src/ in this project.

Frequently Asked Questions about engineering-invariants

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

FAQPage Schema
How do I enforce coding standards for AI agents editing source files?▼

Apply this Skill when working on files matching src/**. It loads seventeen core engineering invariants plus language-specific rule files, so every code change follows the same correctness, simplicity, and security standards.

What engineering principles should AI-generated code follow?▼

The Skill defines principles including correctness first, simplicity first, single responsibility, DRY with judgment, explicit design, separation of concerns, composition over inheritance, explicit error handling, testability, and security by default.

Does this Skill support languages other than TypeScript and Python?▼

Yes. It provides rule files for JavaScript/TypeScript, Go, and Python, and instructs the agent to load the corresponding language rule file for any other language if one is available.

When should design patterns be introduced in agent-written code?▼

Only when they solve an actual problem. The Skill explicitly forbids introducing patterns for their own sake, speculative abstractions, or technical complexity for unrequested or hypothetical requirements.

How is a code change verified before being marked complete?▼

The Skill requires validating the implementation with the project's formatter, linter, type checker, tests, build, or equivalent verification mechanisms before declaring the task complete.

Related Skills

Explore More Software Engineering Skills→
RayzerrekRayzerrek

unity-project-scout

Inspect Unity project version, packages, asmdef layout, and folder structure.

Community
Intermediate
e-stpierree-stpierre
1

af-sdlc-review

Run tests, linters, type checks, and builds to review repository changes.

Community
Advanced
V1vek98V1vek98

security-audit

Identify and report security vulnerabilities in a codebase.

Community
Advanced
the-perfect-developerthe-perfect-developer
11

eslint

Configure ESLint flat configs for JavaScript and TypeScript projects.

Community
Advanced