no-workarounds

Enforce root-cause fixes by detecting and rejecting workaround patterns in code.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/leonanpereirapinto/ai-utils --skill no-workarounds-leonanpereirapinto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: no-workarounds
Source: https://github.com/leonanpereirapinto/ai-utils/tree/main/skills/spec-driven/no-workarounds
Command: npx skills add https://github.com/leonanpereirapinto/ai-utils --skill no-workarounds-leonanpereirapinto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enforce root-cause fixes over workarounds, hacks, and symptom patches in all software engineering tasks. Use when debugging issues, fixing bugs, resolving test failures, planning solutions, making architectural decisions, or reviewing code changes. Activates gate functions that detect and reject common workaround patterns such as type assertions, lint suppressions, error swallowing, timing hacks, and monkey patches. Don't use for trivial formatting changes or documentation-only edits.

Core Features & Use Cases

  • Gate the most common workaround patterns (TYPE, LINT, SWALLOW, TIMING, PATCH, SCATTER, CLONE) to prevent signal silencing.
  • Provide an Escape Valve protocol for unavoidable workarounds with explicit criteria, documentation, and review.
  • Promote long-term code health by guiding refactors, root-cause analysis, and architectural decisions.

Quick Start

Audit your codebase to identify existing workarounds and replace them with root-cause fixes using the gate workflow.

Frequently Asked Questions about no-workarounds

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

FAQPage Schema
How do I eliminate workarounds and technical debt during debugging and bug fixes?

To eliminate workarounds and technical debt during debugging, enforce root-cause fixes over symptom patches by applying a standardized gate workflow that detects and rejects common patterns like type assertions, lint suppressions, and error swallowing.

What are the most common workaround patterns I should look for when refactoring code?

The most common workaround patterns to look for when refactoring code are TYPE, LINT, SWALLOW, TIMING, PATCH, SCATTER, and CLONE. Detecting these patterns prevents signal silencing and promotes long-term code health.

Can I apply a temporary patch if a root-cause fix is not immediately possible during a code review?

Yes, you can apply a temporary patch during a code review if a root-cause fix is not immediately possible by using an Escape Valve protocol, which requires meeting explicit criteria, providing documentation, and undergoing review.

When should I avoid using a root-cause analysis workflow for code changes?

You should avoid using a root-cause analysis workflow for trivial formatting changes or documentation-only edits, as these tasks do not involve the workaround patterns or architectural decisions that necessitate deep debugging gates.

What is the best way to audit an existing codebase for hidden technical debt and monkey patches?

The best way to audit an existing codebase for hidden technical debt and monkey patches is to scan for specific workaround patterns like TIMING and PATCH, then replace them with standardized root-cause fixes using a gate workflow.