What problem does it solve? Editing the proactive nightly Claude audit workflow (claude-nightly-audit.yml) without knowing its non-obvious invariants causes duplicate issues, missed findings, and silently failing runs. This Skill captures the design decisions a future editor would otherwise break. ## Core Features & Use Cases - Dedup scheme documentation: Explains the two-key system (cluster_key per defect, dedup_key per location) that keeps one defect from becoming N issues, and the deterministic prepare_synthesis.py dedup pass. - Dimension boundaries: Defines the four mutually exclusive audit dimensions (correctness, docs, tests, features) and why security lives in its own workflow. - Operational invariants: Covers severity rules, the bug-label auto-fix promotion path, ISO day-of-week deep-mode selection, allowed_bots requirements, and dry_run validation. - Use Case: Before changing the audit workflow's cadence, filing logic, or adding an audit dimension, load this Skill to avoid regressions like the day-of-month deep-sweep bug or re-filing 130 open findings. ## Quick Start Ask the AI to explain the dedup and severity invariants before editing the nightly audit workflow file.
