fix-rule

To fix ShellCheck lint rule deltas in shuck, diagnose whether the divergence originates from the ShellCheck tool, the shuck architecture, or a corpus mismatch, then implement the correction at the appropriate linter architecture layer.

Your shuck rule produces different results due to conformance deltas caused by a ShellCheck quirk, a shuck bug in the parser or semantic layer, or a corpus mismatch that requires updating corpus-metadata with divergence notes.

Debug a CXXX rule by tracing the delta through the linter architecture layers—parser, semantic, facts, and rules—to identify the exact layer where the conformance failure originates before applying a targeted fix.

You should fix the parser or facts layer when a delta originates from shuck architecture limitations, and avoid hacking the rule directly; the structured workflow ensures fixes are implemented at the appropriate layer where the problem actually originates.

You cannot use this skill to implement new rules from scratch; it is specifically designed to diagnose and fix misalignments between ShellCheck and shuck rule deltas for existing rules, not to build new linting logic.

Verify shuck lint rule fixes by running targeted corpus tests against the minimal reproducer after implementing the correction at the identified layer, ensuring the conformance delta is resolved across the corpus.