---
name: validate-17-layers
description: >
  The BlueMouse 17-Layer Alpha Scale (Static Standard).
  Ensures code hygiene, structural integrity, and logic safety.
allowed-tools:
  - Read
  - Bash
  - Grep
  - Glob
user-invocable: true
context: fork
---

# 🐭 BlueMouse Alpha Scale (17-Layer Static Standard)
*The Industrial Golden Standard for Static Code Analysis.*

This document defines the **Alpha Scale** (Layers 1-17), originally established by the BlueMouse project. It ensures code hygiene, structural integrity, and logic safety.

## Group 1: Syntax & Hygiene (L1-L4)
*   **L1: Basic Syntax**: Code must compile/parse without any syntax errors.
*   **L2: AST Structure**: Must have a valid Abstract Syntax Tree with clear class/function hierarchy.
*   **L3: Indentation**: Strict adherence to PEP-8 (4 spaces, no tabs).
*   **L4: Naming**: `snake_case` for functions/variables, `PascalCase` for classes.

## Group 2: Interface & Documentation (L5-L8)
*   **L5: Signature Check**: Function arguments must match the design specification.
*   **L6: Return Value**: Functions must return the expected types (no implicit `None` if `int` promisised).
*   **L7: Type Hints**: Explicit usage of Python typing (`List`, `Dict`, `Optional`, etc.).
*   **L8: Docstrings**: Every function and class must have a descriptive docstring.

## Group 3: Dependency Integrity (L9-L12)
*   **L9: Import Check**: No missing or broken modules.
*   **L10: Circular Ref**: Prevention of circular import loops (A->B->A).
*   **L11: Version Guard**: Package versions must match `requirements.txt`.
*   **L12: Path Resolution**: Correct usage of absolute vs relative imports.

## Group 4: Logic & Safety (L13-L17)
*   **L13: Complexity**: Cyclomatic complexity must remain low (avoid deeply nested loops).
*   **L14: Exception Handling**: No bare `try...except` blocks; specific exceptions required.
*   **L15: Resource Leak**: File handles and sockets must be closed (use `with` context managers).
*   **L16: Security Scan**: Zero tolerance for hardcoded passwords, API keys, or tokens.
*   **L17: Logic Flow**: No dead code or unreachable branches.

---
*Verified by FlashSquirrel Omega-27 Agent.*