sig-audit-loop

Iteratively improves Fallow maintainability using measured SIG audit deltas.

4.4k|154|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/fallow-rs/fallow --skill sig-audit-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sig-audit-loop
Source: https://github.com/fallow-rs/fallow/tree/main/.agents/skills/sig-audit-loop
Command: npx skills add https://github.com/fallow-rs/fallow --skill sig-audit-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about sig-audit-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve maintainability with measured refactoring?

Run a SIG audit to find one weak property, make a bounded structural change, then re-measure with identical settings. Keep the change only if the target improves and verification stays green, and repeat until the goal is met.

What is a SIG audit in the Fallow workflow?

A SIG audit is a maintainability assessment whose results are compared before and after a change. The delta between the two measurements determines whether a refactoring is retained or reverted.

Why should I avoid combining multiple cleanups in one iteration?

Combining unrelated changes makes it impossible to attribute metric movement to a single cause. The loop requires one bounded change per measurement so the audit delta credibly reflects that change's effect.

When should I stop the audit improvement loop?

Stop when the targeted property meets its goal or when further changes show no credible benefit. Before proposing the final result, run a review to confirm the accumulated changes are sound.

What happens if a refactoring regresses other metrics?

The change is not retained. The loop keeps a modification only when the targeted property improves and verification remains green, so regressions trigger a revert rather than a compromise.