sus

What problem does it solve?

Identifies suspicious, architecturally problematic, and high-impact maintainability issues across a codebase by orchestrating focused analysis agents and synthesizing their output into a prioritized actionable report.

Core Features & Use Cases

• Parallel agent analysis: Deploys modular agents (architecture, complexity, coupling, consistency, risk) to scan the repository in parallel and surface targeted findings.
• Compilation gate and safety checks: Verifies the project builds before analysis and requires explicit user input when no build system is detected.
• Consolidated, prioritized reporting: Deduplicates cross-agent findings, ranks by severity and agreement, and produces file-level locations with remediation guidance.
• Use Case: Run against a product repository before a major release to catch architectural drift, high-risk error handling, and maintainability hotspots that warrant immediate attention.

Quick Start

Run the sus skill to audit the repository and produce a prioritized report of suspicious architectural and maintainability issues with file-level locations and suggested fixes.