wiggum-refactor

Analyze code modules to identify patterns, spec deviations, and simplification opportunities.

45|7|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/wiggum-cc/chief-wiggum --skill wiggum-refactor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wiggum-refactor
Source: https://github.com/wiggum-cc/chief-wiggum/tree/main/skills/wiggum-refactor
Command: npx skills add https://github.com/wiggum-cc/chief-wiggum --skill wiggum-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The wiggum-refactor skill performs post-hoc analysis of modules after multiple PRs to identify reusable patterns, reveal spec deviations, and suggest simplifications to reduce technical debt.

Core Features & Use Cases

  • Pattern extraction: Identify recurring structures and conventions that can generalize into a spec or library.
  • Deviation detection: Compare implementation against authoritative specs and highlight mismatches with concrete file:line citations.
  • Simplification guidance: Propose restructuring or consolidation to improve maintainability and readability.
  • Use Case: After a feature has touched the same module across many PRs, run refactor analysis to surface patterns to standardize in the Kanban backlog.

Quick Start

Run the skill on a target module path, for example: wiggum-refactor lib/my-service/

Frequently Asked Questions about wiggum-refactor

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

FAQPage Schema
How do I identify refactoring opportunities to reduce technical debt after multiple PRs?▼

To reduce technical debt after multiple PRs, run a post-hoc module analysis to identify recurring patterns, spec deviations, and simplification opportunities. This process surfaces prioritized refactoring recommendations grounded with file:line citations and authoritative spec references.

What is the best way to detect code deviations from an authoritative spec?▼

The best way to detect code deviations is to perform an analysis that compares your implementation against authoritative specs. This highlights mismatches with concrete file:line citations, revealing exactly where the code diverges from the intended standard.

How do I extract reusable code patterns for a Kanban backlog?▼

You can extract reusable code patterns by analyzing modules to identify recurring structures and conventions. This analysis suggests consolidations to standardize in a library or spec, and can optionally create Kanban tasks to track the work.

When should I run a code simplification analysis on my modules?▼

You should run a code simplification analysis during cleanup cycles or after a feature has touched the same module across multiple PRs. This timing ensures accumulated technical debt and structural inconsistencies are addressed before they compound.

Can I generate Kanban tasks directly from technical debt analysis?▼

Yes, you can generate Kanban tasks directly from technical debt analysis. The analysis produces prioritized refactoring recommendations with evidence, and includes optional Kanban task creation to track the identified simplification work.