What problem does it solve?
Improving codebase maintainability often involves unmeasured refactoring where changes are kept without evidence they actually helped. This Skill enforces a disciplined loop where every structural change is measured before and after with SIG audits, and only retained when the targeted property improves without regressions.
Core Features & Use Cases
- Measured Iteration: Run a SIG audit, select one weak maintainability property, and make a bounded structural change with a measurable expected effect.
- Evidence-Based Retention: Keep a change only when the target metric improves and verification stays green; revert otherwise.
- Regression Guardrails: Never combine unrelated cleanup into one measurement iteration, and run a review before proposing the final result.
- Use Case: A developer wants to reduce complexity hotspots flagged by Fallow. They audit, refactor one module, re-measure with identical settings, and repeat until the target is met.
Quick Start
Run the sig-audit-loop skill to iteratively improve one weak maintainability property in this repository, keeping only changes that measurably improve the SIG audit results.