3a-solid-gate

Audit Python codebases for SOLID-lite violations using lite and strict profiles.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/AgustinMadygraf/skills --skill 3a-solid-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 3a-solid-gate
Source: https://github.com/AgustinMadygraf/skills/tree/main/3a-solid-gate
Command: npx skills add https://github.com/AgustinMadygraf/skills --skill 3a-solid-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Gate automates the detection of SOLID-lite violations (SRP, DIP, ISP) in Python code, reducing architectural drift and regressions.

Core Features & Use Cases

  • Analyzes code structure to surface SRP violations within use_cases modules.
  • Detects overly large gateways and excessive public methods to enforce ISP.
  • Supports lite and strict profiles, baseline/regression checks, exemptions registry, and todo reporting.

Quick Start

Run the SOLID Gate against your repository to identify SOLID-lite issues and update docs/todo accordingly.

Frequently Asked Questions about 3a-solid-gate

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

FAQPage Schema
How do I detect SOLID principle violations in a Python codebase?

To detect SOLID principle violations in a Python codebase, you can audit the code structure for SRP, DIP, and ISP issues. This process surfaces class bloat in use_cases and interface adapter gateways to reduce architectural drift.

How do I check if a Python class violates the Single Responsibility Principle?

You can check for Single Responsibility Principle violations by analyzing use_cases modules for classes taking on too many responsibilities. The audit identifies these structural issues and updates documentation with the findings.

Does this SOLID code analysis tool work with any Python project structure?

This SOLID code analysis tool is designed for repositories organized under a src layout with specific use_cases and interface_adapters layers. It targets this clean architecture structure to accurately surface gateway bloat.

Can I enforce Interface Segregation Principle rules on Python gateways?

You can enforce Interface Segregation Principle rules by scanning for overly large gateways and excessive public methods. The analysis supports strict and lite profiles to match your required level of architectural enforcement.

How do I handle false positives during Python architectural linting?

To handle false positives during Python architectural linting, you can use an exemptions registry to ignore specific findings. You can also establish a baseline to prevent existing violations from failing regression checks.

Why should I use strict and lite profiles for SOLID code auditing?

Strict and lite profiles for SOLID code auditing allow you to adjust the sensitivity of SRP, DIP, and ISP checks. This lets you progressively enforce architectural rules without being overwhelmed by existing codebase violations.