skills.rest
dohernandez
dohernandezCOMMUNITY
Explore all skills by this author →
GitHub

bugfix

Organize structured debugging workflows with reproduce, plan, failing test, fix, and verify phases.

Updated Jan 26, 2026
Search Tags:#workflow#testing#debugging#regression#quality-assurance#root-cause#bugfix
One-click install
npx skills add https://github.com/dohernandez/claude-skills --skill bugfix-dohernandez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bugfix
Source: https://github.com/dohernandez/claude-skills/tree/main/plugins/bugfix/skills/bugfix
Command: npx skills add https://github.com/dohernandez/claude-skills --skill bugfix-dohernandez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured debugging methodology to ensure bugs are understood, captured in tests, and fixed with minimal changes.

Core Features & Use Cases

  • Enforces a reproducible bug workflow from discovery to regression testing.
  • Produces a failing test and a minimal fix plan enabling safe, auditable changes.
  • Scales to team environments by standardizing artifacts such as tests, plans, and documentation.

Quick Start

Follow the Bugfix workflow to reproduce, plan, write a failing test, implement a minimal fix, and run full tests.

Frequently Asked Questions about bugfix

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

FAQPage Schema
What is a structured debugging workflow for fixing bugs with minimal changes?▼

A structured debugging workflow enforces explicit phases from reproducing the bug to verifying the fix, ensuring bugs are captured in tests and resolved with minimal, auditable code changes.

How do I write a failing test to reproduce a bug before implementing a fix?▼

To write a failing test, first reproduce the bug to understand its root cause, then create a test case that explicitly captures the failure condition before planning and applying the minimal code fix.

What is the best way to prevent regressions when applying a minimal bugfix?▼

The best way to prevent regressions is enforcing mandatory test coverage before merging, requiring a failing test that captures the bug and running full tests to verify the fix works without breaking existing functionality.

Does this structured bugfix workflow scale for team environments?▼

Yes, the structured bugfix workflow scales to team environments by standardizing debugging artifacts such as failing tests, minimal fix plans, and documentation to ensure safe, auditable changes across developers.

When should I not use a minimal fix approach for debugging?▼

You should reconsider a minimal fix approach when a bug stems from a deeper architectural root cause requiring broader refactoring, as this workflow prioritizes targeted changes and strict regression testing over structural rewrites.

Related Skills

Explore More Software Engineering Skills→
sQVesQVe

debug-issue

Diagnose bugs by tracing evidence and generating a BR issue template.

Community
Advanced
adolfoaranaes12adolfoaranaes12
2

apply-qa-fixes

Extract QA gate findings and apply prioritized fixes with test validation.

Community
Intermediate
withzombieswithzombies
80

fixing-bugs

Automate bug fixing from issue creation through regression testing and closure.

Community
Advanced
DataDogDataDog
648

lint

Run Hatch-based lint, format, and quality checks on modified files.

Official
Advanced