Architecture Auditing Linter

Architecture Auditing (Linter)

"Dont Trust, must verify."

It scans your code for violations of the architecture rules for logging, pathlib, print, etc.

How to use?

The human-skills linter accepts numerous tool arguments for different purposes. Below, all available arguments are explained:

allowed_args = { "default": ["scan_path", "path", "ignored_path", "ignored_apth", "linter_type"], "rest_api": ["scan_path", "path", "ignored_path", "ignored_apth", "linter_type", "ignored_rules"] }

{
    "tool_name": "linter",
    "tool_args": {
        "scan_path": "Path to the project directory or a specific .py file to audit (REQUIRED).",
        "linter_type": "Linter mode: 'default' (architecture violations) or 'rest_api' (API quality score). Defaults to 'default'.",
        "ignored_path": "Comma-separated list of directory names to skip during scanning (e.g., 'venv, .git, tests').",
        "ignored_rules": "Comma-separated list of rules to skip. Works only in rest_api mode. Example: 'auth_implementation, rate_limiting, caching_strategy'."
    }
}

1. Audit entire project

human-skills '{
    "tool_name": "linter",
    "tool_args": {
        "linter_type": "default",
        "scan_path": "home/user_name/project/",
        "ignored_path": "venv, .git, tests, configs"
    }
}'

2. Audit rest api endpoint

human-skills '{
    "tool_name": "linter",
    "tool_args": {
        "linter_type": "rest_api",
        "scan_path": "home/user_name/project/",
        "ignored_path": "venv, .git, tests, configs",
        "ignored_rules": "auth_implementation, rate_limiting, caching_strategy"
    }
}'

3. Audit a specific file

human-skills '{
    "tool_name": "linter",
    "tool_args": {
        "scan_path": "/path/to/your/project/src/services/logic.py"
    }
}'

What it detects in default mode?

• ❌ Logging Violation: Use of direct import logging (Must use setup_logger).
• ❌ Pathlib Violation: Use of pathlib outside src/config/.
• ❌ Manual Dir Creation: Use of exist_ok=True (Must use ensure_dir).
• ❌ Silent Exception: Use of except: pass (Swallowing errors).
• ⚠️ Print Statements: Use of print() in production-ready code.
• ❌ Env Access: Use of os.environ or os.getenv (Must use Settings).
• ❌ Logger Compliance: Hardcoded log filenames in setup_logger.

What it detects in rest_api mode?

When linter_type="rest_api" is used, it evaluates router files based on 12 Enterprise API Best Practices. Some rules may not apply to local or internal tools. Use ignored_rules to skip them.