protection-audit

What problem does it solve?

This Skill provides comprehensive oversight of your code protection system, ensuring that critical code is consistently safeguarded. It identifies discrepancies between policy and implementation, tracks protection coverage, and automates compliance reporting, saving time and reducing risk.

Core Features & Use Cases

• Codebase Scanning: Scans for @protected, @immutable, and @maintainable annotations across the codebase.
• Detailed Reporting: Generates summary, detailed, and JSON reports on protection levels, files, and lock dates.
• Consistency Verification: Checks if code annotations align with CODE_PROTECTION_POLICY.md, highlighting any inconsistencies.
• Coverage Tracking: Measures and reports the percentage of protected files and tracks protection growth over time via Git history.
• Use Case: Run a weekly audit to ensure all newly stabilized features are properly protected, identify any unprotected passing features, and generate a dashboard for your team to review code stability and compliance, ensuring continuous code health.

Quick Start

Audit the codebase for protection annotations and generate a summary report. Verify consistency between code protection annotations and the policy document.